@trismegisto/spine 2.1.1 → 3.0.0

package/types/trismegisto-spine.d.ts

@@ -1,7 +1,7 @@
-import * as i0 from '@angular/core';
+import * as _angular_core from '@angular/core';
 import { Type, InjectionToken, NgZone, EnvironmentProviders, Provider } from '@angular/core';
 import { HermesThemeName, HermesThemeMode, HermesFamily, HermesDensity } from '@trismegisto/angular';
-import { HermesThemeExtension, PluralMessage, CatalogOverride } from '@trismegisto/primitives';
+import { HermesThemeExtension, TimeHourCycle, HermesMotionPreference, Weekday, PluralMessage, CatalogOverride } from '@trismegisto/primitives';
 
 interface Route {
     route_display_name?: string | null;
@@ -136,6 +136,62 @@ interface SpineConfig {
      * Padrão: `isDevMode()`. Apps com build de produção em homologação passam
      * `!environment.production` (ou equivalente) para mostrá-la fora de produção. */
     technicalDocs?: boolean;
+    /**
+     * Recursos opcionais do painel de configurações (todos desligados sem configuração). Ver `SpineFeatures`.
+     */
+    features?: SpineFeatures;
+}
+/** Um servidor MCP do app, oferecido em Sessões › "Conectar um agente de IA". */
+interface SpineMcpServer {
+    /** Nome da entrada no `.mcp.json` (ex.: `hefesto`). Letras, números, `-` e `_`. */
+    name: string;
+    /** URL do MCP. Relativa (`/hefesto/mcp`) é resolvida contra a origem da página. */
+    url: string;
+    /** Rótulo exibido (padrão: `name`). */
+    label?: string;
+    /** Valor de `x-mcp-scopes` no modo só leitura. Omitido: o header não vai (o MCP já é só leitura sem ele). */
+    readScopes?: string;
+    /** Valor de `x-mcp-scopes` no modo leitura e escrita (ex.: `deploy.*`). Omitido: o servidor só é oferecido para leitura. */
+    writeScopes?: string;
+}
+/** Tipo de aviso que o app emite (`SpineNoticesService.notify`), ligável/desligável em Configurações › Notificações. */
+interface SpineNoticeType {
+    /** Identificador estável (ex.: `deploy-concluido`): é a chave da preferência salva. */
+    id: string;
+    label: string;
+    description?: string;
+    /** Ligado enquanto a pessoa não escolher. Padrão: `true`. */
+    defaultEnabled?: boolean;
+}
+/**
+ * Recursos opcionais do painel de configurações. Cada um só aparece quando ligado aqui (e, quando depende do Argos,
+ * com a API da conta disponível — `AUTH_CONFIG` com `authority`/`realmId`).
+ */
+interface SpineFeatures {
+    /** Sessões › "Conectar um agente de IA": gera um token de aplicação e a configuração MCP pronta para colar.
+     *  Precisa de `SPINE_ADMIN_API` (tokens de aplicação). */
+    aiAgent?: {
+        servers: readonly SpineMcpServer[];
+    };
+    /** MFA › "Atividade da conta": entradas e tentativas que falharam desta conta (últimos 90 dias, API da conta). */
+    accountActivity?: boolean;
+    /** Conta › "Encerrar por inatividade". `true` = opções padrão; `{ min, max }` limita os minutos (com `max` a
+     *  opção "Nunca" some e a escolha é limitada a ele). */
+    idleTimeout?: boolean | {
+        min?: number;
+        max?: number;
+    };
+    /** Conta › "Tela inicial": início, um favorito ou a última tela visitada, aplicada depois do login. */
+    startPage?: boolean;
+    /** Conta › "Crachá padrão": o nível de acesso com que o login entra (guardado no Argos, vale nos outros navegadores). */
+    defaultBadge?: boolean;
+    /** Configurações › Notificações: os tipos de aviso que o app emite e o aviso do navegador com a aba em segundo plano. */
+    notices?: {
+        types: readonly SpineNoticeType[];
+    };
+    /** Preferências (aparência, região, acessibilidade, favoritos, tela inicial…) guardadas também na conta do Argos,
+     *  para acompanharem a pessoa em qualquer navegador. Sem a API da conta, ficam só no navegador. */
+    accountPreferences?: boolean;
 }
 declare const SPINE_CONFIG: InjectionToken<SpineConfig>;
 
@@ -161,8 +217,8 @@ declare class ThemeService {
     get mode(): HermesThemeMode;
     setMode(mode: HermesThemeMode): void;
     setTheme(theme: HermesThemeName): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ThemeService, [null, null, null, { optional: true; }]>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ThemeService>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThemeService, [null, null, null, { optional: true; }]>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ThemeService>;
 }
 
 /**
@@ -178,8 +234,8 @@ declare class ThemePresetService {
     get current(): HermesFamily;
     get families(): readonly HermesFamily[];
     setPreset(family: HermesFamily): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ThemePresetService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ThemePresetService>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThemePresetService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ThemePresetService>;
 }
 
 interface DensitySetting {
@@ -203,8 +259,8 @@ declare class DensityService {
     /** Só alterna entre comfortable e compact — mesmo comportamento do spine antigo
      *  (que chamava a densidade não-compacta de "regular"; o DS novo chama de "comfortable"). */
     toggleDensity(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DensityService, [null, null, { optional: true; }]>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<DensityService>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DensityService, [null, null, { optional: true; }]>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<DensityService>;
 }
 
 /** Registra o catálogo de ícones inteiro — o spine (header/sidebar/navegação/modal/onboarding)
@@ -240,14 +296,30 @@ interface PackageInfo {
 }
 declare const APP_PACKAGE_INFO: InjectionToken<PackageInfo>;
 
+/** Minutos de inatividade oferecidos em "Encerrar por inatividade" (0 = nunca). */
+declare const SPINE_IDLE_OPTIONS: readonly number[];
+/**
+ * Tela inicial depois do login: `home` (a padrão do app), `last` (a última visitada) ou `fav:<id>` (um favorito,
+ * pelo `id` do `SpineQuickAccessService`).
+ */
+type SpineStartPagePreference = 'home' | 'last' | `fav:${string}`;
+/** Relógio escolhido em Região: vazio = o do idioma. */
+type SpineHourCyclePreference = '' | TimeHourCycle;
+/** Primeiro dia da semana escolhido em Região: `null` = o do idioma. */
+type SpineWeekStartPreference = Weekday | null;
 /**
  * Preferências do usuário que não são de tema (tema/família/densidade continuam no
- * `HermesThemeService`; modo do menu lateral no `HermesSidebarService`): fuso horário, idioma e o
- * interruptor dos atalhos de tecla única (WCAG 2.1.4) do `HermesShortcutService`.
+ * `HermesThemeService`; modo do menu lateral no `HermesSidebarService`): fuso horário, idioma, relógio de
+ * 12/24 h e primeiro dia da semana (`HermesI18nService.setRegionalFormat`), tamanho do texto
+ * (`HermesZoomService.setTextScale`), movimento (`HermesMotionService.setPreference`) e o interruptor dos
+ * atalhos de tecla única (WCAG 2.1.4) do `HermesShortcutService`.
+ *
+ * Também guarda as preferências dos recursos opcionais (`SpineFeatures`): minutos de inatividade, tela inicial,
+ * tipos de aviso ligados e o aviso do navegador.
  *
- * Por enquanto vive no navegador (localStorage, sincronizado entre abas). A sincronização com o
- * servidor (argos-admin `/me/preferences`) entra depois sem mudar esta API: quem lê `timeZone()`
- * não precisa saber de onde o valor veio.
+ * Vive no navegador (localStorage, sincronizado entre abas). Com `SpineFeatures.accountPreferences`, o
+ * `SpineAccountPreferencesService` (`@trismegisto/spine/layout`) espelha estes valores na conta do Argos e os aplica
+ * pelos mesmos `set*` no login: quem lê `timeZone()` não precisa saber de onde o valor veio.
  */
 declare class SpinePreferencesService {
     private readonly browser;
@@ -256,24 +328,51 @@ declare class SpinePreferencesService {
     private readonly timeZoneKey;
     private readonly languageKey;
     private readonly characterKeysKey;
+    private readonly textScaleKey;
+    private readonly motionKey;
+    private readonly hourCycleKey;
+    private readonly weekStartKey;
     private readonly shortcuts;
     private readonly i18n;
+    private readonly zoom;
+    private readonly motionService;
     /** Idioma com que o app subiu (`provideHermesI18n`) — vale quando a pessoa não escolheu nenhum. */
     readonly appLanguage: string;
     private readonly channel;
     /** Fuso escolhido (IANA, ex.: "America/Sao_Paulo"). Vazio = o do navegador. */
-    readonly timeZone: i0.WritableSignal<string>;
+    readonly timeZone: _angular_core.WritableSignal<string>;
     /** Fuso do navegador, para mostrar ao lado da opção "automático". */
     readonly browserTimeZone: string;
     /** O fuso que vale de fato: o escolhido ou, sem escolha, o do navegador. */
-    readonly effectiveTimeZone: i0.Signal<string>;
+    readonly effectiveTimeZone: _angular_core.Signal<string>;
     /** Idioma escolhido (BCP 47: `pt-BR`, `en`, `es`). Vazio = o padrão do app. */
-    readonly language: i0.WritableSignal<string>;
+    readonly language: _angular_core.WritableSignal<string>;
     /**
      * Atalhos de tecla única (`?`, `G H`) ligados — WCAG 2.1.4. Guardado por app (`'on'`/`'off'`);
      * sem escolha salva, vale o padrão do `HermesShortcutService` (`provideHermesShortcuts`).
      */
-    readonly characterKeys: i0.WritableSignal<boolean>;
+    readonly characterKeys: _angular_core.WritableSignal<boolean>;
+    /** Tamanho do texto (1 = 100%; os oferecidos em `HERMES_TEXT_SCALES`). */
+    readonly textScale: _angular_core.WritableSignal<number>;
+    /** Movimento: `system` segue o `prefers-reduced-motion`; `reduce` sempre reduz; `full` nunca. */
+    readonly motion: _angular_core.WritableSignal<HermesMotionPreference>;
+    /** Relógio: `h23` (24 horas), `h12` (12 horas) ou vazio (o do idioma). */
+    readonly hourCycle: _angular_core.WritableSignal<SpineHourCyclePreference>;
+    /** Primeiro dia da semana (0 = domingo, 1 = segunda) ou `null` (o do idioma). */
+    readonly weekStart: _angular_core.WritableSignal<SpineWeekStartPreference>;
+    private readonly idleKey;
+    private readonly startPageKey;
+    private readonly noticesKey;
+    private readonly browserNoticesKey;
+    /** Encerrar a sessão depois de tantos minutos sem uso (0 = nunca). Os limites do app (`SpineFeatures.idleTimeout`)
+     *  são aplicados por quem usa o valor (`SpineIdleService`), não aqui. */
+    readonly idleMinutes: _angular_core.WritableSignal<number>;
+    /** Tela que abre depois do login. */
+    readonly startPage: _angular_core.WritableSignal<SpineStartPagePreference>;
+    /** Tipos de aviso que a pessoa ligou/desligou (`id` → ligado); tipo ausente segue o `defaultEnabled` dele. */
+    readonly noticeTypes: _angular_core.WritableSignal<Readonly<Record<string, boolean>>>;
+    /** Aviso do navegador (Notification API) quando a aba está em segundo plano. */
+    readonly browserNotices: _angular_core.WritableSignal<boolean>;
     /** Idiomas oferecidos na configuração, cada um com o nome no próprio idioma (padrão de mercado). */
     readonly languages: readonly {
         readonly value: string;
@@ -288,13 +387,34 @@ declare class SpinePreferencesService {
     /** Troca o idioma da lib e do spine na hora, guarda e avisa as outras abas. Vazio = padrão do app. */
     setLanguage(value: string): void;
     private applyLanguage;
+    /** Tamanho do texto na hora (1 = 100%), guarda e avisa as outras abas. */
+    setTextScale(value: number): void;
+    private applyTextScale;
+    /** Movimento na hora (`system`/`reduce`/`full`), guarda e avisa as outras abas. */
+    setMotion(value: HermesMotionPreference): void;
+    private applyMotion;
+    /** Relógio na hora (`h23`/`h12`; vazio = o do idioma), guarda e avisa as outras abas. */
+    setHourCycle(value: SpineHourCyclePreference): void;
+    /** Primeiro dia da semana na hora (0 = domingo, 1 = segunda; `null` = o do idioma), guarda e avisa. */
+    setWeekStart(value: SpineWeekStartPreference): void;
+    private applyRegionalFormat;
+    /** Minutos sem uso até encerrar a sessão (0 = nunca), guarda e avisa as outras abas. */
+    setIdleMinutes(value: number): void;
+    /** Tela inicial depois do login, guarda e avisa as outras abas. */
+    setStartPage(value: SpineStartPagePreference): void;
+    /** Liga/desliga um tipo de aviso, guarda e avisa as outras abas. */
+    setNoticeType(id: string, enabled: boolean): void;
+    /** Troca o mapa inteiro de tipos de aviso (restaurar, sincronização com a conta). */
+    setNoticeTypes(value: Readonly<Record<string, boolean>>): void;
+    /** Liga/desliga o aviso do navegador, guarda e avisa as outras abas (a permissão é pedida por quem chama). */
+    setBrowserNotices(enabled: boolean): void;
     setTimeZone(value: string): void;
     /** Todos os fusos IANA que o navegador conhece (vazio em navegador antigo). */
     supportedTimeZones(): string[];
     private read;
     private write;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SpinePreferencesService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SpinePreferencesService>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SpinePreferencesService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<SpinePreferencesService>;
 }
 
 /**
@@ -325,8 +445,8 @@ declare class SpineQuickAccessService {
     private readonly storage;
     private readonly favoriteList;
     private readonly recentList;
-    readonly favorites: i0.Signal<readonly QuickAccessItem[]>;
-    readonly recents: i0.Signal<readonly QuickAccessItem[]>;
+    readonly favorites: _angular_core.Signal<readonly QuickAccessItem[]>;
+    readonly recents: _angular_core.Signal<readonly QuickAccessItem[]>;
     private readonly favoriteSet;
     constructor();
     private get favoritesKey();
@@ -334,12 +454,14 @@ declare class SpineQuickAccessService {
     private reload;
     isFavorite(id: string | null | undefined): boolean;
     toggleFavorite(item: QuickAccessItem): void;
+    /** Troca a lista de favoritos inteira (sincronização com a conta). Itens inválidos ou repetidos são descartados. */
+    setFavorites(items: readonly unknown[]): void;
     recordVisit(item: QuickAccessItem): void;
     forgetRecent(id: string): void;
     private commit;
     private load;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SpineQuickAccessService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SpineQuickAccessService>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SpineQuickAccessService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<SpineQuickAccessService>;
 }
 
 /** Listas do shell guardadas no navegador, por usuário. */
@@ -347,6 +469,8 @@ declare const SPINE_USER_STORAGE_KEYS: {
     readonly favorites: "nav_favorites";
     readonly recents: "nav_recent";
     readonly recentSearches: "header_recent_searches";
+    /** Última tela visitada, guardada só com a tela inicial "Última tela visitada" (`SpineStartPageService`). */
+    readonly lastPage: "start_last_page";
 };
 type SpineUserStorageKey = (typeof SPINE_USER_STORAGE_KEYS)[keyof typeof SPINE_USER_STORAGE_KEYS];
 /**
@@ -355,8 +479,9 @@ type SpineUserStorageKey = (typeof SPINE_USER_STORAGE_KEYS)[keyof typeof SPINE_U
  *
  * - Sem `sub` (sem sessão, ou app sem `@orfeu/angular`) a chave é a antiga, `<clientId>_<lista>`.
  * - Com `sub`, a chave antiga sem usuário é apagada (era compartilhada entre todas as contas do navegador).
- * - No logout (`clearHistory()`, chamado pelo spine antes do `logout()`, e o `isAuth$` indo para `false`, que
- *   cobre o logout vindo de outra aba) os HISTÓRICOS do usuário saem; os favoritos ficam.
+ * - No logout (`clearHistory()`, chamado pelo `SpineLogoutService` só quando o `logout()` deu certo, e o `isAuth$`
+ *   indo para `false`, que cobre o logout vindo de outra aba) os HISTÓRICOS do usuário saem; os favoritos ficam.
+ *   Logout que falhou no Argos (`@orfeu/angular` 1.3.x) mantém a sessão e os históricos.
  */
 declare class SpineUserStorage {
     private readonly browser;
@@ -372,12 +497,19 @@ declare class SpineUserStorage {
     key(list: SpineUserStorageKey): string;
     /** Apaga buscas recentes e páginas recentes do usuário (o atual ou o último visto). Favoritos ficam. */
     clearHistory(): void;
+    /**
+     * Apaga uma lista do usuário atual (Configurações › Dados do navegador): a chave dele, e também a antiga sem
+     * usuário. Quem guarda a lista em memória relê (`onChange`).
+     */
+    clear(list: SpineUserStorageKey): void;
+    /** Quantos itens a lista do usuário atual tem guardados (0 sem nada ou com valor ilegível). */
+    count(list: SpineUserStorageKey): number;
     /** Avisa quando a sessão muda ou o histórico é limpo (quem guarda a lista em memória relê). */
     onChange(listener: () => void): () => void;
     private notify;
     private dropLegacy;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SpineUserStorage, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SpineUserStorage>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SpineUserStorage, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<SpineUserStorage>;
 }
 
 /**
@@ -631,6 +763,8 @@ interface SpineMessages {
         sidebar: string;
         sidebarDescription: string;
         sidebarKeywords: string;
+        /** Detalhe de cada modo do menu lateral (toggletip ao lado do rótulo). */
+        sidebarHelp: string;
         sidebarAuto: string;
         sidebarFixed: string;
         sidebarCompact: string;
@@ -647,6 +781,18 @@ interface SpineMessages {
         timeZoneHint: string;
         /** `{zone}` = fuso detectado no navegador. */
         timeZoneAuto: string;
+        /** Formato de hora (Região): automático pelo idioma, 24 ou 12 horas. `{now}` = hora agora no formato. */
+        hourCycle: string;
+        hourCycleHint: string;
+        hourCycleKeywords: string;
+        hourCycleAuto: string;
+        hourCycle24: string;
+        hourCycle12: string;
+        /** Primeiro dia da semana (Região); domingo e segunda saem do `Intl`, no idioma. */
+        weekStart: string;
+        weekStartDescription: string;
+        weekStartKeywords: string;
+        weekStartAuto: string;
         shortcuts: string;
         shortcutsDescription: string;
         shortcutsKeywords: string;
@@ -654,6 +800,52 @@ interface SpineMessages {
         tourDescription: string;
         tourKeywords: string;
         replayTour: string;
+        /** Seção "Acessibilidade" (`?settings=acessibilidade`). */
+        accessibility: string;
+        accessibilityKeywords: string;
+        textSize: string;
+        textSizeDescription: string;
+        textSizeKeywords: string;
+        motion: string;
+        motionDescription: string;
+        motionKeywords: string;
+        motionSystem: string;
+        motionReduce: string;
+        motionFull: string;
+        /** Seção "Ajuda" (`?settings=ajuda`): novidades e tour. */
+        help: string;
+        helpKeywords: string;
+        news: string;
+        newsDescription: string;
+        newsKeywords: string;
+        showNews: string;
+        /** Seção "Dados do navegador" (`?settings=dados`): listas guardadas e restaurar preferências. */
+        browserData: string;
+        browserDataDescription: string;
+        browserDataKeywords: string;
+        recentPages: string;
+        recentPagesKeywords: string;
+        recentSearches: string;
+        recentSearchesKeywords: string;
+        favorites: string;
+        favoritesKeywords: string;
+        /** Quantos itens a lista guarda (descrição da linha). */
+        pagesCount: PluralMessage;
+        searchesCount: PluralMessage;
+        clear: string;
+        confirmClear: string;
+        cancel: string;
+        recentPagesCleared: string;
+        recentSearchesCleared: string;
+        favoritesCleared: string;
+        restorePreferences: string;
+        restorePreferencesDescription: string;
+        /** O que volta ao padrão e o que fica (toggletip ao lado do rótulo). */
+        restorePreferencesHelp: string;
+        restorePreferencesKeywords: string;
+        restore: string;
+        confirmRestore: string;
+        preferencesRestored: string;
         account: string;
         accountKeywords: string;
         user: string;
@@ -672,15 +864,20 @@ interface SpineMessages {
         accessTokenDescription: string;
         accessTokenKeywords: string;
         copy: string;
+        /** Nome acessível do toggletip de ajuda de uma linha; `{label}` é o rótulo da linha. */
+        moreAbout: string;
         appTokens: string;
         appTokensDescription: string;
         appTokensKeywords: string;
+        /** Detalhe dos tokens de aplicação (toggletip ao lado do rótulo). */
+        appTokensHelp: string;
         logout: string;
         logoutDescription: string;
         logoutKeywords: string;
-        security: string;
-        securityDescription: string;
-        securityKeywords: string;
+        /** Seção "MFA" (`?settings=mfa`; a antiga `seguranca` também abre). */
+        mfa: string;
+        mfaDescription: string;
+        mfaKeywords: string;
         signedInAccount: string;
         /** `{realm}` = realm do Argos (nome ou id, como o app usa no login). */
         signedInRealm: string;
@@ -690,9 +887,14 @@ interface SpineMessages {
         recoveryCodes: string;
         recoveryCodesDescription: string;
         recoveryCodesKeywords: string;
+        /** Linha "Sessões e dispositivos" (dentro da seção Sessões). */
         sessions: string;
         sessionsDescription: string;
         sessionsKeywords: string;
+        /** Seção "Sessões" (`?settings=sessoes`): sessão, token de acesso, tokens de aplicação, sessões e dispositivos. */
+        sessionsSection: string;
+        sessionsSectionDescription: string;
+        sessionsSectionKeywords: string;
         about: string;
         aboutKeywords: string;
         application: string;
@@ -923,6 +1125,8 @@ interface SpineMessages {
         signInAgain: string;
         callbackFailedHeading: string;
         callbackFailedText: string;
+        /** `logout()` que o Argos não confirmou (o `@orfeu/angular` repetiu uma vez): a sessão continua. */
+        logoutFailed: string;
     };
     routing: {
         notPublished: string;
@@ -959,6 +1163,7 @@ interface SpineMessages {
         create: string;
         edit: string;
         remove: string;
+        /** @deprecated não é mais exibido (Grupos e Aplicações viraram tabelas, sem "Consultar"). */
         search: string;
         active: string;
         inactive: string;
@@ -972,13 +1177,14 @@ interface SpineMessages {
         tabRoutes: string;
         tabRouters: string;
         tabAccess: string;
-        /** `[innerHTML]`. */
+        /** `[innerHTML]`. Sem client: a pessoa não administra o app em que está logada. */
         noClients: string;
         pickClient: string;
         groupsTitle: string;
         groupsIntro: string;
         /** @deprecated não é mais exibido (o auto-serviço não repete título/explicação que a barra da página e a aba já dão). */
         groupsFixed: string;
+        /** @deprecated não é mais exibido (a tela Grupos lista os grupos numa tabela, sem "Consultar"). */
         pickGroup: string;
         noDescription: string;
         /** @deprecated não é mais exibido (o auto-serviço não repete título/explicação que a barra da página e a aba já dão). */
@@ -1023,13 +1229,15 @@ interface SpineMessages {
         guardsHint: string;
         noPrivateRoutes: string;
         register: string;
+        /** @deprecated não é mais exibido (a tela Aplicações lista as aplicações numa tabela, sem "Consultar"). */
         appsSearchIntro: string;
         secretCreated: string;
+        /** @deprecated não é mais exibido (a tela Aplicações lista as aplicações numa tabela, sem "Consultar"). */
         pickApp: string;
         disable: string;
         enable: string;
         delete: string;
-        /** Nome acessível da faixa de abas da aplicação escolhida (Operações/Acessos). */
+        /** Nome acessível da faixa de abas da aplicação escolhida (Operações/Acessos/Tokens). */
         appSections: string;
         tabOperations: string;
         tabAccesses: string;
@@ -1072,6 +1280,11 @@ interface SpineMessages {
         colPage: string;
         colBuiltPath: string;
         colVisibility: string;
+        /** Coluna e campo do roteador: tipos de grupo (crachás) que podem receber acesso à tela (`allowed_type_ids`). */
+        colAllowedBadges: string;
+        /** Roteador sem restrição de crachá (`allowed_type_ids` vazio); também o placeholder do campo. */
+        anyBadge: string;
+        allowedBadgesHint: string;
         /** @deprecated não é mais exibido (o auto-serviço não repete título/explicação que a barra da página e a aba já dão). */
         routesTitle: string;
         newRoute: string;
@@ -1095,6 +1308,23 @@ interface SpineMessages {
         pathHint: string;
         pathInvalid: string;
         /** Confirmação das exclusões (diálogo): título e mensagem; `{name}`, `{path}` ou `{group}`. */
+        /**
+         * "Gerar novo segredo" de uma aplicação: botão, confirmação, a janela que mostra o segredo uma vez
+         * (`{name}` = nome da aplicação), copiar e os erros (genérico, 404 e 403).
+         */
+        rotateSecret: string;
+        confirmRotateSecretHeading: string;
+        confirmRotateSecret: string;
+        rotatedSecretHeading: string;
+        rotatedSecretWarning: string;
+        rotatedSecretNote: string;
+        rotatedSecretLabel: string;
+        copySecret: string;
+        secretCopied: string;
+        rotatedSecretDone: string;
+        rotateSecretError: string;
+        rotateSecretNotFound: string;
+        rotateSecretForbidden: string;
         confirmDeleteAppHeading: string;
         confirmDeleteApp: string;
         confirmDeleteRouteHeading: string;
@@ -1135,6 +1365,113 @@ interface SpineMessages {
         reorderLoadError: string;
         reorderSaveError: string;
         reorderSave: string;
+        /** Tela Grupos: lista dos grupos do projeto, criar/editar/excluir. */
+        newGroup: string;
+        editGroup: string;
+        groupsCaption: string;
+        noGroups: string;
+        colStatus: string;
+        groupName: string;
+        groupType: string;
+        groupTypePlaceholder: string;
+        groupDescription: string;
+        /** `{name}`: nome acessível do botão que abre o grupo na lista. */
+        openGroup: string;
+        /** @deprecated não é mais exibido (o grupo de administração do projeto é gerido só no painel central e não aparece no auto-serviço). */
+        adminGroupTag: string;
+        /** @deprecated não é mais exibido (o grupo de administração do projeto é gerido só no painel central e não aparece no auto-serviço). */
+        adminGroupNote: string;
+        /** @deprecated não é mais exibido (o grupo de administração do projeto é gerido só no painel central e não aparece no auto-serviço). */
+        adminGroupEditNote: string;
+        /** @deprecated não é mais exibido (o grupo de administração do projeto é gerido só no painel central e não aparece no auto-serviço). */
+        adminGroupLastMemberWarning: string;
+        /** Confirmação da exclusão; `{name}`. */
+        confirmDeleteGroupHeading: string;
+        confirmDeleteGroup: string;
+        groupSaveError: string;
+        membersSaveError: string;
+        /**
+         * Erros do argos-admin-server nos grupos e acessos do auto-serviço, pelo código (`error`) da resposta
+         * (ver `autoServiceErrorText`). `groupNotFound` é o 404 de grupo de outro projeto.
+         */
+        /** Tela Aplicações: tabela das aplicações do projeto (clicar na linha abre a aplicação embaixo). */
+        appsCaption: string;
+        noApps: string;
+        colGrants: string;
+        /** `{name}`: nome acessível do botão que abre a aplicação na lista. */
+        openApp: string;
+        /** Aba Tokens da aplicação: tokens de API (`x-api-token`), criar e revogar. */
+        tabTokens: string;
+        tokensCaption: string;
+        noTokens: string;
+        newToken: string;
+        colTokenPrefix: string;
+        colExpiresAt: string;
+        colLastUsed: string;
+        tokenExpired: string;
+        tokenRevoked: string;
+        neverUsed: string;
+        revokeToken: string;
+        confirmRevokeTokenHeading: string;
+        /** `{name}`. */
+        confirmRevokeToken: string;
+        /** `{name}`. */
+        tokenRevokedDone: string;
+        tokenRevokeError: string;
+        tokensLoadError: string;
+        /** Modal "Novo token": campos, validade (de amanhã a 365 dias) e as operações liberadas ao token. */
+        tokenName: string;
+        tokenDescription: string;
+        tokenExpiresAt: string;
+        tokenExpiresHint: string;
+        tokenExpiresInvalid: string;
+        tokenOperations: string;
+        tokenOperationsNote: string;
+        /** Por que a operação não depende de permissão (caixa marcada e desabilitada): public/optional, private, outro nível. */
+        freeForAll: string;
+        freeForAuthenticated: string;
+        freeNoPermission: string;
+        createToken: string;
+        tokenSaveError: string;
+        /** O token criado, mostrado uma única vez; `{name}` = nome do token. */
+        tokenCreatedHeading: string;
+        tokenCreatedWarning: string;
+        tokenCreatedNote: string;
+        tokenValueLabel: string;
+        copyToken: string;
+        tokenCopied: string;
+        /** Roteadores: a hierarquia é de cima para baixo (cada nível só com o de cima escolhido). */
+        hierarchyHint: string;
+        routerSaveError: string;
+        /** "Gerenciar operações" (grupo ou token): falha ao gravar alguma liberação/retirada. */
+        permissionsSaveError: string;
+        /** Erros do argos-admin-server nos tokens de aplicação, pelo código (`error`) da resposta (ver `autoServiceErrorText`). */
+        tokenErrors: {
+            invalidExpiresAt: string;
+            invalidValidity: string;
+            invalidOperationIds: string;
+            operationNotProtected: string;
+            appNotFound: string;
+            tokenNotFound: string;
+        };
+        /** Erros do argos-admin-server nos roteadores (`router_hierarchy_gap`: nível sem o nível de cima). */
+        routerErrors: {
+            hierarchyGap: string;
+            /** Algum id de `allowed_type_ids` não é tipo de grupo do realm. */
+            invalidAllowedTypes: string;
+        };
+        groupErrors: {
+            invalidType: string;
+            adminTypeReserved: string;
+            emptyUpdate: string;
+            groupProjectImmutable: string;
+            groupNameTaken: string;
+            adminGroupImmutable: string;
+            adminGroupProtected: string;
+            adminGroupLastMember: string;
+            adminGroupAccessProtected: string;
+            groupNotFound: string;
+        };
     };
     /**
      * Tela "Auditoria" (`@trismegisto/spine/audit`, `SpineAuditComponent`): a mesma nos dois escopos — o
@@ -1332,6 +1669,127 @@ interface SpineMessages {
         /** `{app}`, `{operation}`, `{outcome}`, `{offset}`, `{duration}`. */
         spanRow: string;
     };
+    /** Tela Tentativas de login (`SpineLoginAttemptsComponent`, `@trismegisto/spine/audit`). */
+    /** Recursos opcionais do painel de configurações (`SpineFeatures`). */
+    accountFeatures: {
+        aiAgent: string;
+        aiAgentDescription: string;
+        aiAgentKeywords: string;
+        aiAgentHelp: string;
+        aiAgentStart: string;
+        aiAgentServers: string;
+        aiAgentAccess: string;
+        aiAgentReadOnly: string;
+        aiAgentReadWrite: string;
+        aiAgentWriteHint: string;
+        aiAgentReadOnlyServer: string;
+        aiAgentTokenName: string;
+        aiAgentGenerate: string;
+        aiAgentSelectServer: string;
+        aiAgentResult: string;
+        aiAgentResultHint: string;
+        aiAgentCopy: string;
+        aiAgentCopied: string;
+        aiAgentDone: string;
+        aiAgentCreateError: string;
+        aiAgentUnavailable: string;
+        activity: string;
+        activityDescription: string;
+        activityKeywords: string;
+        activityFilter: string;
+        activityAll: string;
+        activityFailures: string;
+        activityDetail: string;
+        activityApp: string;
+        activityEmpty: string;
+        activityMore: string;
+        activityShowing: string;
+        activityLoadError: string;
+        unknownIp: string;
+        unknownApp: string;
+        idle: string;
+        idleDescription: string;
+        idleKeywords: string;
+        idleNever: string;
+        idleOption: string;
+        idleLimitHint: string;
+        idleWarningHeading: string;
+        idleWarningText: PluralMessage;
+        idleStay: string;
+        idleLogout: string;
+        startPage: string;
+        startPageDescription: string;
+        startPageKeywords: string;
+        startHome: string;
+        startLast: string;
+        startFavorite: string;
+        startPageHint: string;
+        defaultBadge: string;
+        defaultBadgeDescription: string;
+        defaultBadgeKeywords: string;
+        defaultBadgeAuto: string;
+        defaultBadgeSaved: string;
+        defaultBadgeError: string;
+        defaultBadgeLoadError: string;
+        notices: string;
+        noticesDescription: string;
+        noticesKeywords: string;
+        browserNotices: string;
+        browserNoticesDescription: string;
+        browserNoticesDenied: string;
+        browserNoticesUnsupported: string;
+        /** Ação do aviso na tela que abre a `url` dele. */
+        noticeOpen: string;
+        sync: string;
+        syncDescription: string;
+        syncKeywords: string;
+        syncSynced: string;
+        syncSaving: string;
+        syncLocal: string;
+        syncError: string;
+        syncNow: string;
+    };
+    loginAttempts: {
+        refresh: string;
+        user: string;
+        userPlaceholder: string;
+        period: string;
+        result: string;
+        method: string;
+        all: string;
+        clear: string;
+        advancedFilters: string;
+        ip: string;
+        ipPlaceholder: string;
+        ipHint: string;
+        reason: string;
+        caption: string;
+        pageItems: string;
+        pageSize: string;
+        colDate: string;
+        colResult: string;
+        colMethod: string;
+        colUser: string;
+        colReason: string;
+        colIp: string;
+        colRealm: string;
+        colClient: string;
+        colUserAgent: string;
+        filterByIp: string;
+        filterByUser: string;
+        /** Identificador digitado que não corresponde a usuário nenhum. */
+        noMatchingUser: string;
+        methods: Record<'local' | 'mfa' | 'github' | 'google' | 'keycloak' | 'entraid', string>;
+        results: Record<'success' | 'failure' | 'cancelled', string>;
+        reasons: Record<'bad_password' | 'unknown_user' | 'locked' | 'mfa_failed' | 'mfa_expired' | 'mfa_not_allowed' | 'mfa_invalid_method' | 'recovery_failed' | 'recovery_refused' | 'not_linked' | 'wrong_realm', string>;
+        /** 403 no painel central (falta a operação). */
+        forbiddenAdmin: string;
+        /** 403 no auto-serviço (não administra o client). */
+        forbiddenClient: string;
+        /** Erro com o detalhe do servidor: `{detail}`. */
+        loadErrorDetail: string;
+        loadError: string;
+    };
 }
 declare const SPINE_MESSAGES_PT_BR: SpineMessages;
 
@@ -1357,11 +1815,15 @@ declare function currentSpineMessages(): SpineMessages;
  * Textos do spine no idioma ativo da lib (`HermesI18nService.locale`): uma troca de idioma com
  * `setLocale` atualiza a lib e o spine juntos, sem recarregar. Leitura igual à do `HERMES_MESSAGES`
  * (`inject(SPINE_MESSAGES).header.settings`), viva também em template.
+ *
+ * `meta.locale` é o de formatação da lib (`HermesI18nService.formatLocale`) quando a língua é a mesma: a
+ * variante regional (`en-GB`) e o relógio/primeiro dia da semana escolhidos em Região valem também nas
+ * datas e horas que o spine formata.
  */
 declare const SPINE_MESSAGES: InjectionToken<SpineMessages>;
 /** Sobrescreve textos do spine e/ou acrescenta idiomas. O idioma em si vem de `provideHermesI18n`. */
 declare function provideSpineMessages(config: SpineI18nConfig): Provider;
 
-export { APP_PACKAGE_INFO, DensityService, HERMES_DS_IMPORTS, SPINE_ADMIN_API, SPINE_CONFIG, SPINE_DEFAULT_LOGO, SPINE_I18N_CONFIG, SPINE_MESSAGES, SPINE_MESSAGES_EN, SPINE_MESSAGES_ES, SPINE_MESSAGES_PT_BR, SPINE_NEWS, SPINE_USER_STORAGE_KEYS, SpinePreferencesService, SpineQuickAccessService, SpineUserStorage, ThemePresetService, ThemeService, applyRuntimeEnvironment, applySpineFavicon, currentSpineMessages, mergeRouteTree, provideSpineMessages, provideSpineNews, provideUi, resolveSpineLogo, routerIdOf, spineRoutesOf };
-export type { DensitySetting, PackageInfo, QuickAccessItem, Route, RuntimeEnvironmentInfo, RuntimeEnvironmentShape, SpineConfig, SpineI18nConfig, SpineLogoConfig, SpineLogoSources, SpineMessages, SpineMessagesOverride, SpineNewsIllustration, SpineNewsItem, SpineNewsSlide, SpineUserStorageKey };
+export { APP_PACKAGE_INFO, DensityService, HERMES_DS_IMPORTS, SPINE_ADMIN_API, SPINE_CONFIG, SPINE_DEFAULT_LOGO, SPINE_I18N_CONFIG, SPINE_IDLE_OPTIONS, SPINE_MESSAGES, SPINE_MESSAGES_EN, SPINE_MESSAGES_ES, SPINE_MESSAGES_PT_BR, SPINE_NEWS, SPINE_USER_STORAGE_KEYS, SpinePreferencesService, SpineQuickAccessService, SpineUserStorage, ThemePresetService, ThemeService, applyRuntimeEnvironment, applySpineFavicon, currentSpineMessages, mergeRouteTree, provideSpineMessages, provideSpineNews, provideUi, resolveSpineLogo, routerIdOf, spineRoutesOf };
+export type { DensitySetting, PackageInfo, QuickAccessItem, Route, RuntimeEnvironmentInfo, RuntimeEnvironmentShape, SpineConfig, SpineFeatures, SpineHourCyclePreference, SpineI18nConfig, SpineLogoConfig, SpineLogoSources, SpineMcpServer, SpineMessages, SpineMessagesOverride, SpineNewsIllustration, SpineNewsItem, SpineNewsSlide, SpineNoticeType, SpineStartPagePreference, SpineUserStorageKey, SpineWeekStartPreference };
 //# sourceMappingURL=trismegisto-spine.d.ts.map