@mintplayer/ng-spark 22.26.0 → 22.27.0

package/fesm2022/mintplayer-ng-spark-soft-delete.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mintplayer-ng-spark-soft-delete.mjs","names":[],"sources":["../../soft-delete/src/spark-soft-delete.service.ts","../../soft-delete/src/spark-deleted-toggle.component.ts","../../soft-delete/src/spark-soft-delete-actions.component.ts","../../soft-delete/src/provide-spark-soft-delete.ts"],"sourcesContent":["import { inject, Injectable } from '@angular/core';\nimport { PersistentObject } from '@mintplayer/ng-spark/models';\nimport { SparkService } from '@mintplayer/ng-spark/services';\n\n/**\n * Client for the SoftDelete package's endpoints (`MintPlayer.Spark.SoftDelete`, #460 T1). Ids travel\n * in the body — the route table is literal and Raven ids contain slashes.\n */\n@Injectable({ providedIn: 'root' })\nexport class SparkSoftDeleteService {\n  private readonly spark = inject(SparkService);\n\n  /**\n   * `POST /spark/po/restore` → the restored (live) object. Requires `Restore/T` and a deleted row;\n   * anything else is 404 (or 401 anonymous), a restore withheld by `OnDisableActionsAsync` is 403.\n   */\n  restore(type: string, id: string): Promise<PersistentObject> {\n    return this.spark.postEnvelope<PersistentObject>('/po/restore', { objectTypeId: type, id });\n  }\n\n  /**\n   * `POST /spark/po/purge` → 204. Requires `Purge/T` and a deleted row. Removes the document and\n   * every revision of it; it cannot be undone.\n   */\n  async purge(type: string, id: string): Promise<void> {\n    await this.spark.postEnvelope<void>('/po/purge', { objectTypeId: type, id });\n  }\n}\n","import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';\nimport { TranslateKeyPipe } from '@mintplayer/ng-spark/pipes';\nimport { SparkIconComponent } from '@mintplayer/ng-spark/icon';\nimport { SparkQueryListContext } from '@mintplayer/ng-spark/panels';\n\n/**\n * The query page's \"Deleted\" toggle (#460): switches the list into the recycle bin\n * (`deleted: only`) and back. Rendered only for holders of `ViewDeleted/T` — for anyone else the\n * server would ignore the widening anyway, so offering it would show the same rows under a\n * misleading label.\n *\n * Registered by {@link provideSparkSoftDelete} as a `SPARK_QUERY_LIST_ACTIONS` entry; usable on its\n * own in a custom page with any {@link SparkQueryListContext}.\n */\n@Component({\n  selector: 'spark-deleted-toggle',\n  imports: [TranslateKeyPipe, SparkIconComponent],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  template: `\n    @if (visible()) {\n      <button type=\"button\"\n              class=\"btn spark-deleted-toggle\"\n              [class.btn-secondary]=\"active()\"\n              [class.btn-outline-secondary]=\"!active()\"\n              [attr.aria-pressed]=\"active()\"\n              (click)=\"toggle()\">\n        <spark-icon name=\"trash\" /> {{ 'softDelete.showDeleted' | t }}\n      </button>\n    }\n  `,\n})\nexport class SparkDeletedToggleComponent {\n  context = input.required<SparkQueryListContext>();\n\n  protected readonly visible = computed(() =>\n    !!this.context().entityType && this.context().permissions?.canViewDeleted === true);\n\n  protected readonly active = computed(() => this.context().deleted === 'only');\n\n  toggle(): void {\n    this.context().setDeleted(this.active() ? 'exclude' : 'only');\n  }\n}\n","import { ChangeDetectionStrategy, Component, computed, inject, input, signal } from '@angular/core';\nimport { HttpErrorResponse } from '@angular/common/http';\nimport { ActivatedRoute, Router } from '@angular/router';\nimport { TranslateKeyPipe } from '@mintplayer/ng-spark/pipes';\nimport { SparkIconComponent } from '@mintplayer/ng-spark/icon';\nimport { SPARK_RETURN_URL_STATE_KEY, SparkLanguageService, SparkReturnNavigationService } from '@mintplayer/ng-spark/services';\nimport { SparkDetailContext } from '@mintplayer/ng-spark/panels';\nimport { SparkSoftDeleteService } from './spark-soft-delete.service';\n\n/**\n * Restore and Purge on the detail page of a row opened from the recycle bin (#460).\n *\n * Shown only when the page loaded the row with `?deleted=only` (every row in the recycle bin is\n * deleted) and the caller holds `Restore/T` / `Purge/T`. The server re-checks both — the row must be\n * deleted and the row gate must pass — so a refusal here is the 404/403 it answers, surfaced inline.\n *\n * Registered by {@link provideSparkSoftDelete} as a `SPARK_DETAIL_ACTIONS` entry.\n */\n@Component({\n  selector: 'spark-soft-delete-actions',\n  imports: [TranslateKeyPipe, SparkIconComponent],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  template: `\n    @if (deletedView()) {\n      <span class=\"d-inline-flex gap-2 align-items-center\">\n        @if (canRestore()) {\n          <button type=\"button\" class=\"btn btn-success spark-restore\" [disabled]=\"busy()\" (click)=\"restore()\">\n            {{ 'softDelete.restore' | t }}\n          </button>\n        }\n        @if (canPurge()) {\n          <button type=\"button\" class=\"btn btn-danger spark-purge\" [disabled]=\"busy()\" (click)=\"purge()\">\n            <spark-icon name=\"trash\" /> {{ 'softDelete.purge' | t }}\n          </button>\n        }\n        @if (error(); as message) {\n          <span class=\"text-danger small spark-soft-delete-error\" role=\"alert\">{{ message }}</span>\n        }\n      </span>\n    }\n  `,\n})\nexport class SparkSoftDeleteActionsComponent {\n  private readonly softDelete = inject(SparkSoftDeleteService);\n  private readonly router = inject(Router);\n  private readonly route = inject(ActivatedRoute);\n  private readonly returnNavigation = inject(SparkReturnNavigationService);\n  private readonly lang = inject(SparkLanguageService);\n\n  context = input.required<SparkDetailContext>();\n\n  protected readonly deletedView = computed(() => this.context().deleted === 'only');\n  protected readonly canRestore = computed(() => this.context().permissions?.canRestore === true);\n  protected readonly canPurge = computed(() => this.context().permissions?.canPurge === true);\n\n  protected readonly busy = signal(false);\n  protected readonly error = signal<string | null>(null);\n\n  async restore(): Promise<void> {\n    if (this.busy()) return;\n    const ctx = this.context();\n    await this.run(async () => {\n      await this.softDelete.restore(ctx.type, ctx.id);\n      // Same page, live mode: dropping `?deleted` makes the detail page re-read the row normally.\n      // The list this row was opened from travels on: a later Delete still returns there.\n      const returnUrl = this.returnNavigation.recordedReturnUrl();\n      await this.router.navigate([], {\n        relativeTo: this.route,\n        queryParams: { deleted: null },\n        queryParamsHandling: 'merge',\n        replaceUrl: true,\n        ...(returnUrl ? { state: { [SPARK_RETURN_URL_STATE_KEY]: returnUrl } } : {}),\n      });\n    });\n  }\n\n  async purge(): Promise<void> {\n    if (this.busy()) return;\n    if (!confirm(this.lang.t('softDelete.confirmPurge'))) return;\n    const ctx = this.context();\n    await this.run(async () => {\n      await this.softDelete.purge(ctx.type, ctx.id);\n      // The row no longer exists: back to the recycle bin it was opened from — the recorded list, else\n      // the type's list in `?deleted=only`. Never \"the previous page\", which may be anything.\n      await this.returnNavigation.returnToList(ctx.entityType?.name, { deletedView: true });\n    });\n  }\n\n  private async run(work: () => Promise<void>): Promise<void> {\n    this.busy.set(true);\n    this.error.set(null);\n    try {\n      await work();\n    } catch (e) {\n      const err = e as HttpErrorResponse;\n      this.error.set(err?.status === 404\n        ? this.lang.t('softDelete.unavailable')\n        : (err?.error?.error || err?.message || this.lang.t('common.actionFailed')));\n    } finally {\n      this.busy.set(false);\n    }\n  }\n}\n","import { Provider } from '@angular/core';\nimport { provideSparkDetailActions, provideSparkQueryListActions } from '@mintplayer/ng-spark/panels';\nimport { SparkDeletedToggleComponent } from './spark-deleted-toggle.component';\nimport { SparkSoftDeleteActionsComponent } from './spark-soft-delete-actions.component';\n\n/**\n * Adds the SoftDelete UI (#460) to the pages `sparkRoutes()` routes to:\n *\n * - the query page gets a **Deleted** toggle (holders of `ViewDeleted/T`) that lists the recycle bin\n *   (`?deleted=only`); its rows open with the same mode;\n * - the detail page of such a row gets **Restore** (`Restore/T`) and **Purge** (`Purge/T`).\n *\n * Needs the server package `MintPlayer.Spark.SoftDelete`. Add to the app's providers:\n * `providers: [provideSpark(...), provideSparkSoftDelete()]`.\n */\nexport function provideSparkSoftDelete(): Provider[] {\n  return [\n    ...provideSparkQueryListActions({ id: 'spark-soft-delete-toggle', component: SparkDeletedToggleComponent, priority: 55 }),\n    ...provideSparkDetailActions({ id: 'spark-soft-delete-actions', component: SparkSoftDeleteActionsComponent, priority: 4 }),\n  ];\n}\n"],"mappings":"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"}
+{"version":3,"file":"mintplayer-ng-spark-soft-delete.mjs","names":[],"sources":["../../soft-delete/src/spark-soft-delete.service.ts","../../soft-delete/src/spark-deleted-toggle.component.ts","../../soft-delete/src/spark-soft-delete-actions.component.ts","../../soft-delete/src/provide-spark-soft-delete.ts"],"sourcesContent":["import { inject, Injectable } from '@angular/core';\nimport { PersistentObject } from '@mintplayer/ng-spark/models';\nimport { SparkService } from '@mintplayer/ng-spark/services';\n\n/**\n * Client for the SoftDelete package's endpoints (`MintPlayer.Spark.SoftDelete`, #460 T1). Ids travel\n * in the body — the route table is literal and Raven ids contain slashes.\n */\n@Injectable({ providedIn: 'root' })\nexport class SparkSoftDeleteService {\n  private readonly spark = inject(SparkService);\n\n  /**\n   * `POST /spark/po/restore` → the restored (live) object. Requires `Restore/T` and a deleted row;\n   * anything else is 404 (or 401 anonymous), a restore withheld by `OnDisableActionsAsync` is 403.\n   */\n  restore(type: string, id: string): Promise<PersistentObject> {\n    return this.spark.postEnvelope<PersistentObject>('/po/restore', { objectTypeId: type, id });\n  }\n\n  /**\n   * `POST /spark/po/purge` → 204. Requires `Purge/T` and a deleted row. Removes the document and\n   * every revision of it; it cannot be undone.\n   */\n  async purge(type: string, id: string, etag: string): Promise<void> {\n    await this.spark.postEnvelope<void>('/po/purge', { objectTypeId: type, id, etag });\n  }\n}\n","import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';\nimport { TranslateKeyPipe } from '@mintplayer/ng-spark/pipes';\nimport { SparkIconComponent } from '@mintplayer/ng-spark/icon';\nimport { SparkQueryListContext } from '@mintplayer/ng-spark/panels';\n\n/**\n * The query page's \"Deleted\" toggle (#460): switches the list into the recycle bin\n * (`deleted: only`) and back. Rendered only for holders of `ViewDeleted/T` — for anyone else the\n * server would ignore the widening anyway, so offering it would show the same rows under a\n * misleading label.\n *\n * Registered by {@link provideSparkSoftDelete} as a `SPARK_QUERY_LIST_ACTIONS` entry; usable on its\n * own in a custom page with any {@link SparkQueryListContext}.\n */\n@Component({\n  selector: 'spark-deleted-toggle',\n  imports: [TranslateKeyPipe, SparkIconComponent],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  template: `\n    @if (visible()) {\n      <button type=\"button\"\n              class=\"btn spark-deleted-toggle\"\n              [class.btn-secondary]=\"active()\"\n              [class.btn-outline-secondary]=\"!active()\"\n              [attr.aria-pressed]=\"active()\"\n              (click)=\"toggle()\">\n        <spark-icon name=\"trash\" /> {{ 'softDelete.showDeleted' | t }}\n      </button>\n    }\n  `,\n})\nexport class SparkDeletedToggleComponent {\n  context = input.required<SparkQueryListContext>();\n\n  protected readonly visible = computed(() =>\n    !!this.context().entityType && this.context().permissions?.canViewDeleted === true);\n\n  protected readonly active = computed(() => this.context().deleted === 'only');\n\n  toggle(): void {\n    this.context().setDeleted(this.active() ? 'exclude' : 'only');\n  }\n}\n","import { ChangeDetectionStrategy, Component, computed, inject, input, signal } from '@angular/core';\nimport { HttpErrorResponse } from '@angular/common/http';\nimport { ActivatedRoute, Router } from '@angular/router';\nimport { TranslateKeyPipe } from '@mintplayer/ng-spark/pipes';\nimport { SparkIconComponent } from '@mintplayer/ng-spark/icon';\nimport { SPARK_RETURN_URL_STATE_KEY, SparkLanguageService, SparkReturnNavigationService } from '@mintplayer/ng-spark/services';\nimport { SparkDetailContext } from '@mintplayer/ng-spark/panels';\nimport { SparkSoftDeleteService } from './spark-soft-delete.service';\n\n/**\n * Restore and Purge on the detail page of a row opened from the recycle bin (#460).\n *\n * Shown only when the page loaded the row with `?deleted=only` (every row in the recycle bin is\n * deleted) and the caller holds `Restore/T` / `Purge/T`. The server re-checks both — the row must be\n * deleted and the row gate must pass — so a refusal here is the 404/403 it answers, surfaced inline.\n *\n * Registered by {@link provideSparkSoftDelete} as a `SPARK_DETAIL_ACTIONS` entry.\n */\n@Component({\n  selector: 'spark-soft-delete-actions',\n  imports: [TranslateKeyPipe, SparkIconComponent],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  template: `\n    @if (deletedView()) {\n      <span class=\"d-inline-flex gap-2 align-items-center\">\n        @if (canRestore()) {\n          <button type=\"button\" class=\"btn btn-success spark-restore\" [disabled]=\"busy()\" (click)=\"restore()\">\n            {{ 'softDelete.restore' | t }}\n          </button>\n        }\n        @if (canPurge()) {\n          <button type=\"button\" class=\"btn btn-danger spark-purge\" [disabled]=\"busy()\" (click)=\"purge()\">\n            <spark-icon name=\"trash\" /> {{ 'softDelete.purge' | t }}\n          </button>\n        }\n        @if (error(); as message) {\n          <span class=\"text-danger small spark-soft-delete-error\" role=\"alert\">{{ message }}</span>\n        }\n      </span>\n    }\n  `,\n})\nexport class SparkSoftDeleteActionsComponent {\n  private readonly softDelete = inject(SparkSoftDeleteService);\n  private readonly router = inject(Router);\n  private readonly route = inject(ActivatedRoute);\n  private readonly returnNavigation = inject(SparkReturnNavigationService);\n  private readonly lang = inject(SparkLanguageService);\n\n  context = input.required<SparkDetailContext>();\n\n  protected readonly deletedView = computed(() => this.context().deleted === 'only');\n  protected readonly canRestore = computed(() => this.context().permissions?.canRestore === true);\n  protected readonly canPurge = computed(() => this.context().permissions?.canPurge === true);\n\n  protected readonly busy = signal(false);\n  protected readonly error = signal<string | null>(null);\n\n  async restore(): Promise<void> {\n    if (this.busy()) return;\n    const ctx = this.context();\n    await this.run(async () => {\n      await this.softDelete.restore(ctx.type, ctx.id);\n      // Same page, live mode: dropping `?deleted` makes the detail page re-read the row normally.\n      // The list this row was opened from travels on: a later Delete still returns there.\n      const returnUrl = this.returnNavigation.recordedReturnUrl();\n      await this.router.navigate([], {\n        relativeTo: this.route,\n        queryParams: { deleted: null },\n        queryParamsHandling: 'merge',\n        replaceUrl: true,\n        ...(returnUrl ? { state: { [SPARK_RETURN_URL_STATE_KEY]: returnUrl } } : {}),\n      });\n    });\n  }\n\n  async purge(): Promise<void> {\n    if (this.busy()) return;\n    if (!confirm(this.lang.t('softDelete.confirmPurge'))) return;\n    const ctx = this.context();\n    await this.run(async () => {\n      await this.softDelete.purge(ctx.type, ctx.id, ctx.item.etag ?? '');\n      // The row no longer exists: back to the recycle bin it was opened from — the recorded list, else\n      // the type's list in `?deleted=only`. Never \"the previous page\", which may be anything.\n      await this.returnNavigation.returnToList(ctx.entityType?.name, { deletedView: true });\n    });\n  }\n\n  private async run(work: () => Promise<void>): Promise<void> {\n    this.busy.set(true);\n    this.error.set(null);\n    try {\n      await work();\n    } catch (e) {\n      const err = e as HttpErrorResponse;\n      this.error.set(err?.status === 404\n        ? this.lang.t('softDelete.unavailable')\n        : (err?.error?.error || err?.message || this.lang.t('common.actionFailed')));\n    } finally {\n      this.busy.set(false);\n    }\n  }\n}\n","import { Provider } from '@angular/core';\nimport { provideSparkDetailActions, provideSparkQueryListActions } from '@mintplayer/ng-spark/panels';\nimport { SparkDeletedToggleComponent } from './spark-deleted-toggle.component';\nimport { SparkSoftDeleteActionsComponent } from './spark-soft-delete-actions.component';\n\n/**\n * Adds the SoftDelete UI (#460) to the pages `sparkRoutes()` routes to:\n *\n * - the query page gets a **Deleted** toggle (holders of `ViewDeleted/T`) that lists the recycle bin\n *   (`?deleted=only`); its rows open with the same mode;\n * - the detail page of such a row gets **Restore** (`Restore/T`) and **Purge** (`Purge/T`).\n *\n * Needs the server package `MintPlayer.Spark.SoftDelete`. Add to the app's providers:\n * `providers: [provideSpark(...), provideSparkSoftDelete()]`.\n */\nexport function provideSparkSoftDelete(): Provider[] {\n  return [\n    ...provideSparkQueryListActions({ id: 'spark-soft-delete-toggle', component: SparkDeletedToggleComponent, priority: 55 }),\n    ...provideSparkDetailActions({ id: 'spark-soft-delete-actions', component: SparkSoftDeleteActionsComponent, priority: 4 }),\n  ];\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mintplayer/ng-spark",
   "private": false,
-  "version": "22.26.0",
+  "version": "22.27.0",
   "description": "Angular component library for MintPlayer.Spark CRUD applications",
   "repository": {
     "type": "git",
@@ -14,8 +14,8 @@
     "@angular/common": "^22.0.0",
     "@angular/router": "^22.0.0",
     "@angular/forms": "^22.0.0",
-    "@mintplayer/ng-bootstrap": "^22.20.0",
-    "@mintplayer/web-components": "^2.17.0",
+    "@mintplayer/ng-bootstrap": "^22.21.0",
+    "@mintplayer/web-components": "^2.18.0",
     "@mintplayer/pagination": "*",
     "rxjs": "~7.8.0"
   },

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

@@ -200,21 +200,21 @@ export declare class SparkQueryActionsContext {
   query: SparkQuery | null;
 }
 /**
- * One button of a query's toolbar (#460, M15): the built-in New or Delete, or a custom action.
+ * One button of a query's toolbar (#460 M15, #467 R3): the built-in New, Edit or Delete, or a custom action.
  *
  * Built by `SparkQueryGridComponent.toolbarActions()` and rendered by every host of the grid — the
  * query card's header and the query-list page's action bar — so both surfaces offer the same
  * actions, enabled by the same rules.
  */
 export interface SparkQueryToolbarAction {
-  kind: 'new' | 'delete' | 'custom' | 'addon';
+  kind: 'new' | 'edit' | 'delete' | 'custom' | 'addon';
   /** For `addon` (row menu only): the add-on's entry (`SPARK_QUERY_ROW_ACTIONS`). */
   addon?: SparkQueryRowAction;
   /** The action's name, unique within the toolbar. */
   name: string;
   /** Its catalogue entry: label, icon, `selectionRule`, `variant`, confirmation. */
   definition: CustomActionDefinition;
-  /** `*bsPriorityNavItem` priority: New first, then Delete, then custom actions by offset. */
+  /** `*bsPriorityNavItem` priority: New first, then Edit, then Delete, then custom actions by offset. */
   priority: number;
 }
 /**
@@ -357,14 +357,13 @@ export declare class SparkQueryGridComponent {
   }>;
   /**
    * A click anywhere on a row opens it, like its first-column link — the link used to be the only
-   * target, so a row whose first column was empty ("—") could not be opened at all. While rows are
-   * selectable a click selects instead, and a double-click opens. Clicks on the link itself or on an
-   * interactive element inside the row (a vote button, a checkbox) are theirs, not the row's; a
-   * modified click (Ctrl, ⌘, Shift, middle) is left to the browser.
+   * target, so a row whose first column was empty ("—") could not be opened at all. This holds on
+   * every list, selectable or not (#467, D9): only the checkbox cell selects, which the datatable's
+   * `'checkbox'` mode guarantees. Clicks on the link itself or on an interactive element inside the
+   * row (a vote button, a checkbox) are theirs, not the row's; a modified click (Ctrl, ⌘, Shift,
+   * middle) is left to the browser.
    */
   protected onRowClick(event: BsDatatableRowEvent<unknown>): void;
-  protected onRowDblClick(event: BsDatatableRowEvent<unknown>): void;
-  private openRow;
   /**
    * Paging and sorting. Two-way, so a host driving `data` can sort those rows by whatever the
    * user actually clicked — the datatable writes the new sort back through here.
@@ -449,45 +448,60 @@ export declare class SparkQueryGridComponent {
    */
   errorMessage: import("@angular/core").WritableSignal<string | null>;
   /**
-   * The rendered selection mode (#460, D17): the host's override (a sub-query entry's
-   * `selectionMode`), else the query's own, else `'auto'` — derived from the CUSTOM actions offered,
-   * exactly as before the setting existed, so no existing grid changes behaviour. The default Delete
-   * does not widen `'auto'`: selection is opt-in, and without it Delete stays reachable per row
-   * through the row menu.
+   * The built-in actions this result offers (#467, R1(1–3)), each with its toolbar kind: listed for
+   * the caller (the right), on the query side (`defaultQueryActions` already filtered `showedOn`),
+   * not withheld by this result's `disabledActions` — Edit also not when `Save` is — and nothing in
+   * the recycle bin. New additionally needs the type's create right ({@link offersCreate}).
+   */
+  readonly offeredDefaultActions: import("@angular/core").Signal<SparkQueryToolbarAction[]>;
+  /**
+   * The rendered selection mode (#467, R1): the host's override (a sub-query entry's
+   * `selectionMode`), else the query's own, else `'auto'` — derived from the EFFECTIVE action list
+   * (built-ins and custom actions alike), so a list is selectable exactly when the caller can use an
+   * action on ticked rows here. Recomputed whenever `disabledActions` or the deleted mode changes;
+   * the selection is cleared when the mode becomes `'none'`.
    */
   selectionMode: import("@angular/core").Signal<import("@mintplayer/ng-spark/models").SparkSelectionMode>;
   /**
-   * The actions a host renders in its toolbar, in one list (#460, M15): New, Delete and the custom
-   * actions, each with the rule that enables it. The query card and the query-list page render this
-   * same list, so the two surfaces cannot drift.
+   * The actions a host renders in its toolbar, in one list (#460 M15, #467 R3): New, Edit, Delete and
+   * the custom actions, each with the rule that enables it. The query card and the query-list page
+   * render this same list, so the two surfaces cannot drift. The same effective list decides
+   * {@link selectionMode}.
    *
-   * - New: the default entry's `showedOn` includes the query, the caller holds `New/T`, and the
-   *   result does not withhold `New`/`Save`.
-   * - Delete: likewise with `Delete/T` and `Delete`, and only while rows can be selected (otherwise
-   *   it could never be enabled — the row menu offers it per row instead).
+   * - New, Edit, Delete: {@link offeredDefaultActions}. Edit and Delete act on ticked rows, so a list
+   *   declared `'none'` leaves them to the row menu, where they would otherwise never be enabled.
    * - Custom: `visibleCustomActions()`.
-   * - In the recycle bin ({@link recycleBin}) none of the three: the list is empty.
+   * - In the recycle bin ({@link recycleBin}) none: the list is empty.
    */
   toolbarActions: import("@angular/core").Signal<SparkQueryToolbarAction[]>;
   /**
-   * The per-row `⋮` menu: every offered action whose rule accepts exactly one row — Delete included,
-   * whatever the selection mode. An action without a rule acts on the query, not on a row, and is
-   * left to the toolbar.
+   * The per-row `⋮` menu: every offered action whose rule accepts exactly one row — Edit and Delete
+   * included, whatever the selection mode. An action without a rule acts on the query, not on a row,
+   * and is left to the toolbar.
    */
   rowActions: import("@angular/core").Signal<SparkQueryToolbarAction[]>;
   /** What an add-on row action is asked whether it is offered; null until the type resolved. */
   private readonly rowActionScope;
-  /** The default Delete: not withheld by the result, and never in the recycle bin. */
-  private offersDelete;
   /** Whether a toolbar action can run with the current selection. The server checks again. */
   isToolbarActionEnabled(action: SparkQueryToolbarAction): boolean;
   /** Runs a toolbar action on the current selection. */
   runToolbarAction(action: SparkQueryToolbarAction): Promise<void>;
   /**
-   * The chip's ⊗, offered only for single selection: there the datatable renders no checkbox
-   * column, so it has no header deselect-all, and a row click never deselects.
+   * The built-in Edit (#467, R2): it only navigates, to the row's edit page with this list as the
+   * return state. Get and Update enforce everything (row gate, `can`, etag, write shield); the `=1`
+   * rule is client-side only, since there is no bulk edit.
    */
+  editRow(row: QueryResultItem | undefined): void;
+  /** The chip's ⊗: drops the whole selection, ticked rows on other pages included. */
   clearSelection(): void;
+  /** The ids of the rows on the page currently shown; the chip counts the ticked rows outside it. */
+  private readonly loadedIds;
+  /**
+   * Ticked rows that are not on the page shown (#467, D19): the selection survives paging, so the
+   * chip says how many of the rows an action will act on cannot be seen ("7 selected, 4 on other
+   * pages"). Actions always receive the whole `selection()`, which is what the chip counts.
+   */
+  readonly offPageCount: import("@angular/core").Signal<number>;
   /** The id of the row whose `⋮` menu is open; at most one is. */
   readonly openRowMenu: import("@angular/core").WritableSignal<string | null>;
   /** Below the toggle, right-aligned; above it when there is no room below. */
@@ -520,10 +534,11 @@ export declare class SparkQueryGridComponent {
    */
   startNew(): void;
   /**
-   * The default Delete on `ids`: one request, all rows or none (#460, D18). Asks first — with the
-   * entry's `confirmationMessageKey` — then clears the selection and refreshes.
+   * The default Delete on `rows`: one request, all rows or none (#460, D18). Asks first — with the
+   * entry's `confirmation` (`{count}` substituted) — then clears the selection and refreshes. Each row
+   * goes with the `etag` it was listed with (#467, D14), so a row changed since is refused, not lost.
    */
-  deleteRows(ids: string[], definition?: CustomActionDefinition): Promise<void>;
+  deleteRows(rows: QueryResultItem[], definition?: CustomActionDefinition): Promise<void>;
   isVirtualScrolling: import("@angular/core").Signal<boolean>;
   /**
    * Columns as sent with the most recent fetched page.

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

@@ -128,51 +128,71 @@ export interface PersistentObjectAttribute {
    */
   asDetailType?: string;
 }
+/**
+ * One action of the composed catalogue (#467, D7), as `/spark/actions/list` reports it for a type:
+ * a built-in (New, Edit, Delete) or a custom action, already narrowed to what the caller may run.
+ * Text arrives resolved by the server (D26).
+ */
 export interface CustomActionDefinition {
   name: string;
-  displayName: TranslatedString;
+  /** `actions.{name}.label`, or the humanized name when untranslated. */
+  label: TranslatedString;
   icon?: string;
-  description?: string;
+  /** `actions.{name}.description`; absent when untranslated. */
+  description?: TranslatedString;
   showedOn: string;
   selectionRule?: string;
   refreshOnCompleted: boolean;
-  confirmationMessageKey?: string;
+  /**
+   * The confirmation to ask before running, `actions.{name}.confirmation` or the explicit key the
+   * catalogue names. May contain `{count}`, the number of rows about to be acted on. Absent: no prompt.
+   */
+  confirmation?: TranslatedString;
   /**
    * How prominently, and how warily, to present the action: 'primary', 'secondary', 'danger',
    * 'warning'. Undefined renders the neutral default.
    *
    * Presentation only — the server decides who may see and run an action. A 'danger' variant just
-   * asks the button to look like what it does; pair it with `confirmationMessageKey` for anything
+   * asks the button to look like what it does; pair it with a `confirmation` for anything
    * irreversible, because the colour warns and the prompt is what actually prevents the accident.
    */
   variant?: string;
   offset: number;
   /**
-   * True for the framework's built-in `New` and `Delete` (#460, D18): catalogue entries with a
-   * `showedOn` and a `selectionRule` like any custom action (defaults: New has no rule, Delete is
-   * `>0`; an app overrides them in `customActions.json`), but run through `/po/new` and
-   * `/po/delete-many`, never `/actions/execute`. Absent for a custom action.
+   * True for the framework's built-in `New`, `Edit` and `Delete` (#460 D18, #467 D7): catalogue
+   * entries with a `showedOn` and a `selectionRule` like any custom action (the core's
+   * `actions.json` ships them; an app overrides or removes them in its own), but run through
+   * `/po/new`, the edit page and `/po/delete-many`, never `/actions/execute`. Absent for a custom action.
    */
   isDefault?: boolean;
 }
-/** How many rows a grid lets the user select — what `<bs-datatable>` renders. */
-export type SparkSelectionMode = 'none' | 'single' | 'multiple';
 /**
- * What a query definition (or a sub-query entry) declares (#460, D17): a fixed mode, or `'auto'` —
+ * Whether a grid lets the user tick rows — what `<bs-datatable>` renders. There is no single
+ * selection (#467, D10): a selectable list is a checkbox list, and actions whose rule does not
+ * match the count are disabled rather than the selection trimmed.
+ */
+export type SparkSelectionMode = 'none' | 'multiple';
+/**
+ * What a query definition (or a sub-query entry) declares (#460 D17): a fixed mode, or `'auto'` —
  * the default, and what an absent field means — to derive it from the actions offered.
  */
 export type SparkSelectionModeSetting = 'auto' | SparkSelectionMode;
+/** The largest selection the server accepts in one request (`SparkDefaultActions.MaxSelectedItems`). */
+export declare const SPARK_MAX_SELECTED_ITEMS = 200;
 /**
- * The selection mode a grid renders.
- *
- * A declared `'none'`, `'single'` or `'multiple'` wins outright. `'auto'` (or nothing) derives it,
- * so a grid gains a checkbox column exactly when an action needs one and is otherwise
- * pixel-identical to a grid with no selection at all — as Vidyano's query grid does. The offered
- * actions include the default Delete (`>0`) when the caller may delete, so such a grid is
- * multi-select.
+ * Whether an action needs ticked rows (#467, R1(4)): it has a rule, and the rule accepts at least
+ * one row. `=0` accepts none, so an action that runs only without a selection never makes a list
+ * selectable; an action without a rule acts on the query, not on rows.
+ */
+export declare function needsSelection(action: CustomActionDefinition): boolean;
+/**
+ * The selection mode a grid renders (#467, R1).
  *
- * Derived: `'single'` when every gated action is satisfied by one row and refused by two; anything
- * else that cares about the count gets `'multiple'`.
+ * A declared `'none'` or `'multiple'` wins outright. `'auto'` (or nothing) derives it from
+ * `actions`, which must already be the **effective** list for this result — listed for the caller
+ * (the right), shown on queries, not withheld by `disabledActions` and not hidden by the recycle
+ * bin. Built-in Edit and Delete count like any other action. `'multiple'` when at least one of them
+ * {@link needsSelection}, else `'none'`, so a read-only user sees a list with no checkbox column.
  */
 export declare function selectionModeFor(actions: CustomActionDefinition[], declared?: SparkSelectionModeSetting | null): SparkSelectionMode;
 /**
@@ -293,7 +313,8 @@ export interface AttributeGroup {
 export interface EntityType {
   id: string;
   name: string;
-  description?: TranslatedString;
+  /** The type's display name, resolved by the server (#467, D6; formerly `description`). */
+  label?: TranslatedString;
   /**
    * The backing CLR type, or absent for a JSON-only virtual type (#325).
    *
@@ -369,7 +390,8 @@ export interface SparkQuerySortColumn {
 export interface SparkQuery {
   id: string;
   name: string;
-  description?: TranslatedString;
+  /** The query's display name, resolved by the server (#467; formerly `description`). */
+  label?: TranslatedString;
   source: string;
   alias?: string;
   sortColumns: SparkQuerySortColumn[];
@@ -479,14 +501,20 @@ export interface QueryColumn extends SparkCellColumn {
 /**
  * One row: an id, a display string, and a value per column.
  *
- * Deliberately too weak to act on — no attribute metadata, no `can` block, no etag, because none
- * of those can be trusted from a projection.
+ * Deliberately too weak to act on — no attribute metadata, no `can` block, because neither can be
+ * trusted from a projection. It does carry its document's `etag` (#467, D14), a version rather than
+ * a judgement, so a delete from the list says which version it removes.
  */
 export interface QueryResultItem {
   /** Never null and unique within a result; the server refuses anything else. */
   id: string;
   /** What to show when the row is named rather than tabulated (a reference picker's value). */
   breadcrumb?: string;
+  /**
+   * The document's change vector when the list loaded (#467, D14). A delete sends it back; a row
+   * changed since is a 409. Absent for a row with no document behind it.
+   */
+  etag?: string;
   values: QueryResultItemValue[];
   /** Presentation hints for the whole row. Keys arrive lower-cased. */
   typeHints?: Record<string, string>;
@@ -926,6 +954,13 @@ export declare function comparableValue(attribute: PersistentObjectAttribute | u
 export declare function comparableFormValue(value: unknown): string;
 /** Whether two form-dict values hold the same content (see {@link comparableFormValue}). */
 export declare function formValuesEqual(a: unknown, b: unknown): boolean;
+/**
+ * The prompt to show before running `action` on `count` rows, with `{count}` substituted, or null
+ * when the action asks for no confirmation (#467, D7).
+ */
+export declare function confirmationText(action: CustomActionDefinition | undefined | null, count: number, lang?: string): string | null;
+/** The built-in action named `name` (`New`, `Edit`, `Delete`) in `actions`, when the server listed it. */
+export declare function builtInAction(actions: CustomActionDefinition[], name: 'New' | 'Edit' | 'Delete'): CustomActionDefinition | undefined;
 /** Whether `showedOn` offers the action on a query: `"query"` or `"both"`, in any casing. */
 export declare function isShowedOnQuery(showedOn: string | undefined | null): boolean;
 /** Whether `showedOn` offers the action on a detail page: `"detail"` or `"both"`, in any casing. */
@@ -937,7 +972,7 @@ export declare function isShowedOnDetail(showedOn: string | undefined | null): b
  * and `"both"` — as the server model and the custom-actions guide have always
  * documented — compared case-insensitively (#460 M15: `"Both"` used to render nowhere).
  *
- * The built-in New and Delete (`isDefault`, #460 D18) are left out: they are not executed as
+ * The built-in New, Edit and Delete (`isDefault`, #460 D18, #467 D7) are left out: they are not executed as
  * custom actions, and the grid offers them itself (see {@link defaultQueryActions}).
  *
  * ⚠️ This narrows what is DISPLAYED. It is NOT an authorization boundary: the grant
@@ -948,8 +983,8 @@ export declare function filterQueryActions(actions: CustomActionDefinition[]): C
 /** The custom actions a detail page should offer — the detail-side counterpart of {@link filterQueryActions}. */
 export declare function filterDetailActions(actions: CustomActionDefinition[]): CustomActionDefinition[];
 /**
- * The built-in New and Delete the server listed for this caller (#460, D18), when their `showedOn`
- * includes the query side. Present only when the caller holds `New/T` or `Delete/T`.
+ * The built-in New, Edit and Delete the server listed for this caller (#460 D18, #467 D7), when their `showedOn`
+ * includes the query side. Present only when the caller holds `New/T`, `Edit/T` or `Delete/T`.
  */
 export declare function defaultQueryActions(actions: CustomActionDefinition[]): CustomActionDefinition[];
 /**

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

@@ -60,8 +60,12 @@ export declare class SparkPoDetailComponent {
   asDetailReferenceOptions: import("@angular/core").WritableSignal<Record<string, Record<string, QueryResultItem[]>>>;
   type: string;
   id: string;
-  canEdit: import("@angular/core").WritableSignal<boolean>;
-  canDelete: import("@angular/core").WritableSignal<boolean>;
+  /** The catalogue's Edit (#467, D8) when this page offers it: listed for the caller, on the detail side, and allowed on this row. */
+  editAction: import("@angular/core").WritableSignal<CustomActionDefinition | null>;
+  /** The catalogue's Delete, on the same terms as {@link editAction}. */
+  deleteAction: import("@angular/core").WritableSignal<CustomActionDefinition | null>;
+  canEdit: import("@angular/core").Signal<boolean>;
+  canDelete: import("@angular/core").Signal<boolean>;
   customActions: import("@angular/core").WritableSignal<CustomActionDefinition[]>;
   /** Type-level rights, kept for the add-on context; null until loaded. */
   permissions: import("@angular/core").WritableSignal<EntityPermissions | null>;
@@ -125,6 +129,8 @@ export declare class SparkPoDetailComponent {
    * a louder style. Restricted to a known set rather than interpolated, because the value arrives
    * from a JSON file and must not be able to put arbitrary classes on the button.
    */
+  /** Edit's and Delete's button classes: the catalogue's variant, else the look they always had. */
+  protected builtInActionClass(action: CustomActionDefinition, fallback: 'primary' | 'danger'): string;
   protected customActionClass(action: CustomActionDefinition): string;
   /**
    * The action currently running, or null. Drives the disabled state on every custom-action

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

@@ -3,7 +3,7 @@ import { TemplateRef } from "@angular/core";
 import { Color } from "@mintplayer/ng-bootstrap";
 import { SparkLanguageService } from "@mintplayer/ng-spark/services";
 import { SparkQueryToolbarAction } from "@mintplayer/ng-spark/grid";
-import { CustomActionDefinition, QueryColumn, QueryColumnFilter, QueryResultItem, SparkDeletedFilter } from "@mintplayer/ng-spark/models";
+import { CustomActionDefinition, QueryColumn, QueryColumnFilter, QueryResultItem, SparkDeletedFilter, SparkSelectionModeSetting } from "@mintplayer/ng-spark/models";
 import { SparkQueryListContext } from "@mintplayer/ng-spark/panels";
 /**
  * The routed query page: chrome around one {@link SparkQueryGridComponent}.
@@ -31,6 +31,11 @@ export declare class SparkQueryListComponent {
   protected readonly lang: SparkLanguageService;
   extraActionsTemplate: import("@angular/core").InputSignal<TemplateRef<void> | null>;
   showCustomActions: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Overrides the query's own `selectionMode` (#467, R3), as the sub-query card's input does: for a
+   * host that embeds this page and wants, say, `'none'` on a list the actions would make selectable.
+   */
+  selectionMode: import("@angular/core").InputSignal<SparkSelectionModeSetting | null>;
   /**
    * Forwarded to the grid, so a query PAGE can replace its row links — the same reason the card
    * forwards it. Without this the escape hatch existed only for a directly-embedded grid.
@@ -147,6 +152,11 @@ export declare class SparkQueryListComponent {
       "required": false;
       "isSignal": true;
     };
+    "selectionMode": {
+      "alias": "selectionMode";
+      "required": false;
+      "isSignal": true;
+    };
     "rowRoute": {
       "alias": "rowRoute";
       "required": false;

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

@@ -62,11 +62,22 @@ export interface NewObjectOptions {
 }
 /** Where a bulk delete was started from; see {@link SparkService.deleteMany}. */
 export interface DeleteManyOptions {
-  /** The query the rows were selected in, for the server's `OnDisableActionsAsync`. */
-  queryId?: string;
+  /**
+   * The query the rows were selected in. Required (#467, D12): the server fetches the rows through it
+   * and applies its `OnDisableActionsAsync` decision; without it the call is a 400.
+   */
+  queryId: string;
   /** The sub-query's container, when deleting from a sub-query. */
   parentId?: string;
   parentType?: string;
+  /** One reason for the whole batch, recorded on every soft-deleted row (#467, D20). */
+  reason?: string;
+}
+/** A row and the version of it the caller saw (#467, D14): what a bulk delete names. */
+export interface SparkRowVersion {
+  id: string;
+  /** The row's `etag` from the query result. */
+  etag: string;
 }
 /** Context for {@link SparkService.deleteRow}. Every field is required — see `DeleteRow.cs`. */
 export interface DeleteRowOptions {
@@ -155,12 +166,20 @@ export declare class SparkService {
    * `parent` is the sub-query the New was started from — the same `parentId`/`parentType`/`queryId`
    * `newObject` was given. The server resolves and authorizes it again and hands it to the save hooks
    * as `PersistentObject.Parent`.
+   *
+   * Resolves to `null` when a server interceptor cancelled the create (#482: the user answered a prompt with
+   * Cancel) — the server answers 204 and nothing was created.
    */
   create(type: string, data: Partial<PersistentObject>, parent?: {
     parentId: string;
     parentType: string;
     queryId: string;
-  }): Promise<PersistentObject>;
+  }): Promise<PersistentObject | null>;
+  /**
+   * Saves an edit. `data.etag` — the etag the object was loaded with — is required (#467, D16): it is
+   * the version being edited. A 409 means the object changed since (`reason: 'changed'`) or was
+   * deleted since (`reason: 'deleted'`).
+   */
   update(type: string, id: string, data: Partial<PersistentObject>): Promise<PersistentObject>;
   /**
    * Asks the server to reshape an in-progress object after `triggeredBy`'s value changed.
@@ -199,14 +218,20 @@ export declare class SparkService {
    * of the route variables.
    */
   deleteRow(type: string, options: DeleteRowOptions): Promise<void>;
-  delete(type: string, id: string): Promise<void>;
+  /**
+   * Deletes one object. `etag` is the version being deleted — the loaded object's `etag` — and is
+   * required (#467, D14): an object changed since is a 409.
+   */
+  delete(type: string, id: string, etag: string): Promise<void>;
   /**
    * Deletes several rows of one type in one request — the default Delete action on a selection
-   * (`POST /spark/po/delete-many`, #460 D18). All or nothing: a 404 means some row is missing or not
-   * yours to delete, a 403 that the server's `OnDisableActionsAsync` withholds Delete on the query or
-   * on one of the rows, a 400 that the selection breaks the rule or the 200-row cap.
+   * (`POST /spark/po/delete-many`, #460 D18). Each row carries the `etag` its query result row had
+   * (#467, D14). All or nothing: a 404 means some row is missing or not yours to delete, a 403 that
+   * the server's `OnDisableActionsAsync` withholds Delete on the query or on one of the rows, a 409
+   * that rows changed since the list loaded (the body's `message` names them), a 400 that the
+   * selection breaks the rule or the 200-row cap.
    */
-  deleteMany(type: string, ids: string[], options?: DeleteManyOptions): Promise<void>;
+  deleteMany(type: string, items: SparkRowVersion[], options: DeleteManyOptions): Promise<void>;
   getCustomActions(objectTypeId: string): Promise<CustomActionDefinition[]>;
   /**
    * @param parent The object of THIS type the action is operating on — the detail-page invocation.

package/types/mintplayer-ng-spark-soft-delete.d.ts

@@ -17,7 +17,7 @@ export declare class SparkSoftDeleteService {
    * `POST /spark/po/purge` → 204. Requires `Purge/T` and a deleted row. Removes the document and
    * every revision of it; it cannot be undone.
    */
-  purge(type: string, id: string): Promise<void>;
+  purge(type: string, id: string, etag: string): Promise<void>;
   static ɵfac: i0.ɵɵFactoryDeclaration<SparkSoftDeleteService, never>;
   static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }