@mintplayer/ng-spark 22.23.0 → 22.25.0

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

@@ -1,11 +1,11 @@
-import * as _angular_core from '@angular/core';
-import { TemplateRef } from '@angular/core';
-import { BsShellState } from '@mintplayer/ng-bootstrap/shell';
-import { Breakpoint } from '@mintplayer/ng-bootstrap';
-import { ShellStateChangeEventDetail } from '@mintplayer/web-components/shell';
-import { ProgramUnitGroup } from '@mintplayer/ng-spark/models';
-import { SparkLanguageService } from '@mintplayer/ng-spark/services';
-
+import * as i0 from "@angular/core";
+import { TemplateRef } from "@angular/core";
+import { BsShellState } from "@mintplayer/ng-bootstrap/shell";
+import { BsThemeService, BsThemeToggleMode } from "@mintplayer/ng-bootstrap/theming";
+import { Breakpoint } from "@mintplayer/ng-bootstrap";
+import { ShellStateChangeEventDetail } from "@mintplayer/web-components/shell";
+import { ProgramUnitGroup } from "@mintplayer/ng-spark/models";
+import { SparkLanguageService } from "@mintplayer/ng-spark/services";
 /**
  * Region slots for `<spark-shell>`.
  *
@@ -35,20 +35,20 @@ import { SparkLanguageService } from '@mintplayer/ng-spark/services';
  * ```
  */
 /** Topbar, leading edge. Default: a `bs-navbar-toggler` mirroring the shell's open state. */
-declare class SparkShellTopbarStartDirective {
-    readonly templateRef: TemplateRef<unknown>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkShellTopbarStartDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SparkShellTopbarStartDirective, "[sparkShellTopbarStart]", never, {}, {}, never, never, true, never>;
+export declare class SparkShellTopbarStartDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkShellTopbarStartDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SparkShellTopbarStartDirective, "[sparkShellTopbarStart]", never, {}, {}, never, never, true, never>;
 }
 /**
  * Topbar, trailing edge. Default: the language selector (which hides itself when the app has
  * one language). This is where an auth bar goes — the shell cannot ship one itself, since
  * `@mintplayer/ng-spark` does not (and must not) depend on `@mintplayer/ng-spark-auth`.
  */
-declare class SparkShellTopbarEndDirective {
-    readonly templateRef: TemplateRef<unknown>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkShellTopbarEndDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SparkShellTopbarEndDirective, "[sparkShellTopbarEnd]", never, {}, {}, never, never, true, never>;
+export declare class SparkShellTopbarEndDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkShellTopbarEndDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SparkShellTopbarEndDirective, "[sparkShellTopbarEnd]", never, {}, {}, never, never, true, never>;
 }
 /**
  * Topbar, trailing edge, **beside** the default chrome rather than instead of it — rendered before
@@ -72,22 +72,22 @@ declare class SparkShellTopbarEndDirective {
  * Supplying both slots is allowed and does what it says: `topbarEnd` replaces the default chrome,
  * and these actions still render ahead of whatever it put there.
  */
-declare class SparkShellTopbarActionsDirective {
-    readonly templateRef: TemplateRef<unknown>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkShellTopbarActionsDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SparkShellTopbarActionsDirective, "[sparkShellTopbarActions]", never, {}, {}, never, never, true, never>;
+export declare class SparkShellTopbarActionsDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkShellTopbarActionsDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SparkShellTopbarActionsDirective, "[sparkShellTopbarActions]", never, {}, {}, never, never, true, never>;
 }
 /** Sidebar, above everything. Default: `<h5>{{ title }}</h5>`. */
-declare class SparkShellSidebarHeaderDirective {
-    readonly templateRef: TemplateRef<unknown>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkShellSidebarHeaderDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SparkShellSidebarHeaderDirective, "[sparkShellSidebarHeader]", never, {}, {}, never, never, true, never>;
+export declare class SparkShellSidebarHeaderDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkShellSidebarHeaderDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SparkShellSidebarHeaderDirective, "[sparkShellSidebarHeader]", never, {}, {}, never, never, true, never>;
 }
 /** Sidebar, between the header and the program-units menu. No default. */
-declare class SparkShellSidebarTopDirective {
-    readonly templateRef: TemplateRef<unknown>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkShellSidebarTopDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SparkShellSidebarTopDirective, "[sparkShellSidebarTop]", never, {}, {}, never, never, true, never>;
+export declare class SparkShellSidebarTopDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkShellSidebarTopDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SparkShellSidebarTopDirective, "[sparkShellSidebarTop]", never, {}, {}, never, never, true, never>;
 }
 /**
  * An extra accordion tab in the sidebar menu, rendered after the generated program-unit groups
@@ -112,40 +112,55 @@ declare class SparkShellSidebarTopDirective {
  * (client-side demos, external tools). For sidebar content that is NOT an accordion tab, use
  * `*sparkShellSidebarTop` or `*sparkShellSidebarFooter`.
  */
-declare class SparkShellTabDirective {
-    readonly templateRef: TemplateRef<unknown>;
-    /** The tab's header label. */
-    readonly header: _angular_core.InputSignal<string>;
-    /** Bootstrap icon name for the header, as in `programUnits.json`. Defaults to a folder. */
-    readonly icon: _angular_core.InputSignal<string | undefined>;
-    /** Replaces the icon+label header entirely, for a header that needs its own markup. */
-    readonly headerTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkShellTabDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SparkShellTabDirective, "[sparkShellTab]", never, { "header": { "alias": "sparkShellTab"; "required": true; "isSignal": true; }; "icon": { "alias": "sparkShellTabIcon"; "required": false; "isSignal": true; }; "headerTemplate": { "alias": "sparkShellTabHeader"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+export declare class SparkShellTabDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  /** The tab's header label. */
+  readonly header: import("@angular/core").InputSignal<string>;
+  /** Bootstrap icon name for the header, as in `programUnits.json`. Defaults to a folder. */
+  readonly icon: import("@angular/core").InputSignal<string | undefined>;
+  /** Replaces the icon+label header entirely, for a header that needs its own markup. */
+  readonly headerTemplate: import("@angular/core").InputSignal<TemplateRef<unknown> | null>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkShellTabDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SparkShellTabDirective, "[sparkShellTab]", never, {
+    "header": {
+      "alias": "sparkShellTab";
+      "required": true;
+      "isSignal": true;
+    };
+    "icon": {
+      "alias": "sparkShellTabIcon";
+      "required": false;
+      "isSignal": true;
+    };
+    "headerTemplate": {
+      "alias": "sparkShellTabHeader";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
 }
 /**
  * A sidebar accordion tab in the shape the menu renders it. Hosts normally contribute tabs with
  * `*sparkShellTab`; this is the same thing as data, for a host that computes its tabs.
  */
-interface SparkSidebarTab {
-    readonly header: string;
-    readonly icon?: string;
-    readonly headerTemplate?: TemplateRef<unknown> | null;
-    readonly content: TemplateRef<unknown>;
+export interface SparkSidebarTab {
+  readonly header: string;
+  readonly icon?: string;
+  readonly headerTemplate?: TemplateRef<unknown> | null;
+  readonly content: TemplateRef<unknown>;
 }
 /** Sidebar, at the very bottom. No default. */
-declare class SparkShellSidebarFooterDirective {
-    readonly templateRef: TemplateRef<unknown>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkShellSidebarFooterDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SparkShellSidebarFooterDirective, "[sparkShellSidebarFooter]", never, {}, {}, never, never, true, never>;
+export declare class SparkShellSidebarFooterDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkShellSidebarFooterDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SparkShellSidebarFooterDirective, "[sparkShellSidebarFooter]", never, {}, {}, never, never, true, never>;
 }
 /** Main region, above the projected content (the host's `<router-outlet>`). No default. */
-declare class SparkShellMainHeaderDirective {
-    readonly templateRef: TemplateRef<unknown>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkShellMainHeaderDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SparkShellMainHeaderDirective, "[sparkShellMainHeader]", never, {}, {}, never, never, true, never>;
+export declare class SparkShellMainHeaderDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkShellMainHeaderDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SparkShellMainHeaderDirective, "[sparkShellMainHeader]", never, {}, {}, never, never, true, never>;
 }
-
 /**
  * The application frame: topbar + sidebar + main, wrapping ng-bootstrap's `bs-shell` (whose
  * `mp-shell` web component owns ALL responsive behavior — breakpoints, the overlay drawer,
@@ -166,62 +181,136 @@ declare class SparkShellMainHeaderDirective {
  * listens to `statechange` to keep the toggler's icon truthful in `auto` mode and only forces
  * `show`/`hide` on explicit toggles.
  *
- * Theming: the chrome colors are CSS custom properties with the classic dark-sidebar defaults —
- * `--spark-shell-topbar-bg`, `--spark-shell-sidebar-bg`, `--spark-shell-main-bg` — overridable on
- * the `<spark-shell>` element. `sidebarTheme` flips the sidebar's `data-bs-theme` (which is what
- * recolors the accordion internals across the shadow boundary) together with its default palette.
+ * Theming: the chrome colors are CSS custom properties —
+ * `--spark-shell-{topbar,sidebar,main}-{bg,color}` — declared per colour scheme under
+ * `[data-bs-theme=light]` / `[data-bs-theme=dark]` from Bootstrap tokens, so the whole shell follows
+ * the page's theme. An app restyles it by overriding those tokens, globally per scheme or on the
+ * `<spark-shell>` element.
+ *
+ * Colour mode: the shell injects `BsThemeService` itself, so 'auto' follows the OS live even when
+ * the topbar toggle is hidden with `[themeToggle]="false"` (an app may then place its own
+ * `<bs-theme-toggle>` elsewhere). The first paint is themed by `bs-theme-preboot.js` in the app's
+ * `index.html`, not by anything here.
  */
-declare class SparkShellComponent {
-    /** The sidebar heading. Ignored when a `*sparkShellSidebarHeader` slot is supplied. */
-    readonly title: _angular_core.InputSignal<string>;
-    /** Forwarded to `bs-shell`: below it the sidebar is an overlay drawer. */
-    readonly breakpoint: _angular_core.InputSignal<Breakpoint>;
-    /**
-     * `data-bs-theme` for the sidebar — what flips the accordion's shadow-DOM internals between
-     * palettes — plus the matching default background. `null` sets no theme (inherit the page's).
-     */
-    readonly sidebarTheme: _angular_core.InputSignal<"dark" | "light" | null>;
-    /** Forwarded to the menu: any changed value re-fetches the program units. */
-    readonly reloadToken: _angular_core.InputSignal<unknown>;
-    /** Extra sidebar tabs as data, for hosts that compute them; `*sparkShellTab` is the usual way. */
-    readonly sidebarTabs: _angular_core.InputSignal<readonly SparkSidebarTab[]>;
-    readonly topbarStartTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
-    readonly topbarEndTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
-    readonly topbarActionsTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
-    readonly sidebarHeaderTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
-    readonly sidebarTopTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
-    readonly sidebarFooterTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
-    readonly mainHeaderTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
-    private readonly topbarStartSlot;
-    private readonly topbarEndSlot;
-    private readonly topbarActionsSlot;
-    private readonly sidebarHeaderSlot;
-    private readonly sidebarTopSlot;
-    private readonly sidebarFooterSlot;
-    private readonly mainHeaderSlot;
-    protected readonly topbarStartTpl: _angular_core.Signal<TemplateRef<unknown> | null>;
-    protected readonly topbarEndTpl: _angular_core.Signal<TemplateRef<unknown> | null>;
-    protected readonly topbarActionsTpl: _angular_core.Signal<TemplateRef<unknown> | null>;
-    protected readonly sidebarHeaderTpl: _angular_core.Signal<TemplateRef<unknown> | null>;
-    protected readonly sidebarTopTpl: _angular_core.Signal<TemplateRef<unknown> | null>;
-    protected readonly sidebarFooterTpl: _angular_core.Signal<TemplateRef<unknown> | null>;
-    protected readonly mainHeaderTpl: _angular_core.Signal<TemplateRef<unknown> | null>;
-    /**
-     * Extra accordion tabs, forwarded to the menu so IT creates the `<bs-accordion-tab>` elements —
-     * the only way they share the generated groups' single-open behavior (see
-     * `SparkShellTabDirective`). Data-supplied tabs come first, then projected ones in declaration
-     * order.
-     */
-    private readonly tabSlots;
-    protected readonly tabs: _angular_core.Signal<readonly SparkSidebarTab[]>;
-    protected readonly shellState: _angular_core.WritableSignal<BsShellState>;
-    protected readonly isSidebarVisible: _angular_core.WritableSignal<boolean>;
-    protected toggleSidebar(open: boolean): void;
-    protected onShellToggle(detail: ShellStateChangeEventDetail): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkShellComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SparkShellComponent, "spark-shell", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "breakpoint": { "alias": "breakpoint"; "required": false; "isSignal": true; }; "sidebarTheme": { "alias": "sidebarTheme"; "required": false; "isSignal": true; }; "reloadToken": { "alias": "reloadToken"; "required": false; "isSignal": true; }; "sidebarTabs": { "alias": "sidebarTabs"; "required": false; "isSignal": true; }; "topbarStartTemplate": { "alias": "topbarStartTemplate"; "required": false; "isSignal": true; }; "topbarEndTemplate": { "alias": "topbarEndTemplate"; "required": false; "isSignal": true; }; "topbarActionsTemplate": { "alias": "topbarActionsTemplate"; "required": false; "isSignal": true; }; "sidebarHeaderTemplate": { "alias": "sidebarHeaderTemplate"; "required": false; "isSignal": true; }; "sidebarTopTemplate": { "alias": "sidebarTopTemplate"; "required": false; "isSignal": true; }; "sidebarFooterTemplate": { "alias": "sidebarFooterTemplate"; "required": false; "isSignal": true; }; "mainHeaderTemplate": { "alias": "mainHeaderTemplate"; "required": false; "isSignal": true; }; }, {}, ["topbarStartSlot", "topbarEndSlot", "topbarActionsSlot", "sidebarHeaderSlot", "sidebarTopSlot", "sidebarFooterSlot", "mainHeaderSlot", "tabSlots"], ["*"], true, never>;
+export declare class SparkShellComponent {
+  /** The sidebar heading. Ignored when a `*sparkShellSidebarHeader` slot is supplied. */
+  readonly title: import("@angular/core").InputSignal<string>;
+  /** Forwarded to `bs-shell`: below it the sidebar is an overlay drawer. */
+  readonly breakpoint: import("@angular/core").InputSignal<Breakpoint>;
+  /**
+   * Render the Auto / Light / Dark `bs-theme-toggle` in the topbar. `false` hides it; the theme
+   * service stays live either way.
+   */
+  readonly themeToggle: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Instantiated here, not only through the toggle (PRD D3): without it, `[themeToggle]="false"`
+   * would leave 'auto' with no live `prefers-color-scheme` listener in Angular's view.
+   */
+  protected readonly theme: BsThemeService;
+  private readonly lang;
+  /** The toggle's cycle with Spark's translated labels (`theme.*` keys); icons stay ng-bootstrap's. */
+  protected readonly themeModes: import("@angular/core").Signal<readonly BsThemeToggleMode[]>;
+  /** Forwarded to the menu: any changed value re-fetches the program units. */
+  readonly reloadToken: import("@angular/core").InputSignal<unknown>;
+  /** Extra sidebar tabs as data, for hosts that compute them; `*sparkShellTab` is the usual way. */
+  readonly sidebarTabs: import("@angular/core").InputSignal<readonly SparkSidebarTab[]>;
+  readonly topbarStartTemplate: import("@angular/core").InputSignal<TemplateRef<unknown> | null>;
+  readonly topbarEndTemplate: import("@angular/core").InputSignal<TemplateRef<unknown> | null>;
+  readonly topbarActionsTemplate: import("@angular/core").InputSignal<TemplateRef<unknown> | null>;
+  readonly sidebarHeaderTemplate: import("@angular/core").InputSignal<TemplateRef<unknown> | null>;
+  readonly sidebarTopTemplate: import("@angular/core").InputSignal<TemplateRef<unknown> | null>;
+  readonly sidebarFooterTemplate: import("@angular/core").InputSignal<TemplateRef<unknown> | null>;
+  readonly mainHeaderTemplate: import("@angular/core").InputSignal<TemplateRef<unknown> | null>;
+  private readonly topbarStartSlot;
+  private readonly topbarEndSlot;
+  private readonly topbarActionsSlot;
+  private readonly sidebarHeaderSlot;
+  private readonly sidebarTopSlot;
+  private readonly sidebarFooterSlot;
+  private readonly mainHeaderSlot;
+  protected readonly topbarStartTpl: import("@angular/core").Signal<TemplateRef<unknown> | null>;
+  protected readonly topbarEndTpl: import("@angular/core").Signal<TemplateRef<unknown> | null>;
+  protected readonly topbarActionsTpl: import("@angular/core").Signal<TemplateRef<unknown> | null>;
+  protected readonly sidebarHeaderTpl: import("@angular/core").Signal<TemplateRef<unknown> | null>;
+  protected readonly sidebarTopTpl: import("@angular/core").Signal<TemplateRef<unknown> | null>;
+  protected readonly sidebarFooterTpl: import("@angular/core").Signal<TemplateRef<unknown> | null>;
+  protected readonly mainHeaderTpl: import("@angular/core").Signal<TemplateRef<unknown> | null>;
+  /**
+   * Extra accordion tabs, forwarded to the menu so IT creates the `<bs-accordion-tab>` elements —
+   * the only way they share the generated groups' single-open behavior (see
+   * `SparkShellTabDirective`). Data-supplied tabs come first, then projected ones in declaration
+   * order.
+   */
+  private readonly tabSlots;
+  protected readonly tabs: import("@angular/core").Signal<readonly SparkSidebarTab[]>;
+  protected readonly shellState: import("@angular/core").WritableSignal<BsShellState>;
+  protected readonly isSidebarVisible: import("@angular/core").WritableSignal<boolean>;
+  protected toggleSidebar(open: boolean): void;
+  protected onShellToggle(detail: ShellStateChangeEventDetail): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkShellComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SparkShellComponent, "spark-shell", never, {
+    "title": {
+      "alias": "title";
+      "required": false;
+      "isSignal": true;
+    };
+    "breakpoint": {
+      "alias": "breakpoint";
+      "required": false;
+      "isSignal": true;
+    };
+    "themeToggle": {
+      "alias": "themeToggle";
+      "required": false;
+      "isSignal": true;
+    };
+    "reloadToken": {
+      "alias": "reloadToken";
+      "required": false;
+      "isSignal": true;
+    };
+    "sidebarTabs": {
+      "alias": "sidebarTabs";
+      "required": false;
+      "isSignal": true;
+    };
+    "topbarStartTemplate": {
+      "alias": "topbarStartTemplate";
+      "required": false;
+      "isSignal": true;
+    };
+    "topbarEndTemplate": {
+      "alias": "topbarEndTemplate";
+      "required": false;
+      "isSignal": true;
+    };
+    "topbarActionsTemplate": {
+      "alias": "topbarActionsTemplate";
+      "required": false;
+      "isSignal": true;
+    };
+    "sidebarHeaderTemplate": {
+      "alias": "sidebarHeaderTemplate";
+      "required": false;
+      "isSignal": true;
+    };
+    "sidebarTopTemplate": {
+      "alias": "sidebarTopTemplate";
+      "required": false;
+      "isSignal": true;
+    };
+    "sidebarFooterTemplate": {
+      "alias": "sidebarFooterTemplate";
+      "required": false;
+      "isSignal": true;
+    };
+    "mainHeaderTemplate": {
+      "alias": "mainHeaderTemplate";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, ["topbarStartSlot", "topbarEndSlot", "topbarActionsSlot", "sidebarHeaderSlot", "sidebarTopSlot", "sidebarFooterSlot", "mainHeaderSlot", "tabSlots"], ["*"], true, never>;
 }
-
 /**
  * The server-driven navigation menu: an accordion of program-unit groups fetched from
  * `GET /spark/program-units`, which the server has already filtered to what the caller's rights
@@ -238,35 +327,42 @@ declare class SparkShellComponent {
  *
  * Usually rendered by `<spark-shell>`; exported standalone for hosts that own their own layout.
  */
-declare class SparkProgramUnitsComponent {
-    private readonly sparkService;
-    private readonly authState;
-    /** Any changed value triggers a reload — for apps whose auth state isn't a provided signal. */
-    readonly reloadToken: _angular_core.InputSignal<unknown>;
-    /**
-     * Extra tabs to render after the generated groups, normally forwarded by `<spark-shell>` from
-     * its `*sparkShellTab` directives. They must be rendered by THIS template — see
-     * `SparkShellTabDirective` for why a host-declared `<bs-accordion-tab>` cannot work.
-     */
-    readonly extraTabs: _angular_core.InputSignal<readonly SparkSidebarTab[]>;
-    protected readonly groups: _angular_core.WritableSignal<ProgramUnitGroup[]>;
-    constructor();
-    /** Re-fetches the menu. The response is already rights-filtered per caller. */
-    reload(): Promise<void>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkProgramUnitsComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SparkProgramUnitsComponent, "spark-program-units", never, { "reloadToken": { "alias": "reloadToken"; "required": false; "isSignal": true; }; "extraTabs": { "alias": "extraTabs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+export declare class SparkProgramUnitsComponent {
+  private readonly sparkService;
+  private readonly authState;
+  /** Any changed value triggers a reload — for apps whose auth state isn't a provided signal. */
+  readonly reloadToken: import("@angular/core").InputSignal<unknown>;
+  /**
+   * Extra tabs to render after the generated groups, normally forwarded by `<spark-shell>` from
+   * its `*sparkShellTab` directives. They must be rendered by THIS template — see
+   * `SparkShellTabDirective` for why a host-declared `<bs-accordion-tab>` cannot work.
+   */
+  readonly extraTabs: import("@angular/core").InputSignal<readonly SparkSidebarTab[]>;
+  protected readonly groups: import("@angular/core").WritableSignal<ProgramUnitGroup[]>;
+  constructor();
+  /** Re-fetches the menu. The response is already rights-filtered per caller. */
+  reload(): Promise<void>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkProgramUnitsComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SparkProgramUnitsComponent, "spark-program-units", never, {
+    "reloadToken": {
+      "alias": "reloadToken";
+      "required": false;
+      "isSignal": true;
+    };
+    "extraTabs": {
+      "alias": "extraTabs";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
 }
-
 /**
  * The culture switcher: a `bs-select` over `SparkLanguageService`'s languages, persisting the
  * choice. Renders nothing when the app declares one language (or none), so hosts can include it
  * unconditionally — `<spark-shell>`'s topbar does exactly that as its trailing default.
  */
-declare class SparkLanguageSelectorComponent {
-    protected readonly lang: SparkLanguageService;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkLanguageSelectorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SparkLanguageSelectorComponent, "spark-language-selector", never, {}, {}, never, never, true, never>;
-}
-
-export { SparkLanguageSelectorComponent, SparkProgramUnitsComponent, SparkShellComponent, SparkShellMainHeaderDirective, SparkShellSidebarFooterDirective, SparkShellSidebarHeaderDirective, SparkShellSidebarTopDirective, SparkShellTabDirective, SparkShellTopbarActionsDirective, SparkShellTopbarEndDirective, SparkShellTopbarStartDirective };
-export type { SparkSidebarTab };
+export declare class SparkLanguageSelectorComponent {
+  protected readonly lang: SparkLanguageService;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkLanguageSelectorComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SparkLanguageSelectorComponent, "spark-language-selector", never, {}, {}, never, never, true, never>;
+}

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

@@ -0,0 +1,90 @@
+import { PersistentObject } from "@mintplayer/ng-spark/models";
+import * as i0 from "@angular/core";
+import { Provider } from "@angular/core";
+import { SparkDetailContext, SparkQueryListContext } from "@mintplayer/ng-spark/panels";
+/**
+ * Client for the SoftDelete package's endpoints (`MintPlayer.Spark.SoftDelete`, #460 T1). Ids travel
+ * in the body — the route table is literal and Raven ids contain slashes.
+ */
+export declare class SparkSoftDeleteService {
+  private readonly spark;
+  /**
+   * `POST /spark/po/restore` → the restored (live) object. Requires `Restore/T` and a deleted row;
+   * anything else is 404 (or 401 anonymous), a restore withheld by `OnDisableActionsAsync` is 403.
+   */
+  restore(type: string, id: string): Promise<PersistentObject>;
+  /**
+   * `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>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkSoftDeleteService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+/**
+ * The query page's "Deleted" toggle (#460): switches the list into the recycle bin
+ * (`deleted: only`) and back. Rendered only for holders of `ViewDeleted/T` — for anyone else the
+ * server would ignore the widening anyway, so offering it would show the same rows under a
+ * misleading label.
+ *
+ * Registered by {@link provideSparkSoftDelete} as a `SPARK_QUERY_LIST_ACTIONS` entry; usable on its
+ * own in a custom page with any {@link SparkQueryListContext}.
+ */
+export declare class SparkDeletedToggleComponent {
+  context: import("@angular/core").InputSignal<SparkQueryListContext>;
+  protected readonly visible: import("@angular/core").Signal<boolean>;
+  protected readonly active: import("@angular/core").Signal<boolean>;
+  toggle(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkDeletedToggleComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SparkDeletedToggleComponent, "spark-deleted-toggle", never, {
+    "context": {
+      "alias": "context";
+      "required": true;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/**
+ * Restore and Purge on the detail page of a row opened from the recycle bin (#460).
+ *
+ * Shown only when the page loaded the row with `?deleted=only` (every row in the recycle bin is
+ * deleted) and the caller holds `Restore/T` / `Purge/T`. The server re-checks both — the row must be
+ * deleted and the row gate must pass — so a refusal here is the 404/403 it answers, surfaced inline.
+ *
+ * Registered by {@link provideSparkSoftDelete} as a `SPARK_DETAIL_ACTIONS` entry.
+ */
+export declare class SparkSoftDeleteActionsComponent {
+  private readonly softDelete;
+  private readonly router;
+  private readonly route;
+  private readonly returnNavigation;
+  private readonly lang;
+  context: import("@angular/core").InputSignal<SparkDetailContext>;
+  protected readonly deletedView: import("@angular/core").Signal<boolean>;
+  protected readonly canRestore: import("@angular/core").Signal<boolean>;
+  protected readonly canPurge: import("@angular/core").Signal<boolean>;
+  protected readonly busy: import("@angular/core").WritableSignal<boolean>;
+  protected readonly error: import("@angular/core").WritableSignal<string | null>;
+  restore(): Promise<void>;
+  purge(): Promise<void>;
+  private run;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SparkSoftDeleteActionsComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SparkSoftDeleteActionsComponent, "spark-soft-delete-actions", never, {
+    "context": {
+      "alias": "context";
+      "required": true;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/**
+ * Adds the SoftDelete UI (#460) to the pages `sparkRoutes()` routes to:
+ *
+ * - the query page gets a **Deleted** toggle (holders of `ViewDeleted/T`) that lists the recycle bin
+ *   (`?deleted=only`); its rows open with the same mode;
+ * - the detail page of such a row gets **Restore** (`Restore/T`) and **Purge** (`Purge/T`).
+ *
+ * Needs the server package `MintPlayer.Spark.SoftDelete`. Add to the app's providers:
+ * `providers: [provideSpark(...), provideSparkSoftDelete()]`.
+ */
+export declare function provideSparkSoftDelete(): Provider[];

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

@@ -1,11 +1,21 @@
-import { InjectionToken, Signal, Provider } from '@angular/core';
-
+import { InjectionToken, Provider, Signal } from "@angular/core";
 interface SparkConfig {
-    baseUrl: string;
+  baseUrl: string;
+  /**
+   * The concurrency-conflict notice and dialog on the edit page.
+   *
+   * `showChangedBy`: when true, "Changed by X" names whoever wrote the version merged against, but
+   * only when History resolves a display name for exactly that version (a `History/T` holder; one
+   * `POST /spark/po/revisions` request). Default false: no History request is made and no user is
+   * shown. A raw `ModifiedBy` user id is never shown in either mode. The "at T" time part is shown
+   * whenever the object carries `ModifiedAt`.
+   */
+  conflictDialog?: {
+    showChangedBy?: boolean;
+  };
 }
-declare const SPARK_CONFIG: InjectionToken<SparkConfig>;
-declare const defaultSparkConfig: SparkConfig;
-
+export declare const SPARK_CONFIG: InjectionToken<SparkConfig>;
+export declare const defaultSparkConfig: SparkConfig;
 /**
  * A signal that changes whenever the authenticated user changes — the bridge that lets ng-spark
  * components react to sign-in/out without a dependency on `@mintplayer/ng-spark-auth` (no
@@ -19,9 +29,6 @@ declare const defaultSparkConfig: SparkConfig;
  * The signal's VALUE is deliberately opaque (`unknown`): consumers only track it for change,
  * never read it — what "the user" looks like belongs to the auth package.
  */
-declare const SPARK_AUTH_STATE: InjectionToken<Signal<unknown>>;
-
-declare function provideSpark(config?: Partial<SparkConfig>): Provider[];
-
-export { SPARK_AUTH_STATE, SPARK_CONFIG, defaultSparkConfig, provideSpark };
-export type { SparkConfig };
+export declare const SPARK_AUTH_STATE: InjectionToken<Signal<unknown>>;
+export declare function provideSpark(config?: Partial<SparkConfig>): Provider[];
+export type { SparkConfig };