@mintplayer/ng-spark 22.29.0 → 22.30.0

package/README.md

@@ -62,7 +62,7 @@ Import from the entry point, not from the package root; each one is a separate c
 | `/column-filter` | `<spark-column-filter-panel>` |
 | `/po-detail`, `/po-create`, `/po-edit` | The routed detail, create and edit pages |
 | `/po-form` | `<spark-po-form>`, `<spark-reference-picker>`, `<spark-lookup-picker>` |
-| `/renderers` | `provideSparkAttributeRenderers([...])`, `SPARK_ATTRIBUTE_RENDERERS`, `withDeclaredInputs` ([guide](https://github.com/MintPlayer/MintPlayer.Spark/blob/master/docs/guide-custom-attribute-renderers.md)) |
+| `/renderers` | `provideSparkAttributeRenderers([...])`, `SPARK_ATTRIBUTE_RENDERERS` (with the core `paragraph` renderer built in), `withDeclaredInputs` ([guide](https://github.com/MintPlayer/MintPlayer.Spark/blob/master/docs/guide-custom-attribute-renderers.md)) |
 | `/panels` | `provideSparkDetailPanels(...)`, `provideSparkDetailActions(...)`, `provideSparkQueryListActions(...)` — how add-ons put components on the routed pages |
 | `/client-operations` | `provideSparkClientOperations()` — notify, navigate and refresh operations from server-side action code; the toast container |
 | `/retry-action-modal` | The modal that answers a server's retry action ([guide](https://github.com/MintPlayer/MintPlayer.Spark/blob/master/docs/guide-manager-retry-actions.md)) |

package/fesm2022/mintplayer-ng-spark-client-operations.mjs

@@ -1,5 +1,5 @@
 import * as i0 from "@angular/core";
-import { ChangeDetectionStrategy, Component, Injectable, InjectionToken, inject, makeEnvironmentProviders, signal } from "@angular/core";
+import { ChangeDetectionStrategy, Component, EnvironmentInjector, Injectable, InjectionToken, inject, makeEnvironmentProviders, runInInjectionContext, signal } from "@angular/core";
 import { Router } from "@angular/router";
 import { resolveTranslation } from "@mintplayer/ng-spark/models";
 var NotificationKind;
@@ -52,6 +52,80 @@ i0.ɵɵngDeclareClassMetadata({
 	}],
 	ctorParameters: () => []
 });
+const SPARK_CLIENT_METHODS = new InjectionToken("SPARK_CLIENT_METHODS");
+const SPARK_CLIENT_UNSUPPORTED_REASON = "common.clientUnsupported";
+function provideSparkClientMethods(methods) {
+	return makeEnvironmentProviders([{
+		provide: SPARK_CLIENT_METHODS,
+		useValue: methods,
+		multi: true
+	}]);
+}
+var SparkClientMethodRegistry = class SparkClientMethodRegistry {
+	injector = inject(EnvironmentInjector);
+	methods;
+	constructor() {
+		const methods = /* @__PURE__ */ new Map();
+		for (const registration of inject(SPARK_CLIENT_METHODS, { optional: true }) ?? []) for (const [name, method] of Object.entries(registration)) methods.set(name, method);
+		this.methods = methods;
+	}
+	unavailableReason(name) {
+		if (!name) return null;
+		const method = this.methods.get(name);
+		if (!method) return SPARK_CLIENT_UNSUPPORTED_REASON;
+		return this.isSupported(method) ? null : method.unsupportedReason ?? "common.clientUnsupported";
+	}
+	async invoke(name, args) {
+		const method = this.methods.get(name);
+		if (!method) {
+			console.warn(`[spark] the server invoked the client method '${name}', which is not registered; answered Cancel.`);
+			return { ok: false };
+		}
+		if (!this.isSupported(method)) return { ok: false };
+		try {
+			return {
+				ok: true,
+				value: await runInInjectionContext(this.injector, () => method.invoke(args))
+			};
+		} catch {
+			return { ok: false };
+		}
+	}
+	isSupported(method) {
+		if (!method.supported) return true;
+		try {
+			return runInInjectionContext(this.injector, () => method.supported()) === true;
+		} catch {
+			return false;
+		}
+	}
+	static ɵfac = i0.ɵɵngDeclareFactory({
+		minVersion: "12.0.0",
+		version: "22.2.0",
+		ngImport: i0,
+		type: SparkClientMethodRegistry,
+		deps: [],
+		target: i0.ɵɵFactoryTarget.Injectable
+	});
+	static ɵprov = i0.ɵɵngDeclareInjectable({
+		minVersion: "12.0.0",
+		version: "22.2.0",
+		ngImport: i0,
+		type: SparkClientMethodRegistry,
+		providedIn: "root"
+	});
+};
+i0.ɵɵngDeclareClassMetadata({
+	minVersion: "12.0.0",
+	version: "22.2.0",
+	ngImport: i0,
+	type: SparkClientMethodRegistry,
+	decorators: [{
+		type: Injectable,
+		args: [{ providedIn: "root" }]
+	}],
+	ctorParameters: () => []
+});
 const DEFAULT_DURATION_MS = 4e3;
 var SparkNotificationService = class SparkNotificationService {
 	_toasts = signal([], ...ngDevMode ? [{ debugName: "_toasts" }] : /* istanbul ignore next */ []);
@@ -342,6 +416,6 @@ function provideSparkClientOperations() {
 		}
 	]);
 }
-export { NotificationKind, SPARK_CLIENT_OPERATION_HANDLERS, SparkAttributeRefreshService, SparkClientOperationDispatcher, SparkNotificationService, SparkQueryRefreshService, SparkToastContainerComponent, provideSparkClientOperations };
+export { NotificationKind, SPARK_CLIENT_METHODS, SPARK_CLIENT_OPERATION_HANDLERS, SPARK_CLIENT_UNSUPPORTED_REASON, SparkAttributeRefreshService, SparkClientMethodRegistry, SparkClientOperationDispatcher, SparkNotificationService, SparkQueryRefreshService, SparkToastContainerComponent, provideSparkClientMethods, provideSparkClientOperations };
 
 //# sourceMappingURL=mintplayer-ng-spark-client-operations.mjs.map

package/fesm2022/mintplayer-ng-spark-client-operations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mintplayer-ng-spark-client-operations.mjs","names":[],"sources":["../../client-operations/src/operations.ts","../../client-operations/src/handlers.token.ts","../../client-operations/src/dispatcher.service.ts","../../client-operations/src/notification.service.ts","../../client-operations/src/toast-container.component.ts","../../client-operations/src/attribute-refresh.service.ts","../../client-operations/src/query-refresh.service.ts","../../client-operations/src/provide.ts"],"sourcesContent":["// Wire types matching MintPlayer.Spark.Abstractions.ClientOperations on the server.\n// Discriminator is the `type` field. Unknown operation types are silently dropped\n// by the dispatcher (forward-compat: new types can land server-side without updating\n// older clients).\n\nimport type { PersistentObject, TranslatedString } from '@mintplayer/ng-spark/models';\n\nexport enum NotificationKind {\n    Info = 0,\n    Success = 1,\n    Warning = 2,\n    Error = 3,\n}\n\nexport interface NavigateOperation {\n    type: 'navigate';\n    objectTypeId?: string;\n    id?: string;\n    routeName?: string;\n}\n\nexport interface NotifyOperation {\n    type: 'notify';\n    /** The text in the request's language (the browser's `Accept-Language`). */\n    message: string;\n    /**\n     * The text in every language, when the server has it. Shown in the language the user picked in\n     * the app (`SparkLanguageService`), which the server never learns; `message` is the fallback.\n     */\n    translatedMessage?: TranslatedString | null;\n    kind: NotificationKind;\n    durationMs?: number;\n}\n\nexport interface RefreshAttributeOperation {\n    type: 'refreshAttribute';\n    objectTypeId: string;\n    id: string;\n    attributeName: string;\n    value?: unknown;\n\n    /**\n     * Nested rows of an `AsDetail` attribute. A loaded AsDetail attribute carries its rows in\n     * `object` / `objects` and leaves `value` null, so a patch limited to `value` could never\n     * refresh a detail grid -- it always sent null, and a null over a null repaints nothing.\n     *\n     * An empty `objects` array means the grid is now empty, and is distinct from omitting it.\n     */\n    object?: unknown;\n    objects?: unknown[];\n}\n\nexport interface RefreshQueryOperation {\n    type: 'refreshQuery';\n    queryId: string;\n}\n\n// `disableAction` is gone (#460, D13): the server no longer emits it. Disabled actions arrive on\n// `PersistentObject.disabledActions` / `QueryResult.disabledActions`, and a submitted disabled action\n// is refused with 403.\n\nexport interface RetryOperation {\n    type: 'retry';\n    step: number;\n    title: string;\n    options: string[];\n    defaultOption?: string | null;\n    persistentObject?: PersistentObject | null;\n    message?: string | null;\n}\n\n/**\n * Discriminated union of known operation types, plus an open shape for unknown\n * future operations. Handlers should narrow via the `type` discriminator before\n * accessing fields specific to their operation type.\n */\nexport type ClientOperation =\n    | NavigateOperation\n    | NotifyOperation\n    | RefreshAttributeOperation\n    | RefreshQueryOperation\n    | RetryOperation\n    | { type: string; [key: string]: unknown };\n\n/**\n * Wire envelope returned by every action endpoint. `result` carries the primary\n * payload (the PersistentObject for a Create, the QueryResult for an Execute,\n * etc.); `operations` carries the side-effects the frontend dispatches.\n */\nexport interface ClientOperationEnvelope<T = unknown> {\n    result: T | null;\n    operations: ClientOperation[];\n}\n","import { InjectionToken } from '@angular/core';\nimport type { ClientOperation } from './operations';\n\n/**\n * A handler for a specific operation type. Receives the operation and\n * executes the side-effect (e.g. show a toast, navigate, refresh a query).\n * Handlers should `as`-narrow the operation to the type they registered for.\n */\nexport type ClientOperationHandler = (operation: ClientOperation) => void;\n\n/**\n * One entry in the multi-provider registration. Apps can register custom\n * handlers alongside the built-in ones to extend the operation set with\n * app-specific operation types.\n */\nexport interface ClientOperationHandlerRegistration {\n    type: string;\n    handler: ClientOperationHandler;\n}\n\n/**\n * Multi-provider token. `provideSparkClientOperations()` registers the\n * built-in handlers; apps can add their own with additional `multi: true`\n * providers using this token.\n */\nexport const SPARK_CLIENT_OPERATION_HANDLERS = new InjectionToken<readonly ClientOperationHandlerRegistration[]>(\n    'SPARK_CLIENT_OPERATION_HANDLERS',\n);\n","import { Injectable, inject } from '@angular/core';\nimport type { ClientOperation } from './operations';\nimport { SPARK_CLIENT_OPERATION_HANDLERS, type ClientOperationHandler } from './handlers.token';\n\n/**\n * Routes received operations to registered handlers. Unknown operation types\n * (no matching registration) are silently dropped — this is the forward-compat\n * contract that lets new operation types ship server-side without coordinated\n * client updates.\n *\n * Last-registered-wins on duplicate `type` values, matching standard\n * Angular multi-provider override semantics.\n *\n * R2-H19 — security contract for handler authors:\n *   The dispatcher treats handler resolution as allow-list-by-type (unknown\n *   types drop). It does NOT validate the *content* of each operation. Handlers\n *   that act on URL-shaped fields (navigate, redirect, openWindow) MUST run\n *   the value through `sanitizeReturnUrl` from `@mintplayer/ng-spark-auth/models`\n *   (or an equivalent same-origin check) before acting on it. Otherwise a\n *   single attribute-echo XSS or a single mid-channel byte flip on a non-TLS\n *   path lets the server drive client navigation to an attacker host. The\n *   built-in `notify` handler renders via Angular interpolation (escaped) so\n *   it's safe to pass through, but anything more powerful must validate.\n */\n@Injectable({ providedIn: 'root' })\nexport class SparkClientOperationDispatcher {\n    private readonly handlerMap: ReadonlyMap<string, ClientOperationHandler>;\n\n    constructor() {\n        const registrations = inject(SPARK_CLIENT_OPERATION_HANDLERS, { optional: true }) ?? [];\n        const map = new Map<string, ClientOperationHandler>();\n        for (const { type, handler } of registrations) {\n            map.set(type, handler);\n        }\n        this.handlerMap = map;\n    }\n\n    dispatch(operations: readonly ClientOperation[] | null | undefined): void {\n        if (!operations || operations.length === 0) return;\n        for (const operation of operations) {\n            const handler = this.handlerMap.get(operation.type);\n            if (handler) {\n                handler(operation);\n            }\n            // Unknown types: silently dropped (forward-compat).\n        }\n    }\n}\n","import { Injectable, signal } from '@angular/core';\nimport { NotificationKind } from './operations';\n\nexport interface SparkToast {\n    id: string;\n    message: string;\n    kind: NotificationKind;\n    durationMs: number;\n}\n\nconst DEFAULT_DURATION_MS = 4000;\n\n/**\n * Holds the active toasts as a signal. The `<spark-toast-container>` component\n * renders them; the built-in `notify` operation handler pushes new toasts here.\n *\n * Auto-dismissal: each toast schedules its own removal after `durationMs`. Pass\n * `0` to make a toast sticky (manual dismissal only).\n */\n@Injectable({ providedIn: 'root' })\nexport class SparkNotificationService {\n    private readonly _toasts = signal<readonly SparkToast[]>([]);\n    readonly toasts = this._toasts.asReadonly();\n\n    show(message: string, kind: NotificationKind = NotificationKind.Info, durationMs?: number): void {\n        const id = typeof crypto !== 'undefined' && crypto.randomUUID ? crypto.randomUUID() : `${Date.now()}-${Math.random()}`;\n        const effectiveDuration = durationMs ?? DEFAULT_DURATION_MS;\n        const toast: SparkToast = { id, message, kind, durationMs: effectiveDuration };\n        this._toasts.update(toasts => [...toasts, toast]);\n\n        if (effectiveDuration > 0) {\n            setTimeout(() => this.dismiss(id), effectiveDuration);\n        }\n    }\n\n    dismiss(id: string): void {\n        this._toasts.update(toasts => toasts.filter(t => t.id !== id));\n    }\n\n    clear(): void {\n        this._toasts.set([]);\n    }\n}\n","import { ChangeDetectionStrategy, Component, inject } from '@angular/core';\nimport { SparkNotificationService } from './notification.service';\nimport { NotificationKind } from './operations';\n\n@Component({\n    selector: 'spark-toast-container',\n    standalone: true,\n    template: `\n        <div class=\"spark-toast-container\">\n            @for (toast of notifications.toasts(); track toast.id) {\n                <div\n                    class=\"spark-toast\"\n                    [class.spark-toast--info]=\"toast.kind === Kind.Info\"\n                    [class.spark-toast--success]=\"toast.kind === Kind.Success\"\n                    [class.spark-toast--warning]=\"toast.kind === Kind.Warning\"\n                    [class.spark-toast--error]=\"toast.kind === Kind.Error\"\n                    (click)=\"notifications.dismiss(toast.id)\"\n                >\n                    {{ toast.message }}\n                </div>\n            }\n        </div>\n    `,\n    styles: [`\n        .spark-toast-container {\n            position: fixed;\n            top: 1rem;\n            right: 1rem;\n            z-index: 9999;\n            display: flex;\n            flex-direction: column;\n            gap: 0.5rem;\n            pointer-events: none;\n        }\n        .spark-toast {\n            padding: 0.75rem 1rem;\n            border-radius: 4px;\n            box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);\n            cursor: pointer;\n            min-width: 220px;\n            max-width: 400px;\n            color: var(--bs-white);\n            font-size: 0.95rem;\n            pointer-events: auto;\n            animation: spark-toast-in 0.18s ease-out;\n        }\n        .spark-toast--info { background: var(--bs-primary); }\n        .spark-toast--success { background: var(--bs-success); }\n        .spark-toast--warning { background: var(--bs-warning); color: var(--bs-dark); }\n        .spark-toast--error { background: var(--bs-danger); }\n        @keyframes spark-toast-in {\n            from { opacity: 0; transform: translateX(8px); }\n            to { opacity: 1; transform: translateX(0); }\n        }\n    `],\n    changeDetection: ChangeDetectionStrategy.OnPush,\n})\nexport class SparkToastContainerComponent {\n    protected readonly notifications = inject(SparkNotificationService);\n    protected readonly Kind = NotificationKind;\n}\n","import { Injectable, signal } from '@angular/core';\n\n/**\n * Carries a server-issued `refreshAttribute` to whichever detail page is showing that object.\n *\n * The same broadcast shape as {@link SparkQueryRefreshService}, and for the same reason: detail\n * pages come and go behind `@if` and lazy routes, and nothing in ng-spark holds a component\n * reference. A page reads {@link tokenFor} in an effect and applies {@link patchesFor} when it\n * changes.\n *\n * Until this existed the operation was declared on the wire and handled by nobody: the server\n * computed the new values, serialised them, sent them, and the dispatcher dropped them silently\n * because unknown types are ignored. `IClientAccessor.RefreshAttribute` was inert in every Spark\n * application. It is what made the Coverage home page's Resync button look dead — it recomputed\n * the account and repository counts correctly on every click and none of them ever arrived.\n *\n * The operation carries the new value, so this is a patch and not a re-fetch: no round trip, and\n * no dependence on an index that may still be stale from the write that triggered it.\n */\n/**\n * The parts of an attribute a server patch may carry.\n *\n * Three fields rather than one value because a loaded attribute does not keep every shape in\n * `value`: an `AsDetail` attribute puts its nested rows in `object` / `objects` and leaves\n * `value` null. A patch limited to `value` was therefore incapable of refreshing a detail grid,\n * and did so silently -- see {@link SparkAttributeRefreshService}.\n *\n * Only the keys the server sent are present, and each is applied on its own. An `objects: []`\n * means the grid is now empty, which is why emptiness has to be distinguishable from absence.\n */\nexport interface SparkAttributePatch {\n  value?: unknown;\n  object?: unknown;\n  objects?: unknown[];\n}\n\n@Injectable({ providedIn: 'root' })\nexport class SparkAttributeRefreshService {\n  private readonly tokens = signal<Record<string, number>>({});\n  private readonly patches = signal<Record<string, Record<string, SparkAttributePatch>>>({});\n\n  /**\n   * Objects are keyed by type AND id: the same id can exist under two types, and a detail page\n   * only ever wants the attributes meant for the object it is showing.\n   */\n  private static keyFor(objectTypeId: string, id: string): string {\n    return `${objectTypeId}${id}`;\n  }\n\n  /** Bumped every time the server patches an attribute of this object. */\n  tokenFor(objectTypeId: string | undefined | null, id: string | undefined | null): number {\n    if (!objectTypeId || !id) return 0;\n    return this.tokens()[SparkAttributeRefreshService.keyFor(objectTypeId, id)] ?? 0;\n  }\n\n  /**\n   * The newest value the server sent for each patched attribute of this object.\n   *\n   * Cumulative rather than drained on read: a detail page that mounts after the operation arrived\n   * still sees the value, and two pages showing the same object both get it. Values are overwritten\n   * by later patches, so this holds one entry per attribute, not a history.\n   */\n  patchesFor(objectTypeId: string | undefined | null, id: string | undefined | null): Record<string, SparkAttributePatch> {\n    if (!objectTypeId || !id) return {};\n    return this.patches()[SparkAttributeRefreshService.keyFor(objectTypeId, id)] ?? {};\n  }\n\n  /**\n   * Record a new value for one attribute and wake whoever is showing the object.\n   *\n   * Callers patching several attributes for one user action should do so in one synchronous run:\n   * the signals coalesce within a tick into a single effect run, and patches split across an await\n   * become one run each.\n   */\n  request(objectTypeId: string, id: string, attributeName: string, patch: SparkAttributePatch): void {\n    const key = SparkAttributeRefreshService.keyFor(objectTypeId, id);\n    this.patches.update(current => ({\n      ...current,\n      [key]: { ...(current[key] ?? {}), [attributeName]: patch },\n    }));\n    this.tokens.update(current => ({ ...current, [key]: (current[key] ?? 0) + 1 }));\n  }\n}\n","import { Injectable, signal } from '@angular/core';\n\n/**\n * Carries a server-issued `refreshQuery` to whichever grids are showing that query.\n *\n * A broadcast signal rather than a registry of component handles: grids come and go behind\n * `@if` and lazy routes, and nothing else in ng-spark holds a component reference. A grid\n * reads {@link tokenFor} in an effect and re-fetches when it changes, which is the same\n * declarative shape as the `reloadToken` input a host would use.\n *\n * Until this existed the server could emit the operation and the dispatcher dropped it: only\n * `notify` was registered, and unknown types are ignored silently — so `refreshOnCompleted`\n * on the server had no effect on any grid the action did not happen to be hosted in.\n */\n@Injectable({ providedIn: 'root' })\nexport class SparkQueryRefreshService {\n  private readonly tokens = signal<Record<string, number>>({});\n\n  /**\n   * Bumped every time a refresh is asked for this key.\n   *\n   * ⚠️ Reading it makes the caller depend on EVERY key, not just this one: the counters share one\n   * signal. A grid must therefore compare the value with the one it last saw, never react to the\n   * read alone (#319) — otherwise it re-fetches for every query refreshed anywhere in the app.\n   */\n  tokenFor(queryId: string | undefined): number {\n    if (!queryId) return 0;\n    return this.tokens()[normalize(queryId)] ?? 0;\n  }\n\n  /**\n   * Ask every grid showing `queryId` to re-fetch.\n   *\n   * `queryId` is the query's id or its alias. A grid answers to both, whichever its own `queryId`\n   * input holds, because it learns the other from the query it resolved. Keys are matched\n   * case-insensitively, as the server resolves them (`QueryLoader.ResolveQuery`).\n   *\n   * Callers bumping several keys for one user action should do so in one synchronous run: the\n   * signal coalesces bumps within a tick into a single effect run, and bumps split across an\n   * await become one re-fetch each (#319).\n   */\n  request(queryId: string): void {\n    const key = normalize(queryId);\n    this.tokens.update(current => ({ ...current, [key]: (current[key] ?? 0) + 1 }));\n  }\n}\n\nfunction normalize(queryId: string): string {\n  return queryId.toLowerCase();\n}\n","import { type EnvironmentProviders, inject, makeEnvironmentProviders } from '@angular/core';\nimport { Router } from '@angular/router';\nimport { resolveTranslation } from '@mintplayer/ng-spark/models';\nimport type {\n    ClientOperation,\n    NavigateOperation,\n    NotifyOperation,\n    RefreshAttributeOperation,\n    RefreshQueryOperation,\n} from './operations';\nimport { SPARK_CLIENT_OPERATION_HANDLERS } from './handlers.token';\nimport { SparkAttributeRefreshService } from './attribute-refresh.service';\nimport { SparkNotificationService } from './notification.service';\nimport { SparkQueryRefreshService } from './query-refresh.service';\n\n/**\n * Registers the built-in client-operation handlers: `notify`, `refreshQuery`,\n * `refreshAttribute` and `navigate`. Apps add this once in their bootstrap providers.\n *\n * Unregistered operation types are dropped SILENTLY by the dispatcher, which is why\n * `refreshQuery` did nothing at all for as long as it went unhandled — the server emitted\n * it, nothing listened, and no error said so.\n *\n * That happened twice more before anyone noticed. `refreshAttribute` and `navigate` were both\n * declared wire types with no handler anywhere in the repository: every\n * `IClientAccessor.RefreshAttribute` and `Navigate` call in every Spark application was\n * computed, serialised, sent and discarded. Both are registered below. The last gap,\n * `disableAction`, was closed by deleting it (#460, D13): disabled actions travel on the object's\n * or result's `disabledActions` and are enforced by the server at submit.\n *\n * The lesson worth keeping: a wire type in `operations.ts` is not a feature. Adding one without\n * a handler here produces a server API that appears to work and does nothing.\n *\n * To register custom operation types alongside the built-ins, add additional\n * `multi: true` providers using <see cref=\"SPARK_CLIENT_OPERATION_HANDLERS\" />.\n */\nexport function provideSparkClientOperations(): EnvironmentProviders {\n    return makeEnvironmentProviders([\n        {\n            provide: SPARK_CLIENT_OPERATION_HANDLERS,\n            useFactory: () => {\n                const notifications = inject(SparkNotificationService);\n                return {\n                    type: 'notify',\n                    handler: (operation: ClientOperation) => {\n                        const notify = operation as NotifyOperation;\n                        // The app-chosen language, not the browser's that the server resolved `message` in.\n                        const message = (notify.translatedMessage && resolveTranslation(notify.translatedMessage)) || notify.message;\n                        notifications.show(message, notify.kind, notify.durationMs);\n                    },\n                };\n            },\n            multi: true,\n        },\n        {\n            provide: SPARK_CLIENT_OPERATION_HANDLERS,\n            useFactory: () => {\n                const refresh = inject(SparkQueryRefreshService);\n                return {\n                    type: 'refreshQuery',\n                    handler: (operation: ClientOperation) => {\n                        refresh.request((operation as RefreshQueryOperation).queryId);\n                    },\n                };\n            },\n            multi: true,\n        },\n        {\n            provide: SPARK_CLIENT_OPERATION_HANDLERS,\n            useFactory: () => {\n                const attributes = inject(SparkAttributeRefreshService);\n                return {\n                    type: 'refreshAttribute',\n                    handler: (operation: ClientOperation) => {\n                        const patch = operation as RefreshAttributeOperation;\n                        // Forwarded field by field, not as one value: an AsDetail attribute's rows\n                        // travel in object/objects and its value is null, so collapsing them here\n                        // is what made a detail-grid refresh impossible to express.\n                        attributes.request(patch.objectTypeId, patch.id, patch.attributeName, {\n                            value: patch.value,\n                            object: patch.object,\n                            objects: patch.objects,\n                        });\n                    },\n                };\n            },\n            multi: true,\n        },\n        {\n            provide: SPARK_CLIENT_OPERATION_HANDLERS,\n            useFactory: () => {\n                const router = inject(Router);\n                return {\n                    type: 'navigate',\n                    handler: (operation: ClientOperation) => {\n                        const navigate = operation as NavigateOperation;\n\n                        if (navigate.routeName) {\n                            void router.navigateByUrl(\n                                navigate.routeName.startsWith('/') ? navigate.routeName : `/${navigate.routeName}`);\n                            return;\n                        }\n\n                        // `/po/{type}/{id}` is the convention the grid's row links already assume,\n                        // and the detail route resolves a type by id as well as by alias, so the\n                        // operation's objectTypeId can be used verbatim.\n                        if (navigate.objectTypeId && navigate.id) {\n                            void router.navigate(['/po', navigate.objectTypeId, navigate.id]);\n                            return;\n                        }\n\n                        console.warn('[spark] navigate operation carried neither routeName nor objectTypeId+id; ignored.');\n                    },\n                };\n            },\n            multi: true,\n        },\n    ]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"mintplayer-ng-spark-client-operations.mjs","names":[],"sources":["../../client-operations/src/operations.ts","../../client-operations/src/handlers.token.ts","../../client-operations/src/dispatcher.service.ts","../../client-operations/src/client-methods.ts","../../client-operations/src/notification.service.ts","../../client-operations/src/toast-container.component.ts","../../client-operations/src/attribute-refresh.service.ts","../../client-operations/src/query-refresh.service.ts","../../client-operations/src/provide.ts"],"sourcesContent":["// Wire types matching MintPlayer.Spark.Abstractions.ClientOperations on the server.\n// Discriminator is the `type` field. Unknown operation types are silently dropped\n// by the dispatcher (forward-compat: new types can land server-side without updating\n// older clients).\n\nimport type { PersistentObject, TranslatedString } from '@mintplayer/ng-spark/models';\n\nexport enum NotificationKind {\n    Info = 0,\n    Success = 1,\n    Warning = 2,\n    Error = 3,\n}\n\nexport interface NavigateOperation {\n    type: 'navigate';\n    objectTypeId?: string;\n    id?: string;\n    routeName?: string;\n}\n\nexport interface NotifyOperation {\n    type: 'notify';\n    /** The text in the request's language (the browser's `Accept-Language`). */\n    message: string;\n    /**\n     * The text in every language, when the server has it. Shown in the language the user picked in\n     * the app (`SparkLanguageService`), which the server never learns; `message` is the fallback.\n     */\n    translatedMessage?: TranslatedString | null;\n    kind: NotificationKind;\n    durationMs?: number;\n}\n\nexport interface RefreshAttributeOperation {\n    type: 'refreshAttribute';\n    objectTypeId: string;\n    id: string;\n    attributeName: string;\n    value?: unknown;\n\n    /**\n     * Nested rows of an `AsDetail` attribute. A loaded AsDetail attribute carries its rows in\n     * `object` / `objects` and leaves `value` null, so a patch limited to `value` could never\n     * refresh a detail grid -- it always sent null, and a null over a null repaints nothing.\n     *\n     * An empty `objects` array means the grid is now empty, and is distinct from omitting it.\n     */\n    object?: unknown;\n    objects?: unknown[];\n}\n\nexport interface RefreshQueryOperation {\n    type: 'refreshQuery';\n    queryId: string;\n}\n\n// `disableAction` is gone (#460, D13): the server no longer emits it. Disabled actions arrive on\n// `PersistentObject.disabledActions` / `QueryResult.disabledActions`, and a submitted disabled action\n// is refused with 403.\n\nexport interface RetryOperation {\n    type: 'retry';\n    step: number;\n    title: string;\n    options: string[];\n    defaultOption?: string | null;\n    persistentObject?: PersistentObject | null;\n    message?: string | null;\n    /** Whether the client offers its own translated Cancel, answered as `'Cancel'` (`IRetryAccessor.Action(..., cancellable)`). */\n    cancellable?: boolean;\n    /** A client method to run instead of a modal (`IRetryAccessor.Invoke`); see `provideSparkClientMethods`. */\n    clientMethod?: string | null;\n    /** Its argument, as the server serialized it. */\n    arguments?: unknown;\n}\n\n/**\n * Discriminated union of known operation types, plus an open shape for unknown\n * future operations. Handlers should narrow via the `type` discriminator before\n * accessing fields specific to their operation type.\n */\nexport type ClientOperation =\n    | NavigateOperation\n    | NotifyOperation\n    | RefreshAttributeOperation\n    | RefreshQueryOperation\n    | RetryOperation\n    | { type: string; [key: string]: unknown };\n\n/**\n * Wire envelope returned by every action endpoint. `result` carries the primary\n * payload (the PersistentObject for a Create, the QueryResult for an Execute,\n * etc.); `operations` carries the side-effects the frontend dispatches.\n */\nexport interface ClientOperationEnvelope<T = unknown> {\n    result: T | null;\n    operations: ClientOperation[];\n}\n","import { InjectionToken } from '@angular/core';\nimport type { ClientOperation } from './operations';\n\n/**\n * A handler for a specific operation type. Receives the operation and\n * executes the side-effect (e.g. show a toast, navigate, refresh a query).\n * Handlers should `as`-narrow the operation to the type they registered for.\n */\nexport type ClientOperationHandler = (operation: ClientOperation) => void;\n\n/**\n * One entry in the multi-provider registration. Apps can register custom\n * handlers alongside the built-in ones to extend the operation set with\n * app-specific operation types.\n */\nexport interface ClientOperationHandlerRegistration {\n    type: string;\n    handler: ClientOperationHandler;\n}\n\n/**\n * Multi-provider token. `provideSparkClientOperations()` registers the\n * built-in handlers; apps can add their own with additional `multi: true`\n * providers using this token.\n */\nexport const SPARK_CLIENT_OPERATION_HANDLERS = new InjectionToken<readonly ClientOperationHandlerRegistration[]>(\n    'SPARK_CLIENT_OPERATION_HANDLERS',\n);\n","import { Injectable, inject } from '@angular/core';\nimport type { ClientOperation } from './operations';\nimport { SPARK_CLIENT_OPERATION_HANDLERS, type ClientOperationHandler } from './handlers.token';\n\n/**\n * Routes received operations to registered handlers. Unknown operation types\n * (no matching registration) are silently dropped — this is the forward-compat\n * contract that lets new operation types ship server-side without coordinated\n * client updates.\n *\n * Last-registered-wins on duplicate `type` values, matching standard\n * Angular multi-provider override semantics.\n *\n * R2-H19 — security contract for handler authors:\n *   The dispatcher treats handler resolution as allow-list-by-type (unknown\n *   types drop). It does NOT validate the *content* of each operation. Handlers\n *   that act on URL-shaped fields (navigate, redirect, openWindow) MUST run\n *   the value through `sanitizeReturnUrl` from `@mintplayer/ng-spark-auth/models`\n *   (or an equivalent same-origin check) before acting on it. Otherwise a\n *   single attribute-echo XSS or a single mid-channel byte flip on a non-TLS\n *   path lets the server drive client navigation to an attacker host. The\n *   built-in `notify` handler renders via Angular interpolation (escaped) so\n *   it's safe to pass through, but anything more powerful must validate.\n */\n@Injectable({ providedIn: 'root' })\nexport class SparkClientOperationDispatcher {\n    private readonly handlerMap: ReadonlyMap<string, ClientOperationHandler>;\n\n    constructor() {\n        const registrations = inject(SPARK_CLIENT_OPERATION_HANDLERS, { optional: true }) ?? [];\n        const map = new Map<string, ClientOperationHandler>();\n        for (const { type, handler } of registrations) {\n            map.set(type, handler);\n        }\n        this.handlerMap = map;\n    }\n\n    dispatch(operations: readonly ClientOperation[] | null | undefined): void {\n        if (!operations || operations.length === 0) return;\n        for (const operation of operations) {\n            const handler = this.handlerMap.get(operation.type);\n            if (handler) {\n                handler(operation);\n            }\n            // Unknown types: silently dropped (forward-compat).\n        }\n    }\n}\n","import {\n    EnvironmentInjector,\n    type EnvironmentProviders,\n    Injectable,\n    InjectionToken,\n    inject,\n    makeEnvironmentProviders,\n    runInInjectionContext,\n} from '@angular/core';\n\n/**\n * One step a server action needs from the browser (`IRetryAccessor.Invoke` on the server): WebAuthn,\n * a file picker, the clipboard. The answer travels back into the same server action as the retry's\n * `value`, so authorization, state and the follow-up all stay inside that one action.\n */\nexport interface SparkClientMethod {\n    /**\n     * Runs the step. Called in an injection context, so `inject()` works synchronously at the top.\n     * A rejection or a thrown error answers the server with `Cancel`, exactly like an unknown name.\n     */\n    invoke(args: unknown): Promise<unknown>;\n    /**\n     * Whether this browser can run the method at all. An action whose `requiresClient` names a method\n     * that is unsupported is shown disabled; an `Invoke` of it answers `Cancel` without running it.\n     * Absent means always supported.\n     */\n    supported?(): boolean;\n    /** The translation key explaining why the method is unsupported; defaults to `common.clientUnsupported`. */\n    unsupportedReason?: string;\n}\n\n/** Client methods by the name the server invokes them with, e.g. `{ 'webauthn.create': { invoke: … } }`. */\nexport type SparkClientMethodMap = Readonly<Record<string, SparkClientMethod>>;\n\n/** Multi-provider token; use {@link provideSparkClientMethods}. A later registration of a name wins. */\nexport const SPARK_CLIENT_METHODS = new InjectionToken<readonly SparkClientMethodMap[]>('SPARK_CLIENT_METHODS');\n\n/** The reason shown on an action whose client method is missing or unsupported, when the method names none. */\nexport const SPARK_CLIENT_UNSUPPORTED_REASON = 'common.clientUnsupported';\n\n/**\n * Registers client methods a server action may invoke through a retry (`IRetryAccessor.Invoke`).\n *\n * The set is closed on purpose: the server can only name a method the app registered here, and an\n * unknown name answers `Cancel`. Nothing the server sends is evaluated.\n *\n * @example\n * provideSparkClientMethods({\n *   'clipboard.read': { invoke: () => navigator.clipboard.readText(), supported: () => !!navigator.clipboard },\n * })\n */\nexport function provideSparkClientMethods(methods: SparkClientMethodMap): EnvironmentProviders {\n    return makeEnvironmentProviders([{ provide: SPARK_CLIENT_METHODS, useValue: methods, multi: true }]);\n}\n\n/** How a client method ended: its value, or a failure the server sees as `Cancel`. */\nexport type SparkClientMethodOutcome = { ok: true; value: unknown } | { ok: false };\n\n/** The registered client methods: whether one can run here, and running it. */\n@Injectable({ providedIn: 'root' })\nexport class SparkClientMethodRegistry {\n    private readonly injector = inject(EnvironmentInjector);\n    private readonly methods: ReadonlyMap<string, SparkClientMethod>;\n\n    constructor() {\n        const methods = new Map<string, SparkClientMethod>();\n        for (const registration of inject(SPARK_CLIENT_METHODS, { optional: true }) ?? []) {\n            for (const [name, method] of Object.entries(registration))\n                methods.set(name, method);\n        }\n        this.methods = methods;\n    }\n\n    /**\n     * Null when the method is registered and supported here; otherwise the translation key saying why\n     * it is not. Null for no name at all, so an action without `requiresClient` is never affected.\n     */\n    unavailableReason(name: string | null | undefined): string | null {\n        if (!name) return null;\n        const method = this.methods.get(name);\n        if (!method) return SPARK_CLIENT_UNSUPPORTED_REASON;\n        return this.isSupported(method) ? null : (method.unsupportedReason ?? SPARK_CLIENT_UNSUPPORTED_REASON);\n    }\n\n    /**\n     * Runs the method registered under `name`. Fails closed: an unknown name, an unsupported method, a\n     * rejection or a thrown error all end as `{ ok: false }`, which the retry loop answers as `Cancel`.\n     */\n    async invoke(name: string, args: unknown): Promise<SparkClientMethodOutcome> {\n        const method = this.methods.get(name);\n        if (!method) {\n            // A server naming a method this app never registered is a wiring mistake worth a line in\n            // the console; a user cancelling a ceremony is not, so rejections stay quiet.\n            console.warn(`[spark] the server invoked the client method '${name}', which is not registered; answered Cancel.`);\n            return { ok: false };\n        }\n        if (!this.isSupported(method)) return { ok: false };\n\n        try {\n            const value = await runInInjectionContext(this.injector, () => method.invoke(args));\n            return { ok: true, value };\n        } catch {\n            return { ok: false };\n        }\n    }\n\n    private isSupported(method: SparkClientMethod): boolean {\n        if (!method.supported) return true;\n        try {\n            return runInInjectionContext(this.injector, () => method.supported!()) === true;\n        } catch {\n            return false;\n        }\n    }\n}\n","import { Injectable, signal } from '@angular/core';\nimport { NotificationKind } from './operations';\n\nexport interface SparkToast {\n    id: string;\n    message: string;\n    kind: NotificationKind;\n    durationMs: number;\n}\n\nconst DEFAULT_DURATION_MS = 4000;\n\n/**\n * Holds the active toasts as a signal. The `<spark-toast-container>` component\n * renders them; the built-in `notify` operation handler pushes new toasts here.\n *\n * Auto-dismissal: each toast schedules its own removal after `durationMs`. Pass\n * `0` to make a toast sticky (manual dismissal only).\n */\n@Injectable({ providedIn: 'root' })\nexport class SparkNotificationService {\n    private readonly _toasts = signal<readonly SparkToast[]>([]);\n    readonly toasts = this._toasts.asReadonly();\n\n    show(message: string, kind: NotificationKind = NotificationKind.Info, durationMs?: number): void {\n        const id = typeof crypto !== 'undefined' && crypto.randomUUID ? crypto.randomUUID() : `${Date.now()}-${Math.random()}`;\n        const effectiveDuration = durationMs ?? DEFAULT_DURATION_MS;\n        const toast: SparkToast = { id, message, kind, durationMs: effectiveDuration };\n        this._toasts.update(toasts => [...toasts, toast]);\n\n        if (effectiveDuration > 0) {\n            setTimeout(() => this.dismiss(id), effectiveDuration);\n        }\n    }\n\n    dismiss(id: string): void {\n        this._toasts.update(toasts => toasts.filter(t => t.id !== id));\n    }\n\n    clear(): void {\n        this._toasts.set([]);\n    }\n}\n","import { ChangeDetectionStrategy, Component, inject } from '@angular/core';\nimport { SparkNotificationService } from './notification.service';\nimport { NotificationKind } from './operations';\n\n@Component({\n    selector: 'spark-toast-container',\n    standalone: true,\n    template: `\n        <div class=\"spark-toast-container\">\n            @for (toast of notifications.toasts(); track toast.id) {\n                <div\n                    class=\"spark-toast\"\n                    [class.spark-toast--info]=\"toast.kind === Kind.Info\"\n                    [class.spark-toast--success]=\"toast.kind === Kind.Success\"\n                    [class.spark-toast--warning]=\"toast.kind === Kind.Warning\"\n                    [class.spark-toast--error]=\"toast.kind === Kind.Error\"\n                    (click)=\"notifications.dismiss(toast.id)\"\n                >\n                    {{ toast.message }}\n                </div>\n            }\n        </div>\n    `,\n    styles: [`\n        .spark-toast-container {\n            position: fixed;\n            top: 1rem;\n            right: 1rem;\n            z-index: 9999;\n            display: flex;\n            flex-direction: column;\n            gap: 0.5rem;\n            pointer-events: none;\n        }\n        .spark-toast {\n            padding: 0.75rem 1rem;\n            border-radius: 4px;\n            box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);\n            cursor: pointer;\n            min-width: 220px;\n            max-width: 400px;\n            color: var(--bs-white);\n            font-size: 0.95rem;\n            pointer-events: auto;\n            animation: spark-toast-in 0.18s ease-out;\n        }\n        .spark-toast--info { background: var(--bs-primary); }\n        .spark-toast--success { background: var(--bs-success); }\n        .spark-toast--warning { background: var(--bs-warning); color: var(--bs-dark); }\n        .spark-toast--error { background: var(--bs-danger); }\n        @keyframes spark-toast-in {\n            from { opacity: 0; transform: translateX(8px); }\n            to { opacity: 1; transform: translateX(0); }\n        }\n    `],\n    changeDetection: ChangeDetectionStrategy.OnPush,\n})\nexport class SparkToastContainerComponent {\n    protected readonly notifications = inject(SparkNotificationService);\n    protected readonly Kind = NotificationKind;\n}\n","import { Injectable, signal } from '@angular/core';\n\n/**\n * Carries a server-issued `refreshAttribute` to whichever detail page is showing that object.\n *\n * The same broadcast shape as {@link SparkQueryRefreshService}, and for the same reason: detail\n * pages come and go behind `@if` and lazy routes, and nothing in ng-spark holds a component\n * reference. A page reads {@link tokenFor} in an effect and applies {@link patchesFor} when it\n * changes.\n *\n * Until this existed the operation was declared on the wire and handled by nobody: the server\n * computed the new values, serialised them, sent them, and the dispatcher dropped them silently\n * because unknown types are ignored. `IClientAccessor.RefreshAttribute` was inert in every Spark\n * application. It is what made the Coverage home page's Resync button look dead — it recomputed\n * the account and repository counts correctly on every click and none of them ever arrived.\n *\n * The operation carries the new value, so this is a patch and not a re-fetch: no round trip, and\n * no dependence on an index that may still be stale from the write that triggered it.\n */\n/**\n * The parts of an attribute a server patch may carry.\n *\n * Three fields rather than one value because a loaded attribute does not keep every shape in\n * `value`: an `AsDetail` attribute puts its nested rows in `object` / `objects` and leaves\n * `value` null. A patch limited to `value` was therefore incapable of refreshing a detail grid,\n * and did so silently -- see {@link SparkAttributeRefreshService}.\n *\n * Only the keys the server sent are present, and each is applied on its own. An `objects: []`\n * means the grid is now empty, which is why emptiness has to be distinguishable from absence.\n */\nexport interface SparkAttributePatch {\n  value?: unknown;\n  object?: unknown;\n  objects?: unknown[];\n}\n\n@Injectable({ providedIn: 'root' })\nexport class SparkAttributeRefreshService {\n  private readonly tokens = signal<Record<string, number>>({});\n  private readonly patches = signal<Record<string, Record<string, SparkAttributePatch>>>({});\n\n  /**\n   * Objects are keyed by type AND id: the same id can exist under two types, and a detail page\n   * only ever wants the attributes meant for the object it is showing.\n   */\n  private static keyFor(objectTypeId: string, id: string): string {\n    return `${objectTypeId}${id}`;\n  }\n\n  /** Bumped every time the server patches an attribute of this object. */\n  tokenFor(objectTypeId: string | undefined | null, id: string | undefined | null): number {\n    if (!objectTypeId || !id) return 0;\n    return this.tokens()[SparkAttributeRefreshService.keyFor(objectTypeId, id)] ?? 0;\n  }\n\n  /**\n   * The newest value the server sent for each patched attribute of this object.\n   *\n   * Cumulative rather than drained on read: a detail page that mounts after the operation arrived\n   * still sees the value, and two pages showing the same object both get it. Values are overwritten\n   * by later patches, so this holds one entry per attribute, not a history.\n   */\n  patchesFor(objectTypeId: string | undefined | null, id: string | undefined | null): Record<string, SparkAttributePatch> {\n    if (!objectTypeId || !id) return {};\n    return this.patches()[SparkAttributeRefreshService.keyFor(objectTypeId, id)] ?? {};\n  }\n\n  /**\n   * Record a new value for one attribute and wake whoever is showing the object.\n   *\n   * Callers patching several attributes for one user action should do so in one synchronous run:\n   * the signals coalesce within a tick into a single effect run, and patches split across an await\n   * become one run each.\n   */\n  request(objectTypeId: string, id: string, attributeName: string, patch: SparkAttributePatch): void {\n    const key = SparkAttributeRefreshService.keyFor(objectTypeId, id);\n    this.patches.update(current => ({\n      ...current,\n      [key]: { ...(current[key] ?? {}), [attributeName]: patch },\n    }));\n    this.tokens.update(current => ({ ...current, [key]: (current[key] ?? 0) + 1 }));\n  }\n}\n","import { Injectable, signal } from '@angular/core';\n\n/**\n * Carries a server-issued `refreshQuery` to whichever grids are showing that query.\n *\n * A broadcast signal rather than a registry of component handles: grids come and go behind\n * `@if` and lazy routes, and nothing else in ng-spark holds a component reference. A grid\n * reads {@link tokenFor} in an effect and re-fetches when it changes, which is the same\n * declarative shape as the `reloadToken` input a host would use.\n *\n * Until this existed the server could emit the operation and the dispatcher dropped it: only\n * `notify` was registered, and unknown types are ignored silently — so `refreshOnCompleted`\n * on the server had no effect on any grid the action did not happen to be hosted in.\n */\n@Injectable({ providedIn: 'root' })\nexport class SparkQueryRefreshService {\n  private readonly tokens = signal<Record<string, number>>({});\n\n  /**\n   * Bumped every time a refresh is asked for this key.\n   *\n   * ⚠️ Reading it makes the caller depend on EVERY key, not just this one: the counters share one\n   * signal. A grid must therefore compare the value with the one it last saw, never react to the\n   * read alone (#319) — otherwise it re-fetches for every query refreshed anywhere in the app.\n   */\n  tokenFor(queryId: string | undefined): number {\n    if (!queryId) return 0;\n    return this.tokens()[normalize(queryId)] ?? 0;\n  }\n\n  /**\n   * Ask every grid showing `queryId` to re-fetch.\n   *\n   * `queryId` is the query's id or its alias. A grid answers to both, whichever its own `queryId`\n   * input holds, because it learns the other from the query it resolved. Keys are matched\n   * case-insensitively, as the server resolves them (`QueryLoader.ResolveQuery`).\n   *\n   * Callers bumping several keys for one user action should do so in one synchronous run: the\n   * signal coalesces bumps within a tick into a single effect run, and bumps split across an\n   * await become one re-fetch each (#319).\n   */\n  request(queryId: string): void {\n    const key = normalize(queryId);\n    this.tokens.update(current => ({ ...current, [key]: (current[key] ?? 0) + 1 }));\n  }\n}\n\nfunction normalize(queryId: string): string {\n  return queryId.toLowerCase();\n}\n","import { type EnvironmentProviders, inject, makeEnvironmentProviders } from '@angular/core';\nimport { Router } from '@angular/router';\nimport { resolveTranslation } from '@mintplayer/ng-spark/models';\nimport type {\n    ClientOperation,\n    NavigateOperation,\n    NotifyOperation,\n    RefreshAttributeOperation,\n    RefreshQueryOperation,\n} from './operations';\nimport { SPARK_CLIENT_OPERATION_HANDLERS } from './handlers.token';\nimport { SparkAttributeRefreshService } from './attribute-refresh.service';\nimport { SparkNotificationService } from './notification.service';\nimport { SparkQueryRefreshService } from './query-refresh.service';\n\n/**\n * Registers the built-in client-operation handlers: `notify`, `refreshQuery`,\n * `refreshAttribute` and `navigate`. Apps add this once in their bootstrap providers.\n *\n * Unregistered operation types are dropped SILENTLY by the dispatcher, which is why\n * `refreshQuery` did nothing at all for as long as it went unhandled — the server emitted\n * it, nothing listened, and no error said so.\n *\n * That happened twice more before anyone noticed. `refreshAttribute` and `navigate` were both\n * declared wire types with no handler anywhere in the repository: every\n * `IClientAccessor.RefreshAttribute` and `Navigate` call in every Spark application was\n * computed, serialised, sent and discarded. Both are registered below. The last gap,\n * `disableAction`, was closed by deleting it (#460, D13): disabled actions travel on the object's\n * or result's `disabledActions` and are enforced by the server at submit.\n *\n * The lesson worth keeping: a wire type in `operations.ts` is not a feature. Adding one without\n * a handler here produces a server API that appears to work and does nothing.\n *\n * To register custom operation types alongside the built-ins, add additional\n * `multi: true` providers using <see cref=\"SPARK_CLIENT_OPERATION_HANDLERS\" />.\n */\nexport function provideSparkClientOperations(): EnvironmentProviders {\n    return makeEnvironmentProviders([\n        {\n            provide: SPARK_CLIENT_OPERATION_HANDLERS,\n            useFactory: () => {\n                const notifications = inject(SparkNotificationService);\n                return {\n                    type: 'notify',\n                    handler: (operation: ClientOperation) => {\n                        const notify = operation as NotifyOperation;\n                        // The app-chosen language, not the browser's that the server resolved `message` in.\n                        const message = (notify.translatedMessage && resolveTranslation(notify.translatedMessage)) || notify.message;\n                        notifications.show(message, notify.kind, notify.durationMs);\n                    },\n                };\n            },\n            multi: true,\n        },\n        {\n            provide: SPARK_CLIENT_OPERATION_HANDLERS,\n            useFactory: () => {\n                const refresh = inject(SparkQueryRefreshService);\n                return {\n                    type: 'refreshQuery',\n                    handler: (operation: ClientOperation) => {\n                        refresh.request((operation as RefreshQueryOperation).queryId);\n                    },\n                };\n            },\n            multi: true,\n        },\n        {\n            provide: SPARK_CLIENT_OPERATION_HANDLERS,\n            useFactory: () => {\n                const attributes = inject(SparkAttributeRefreshService);\n                return {\n                    type: 'refreshAttribute',\n                    handler: (operation: ClientOperation) => {\n                        const patch = operation as RefreshAttributeOperation;\n                        // Forwarded field by field, not as one value: an AsDetail attribute's rows\n                        // travel in object/objects and its value is null, so collapsing them here\n                        // is what made a detail-grid refresh impossible to express.\n                        attributes.request(patch.objectTypeId, patch.id, patch.attributeName, {\n                            value: patch.value,\n                            object: patch.object,\n                            objects: patch.objects,\n                        });\n                    },\n                };\n            },\n            multi: true,\n        },\n        {\n            provide: SPARK_CLIENT_OPERATION_HANDLERS,\n            useFactory: () => {\n                const router = inject(Router);\n                return {\n                    type: 'navigate',\n                    handler: (operation: ClientOperation) => {\n                        const navigate = operation as NavigateOperation;\n\n                        if (navigate.routeName) {\n                            void router.navigateByUrl(\n                                navigate.routeName.startsWith('/') ? navigate.routeName : `/${navigate.routeName}`);\n                            return;\n                        }\n\n                        // `/po/{type}/{id}` is the convention the grid's row links already assume,\n                        // and the detail route resolves a type by id as well as by alias, so the\n                        // operation's objectTypeId can be used verbatim.\n                        if (navigate.objectTypeId && navigate.id) {\n                            void router.navigate(['/po', navigate.objectTypeId, navigate.id]);\n                            return;\n                        }\n\n                        console.warn('[spark] navigate operation carried neither routeName nor objectTypeId+id; ignored.');\n                    },\n                };\n            },\n            multi: true,\n        },\n    ]);\n}\n"],"mappings":";;;;AAOA,IAAY;CAAZ,SAAY,kBAAgB;CACxB,iBAAA,iBAAA,UAAA,KAAA;CACA,iBAAA,iBAAA,aAAA,KAAA;CACA,iBAAA,iBAAA,aAAA,KAAA;CACA,iBAAA,iBAAA,WAAA,KAAA;AACJ,EAAA,CALY,qBAAA,mBAAgB,CAAA,EAAA;ACkB5B,MAAa,kCAAkC,IAAI,eAC/C,iCAAiC;ACDrC,IAAa,iCAAb,MAAa,+BAA8B;CACtB;CAEjB,cAAA;EACI,MAAM,gBAAgB,OAAO,iCAAiC,EAAE,UAAU,KAAI,CAAE,KAAK,CAAA;EACrF,MAAM,sBAAM,IAAI,IAAG;EACnB,KAAK,MAAM,EAAE,MAAM,aAAa,eAC5B,IAAI,IAAI,MAAM,OAAO;EAEzB,KAAK,aAAa;CACtB;CAEA,SAAS,YAAyD;EAC9D,IAAI,CAAC,cAAc,WAAW,WAAW,GAAG;EAC5C,KAAK,MAAM,aAAa,YAAY;GAChC,MAAM,UAAU,KAAK,WAAW,IAAI,UAAU,IAAI;GAClD,IAAI,SACA,QAAQ,SAAS;EAGzB;CACJ;CArBS,OAAA,OAAA,GAAA,mBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAA8B,MAAA,CAAA;EAAA,QAAA,GAAA,gBAAA;CAAA,CAAA;CAA9B,OAAA,QAAA,GAAA,sBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAA8B,YADjB;CAAM,CAAA;;AACnB,GAAA,yBAAA;CAAA,YAAA;CAAA,SAAA;CAAA,UAAA;CAAA,MAAA;CAA8B,YAAA,CAAA;EAD1C,MAAA;EAAW,MAAA,CAAA,EAAE,YAAY,OAAM,CAAE;;;;ACWlC,MAAa,uBAAuB,IAAI,eAAgD,sBAAsB;AAG9G,MAAa,kCAAkC;AAa/C,SAAgB,0BAA0B,SAA6B;CACnE,OAAO,yBAAyB,CAAC;EAAE,SAAS;EAAsB,UAAU;EAAS,OAAO;CAAI,CAAE,CAAC;AACvG;AAOA,IAAa,4BAAb,MAAa,0BAAyB;CACjB,WAAW,OAAO,mBAAmB;CACrC;CAEjB,cAAA;EACI,MAAM,0BAAU,IAAI,IAAG;EACvB,KAAK,MAAM,gBAAgB,OAAO,sBAAsB,EAAE,UAAU,KAAI,CAAE,KAAK,CAAA,GAC3E,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,YAAY,GACpD,QAAQ,IAAI,MAAM,MAAM;EAEhC,KAAK,UAAU;CACnB;CAMA,kBAAkB,MAA+B;EAC7C,IAAI,CAAC,MAAM,OAAO;EAClB,MAAM,SAAS,KAAK,QAAQ,IAAI,IAAI;EACpC,IAAI,CAAC,QAAQ,OAAO;EACpB,OAAO,KAAK,YAAY,MAAM,IAAI,OAAQ,OAAO,qBAAA;CACrD;CAMA,MAAM,OAAO,MAAc,MAAa;EACpC,MAAM,SAAS,KAAK,QAAQ,IAAI,IAAI;EACpC,IAAI,CAAC,QAAQ;GAGT,QAAQ,KAAK,iDAAiD,KAAI,6CAA8C;GAChH,OAAO,EAAE,IAAI,MAAK;EACtB;EACA,IAAI,CAAC,KAAK,YAAY,MAAM,GAAG,OAAO,EAAE,IAAI,MAAK;EAEjD,IAAI;GAEA,OAAO;IAAE,IAAI;IAAM,aADC,sBAAsB,KAAK,gBAAgB,OAAO,OAAO,IAAI,CAAC;GAC1D;EAC5B,QAAQ;GACJ,OAAO,EAAE,IAAI,MAAK;EACtB;CACJ;CAEQ,YAAY,QAAyB;EACzC,IAAI,CAAC,OAAO,WAAW,OAAO;EAC9B,IAAI;GACA,OAAO,sBAAsB,KAAK,gBAAgB,OAAO,UAAU,CAAE,MAAM;EAC/E,QAAQ;GACJ,OAAO;EACX;CACJ;CArDS,OAAA,OAAA,GAAA,mBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAAyB,MAAA,CAAA;EAAA,QAAA,GAAA,gBAAA;CAAA,CAAA;CAAzB,OAAA,QAAA,GAAA,sBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAAyB,YADZ;CAAM,CAAA;;AACnB,GAAA,yBAAA;CAAA,YAAA;CAAA,SAAA;CAAA,UAAA;CAAA,MAAA;CAAyB,YAAA,CAAA;EADrC,MAAA;EAAW,MAAA,CAAA,EAAE,YAAY,OAAM,CAAE;;;;ACjDlC,MAAM,sBAAsB;AAU5B,IAAa,2BAAb,MAAa,yBAAwB;CAChB,UAAU,OAA8B,CAAA,GAAG,GAAA,YAAA,CAAA,EAAA,WAAA,UAAA,CAAA,+BAAA,CAAA,CAAA;CACnD,SAAS,KAAK,QAAQ,WAAU;CAEzC,KAAK,SAAiB,OAAyB,iBAAiB,MAAM,YAAmB;EACrF,MAAM,KAAK,OAAO,WAAW,eAAe,OAAO,aAAa,OAAO,WAAU,IAAK,GAAG,KAAK,IAAG,EAAE,GAAI,KAAK,OAAM;EAClH,MAAM,oBAAoB,cAAc;EACxC,MAAM,QAAoB;GAAE;GAAI;GAAS;GAAM,YAAY;EAAiB;EAC5E,KAAK,QAAQ,QAAO,WAAU,CAAC,GAAG,QAAQ,KAAK,CAAC;EAEhD,IAAI,oBAAoB,GACpB,iBAAiB,KAAK,QAAQ,EAAE,GAAG,iBAAiB;CAE5D;CAEA,QAAQ,IAAU;EACd,KAAK,QAAQ,QAAO,WAAU,OAAO,QAAO,MAAK,EAAE,OAAO,EAAE,CAAC;CACjE;CAEA,QAAK;EACD,KAAK,QAAQ,IAAI,CAAA,CAAE;CACvB;CArBS,OAAA,OAAA,GAAA,mBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAAwB,MAAA,CAAA;EAAA,QAAA,GAAA,gBAAA;CAAA,CAAA;CAAxB,OAAA,QAAA,GAAA,sBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAAwB,YADX;CAAM,CAAA;;AACnB,GAAA,yBAAA;CAAA,YAAA;CAAA,SAAA;CAAA,UAAA;CAAA,MAAA;CAAwB,YAAA,CAAA;EADpC,MAAA;EAAW,MAAA,CAAA,EAAE,YAAY,OAAM,CAAE;;;ACsClC,IAAa,+BAAb,MAAa,6BAA4B;CAClB,gBAAgB,OAAO,wBAAwB;CAC/C,OAAO;CAFjB,OAAA,OAAA,GAAA,mBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAA4B,MAAA,CAAA;EAAA,QAAA,GAAA,gBAAA;CAAA,CAAA;CAA5B,OAAA,OAAA,GAAA,qBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,MAAA;EAA4B,cAAA;EAAA,UAAA;EAAA,UAAA;EAAA,UAlD3B;;;;;;;;;;;;;;;;EAeT,UAAA;EAAA,QAAA,CAAA,+qBAAA;EAAA,iBAAA,GAAA,wBAAA;CAAA,CAAA;;AAmCQ,GAAA,yBAAA;CAAA,YAAA;CAAA,SAAA;CAAA,UAAA;CAAA,MAAA;CAA4B,YAAA,CAAA;EArDxC,MAAA;EACa,MAAA,CAAA;GAAA,UAAA;GAAuB,YACrB;GAAI,UACN;;;;;;;;;;;;;;;;GAeT,iBAiCgB,wBAAwB;GAAM,QAAA,CAAA,+qBAAA;EAAA,CAAA;;;AClBnD,IAAa,+BAAb,MAAa,6BAA4B;CACtB,SAAS,OAA+B,CAAA,GAAG,GAAA,YAAA,CAAA,EAAA,WAAA,SAAA,CAAA,+BAAA,CAAA,CAAA;CAC3C,UAAU,OAA4D,CAAA,GAAG,GAAA,YAAA,CAAA,EAAA,WAAA,UAAA,CAAA,+BAAA,CAAA,CAAA;CAMlF,OAAO,OAAO,cAAsB,IAAU;EACpD,OAAO,GAAG,eAAe;CAC3B;CAGA,SAAS,cAAyC,IAA6B;EAC7E,IAAI,CAAC,gBAAgB,CAAC,IAAI,OAAO;EACjC,OAAO,KAAK,OAAM,CAAE,CAAC,6BAA6B,OAAO,cAAc,EAAE,MAAM;CACjF;CASA,WAAW,cAAyC,IAA6B;EAC/E,IAAI,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAA;EACjC,OAAO,KAAK,QAAO,CAAE,CAAC,6BAA6B,OAAO,cAAc,EAAE,MAAM,CAAA;CAClF;CASA,QAAQ,cAAsB,IAAY,eAAuB,OAA0B;EACzF,MAAM,MAAM,6BAA6B,OAAO,cAAc,EAAE;EAChE,KAAK,QAAQ,QAAO,aAAY;GAC9B,GAAG;IACF,MAAM;IAAE,GAAI,QAAQ,QAAQ,CAAA;KAAM,gBAAgB;GAAK;EACzD,EAAC;EACF,KAAK,OAAO,QAAO,aAAY;GAAE,GAAG;IAAU,OAAO,QAAQ,QAAQ,KAAK;EAAC,EAAG;CAChF;CA5CW,OAAA,OAAA,GAAA,mBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAA4B,MAAA,CAAA;EAAA,QAAA,GAAA,gBAAA;CAAA,CAAA;CAA5B,OAAA,QAAA,GAAA,sBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAA4B,YADf;CAAM,CAAA;;AACnB,GAAA,yBAAA;CAAA,YAAA;CAAA,SAAA;CAAA,UAAA;CAAA,MAAA;CAA4B,YAAA,CAAA;EADxC,MAAA;EAAW,MAAA,CAAA,EAAE,YAAY,OAAM,CAAE;;;ACrBlC,IAAa,2BAAb,MAAa,yBAAwB;CAClB,SAAS,OAA+B,CAAA,GAAG,GAAA,YAAA,CAAA,EAAA,WAAA,SAAA,CAAA,+BAAA,CAAA,CAAA;CAS5D,SAAS,SAA2B;EAClC,IAAI,CAAC,SAAS,OAAO;EACrB,OAAO,KAAK,OAAM,CAAE,CAAC,UAAU,OAAO,MAAM;CAC9C;CAaA,QAAQ,SAAe;EACrB,MAAM,MAAM,UAAU,OAAO;EAC7B,KAAK,OAAO,QAAO,aAAY;GAAE,GAAG;IAAU,OAAO,QAAQ,QAAQ,KAAK;EAAC,EAAG;CAChF;CA7BW,OAAA,OAAA,GAAA,mBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAAwB,MAAA,CAAA;EAAA,QAAA,GAAA,gBAAA;CAAA,CAAA;CAAxB,OAAA,QAAA,GAAA,sBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAAwB,YADX;CAAM,CAAA;;AACnB,GAAA,yBAAA;CAAA,YAAA;CAAA,SAAA;CAAA,UAAA;CAAA,MAAA;CAAwB,YAAA,CAAA;EADpC,MAAA;EAAW,MAAA,CAAA,EAAE,YAAY,OAAM,CAAE;;;AAiClC,SAAS,UAAU,SAAe;CAChC,OAAO,QAAQ,YAAW;AAC5B;ACbA,SAAgB,+BAA4B;CACxC,OAAO,yBAAyB;EAC5B;GACI,SAAS;GACT,kBAAiB;IACb,MAAM,gBAAgB,OAAO,wBAAwB;IACrD,OAAO;KACH,MAAM;KACN,UAAU,cAA8B;MACpC,MAAM,SAAS;MAEf,MAAM,UAAW,OAAO,qBAAqB,mBAAmB,OAAO,iBAAiB,KAAM,OAAO;MACrG,cAAc,KAAK,SAAS,OAAO,MAAM,OAAO,UAAU;KAC9D;IACH;GACL;GACA,OAAO;EACV;EACD;GACI,SAAS;GACT,kBAAiB;IACb,MAAM,UAAU,OAAO,wBAAwB;IAC/C,OAAO;KACH,MAAM;KACN,UAAU,cAA8B;MACpC,QAAQ,QAAS,UAAoC,OAAO;KAChE;IACH;GACL;GACA,OAAO;EACV;EACD;GACI,SAAS;GACT,kBAAiB;IACb,MAAM,aAAa,OAAO,4BAA4B;IACtD,OAAO;KACH,MAAM;KACN,UAAU,cAA8B;MACpC,MAAM,QAAQ;MAId,WAAW,QAAQ,MAAM,cAAc,MAAM,IAAI,MAAM,eAAe;OAClE,OAAO,MAAM;OACb,QAAQ,MAAM;OACd,SAAS,MAAM;MAClB,CAAA;KACL;IACH;GACL;GACA,OAAO;EACV;EACD;GACI,SAAS;GACT,kBAAiB;IACb,MAAM,SAAS,OAAO,MAAM;IAC5B,OAAO;KACH,MAAM;KACN,UAAU,cAA8B;MACpC,MAAM,WAAW;MAEjB,IAAI,SAAS,WAAW;OACpB,AAAK,OAAO,cACR,SAAS,UAAU,WAAW,GAAG,IAAI,SAAS,YAAY,IAAI,SAAS,WAAW;OACtF;MACJ;MAKA,IAAI,SAAS,gBAAgB,SAAS,IAAI;OACtC,AAAK,OAAO,SAAS;QAAC;QAAO,SAAS;QAAc,SAAS;OAAE,CAAC;OAChE;MACJ;MAEA,QAAQ,KAAK,oFAAoF;KACrG;IACH;GACL;GACA,OAAO;EACV;CACJ,CAAA;AACL"}

package/fesm2022/mintplayer-ng-spark-grid.mjs

@@ -3,7 +3,7 @@ import * as i0 from "@angular/core";
 import { ChangeDetectionStrategy, Component, DestroyRef, Directive, Injectable, Injector, TemplateRef, computed, contentChildren, effect, inject, input, linkedSignal, model, output, runInInjectionContext, signal, untracked, viewChild } from "@angular/core";
 import { ShowedOn, confirmationText, defaultQueryActions, filterQueryActions, hasShowedOnFlag, parseSelectionRule, selectionModeFor, valueFor } from "@mintplayer/ng-spark/models";
 import { SPARK_ATTRIBUTE_RENDERERS, cellValue, withDeclaredInputs } from "@mintplayer/ng-spark/renderers";
-import { SPARK_RETURN_URL_STATE_KEY, SparkLanguageService, SparkService } from "@mintplayer/ng-spark/services";
+import { SPARK_RETURN_URL_STATE_KEY, SparkLanguageService, SparkService, sparkDatatableLabels } from "@mintplayer/ng-spark/services";
 import * as i1$1 from "@angular/common";
 import { CommonModule, NgComponentOutlet } from "@angular/common";
 import { toSignal } from "@angular/core/rxjs-interop";
@@ -17,7 +17,7 @@ import { BsBadgeComponent } from "@mintplayer/ng-bootstrap/badge";
 import { CdkConnectedOverlay, CdkOverlayOrigin } from "@angular/cdk/overlay";
 import { BsDropdownItemDirective, BsDropdownMenuComponent } from "@mintplayer/ng-bootstrap/dropdown-menu";
 import { SparkIconComponent } from "@mintplayer/ng-spark/icon";
-import { SparkQueryRefreshService } from "@mintplayer/ng-spark/client-operations";
+import { SparkClientMethodRegistry, SparkQueryRefreshService } from "@mintplayer/ng-spark/client-operations";
 import { QueryCellValuePipe, QueryReferenceChipsPipe, ResolveTranslationPipe, TranslateKeyPipe } from "@mintplayer/ng-spark/pipes";
 import { SparkAttributeDescriptionComponent } from "@mintplayer/ng-spark/attribute-description";
 import { SparkColumnFilterPanelComponent } from "@mintplayer/ng-spark/column-filter";
@@ -522,6 +522,7 @@ var SparkQueryGridComponent = class SparkQueryGridComponent {
 	injector = inject(Injector);
 	addonRowActions = orderSparkExtensions(inject(SPARK_QUERY_ROW_ACTIONS, { optional: true }), (a) => a.priority ?? 50);
 	lang = inject(SparkLanguageService);
+	clientMethods = inject(SparkClientMethodRegistry);
 	queryId = input.required(...ngDevMode ? [{ debugName: "queryId" }] : /* istanbul ignore next */ []);
 	parentId = input("", ...ngDevMode ? [{ debugName: "parentId" }] : /* istanbul ignore next */ []);
 	parentType = input("", ...ngDevMode ? [{ debugName: "parentType" }] : /* istanbul ignore next */ []);
@@ -754,6 +755,7 @@ var SparkQueryGridComponent = class SparkQueryGridComponent {
 		this.closeRowMenu(rowId);
 	}
 	async chooseRowAction(action, row) {
+		if (this.actionUnavailableReason(action.definition) !== null) return;
 		this.closeRowMenu();
 		await this.runRowAction(action, row);
 	}
@@ -842,9 +844,15 @@ var SparkQueryGridComponent = class SparkQueryGridComponent {
 	isVirtualScrolling = computed(() => isVirtualScrollingQuery(this.query()), ...ngDevMode ? [{ debugName: "isVirtualScrolling" }] : /* istanbul ignore next */ []);
 	fetchedColumns = signal([], ...ngDevMode ? [{ debugName: "fetchedColumns" }] : /* istanbul ignore next */ []);
 	allColumns = computed(() => this.columns() ?? this.fetchedColumns(), ...ngDevMode ? [{ debugName: "allColumns" }] : /* istanbul ignore next */ []);
+	rowActionsColumn = "__sparkRowActions";
+	datatableLabels = computed(() => sparkDatatableLabels(this.lang), ...ngDevMode ? [{ debugName: "datatableLabels" }] : /* istanbul ignore next */ []);
 	hasExternalData = computed(() => this.data() !== null || this.query()?.isStreamingQuery === true, ...ngDevMode ? [{ debugName: "hasExternalData" }] : /* istanbul ignore next */ []);
 	isActionEnabled(action) {
-		return parseSelectionRule(action.selectionRule)(this.selection().map((r) => r.id).length);
+		return this.clientMethods.unavailableReason(action.requiresClient) === null && parseSelectionRule(action.selectionRule)(this.selection().map((r) => r.id).length);
+	}
+	actionUnavailableReason(action) {
+		const key = this.clientMethods.unavailableReason(action.requiresClient);
+		return key === null ? null : this.lang.t(key);
 	}
 	constructor() {
 		effect(() => {
@@ -1269,7 +1277,7 @@ var SparkQueryGridComponent = class SparkQueryGridComponent {
 			isSignal: true
 		}],
 		ngImport: i0,
-		template: "<!--\n  Three explicit states, in this order, and the order is load-bearing.\n\n  This template used to open with `@if (query(); as q)` wrapping EVERYTHING, and `query()` is only\n  set after loadData's awaits resolve. Three separate bugs fell out of that one line: the spinner\n  was unreachable on a first load (it rendered inside the gate, while `loading` starts true and\n  `query` starts null), a first-load failure rendered ZERO DOM — no card, no message, nothing to\n  see or report — and a failed RELOAD left the previous query's rows on screen.\n\n  So: `loading` is checked first and outside any dependency on `query`, and the final `@else`\n  always renders something. Do not fold these back into one gate, and do not move the spinner\n  inside the `query()` branch.\n-->\n@if (loading()) {\n  <div class=\"text-center p-3\">\n    <bs-spinner />\n  </div>\n} @else if (query()) {\n  <!-- A page-fetch failure while the grid is already resolved. Without this the catch returns an\n       empty page and a failed query is indistinguishable from one that legitimately has no rows. -->\n  @if (errorMessage(); as err) {\n    <bs-alert [type]=\"colors.danger\" class=\"mb-3\">\n      {{ err }}\n    </bs-alert>\n  }\n\n  <!--\n    One datatable, two row sources. `[data]` and `[fetch]` are mutually exclusive in\n    ng-bootstrap — binding both makes `[fetch]` win silently — so exactly one is ever non-null\n    here: `fetchFn` is left null whenever `data` is bound. See the class comment for why rows can\n    arrive from outside at all (streaming must not put a websocket in every detail page's bundle).\n  -->\n  <!--\n    The selection bar (#460, M15): the \"N selected\" chip, only while rows are selected, and part\n    of the grid rather than of a host, so the query card and the query-list page show the same\n    thing. There is deliberately no select-all (owner decision, 2026-09-29): with paged, lazy or\n    virtual-scrolled rows it could only tick the rows loaded so far. The selection survives paging\n    (#467, D19), so the chip counts every ticked row — exactly what an action receives — and says how\n    many are on other pages; its ⊗ drops them all, since the header checkbox only sees this page.\n    The bar keeps its height while empty, so ticking the first row does not push the table down\n    under the pointer.\n  -->\n  @if (selectionMode() !== 'none') {\n    <div class=\"spark-selection-bar d-flex align-items-center gap-2 mb-2\" style=\"min-height: 1.5rem\">\n      @if (selection().length) {\n        <bs-badge [type]=\"colors.primary\" class=\"spark-selection-chip\">\n          {{ selection().length }} {{ 'common.selected' | t }}\n          @if (offPageCount()) {\n            <span class=\"spark-selection-off-page\">· {{ offPageCount() }} {{ 'common.onOtherPages' | t }}</span>\n          }\n          <button type=\"button\" class=\"spark-selection-clear\"\n                  [attr.aria-label]=\"'common.clearSelection' | t\" (click)=\"clearSelection()\">\n            <spark-icon name=\"x-circle\" />\n          </button>\n        </bs-badge>\n      }\n    </div>\n  }\n\n  <!-- 'checkbox' (#467, D9): only the checkbox cell selects; a row click opens the row. -->\n  <bs-datatable\n      [selectionMode]=\"selectionMode() === 'multiple' ? 'checkbox' : 'none'\"\n      [(selection)]=\"selection\"\n      [virtualScroll]=\"isVirtualScrolling()\"\n      [itemSize]=\"40\"\n      [isResponsive]=\"isVirtualScrolling()\"\n      [data]=\"data()\"\n      [fetch]=\"fetchFn()\"\n      [distincts]=\"distinctsFn\"\n      (filterChange)=\"onFilterChange($event)\"\n      (rowClick)=\"onRowClick($event)\"\n      [(settings)]=\"settings\">\n    @for (col of allColumns(); track col.name) {\n      <!--\n        `canSort`/`canFilter` arrive already resolved by the server (query override → attribute →\n        true), so this only spells the polarity. `!== false` is needed for BOTH, for opposite\n        reasons: absent means capable on our wire, while the datatable's own `filterable` defaults\n        to false, unlike `sortable`.\n\n        ⚠️ `filterActive` and `filterSummary` are deliberately NOT bound. Any *bsDatatableColumn\n        input change recomputes the column set, which retires the live filter view — while the web\n        component's mount-once guard leaves the panel's nodes in place and never re-renders them.\n        Binding them to state our own panel mutates would freeze the panel the instant a value is\n        ticked, until it is closed and reopened. The cost is that a filtered column carries no\n        visual marker yet, which is worth far less than a panel that dies on first use. See #431 F7.\n      -->\n      <div *bsDatatableColumn=\"col.name; sortable: col.canSort !== false; filterable: col.canFilter !== false\">\n        {{ (col.label | resolveTranslation) || col.name }}\n        <spark-attribute-description [description]=\"col.description\" />\n\n        @if (col.canFilter !== false) {\n          <ng-container *bsDatatableFilterPanel=\"let values; let ctx = ctx\">\n            <spark-column-filter-panel\n              [column]=\"col\"\n              [values]=\"values()\"\n              [ctx]=\"ctx\"\n              [filterLabel]=\"filterLabelFor(col)\" />\n          </ng-container>\n        }\n      </div>\n    }\n    <!--\n      The per-row ⋮ menu's column: no header, never sorted or filtered.\n\n      ⚠️ Only once the data columns exist. Those ship WITH the first page, so the rows reach the\n      datatable one render before the column templates do. The datatable sizes its columns ONCE,\n      from the first render that has both columns and rows, then switches to `table-layout: fixed`\n      and never measures again. If this column were already registered it would be the only one\n      measured; the data columns would share what it left over equally, and at phone width their\n      unclipped headers ran into each other. With no column at all the datatable waits.\n    -->\n    @if (rowActions().length && allColumns().length) {\n      <div *bsDatatableColumn=\"'__sparkRowActions'; sortable: false; filterable: false\">\n        <span class=\"visually-hidden\">{{ 'common.actions' | t }}</span>\n      </div>\n    }\n\n    <ng-container *bsRowTemplate=\"let item\">\n      @let row = $any(item);\n      @for (col of allColumns(); track col.name; let first = $first) {\n        <td>\n          @if (row) {\n            <!-- The first column links to the row's detail page. Two things about this are\n                 routinely misread:\n\n                 1. `cellContent` is projected INSIDE the anchor, so a custom `renderer` does NOT\n                    suppress this link — a renderer that emits its own <a> produces nested anchors\n                    (invalid HTML) rather than replacing this one.\n                 2. `canRead()` is the whole gate, and it is the rights model: `Query` without\n                    `Read` lists the rows and withholds the link. Withhold `Read` for a query\n                    whose rows no detail page can load — a Custom.* query that fabricates rows in\n                    memory, say.\n                 3. `rowRoute` replaces the DESTINATION only, never the gate: returning a route\n                    from it cannot make a row clickable that `canRead()` withheld, and returning\n                    null from it suppresses the link for that one row. -->\n            @if (first && canRead() && rowRouteFor(row); as route) {\n              <a [routerLink]=\"route\" [queryParams]=\"rowQueryParams()\" [state]=\"rowLinkState()\"\n                 (click)=\"rowClicked.emit(row)\">\n                <ng-container *ngTemplateOutlet=\"cellContent; context: { $implicit: row, col: col }\"></ng-container>\n              </a>\n            } @else {\n              <ng-container *ngTemplateOutlet=\"cellContent; context: { $implicit: row, col: col }\"></ng-container>\n            }\n          } @else {\n            &nbsp;\n          }\n        </td>\n      }\n      @if (rowActions().length) {\n        <!-- The row menu: every action whose rule accepts one row, run on THIS row only. The\n             checkbox selection is left alone (runRowAction never reads or writes it). -->\n        <td class=\"spark-row-actions text-end\" (click)=\"$event.stopPropagation()\" (dblclick)=\"$event.stopPropagation()\">\n          @if (row) {\n            <button type=\"button\" cdkOverlayOrigin #rowMenuOrigin=\"cdkOverlayOrigin\" #rowMenuToggle\n                    class=\"btn btn-sm btn-link spark-row-menu-toggle\"\n                    aria-haspopup=\"menu\" [attr.aria-expanded]=\"openRowMenu() === row.id\"\n                    [attr.aria-label]=\"'common.actions' | t\" (click)=\"toggleRowMenu(row)\">\n              <spark-icon name=\"three-dots-vertical\" />\n            </button>\n            <ng-template cdkConnectedOverlay\n                         [cdkConnectedOverlayOrigin]=\"rowMenuOrigin\"\n                         [cdkConnectedOverlayOpen]=\"openRowMenu() === row.id\"\n                         [cdkConnectedOverlayPositions]=\"rowMenuPositions\"\n                         (overlayOutsideClick)=\"onRowMenuOutsideClick($event, rowMenuToggle, row.id)\"\n                         (overlayKeydown)=\"$event.key === 'Escape' && closeRowMenu(row.id)\"\n                         (detach)=\"closeRowMenu(row.id)\">\n              <bs-dropdown-menu class=\"spark-row-menu\">\n                @for (action of rowActions(); track action.name) {\n                  <li bsDropdownItem class=\"spark-row-action\" [attr.data-action]=\"action.name\"\n                      (click)=\"chooseRowAction(action, row)\">\n                    {{ action.definition.label | resolveTranslation }}\n                  </li>\n                }\n              </bs-dropdown-menu>\n            </ng-template>\n          }\n        </td>\n      }\n    </ng-container>\n  </bs-datatable>\n} @else {\n  <!-- The query could not be resolved. Rendering something keeps the host's layout intact and,\n       crucially, makes the failure visible: this branch used to render nothing at all. -->\n  <bs-alert [type]=\"colors.danger\" class=\"mb-0\">\n    {{ errorMessage() || ('spark.query.unavailable' | t) }}\n  </bs-alert>\n}\n\n<ng-template #cellContent let-item let-col=\"col\">\n  <!--\n    Presentation lives in <spark-grid-cell>, shared with the AsDetail table on the PO detail page.\n    Value resolution stays here: a query row is a PersistentObject with an attribute list, and the\n    AsDetail table's rows are plain dictionaries, so only the rendering is common.\n\n    `link` is deliberately not passed. The first-column link is the grid's own rule and wraps this\n    template from outside; setting both would nest anchors.\n  -->\n  <spark-grid-cell\n      [column]=\"col\"\n      [display]=\"(col | queryCellValue:item:lookupReferenceOptions())\"\n      [rendererValue]=\"rendererValueFor(item, col)\"\n      [item]=\"item\"\n      [chips]=\"(col | queryReferenceChips:item)\" />\n</ng-template>\n",
+		template: "<!--\n  Three explicit states, in this order, and the order is load-bearing.\n\n  This template used to open with `@if (query(); as q)` wrapping EVERYTHING, and `query()` is only\n  set after loadData's awaits resolve. Three separate bugs fell out of that one line: the spinner\n  was unreachable on a first load (it rendered inside the gate, while `loading` starts true and\n  `query` starts null), a first-load failure rendered ZERO DOM — no card, no message, nothing to\n  see or report — and a failed RELOAD left the previous query's rows on screen.\n\n  So: `loading` is checked first and outside any dependency on `query`, and the final `@else`\n  always renders something. Do not fold these back into one gate, and do not move the spinner\n  inside the `query()` branch.\n-->\n@if (loading()) {\n  <div class=\"text-center p-3\">\n    <bs-spinner />\n  </div>\n} @else if (query()) {\n  <!-- A page-fetch failure while the grid is already resolved. Without this the catch returns an\n       empty page and a failed query is indistinguishable from one that legitimately has no rows. -->\n  @if (errorMessage(); as err) {\n    <bs-alert [type]=\"colors.danger\" class=\"mb-3\">\n      {{ err }}\n    </bs-alert>\n  }\n\n  <!--\n    One datatable, two row sources. `[data]` and `[fetch]` are mutually exclusive in\n    ng-bootstrap — binding both makes `[fetch]` win silently — so exactly one is ever non-null\n    here: `fetchFn` is left null whenever `data` is bound. See the class comment for why rows can\n    arrive from outside at all (streaming must not put a websocket in every detail page's bundle).\n  -->\n  <!--\n    The selection bar (#460, M15): the \"N selected\" chip, only while rows are selected, and part\n    of the grid rather than of a host, so the query card and the query-list page show the same\n    thing. There is deliberately no select-all (owner decision, 2026-09-29): with paged, lazy or\n    virtual-scrolled rows it could only tick the rows loaded so far. The selection survives paging\n    (#467, D19), so the chip counts every ticked row — exactly what an action receives — and says how\n    many are on other pages; its ⊗ drops them all, since the header checkbox only sees this page.\n    The bar keeps its height while empty, so ticking the first row does not push the table down\n    under the pointer.\n  -->\n  @if (selectionMode() !== 'none') {\n    <div class=\"spark-selection-bar d-flex align-items-center gap-2 mb-2\" style=\"min-height: 1.5rem\">\n      @if (selection().length) {\n        <bs-badge [type]=\"colors.primary\" class=\"spark-selection-chip\">\n          {{ selection().length }} {{ 'common.selected' | t }}\n          @if (offPageCount()) {\n            <span class=\"spark-selection-off-page\">· {{ offPageCount() }} {{ 'common.onOtherPages' | t }}</span>\n          }\n          <button type=\"button\" class=\"spark-selection-clear\"\n                  [attr.aria-label]=\"'common.clearSelection' | t\" (click)=\"clearSelection()\">\n            <spark-icon name=\"x-circle\" />\n          </button>\n        </bs-badge>\n      }\n    </div>\n  }\n\n  <!-- 'checkbox' (#467, D9): only the checkbox cell selects; a row click opens the row. -->\n  <bs-datatable\n      [selectionMode]=\"selectionMode() === 'multiple' ? 'checkbox' : 'none'\"\n      [(selection)]=\"selection\"\n      [virtualScroll]=\"isVirtualScrolling()\"\n      [itemSize]=\"40\"\n      [isResponsive]=\"isVirtualScrolling()\"\n      [data]=\"data()\"\n      [fetch]=\"fetchFn()\"\n      [distincts]=\"distinctsFn\"\n      [labels]=\"datatableLabels()\"\n      (filterChange)=\"onFilterChange($event)\"\n      (rowClick)=\"onRowClick($event)\"\n      [(settings)]=\"settings\">\n    @for (col of allColumns(); track col.name) {\n      <!--\n        `canSort`/`canFilter` arrive already resolved by the server (query override → attribute →\n        true), so this only spells the polarity. `!== false` is needed for BOTH, for opposite\n        reasons: absent means capable on our wire, while the datatable's own `filterable` defaults\n        to false, unlike `sortable`.\n\n        ⚠️ `filterActive` and `filterSummary` are deliberately NOT bound. Any *bsDatatableColumn\n        input change recomputes the column set, which retires the live filter view — while the web\n        component's mount-once guard leaves the panel's nodes in place and never re-renders them.\n        Binding them to state our own panel mutates would freeze the panel the instant a value is\n        ticked, until it is closed and reopened. The cost is that a filtered column carries no\n        visual marker yet, which is worth far less than a panel that dies on first use. See #431 F7.\n      -->\n      <div *bsDatatableColumn=\"col.name; sortable: col.canSort !== false; filterable: col.canFilter !== false; label: (col.label | resolveTranslation) || col.name\">\n        {{ (col.label | resolveTranslation) || col.name }}\n        <spark-attribute-description [description]=\"col.description\" />\n\n        @if (col.canFilter !== false) {\n          <ng-container *bsDatatableFilterPanel=\"let values; let ctx = ctx\">\n            <spark-column-filter-panel\n              [column]=\"col\"\n              [values]=\"values()\"\n              [ctx]=\"ctx\"\n              [filterLabel]=\"filterLabelFor(col)\" />\n          </ng-container>\n        }\n      </div>\n    }\n    <!--\n      The per-row ⋮ menu's column: no header, never sorted or filtered.\n\n      ⚠️ Only once the data columns exist. Those ship WITH the first page, so the rows reach the\n      datatable one render before the column templates do. The datatable sizes its columns ONCE,\n      from the first render that has both columns and rows, then switches to `table-layout: fixed`\n      and never measures again. If this column were already registered it would be the only one\n      measured; the data columns would share what it left over equally, and at phone width their\n      unclipped headers ran into each other. With no column at all the datatable waits.\n    -->\n    @if (rowActions().length && allColumns().length) {\n      <div *bsDatatableColumn=\"rowActionsColumn; sortable: false; filterable: false; resizable: false; label: 'common.actions' | t\">\n        <span class=\"visually-hidden\">{{ 'common.actions' | t }}</span>\n      </div>\n    }\n\n    <ng-container *bsRowTemplate=\"let item\">\n      @let row = $any(item);\n      @for (col of allColumns(); track col.name; let first = $first) {\n        <td>\n          @if (row) {\n            <!-- The first column links to the row's detail page. Two things about this are\n                 routinely misread:\n\n                 1. `cellContent` is projected INSIDE the anchor, so a custom `renderer` does NOT\n                    suppress this link — a renderer that emits its own <a> produces nested anchors\n                    (invalid HTML) rather than replacing this one.\n                 2. `canRead()` is the whole gate, and it is the rights model: `Query` without\n                    `Read` lists the rows and withholds the link. Withhold `Read` for a query\n                    whose rows no detail page can load — a Custom.* query that fabricates rows in\n                    memory, say.\n                 3. `rowRoute` replaces the DESTINATION only, never the gate: returning a route\n                    from it cannot make a row clickable that `canRead()` withheld, and returning\n                    null from it suppresses the link for that one row. -->\n            @if (first && canRead() && rowRouteFor(row); as route) {\n              <a [routerLink]=\"route\" [queryParams]=\"rowQueryParams()\" [state]=\"rowLinkState()\"\n                 (click)=\"rowClicked.emit(row)\">\n                <ng-container *ngTemplateOutlet=\"cellContent; context: { $implicit: row, col: col }\"></ng-container>\n              </a>\n            } @else {\n              <ng-container *ngTemplateOutlet=\"cellContent; context: { $implicit: row, col: col }\"></ng-container>\n            }\n          } @else {\n            &nbsp;\n          }\n        </td>\n      }\n      @if (rowActions().length) {\n        <!-- The row menu: every action whose rule accepts one row, run on THIS row only. The\n             checkbox selection is left alone (runRowAction never reads or writes it). -->\n        <td class=\"spark-row-actions text-end\" (click)=\"$event.stopPropagation()\" (dblclick)=\"$event.stopPropagation()\">\n          @if (row) {\n            <button type=\"button\" cdkOverlayOrigin #rowMenuOrigin=\"cdkOverlayOrigin\" #rowMenuToggle\n                    class=\"btn btn-sm btn-link spark-row-menu-toggle\"\n                    aria-haspopup=\"menu\" [attr.aria-expanded]=\"openRowMenu() === row.id\"\n                    [attr.aria-label]=\"'common.actions' | t\" (click)=\"toggleRowMenu(row)\">\n              <spark-icon name=\"three-dots-vertical\" />\n            </button>\n            <ng-template cdkConnectedOverlay\n                         [cdkConnectedOverlayOrigin]=\"rowMenuOrigin\"\n                         [cdkConnectedOverlayOpen]=\"openRowMenu() === row.id\"\n                         [cdkConnectedOverlayPositions]=\"rowMenuPositions\"\n                         (overlayOutsideClick)=\"onRowMenuOutsideClick($event, rowMenuToggle, row.id)\"\n                         (overlayKeydown)=\"$event.key === 'Escape' && closeRowMenu(row.id)\"\n                         (detach)=\"closeRowMenu(row.id)\">\n              <bs-dropdown-menu class=\"spark-row-menu\">\n                @for (action of rowActions(); track action.name) {\n                  @let unavailable = actionUnavailableReason(action.definition);\n                  <li bsDropdownItem class=\"spark-row-action\" [attr.data-action]=\"action.name\"\n                      [class.disabled]=\"unavailable !== null\" [attr.aria-disabled]=\"unavailable !== null ? 'true' : null\"\n                      [attr.title]=\"unavailable\"\n                      (click)=\"chooseRowAction(action, row)\">\n                    {{ action.definition.label | resolveTranslation }}\n                  </li>\n                }\n              </bs-dropdown-menu>\n            </ng-template>\n          }\n        </td>\n      }\n    </ng-container>\n  </bs-datatable>\n} @else {\n  <!-- The query could not be resolved. Rendering something keeps the host's layout intact and,\n       crucially, makes the failure visible: this branch used to render nothing at all. -->\n  <bs-alert [type]=\"colors.danger\" class=\"mb-0\">\n    {{ errorMessage() || ('spark.query.unavailable' | t) }}\n  </bs-alert>\n}\n\n<ng-template #cellContent let-item let-col=\"col\">\n  <!--\n    Presentation lives in <spark-grid-cell>, shared with the AsDetail table on the PO detail page.\n    Value resolution stays here: a query row is a PersistentObject with an attribute list, and the\n    AsDetail table's rows are plain dictionaries, so only the rendering is common.\n\n    `link` is deliberately not passed. The first-column link is the grid's own rule and wraps this\n    template from outside; setting both would nest anchors.\n  -->\n  <spark-grid-cell\n      [column]=\"col\"\n      [display]=\"(col | queryCellValue:item:lookupReferenceOptions())\"\n      [rendererValue]=\"rendererValueFor(item, col)\"\n      [item]=\"item\"\n      [chips]=\"(col | queryReferenceChips:item)\" />\n</ng-template>\n",
 		styles: [":host ::ng-deep tbody tr[data-selected=true] a:not(.btn),:host ::ng-deep tbody tr[data-selected=true] .spark-row-menu-toggle{color:var(--mp-datatable-row-selected-color)}:host ::ng-deep tbody tr[data-selected=true] .spark-row-menu-toggle{--bs-btn-color: var(--mp-datatable-row-selected-color);--bs-btn-hover-color: var(--mp-datatable-row-selected-color);--bs-btn-active-color: var(--mp-datatable-row-selected-color)}\n"],
 		dependencies: [
 			{
@@ -1368,6 +1376,8 @@ var SparkQueryGridComponent = class SparkQueryGridComponent {
 				inputs: [
 					"bsDatatableColumn",
 					"bsDatatableColumnSortable",
+					"bsDatatableColumnLabel",
+					"bsDatatableColumnResizable",
 					"bsDatatableColumnFilterable",
 					"bsDatatableColumnFilterActive",
 					"bsDatatableColumnFilterSummary",
@@ -1560,7 +1570,7 @@ i0.ɵɵngDeclareClassMetadata({
 				SparkIconComponent
 			],
 			changeDetection: ChangeDetectionStrategy.OnPush,
-			template: "<!--\n  Three explicit states, in this order, and the order is load-bearing.\n\n  This template used to open with `@if (query(); as q)` wrapping EVERYTHING, and `query()` is only\n  set after loadData's awaits resolve. Three separate bugs fell out of that one line: the spinner\n  was unreachable on a first load (it rendered inside the gate, while `loading` starts true and\n  `query` starts null), a first-load failure rendered ZERO DOM — no card, no message, nothing to\n  see or report — and a failed RELOAD left the previous query's rows on screen.\n\n  So: `loading` is checked first and outside any dependency on `query`, and the final `@else`\n  always renders something. Do not fold these back into one gate, and do not move the spinner\n  inside the `query()` branch.\n-->\n@if (loading()) {\n  <div class=\"text-center p-3\">\n    <bs-spinner />\n  </div>\n} @else if (query()) {\n  <!-- A page-fetch failure while the grid is already resolved. Without this the catch returns an\n       empty page and a failed query is indistinguishable from one that legitimately has no rows. -->\n  @if (errorMessage(); as err) {\n    <bs-alert [type]=\"colors.danger\" class=\"mb-3\">\n      {{ err }}\n    </bs-alert>\n  }\n\n  <!--\n    One datatable, two row sources. `[data]` and `[fetch]` are mutually exclusive in\n    ng-bootstrap — binding both makes `[fetch]` win silently — so exactly one is ever non-null\n    here: `fetchFn` is left null whenever `data` is bound. See the class comment for why rows can\n    arrive from outside at all (streaming must not put a websocket in every detail page's bundle).\n  -->\n  <!--\n    The selection bar (#460, M15): the \"N selected\" chip, only while rows are selected, and part\n    of the grid rather than of a host, so the query card and the query-list page show the same\n    thing. There is deliberately no select-all (owner decision, 2026-09-29): with paged, lazy or\n    virtual-scrolled rows it could only tick the rows loaded so far. The selection survives paging\n    (#467, D19), so the chip counts every ticked row — exactly what an action receives — and says how\n    many are on other pages; its ⊗ drops them all, since the header checkbox only sees this page.\n    The bar keeps its height while empty, so ticking the first row does not push the table down\n    under the pointer.\n  -->\n  @if (selectionMode() !== 'none') {\n    <div class=\"spark-selection-bar d-flex align-items-center gap-2 mb-2\" style=\"min-height: 1.5rem\">\n      @if (selection().length) {\n        <bs-badge [type]=\"colors.primary\" class=\"spark-selection-chip\">\n          {{ selection().length }} {{ 'common.selected' | t }}\n          @if (offPageCount()) {\n            <span class=\"spark-selection-off-page\">· {{ offPageCount() }} {{ 'common.onOtherPages' | t }}</span>\n          }\n          <button type=\"button\" class=\"spark-selection-clear\"\n                  [attr.aria-label]=\"'common.clearSelection' | t\" (click)=\"clearSelection()\">\n            <spark-icon name=\"x-circle\" />\n          </button>\n        </bs-badge>\n      }\n    </div>\n  }\n\n  <!-- 'checkbox' (#467, D9): only the checkbox cell selects; a row click opens the row. -->\n  <bs-datatable\n      [selectionMode]=\"selectionMode() === 'multiple' ? 'checkbox' : 'none'\"\n      [(selection)]=\"selection\"\n      [virtualScroll]=\"isVirtualScrolling()\"\n      [itemSize]=\"40\"\n      [isResponsive]=\"isVirtualScrolling()\"\n      [data]=\"data()\"\n      [fetch]=\"fetchFn()\"\n      [distincts]=\"distinctsFn\"\n      (filterChange)=\"onFilterChange($event)\"\n      (rowClick)=\"onRowClick($event)\"\n      [(settings)]=\"settings\">\n    @for (col of allColumns(); track col.name) {\n      <!--\n        `canSort`/`canFilter` arrive already resolved by the server (query override → attribute →\n        true), so this only spells the polarity. `!== false` is needed for BOTH, for opposite\n        reasons: absent means capable on our wire, while the datatable's own `filterable` defaults\n        to false, unlike `sortable`.\n\n        ⚠️ `filterActive` and `filterSummary` are deliberately NOT bound. Any *bsDatatableColumn\n        input change recomputes the column set, which retires the live filter view — while the web\n        component's mount-once guard leaves the panel's nodes in place and never re-renders them.\n        Binding them to state our own panel mutates would freeze the panel the instant a value is\n        ticked, until it is closed and reopened. The cost is that a filtered column carries no\n        visual marker yet, which is worth far less than a panel that dies on first use. See #431 F7.\n      -->\n      <div *bsDatatableColumn=\"col.name; sortable: col.canSort !== false; filterable: col.canFilter !== false\">\n        {{ (col.label | resolveTranslation) || col.name }}\n        <spark-attribute-description [description]=\"col.description\" />\n\n        @if (col.canFilter !== false) {\n          <ng-container *bsDatatableFilterPanel=\"let values; let ctx = ctx\">\n            <spark-column-filter-panel\n              [column]=\"col\"\n              [values]=\"values()\"\n              [ctx]=\"ctx\"\n              [filterLabel]=\"filterLabelFor(col)\" />\n          </ng-container>\n        }\n      </div>\n    }\n    <!--\n      The per-row ⋮ menu's column: no header, never sorted or filtered.\n\n      ⚠️ Only once the data columns exist. Those ship WITH the first page, so the rows reach the\n      datatable one render before the column templates do. The datatable sizes its columns ONCE,\n      from the first render that has both columns and rows, then switches to `table-layout: fixed`\n      and never measures again. If this column were already registered it would be the only one\n      measured; the data columns would share what it left over equally, and at phone width their\n      unclipped headers ran into each other. With no column at all the datatable waits.\n    -->\n    @if (rowActions().length && allColumns().length) {\n      <div *bsDatatableColumn=\"'__sparkRowActions'; sortable: false; filterable: false\">\n        <span class=\"visually-hidden\">{{ 'common.actions' | t }}</span>\n      </div>\n    }\n\n    <ng-container *bsRowTemplate=\"let item\">\n      @let row = $any(item);\n      @for (col of allColumns(); track col.name; let first = $first) {\n        <td>\n          @if (row) {\n            <!-- The first column links to the row's detail page. Two things about this are\n                 routinely misread:\n\n                 1. `cellContent` is projected INSIDE the anchor, so a custom `renderer` does NOT\n                    suppress this link — a renderer that emits its own <a> produces nested anchors\n                    (invalid HTML) rather than replacing this one.\n                 2. `canRead()` is the whole gate, and it is the rights model: `Query` without\n                    `Read` lists the rows and withholds the link. Withhold `Read` for a query\n                    whose rows no detail page can load — a Custom.* query that fabricates rows in\n                    memory, say.\n                 3. `rowRoute` replaces the DESTINATION only, never the gate: returning a route\n                    from it cannot make a row clickable that `canRead()` withheld, and returning\n                    null from it suppresses the link for that one row. -->\n            @if (first && canRead() && rowRouteFor(row); as route) {\n              <a [routerLink]=\"route\" [queryParams]=\"rowQueryParams()\" [state]=\"rowLinkState()\"\n                 (click)=\"rowClicked.emit(row)\">\n                <ng-container *ngTemplateOutlet=\"cellContent; context: { $implicit: row, col: col }\"></ng-container>\n              </a>\n            } @else {\n              <ng-container *ngTemplateOutlet=\"cellContent; context: { $implicit: row, col: col }\"></ng-container>\n            }\n          } @else {\n            &nbsp;\n          }\n        </td>\n      }\n      @if (rowActions().length) {\n        <!-- The row menu: every action whose rule accepts one row, run on THIS row only. The\n             checkbox selection is left alone (runRowAction never reads or writes it). -->\n        <td class=\"spark-row-actions text-end\" (click)=\"$event.stopPropagation()\" (dblclick)=\"$event.stopPropagation()\">\n          @if (row) {\n            <button type=\"button\" cdkOverlayOrigin #rowMenuOrigin=\"cdkOverlayOrigin\" #rowMenuToggle\n                    class=\"btn btn-sm btn-link spark-row-menu-toggle\"\n                    aria-haspopup=\"menu\" [attr.aria-expanded]=\"openRowMenu() === row.id\"\n                    [attr.aria-label]=\"'common.actions' | t\" (click)=\"toggleRowMenu(row)\">\n              <spark-icon name=\"three-dots-vertical\" />\n            </button>\n            <ng-template cdkConnectedOverlay\n                         [cdkConnectedOverlayOrigin]=\"rowMenuOrigin\"\n                         [cdkConnectedOverlayOpen]=\"openRowMenu() === row.id\"\n                         [cdkConnectedOverlayPositions]=\"rowMenuPositions\"\n                         (overlayOutsideClick)=\"onRowMenuOutsideClick($event, rowMenuToggle, row.id)\"\n                         (overlayKeydown)=\"$event.key === 'Escape' && closeRowMenu(row.id)\"\n                         (detach)=\"closeRowMenu(row.id)\">\n              <bs-dropdown-menu class=\"spark-row-menu\">\n                @for (action of rowActions(); track action.name) {\n                  <li bsDropdownItem class=\"spark-row-action\" [attr.data-action]=\"action.name\"\n                      (click)=\"chooseRowAction(action, row)\">\n                    {{ action.definition.label | resolveTranslation }}\n                  </li>\n                }\n              </bs-dropdown-menu>\n            </ng-template>\n          }\n        </td>\n      }\n    </ng-container>\n  </bs-datatable>\n} @else {\n  <!-- The query could not be resolved. Rendering something keeps the host's layout intact and,\n       crucially, makes the failure visible: this branch used to render nothing at all. -->\n  <bs-alert [type]=\"colors.danger\" class=\"mb-0\">\n    {{ errorMessage() || ('spark.query.unavailable' | t) }}\n  </bs-alert>\n}\n\n<ng-template #cellContent let-item let-col=\"col\">\n  <!--\n    Presentation lives in <spark-grid-cell>, shared with the AsDetail table on the PO detail page.\n    Value resolution stays here: a query row is a PersistentObject with an attribute list, and the\n    AsDetail table's rows are plain dictionaries, so only the rendering is common.\n\n    `link` is deliberately not passed. The first-column link is the grid's own rule and wraps this\n    template from outside; setting both would nest anchors.\n  -->\n  <spark-grid-cell\n      [column]=\"col\"\n      [display]=\"(col | queryCellValue:item:lookupReferenceOptions())\"\n      [rendererValue]=\"rendererValueFor(item, col)\"\n      [item]=\"item\"\n      [chips]=\"(col | queryReferenceChips:item)\" />\n</ng-template>\n",
+			template: "<!--\n  Three explicit states, in this order, and the order is load-bearing.\n\n  This template used to open with `@if (query(); as q)` wrapping EVERYTHING, and `query()` is only\n  set after loadData's awaits resolve. Three separate bugs fell out of that one line: the spinner\n  was unreachable on a first load (it rendered inside the gate, while `loading` starts true and\n  `query` starts null), a first-load failure rendered ZERO DOM — no card, no message, nothing to\n  see or report — and a failed RELOAD left the previous query's rows on screen.\n\n  So: `loading` is checked first and outside any dependency on `query`, and the final `@else`\n  always renders something. Do not fold these back into one gate, and do not move the spinner\n  inside the `query()` branch.\n-->\n@if (loading()) {\n  <div class=\"text-center p-3\">\n    <bs-spinner />\n  </div>\n} @else if (query()) {\n  <!-- A page-fetch failure while the grid is already resolved. Without this the catch returns an\n       empty page and a failed query is indistinguishable from one that legitimately has no rows. -->\n  @if (errorMessage(); as err) {\n    <bs-alert [type]=\"colors.danger\" class=\"mb-3\">\n      {{ err }}\n    </bs-alert>\n  }\n\n  <!--\n    One datatable, two row sources. `[data]` and `[fetch]` are mutually exclusive in\n    ng-bootstrap — binding both makes `[fetch]` win silently — so exactly one is ever non-null\n    here: `fetchFn` is left null whenever `data` is bound. See the class comment for why rows can\n    arrive from outside at all (streaming must not put a websocket in every detail page's bundle).\n  -->\n  <!--\n    The selection bar (#460, M15): the \"N selected\" chip, only while rows are selected, and part\n    of the grid rather than of a host, so the query card and the query-list page show the same\n    thing. There is deliberately no select-all (owner decision, 2026-09-29): with paged, lazy or\n    virtual-scrolled rows it could only tick the rows loaded so far. The selection survives paging\n    (#467, D19), so the chip counts every ticked row — exactly what an action receives — and says how\n    many are on other pages; its ⊗ drops them all, since the header checkbox only sees this page.\n    The bar keeps its height while empty, so ticking the first row does not push the table down\n    under the pointer.\n  -->\n  @if (selectionMode() !== 'none') {\n    <div class=\"spark-selection-bar d-flex align-items-center gap-2 mb-2\" style=\"min-height: 1.5rem\">\n      @if (selection().length) {\n        <bs-badge [type]=\"colors.primary\" class=\"spark-selection-chip\">\n          {{ selection().length }} {{ 'common.selected' | t }}\n          @if (offPageCount()) {\n            <span class=\"spark-selection-off-page\">· {{ offPageCount() }} {{ 'common.onOtherPages' | t }}</span>\n          }\n          <button type=\"button\" class=\"spark-selection-clear\"\n                  [attr.aria-label]=\"'common.clearSelection' | t\" (click)=\"clearSelection()\">\n            <spark-icon name=\"x-circle\" />\n          </button>\n        </bs-badge>\n      }\n    </div>\n  }\n\n  <!-- 'checkbox' (#467, D9): only the checkbox cell selects; a row click opens the row. -->\n  <bs-datatable\n      [selectionMode]=\"selectionMode() === 'multiple' ? 'checkbox' : 'none'\"\n      [(selection)]=\"selection\"\n      [virtualScroll]=\"isVirtualScrolling()\"\n      [itemSize]=\"40\"\n      [isResponsive]=\"isVirtualScrolling()\"\n      [data]=\"data()\"\n      [fetch]=\"fetchFn()\"\n      [distincts]=\"distinctsFn\"\n      [labels]=\"datatableLabels()\"\n      (filterChange)=\"onFilterChange($event)\"\n      (rowClick)=\"onRowClick($event)\"\n      [(settings)]=\"settings\">\n    @for (col of allColumns(); track col.name) {\n      <!--\n        `canSort`/`canFilter` arrive already resolved by the server (query override → attribute →\n        true), so this only spells the polarity. `!== false` is needed for BOTH, for opposite\n        reasons: absent means capable on our wire, while the datatable's own `filterable` defaults\n        to false, unlike `sortable`.\n\n        ⚠️ `filterActive` and `filterSummary` are deliberately NOT bound. Any *bsDatatableColumn\n        input change recomputes the column set, which retires the live filter view — while the web\n        component's mount-once guard leaves the panel's nodes in place and never re-renders them.\n        Binding them to state our own panel mutates would freeze the panel the instant a value is\n        ticked, until it is closed and reopened. The cost is that a filtered column carries no\n        visual marker yet, which is worth far less than a panel that dies on first use. See #431 F7.\n      -->\n      <div *bsDatatableColumn=\"col.name; sortable: col.canSort !== false; filterable: col.canFilter !== false; label: (col.label | resolveTranslation) || col.name\">\n        {{ (col.label | resolveTranslation) || col.name }}\n        <spark-attribute-description [description]=\"col.description\" />\n\n        @if (col.canFilter !== false) {\n          <ng-container *bsDatatableFilterPanel=\"let values; let ctx = ctx\">\n            <spark-column-filter-panel\n              [column]=\"col\"\n              [values]=\"values()\"\n              [ctx]=\"ctx\"\n              [filterLabel]=\"filterLabelFor(col)\" />\n          </ng-container>\n        }\n      </div>\n    }\n    <!--\n      The per-row ⋮ menu's column: no header, never sorted or filtered.\n\n      ⚠️ Only once the data columns exist. Those ship WITH the first page, so the rows reach the\n      datatable one render before the column templates do. The datatable sizes its columns ONCE,\n      from the first render that has both columns and rows, then switches to `table-layout: fixed`\n      and never measures again. If this column were already registered it would be the only one\n      measured; the data columns would share what it left over equally, and at phone width their\n      unclipped headers ran into each other. With no column at all the datatable waits.\n    -->\n    @if (rowActions().length && allColumns().length) {\n      <div *bsDatatableColumn=\"rowActionsColumn; sortable: false; filterable: false; resizable: false; label: 'common.actions' | t\">\n        <span class=\"visually-hidden\">{{ 'common.actions' | t }}</span>\n      </div>\n    }\n\n    <ng-container *bsRowTemplate=\"let item\">\n      @let row = $any(item);\n      @for (col of allColumns(); track col.name; let first = $first) {\n        <td>\n          @if (row) {\n            <!-- The first column links to the row's detail page. Two things about this are\n                 routinely misread:\n\n                 1. `cellContent` is projected INSIDE the anchor, so a custom `renderer` does NOT\n                    suppress this link — a renderer that emits its own <a> produces nested anchors\n                    (invalid HTML) rather than replacing this one.\n                 2. `canRead()` is the whole gate, and it is the rights model: `Query` without\n                    `Read` lists the rows and withholds the link. Withhold `Read` for a query\n                    whose rows no detail page can load — a Custom.* query that fabricates rows in\n                    memory, say.\n                 3. `rowRoute` replaces the DESTINATION only, never the gate: returning a route\n                    from it cannot make a row clickable that `canRead()` withheld, and returning\n                    null from it suppresses the link for that one row. -->\n            @if (first && canRead() && rowRouteFor(row); as route) {\n              <a [routerLink]=\"route\" [queryParams]=\"rowQueryParams()\" [state]=\"rowLinkState()\"\n                 (click)=\"rowClicked.emit(row)\">\n                <ng-container *ngTemplateOutlet=\"cellContent; context: { $implicit: row, col: col }\"></ng-container>\n              </a>\n            } @else {\n              <ng-container *ngTemplateOutlet=\"cellContent; context: { $implicit: row, col: col }\"></ng-container>\n            }\n          } @else {\n            &nbsp;\n          }\n        </td>\n      }\n      @if (rowActions().length) {\n        <!-- The row menu: every action whose rule accepts one row, run on THIS row only. The\n             checkbox selection is left alone (runRowAction never reads or writes it). -->\n        <td class=\"spark-row-actions text-end\" (click)=\"$event.stopPropagation()\" (dblclick)=\"$event.stopPropagation()\">\n          @if (row) {\n            <button type=\"button\" cdkOverlayOrigin #rowMenuOrigin=\"cdkOverlayOrigin\" #rowMenuToggle\n                    class=\"btn btn-sm btn-link spark-row-menu-toggle\"\n                    aria-haspopup=\"menu\" [attr.aria-expanded]=\"openRowMenu() === row.id\"\n                    [attr.aria-label]=\"'common.actions' | t\" (click)=\"toggleRowMenu(row)\">\n              <spark-icon name=\"three-dots-vertical\" />\n            </button>\n            <ng-template cdkConnectedOverlay\n                         [cdkConnectedOverlayOrigin]=\"rowMenuOrigin\"\n                         [cdkConnectedOverlayOpen]=\"openRowMenu() === row.id\"\n                         [cdkConnectedOverlayPositions]=\"rowMenuPositions\"\n                         (overlayOutsideClick)=\"onRowMenuOutsideClick($event, rowMenuToggle, row.id)\"\n                         (overlayKeydown)=\"$event.key === 'Escape' && closeRowMenu(row.id)\"\n                         (detach)=\"closeRowMenu(row.id)\">\n              <bs-dropdown-menu class=\"spark-row-menu\">\n                @for (action of rowActions(); track action.name) {\n                  @let unavailable = actionUnavailableReason(action.definition);\n                  <li bsDropdownItem class=\"spark-row-action\" [attr.data-action]=\"action.name\"\n                      [class.disabled]=\"unavailable !== null\" [attr.aria-disabled]=\"unavailable !== null ? 'true' : null\"\n                      [attr.title]=\"unavailable\"\n                      (click)=\"chooseRowAction(action, row)\">\n                    {{ action.definition.label | resolveTranslation }}\n                  </li>\n                }\n              </bs-dropdown-menu>\n            </ng-template>\n          }\n        </td>\n      }\n    </ng-container>\n  </bs-datatable>\n} @else {\n  <!-- The query could not be resolved. Rendering something keeps the host's layout intact and,\n       crucially, makes the failure visible: this branch used to render nothing at all. -->\n  <bs-alert [type]=\"colors.danger\" class=\"mb-0\">\n    {{ errorMessage() || ('spark.query.unavailable' | t) }}\n  </bs-alert>\n}\n\n<ng-template #cellContent let-item let-col=\"col\">\n  <!--\n    Presentation lives in <spark-grid-cell>, shared with the AsDetail table on the PO detail page.\n    Value resolution stays here: a query row is a PersistentObject with an attribute list, and the\n    AsDetail table's rows are plain dictionaries, so only the rendering is common.\n\n    `link` is deliberately not passed. The first-column link is the grid's own rule and wraps this\n    template from outside; setting both would nest anchors.\n  -->\n  <spark-grid-cell\n      [column]=\"col\"\n      [display]=\"(col | queryCellValue:item:lookupReferenceOptions())\"\n      [rendererValue]=\"rendererValueFor(item, col)\"\n      [item]=\"item\"\n      [chips]=\"(col | queryReferenceChips:item)\" />\n</ng-template>\n",
 			styles: [":host ::ng-deep tbody tr[data-selected=true] a:not(.btn),:host ::ng-deep tbody tr[data-selected=true] .spark-row-menu-toggle{color:var(--mp-datatable-row-selected-color)}:host ::ng-deep tbody tr[data-selected=true] .spark-row-menu-toggle{--bs-btn-color: var(--mp-datatable-row-selected-color);--bs-btn-hover-color: var(--mp-datatable-row-selected-color);--bs-btn-active-color: var(--mp-datatable-row-selected-color)}\n"]
 		}]
 	}],
@@ -2026,6 +2036,9 @@ var SparkQueryCardComponent = class SparkQueryCardComponent {
 	isEnabled(action) {
 		return this.grid()?.isToolbarActionEnabled(action) ?? false;
 	}
+	unavailableReason(action) {
+		return this.grid()?.actionUnavailableReason(action.definition) ?? null;
+	}
 	run(action) {
 		this.grid()?.runToolbarAction(action);
 	}
@@ -2174,8 +2187,8 @@ var SparkQueryCardComponent = class SparkQueryCardComponent {
 			isSignal: true
 		}],
 		ngImport: i0,
-		template: "<!--\n  The card is always rendered. A host that wants no card uses <spark-query-grid> directly — which\n  is what the old `showCard=\"false\"` meant, expressed as a component choice rather than a flag.\n-->\n<bs-card class=\"d-block my-3\">\n  <bs-card-header>\n    <div class=\"d-flex align-items-center gap-2\">\n      @if (iconTpl(); as tpl) {\n        <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: query() }\"></ng-container>\n      }\n\n      <!--\n        Caption first, actions on the trailing edge (#460 M15, as query-grid-card-PRD.md always said,\n        and as Vidyano's sub-query tabs do). `me-auto` on the caption pushes the actions right; a card\n        without actions looks exactly as a plain caption did.\n      -->\n      <span class=\"me-auto spark-query-card-caption\">\n        @if (captionTpl(); as tpl) {\n          <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: caption(), query: query() }\"></ng-container>\n        } @else {\n          {{ caption() }}\n        }\n      </span>\n\n      @if (actionsTpl(); as tpl) {\n        <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: customActions(), actions: toolbarActions(), selection: selection(), query: query() }\"></ng-container>\n      } @else if (toolbarActions().length) {\n        <!-- The default: New, Delete and the custom actions the server offers this caller, with the\n             overflow in the priority nav under the translated \"More\" (common.more). The nav renders only when there are any.\n\n             Disabled, not hidden: hiding makes the affordance undiscoverable and reflows the\n             priority nav on every selection change. The server enforces the same rules. -->\n        <bs-priority-nav class=\"spark-query-card-actions\" [moreLabel]=\"lang.t('common.more')\" [collapseAt]=\"'sm'\">\n          @for (action of toolbarActions(); track action.name) {\n            <button *bsPriorityNavItem=\"action.priority\" type=\"button\" [class]=\"actionClass(action)\"\n                    [attr.data-action]=\"action.name\"\n                    [disabled]=\"!isEnabled(action)\" (click)=\"run(action)\">\n              @if (action.definition.icon && action.kind !== 'custom') {\n                <spark-icon [name]=\"action.definition.icon\" />\n              }\n              {{ action.definition.label | resolveTranslation }}\n            </button>\n          }\n        </bs-priority-nav>\n      }\n\n      <!-- The query search, on the trailing edge next to the actions, as Vidyano's sub-query tabs\n           have it (#460 M15, D17 addendum). The same box as the query-list page; it feeds the\n           grid's `search`, which the server applies together with the parent. Absent for bound\n           `data`, which the grid never refetches. -->\n      @if (showSearch()) {\n        <spark-search-box class=\"spark-query-card-search\" size=\"sm\" [(term)]=\"searchTerm\" />\n      }\n    </div>\n  </bs-card-header>\n\n  <div class=\"p-3\">\n    <spark-query-grid\n        [queryId]=\"queryId()\"\n        [parentId]=\"parentId()\"\n        [parentType]=\"parentType()\"\n        [reloadToken]=\"reloadToken()\"\n        [data]=\"data()\"\n        [search]=\"searchTerm()\"\n        [rowRoute]=\"rowRoute()\"\n        [selectionModeSetting]=\"selectionMode()\"\n        [deleted]=\"deleted()\"\n        [parentDeleted]=\"parentDeleted()\"\n        (error)=\"error.emit($event)\"\n        (rowClicked)=\"rowClicked.emit($event)\"\n        (customActionExecuted)=\"customActionExecuted.emit($event)\" />\n  </div>\n</bs-card>\n",
-		styles: [".spark-query-card-search{flex:0 1 14rem;min-width:8rem}\n"],
+		template: "<!--\n  The card is always rendered. A host that wants no card uses <spark-query-grid> directly — which\n  is what the old `showCard=\"false\"` meant, expressed as a component choice rather than a flag.\n-->\n<bs-card class=\"d-block my-3\">\n  <bs-card-header>\n    <div class=\"spark-query-card-header d-flex align-items-center gap-2\">\n      @if (iconTpl(); as tpl) {\n        <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: query() }\"></ng-container>\n      }\n\n      <!--\n        Caption first, actions on the trailing edge (#460 M15, as query-grid-card-PRD.md always said,\n        and as Vidyano's sub-query tabs do). `me-auto` on the caption pushes the actions right; a card\n        without actions looks exactly as a plain caption did.\n      -->\n      <span class=\"me-auto spark-query-card-caption\">\n        @if (captionTpl(); as tpl) {\n          <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: caption(), query: query() }\"></ng-container>\n        } @else {\n          {{ caption() }}\n        }\n      </span>\n\n      @if (actionsTpl(); as tpl) {\n        <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: customActions(), actions: toolbarActions(), selection: selection(), query: query() }\"></ng-container>\n      } @else if (toolbarActions().length) {\n        <!-- The default: New, Delete and the custom actions the server offers this caller, with the\n             overflow in the priority nav under the translated \"More\" (common.more). The nav renders only when there are any.\n\n             Disabled, not hidden: hiding makes the affordance undiscoverable and reflows the\n             priority nav on every selection change. The server enforces the same rules. -->\n        <bs-priority-nav class=\"spark-query-card-actions\" [moreLabel]=\"lang.t('common.more')\" [collapseAt]=\"'sm'\">\n          @for (action of toolbarActions(); track action.name) {\n            <button *bsPriorityNavItem=\"action.priority\" type=\"button\" [class]=\"actionClass(action)\"\n                    [attr.data-action]=\"action.name\"\n                    [disabled]=\"!isEnabled(action)\" [attr.title]=\"unavailableReason(action)\" (click)=\"run(action)\">\n              @if (action.definition.icon && action.kind !== 'custom') {\n                <spark-icon [name]=\"action.definition.icon\" />\n              }\n              {{ action.definition.label | resolveTranslation }}\n            </button>\n          }\n        </bs-priority-nav>\n      }\n\n      <!-- The query search, on the trailing edge next to the actions, as Vidyano's sub-query tabs\n           have it (#460 M15, D17 addendum). The same box as the query-list page; it feeds the\n           grid's `search`, which the server applies together with the parent. Absent for bound\n           `data`, which the grid never refetches. -->\n      @if (showSearch()) {\n        <spark-search-box class=\"spark-query-card-search\" size=\"sm\" [(term)]=\"searchTerm\" />\n      }\n    </div>\n  </bs-card-header>\n\n  <div class=\"p-3\">\n    <spark-query-grid\n        [queryId]=\"queryId()\"\n        [parentId]=\"parentId()\"\n        [parentType]=\"parentType()\"\n        [reloadToken]=\"reloadToken()\"\n        [data]=\"data()\"\n        [search]=\"searchTerm()\"\n        [rowRoute]=\"rowRoute()\"\n        [selectionModeSetting]=\"selectionMode()\"\n        [deleted]=\"deleted()\"\n        [parentDeleted]=\"parentDeleted()\"\n        (error)=\"error.emit($event)\"\n        (rowClicked)=\"rowClicked.emit($event)\"\n        (customActionExecuted)=\"customActionExecuted.emit($event)\" />\n  </div>\n</bs-card>\n",
+		styles: [".spark-query-card-search{flex:0 1 14rem;min-width:8rem}@media(max-width:575.98px){.spark-query-card-header{flex-wrap:wrap}.spark-query-card-search{flex:1 1 8rem}}\n"],
 		dependencies: [
 			{
 				kind: "ngmodule",
@@ -2299,8 +2312,8 @@ i0.ɵɵngDeclareClassMetadata({
 				SparkIconComponent
 			],
 			changeDetection: ChangeDetectionStrategy.OnPush,
-			template: "<!--\n  The card is always rendered. A host that wants no card uses <spark-query-grid> directly — which\n  is what the old `showCard=\"false\"` meant, expressed as a component choice rather than a flag.\n-->\n<bs-card class=\"d-block my-3\">\n  <bs-card-header>\n    <div class=\"d-flex align-items-center gap-2\">\n      @if (iconTpl(); as tpl) {\n        <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: query() }\"></ng-container>\n      }\n\n      <!--\n        Caption first, actions on the trailing edge (#460 M15, as query-grid-card-PRD.md always said,\n        and as Vidyano's sub-query tabs do). `me-auto` on the caption pushes the actions right; a card\n        without actions looks exactly as a plain caption did.\n      -->\n      <span class=\"me-auto spark-query-card-caption\">\n        @if (captionTpl(); as tpl) {\n          <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: caption(), query: query() }\"></ng-container>\n        } @else {\n          {{ caption() }}\n        }\n      </span>\n\n      @if (actionsTpl(); as tpl) {\n        <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: customActions(), actions: toolbarActions(), selection: selection(), query: query() }\"></ng-container>\n      } @else if (toolbarActions().length) {\n        <!-- The default: New, Delete and the custom actions the server offers this caller, with the\n             overflow in the priority nav under the translated \"More\" (common.more). The nav renders only when there are any.\n\n             Disabled, not hidden: hiding makes the affordance undiscoverable and reflows the\n             priority nav on every selection change. The server enforces the same rules. -->\n        <bs-priority-nav class=\"spark-query-card-actions\" [moreLabel]=\"lang.t('common.more')\" [collapseAt]=\"'sm'\">\n          @for (action of toolbarActions(); track action.name) {\n            <button *bsPriorityNavItem=\"action.priority\" type=\"button\" [class]=\"actionClass(action)\"\n                    [attr.data-action]=\"action.name\"\n                    [disabled]=\"!isEnabled(action)\" (click)=\"run(action)\">\n              @if (action.definition.icon && action.kind !== 'custom') {\n                <spark-icon [name]=\"action.definition.icon\" />\n              }\n              {{ action.definition.label | resolveTranslation }}\n            </button>\n          }\n        </bs-priority-nav>\n      }\n\n      <!-- The query search, on the trailing edge next to the actions, as Vidyano's sub-query tabs\n           have it (#460 M15, D17 addendum). The same box as the query-list page; it feeds the\n           grid's `search`, which the server applies together with the parent. Absent for bound\n           `data`, which the grid never refetches. -->\n      @if (showSearch()) {\n        <spark-search-box class=\"spark-query-card-search\" size=\"sm\" [(term)]=\"searchTerm\" />\n      }\n    </div>\n  </bs-card-header>\n\n  <div class=\"p-3\">\n    <spark-query-grid\n        [queryId]=\"queryId()\"\n        [parentId]=\"parentId()\"\n        [parentType]=\"parentType()\"\n        [reloadToken]=\"reloadToken()\"\n        [data]=\"data()\"\n        [search]=\"searchTerm()\"\n        [rowRoute]=\"rowRoute()\"\n        [selectionModeSetting]=\"selectionMode()\"\n        [deleted]=\"deleted()\"\n        [parentDeleted]=\"parentDeleted()\"\n        (error)=\"error.emit($event)\"\n        (rowClicked)=\"rowClicked.emit($event)\"\n        (customActionExecuted)=\"customActionExecuted.emit($event)\" />\n  </div>\n</bs-card>\n",
-			styles: [".spark-query-card-search{flex:0 1 14rem;min-width:8rem}\n"]
+			template: "<!--\n  The card is always rendered. A host that wants no card uses <spark-query-grid> directly — which\n  is what the old `showCard=\"false\"` meant, expressed as a component choice rather than a flag.\n-->\n<bs-card class=\"d-block my-3\">\n  <bs-card-header>\n    <div class=\"spark-query-card-header d-flex align-items-center gap-2\">\n      @if (iconTpl(); as tpl) {\n        <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: query() }\"></ng-container>\n      }\n\n      <!--\n        Caption first, actions on the trailing edge (#460 M15, as query-grid-card-PRD.md always said,\n        and as Vidyano's sub-query tabs do). `me-auto` on the caption pushes the actions right; a card\n        without actions looks exactly as a plain caption did.\n      -->\n      <span class=\"me-auto spark-query-card-caption\">\n        @if (captionTpl(); as tpl) {\n          <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: caption(), query: query() }\"></ng-container>\n        } @else {\n          {{ caption() }}\n        }\n      </span>\n\n      @if (actionsTpl(); as tpl) {\n        <ng-container *ngTemplateOutlet=\"tpl; context: { $implicit: customActions(), actions: toolbarActions(), selection: selection(), query: query() }\"></ng-container>\n      } @else if (toolbarActions().length) {\n        <!-- The default: New, Delete and the custom actions the server offers this caller, with the\n             overflow in the priority nav under the translated \"More\" (common.more). The nav renders only when there are any.\n\n             Disabled, not hidden: hiding makes the affordance undiscoverable and reflows the\n             priority nav on every selection change. The server enforces the same rules. -->\n        <bs-priority-nav class=\"spark-query-card-actions\" [moreLabel]=\"lang.t('common.more')\" [collapseAt]=\"'sm'\">\n          @for (action of toolbarActions(); track action.name) {\n            <button *bsPriorityNavItem=\"action.priority\" type=\"button\" [class]=\"actionClass(action)\"\n                    [attr.data-action]=\"action.name\"\n                    [disabled]=\"!isEnabled(action)\" [attr.title]=\"unavailableReason(action)\" (click)=\"run(action)\">\n              @if (action.definition.icon && action.kind !== 'custom') {\n                <spark-icon [name]=\"action.definition.icon\" />\n              }\n              {{ action.definition.label | resolveTranslation }}\n            </button>\n          }\n        </bs-priority-nav>\n      }\n\n      <!-- The query search, on the trailing edge next to the actions, as Vidyano's sub-query tabs\n           have it (#460 M15, D17 addendum). The same box as the query-list page; it feeds the\n           grid's `search`, which the server applies together with the parent. Absent for bound\n           `data`, which the grid never refetches. -->\n      @if (showSearch()) {\n        <spark-search-box class=\"spark-query-card-search\" size=\"sm\" [(term)]=\"searchTerm\" />\n      }\n    </div>\n  </bs-card-header>\n\n  <div class=\"p-3\">\n    <spark-query-grid\n        [queryId]=\"queryId()\"\n        [parentId]=\"parentId()\"\n        [parentType]=\"parentType()\"\n        [reloadToken]=\"reloadToken()\"\n        [data]=\"data()\"\n        [search]=\"searchTerm()\"\n        [rowRoute]=\"rowRoute()\"\n        [selectionModeSetting]=\"selectionMode()\"\n        [deleted]=\"deleted()\"\n        [parentDeleted]=\"parentDeleted()\"\n        (error)=\"error.emit($event)\"\n        (rowClicked)=\"rowClicked.emit($event)\"\n        (customActionExecuted)=\"customActionExecuted.emit($event)\" />\n  </div>\n</bs-card>\n",
+			styles: [".spark-query-card-search{flex:0 1 14rem;min-width:8rem}@media(max-width:575.98px){.spark-query-card-header{flex-wrap:wrap}.spark-query-card-search{flex:1 1 8rem}}\n"]
 		}]
 	}],
 	propDecorators: {