valtech-components 4.0.540 → 4.0.542

package/lib/components/molecules/picker-v2/picker-v2.component.d.ts

@@ -24,8 +24,8 @@ export declare class PickerV2Component {
     selectionChange: EventEmitter<string>;
     private host;
     readonly open: import("@angular/core").WritableSignal<boolean>;
-    readonly selectedOption: import("@angular/core").Signal<PickerV2Option>;
-    readonly displayText: import("@angular/core").Signal<string>;
+    selectedOption(): PickerV2Option | undefined;
+    displayText(): string;
     toggle(): void;
     select(option: PickerV2Option): void;
     onDocumentClick(event: MouseEvent): void;

package/lib/components/organisms/bottom-nav/side-nav-adapter.d.ts

@@ -0,0 +1,7 @@
+import { SideNavItem } from '../../templates/page-wrapper/types';
+import { BottomNavMetadata } from './types';
+export interface SideNavFromBottomNavOptions {
+    translate?: (key: string, namespace?: string) => string;
+    exact?: boolean;
+}
+export declare function buildSideNavItemsFromBottomNav(config: BottomNavMetadata, options?: SideNavFromBottomNavOptions): SideNavItem[];

package/lib/components/organisms/mini-games/chessimals-challenge-progress.service.d.ts

@@ -32,7 +32,11 @@ export declare class ChessimalsChallengeProgressService {
     private runsPath;
     private readLocalActiveRun;
     private writeLocalActiveRun;
+    private clearLocalActiveRun;
     private localActiveRunKey;
+    private newestActiveRun;
+    private runProgressScore;
+    private runTime;
     private withoutUndefined;
     static ɵfac: i0.ɵɵFactoryDeclaration<ChessimalsChallengeProgressService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ChessimalsChallengeProgressService>;

package/lib/components/organisms/mini-games/chessimals-game.component.d.ts

@@ -114,7 +114,7 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     readonly botProfiles: ChessimalsBotProfile[];
     readonly challengeLadder: ChessimalsChallengeBot[];
     readonly animals: ChessimalsAnimalView[];
-    readonly valtechComponentsVersion = "4.0.540";
+    readonly valtechComponentsVersion = "4.0.542";
     readonly screen: import("@angular/core").WritableSignal<"home" | "challenge" | "path" | "game">;
     readonly selectedBoardSize: import("@angular/core").WritableSignal<ChessimalsBoardSize>;
     readonly selectedLocalMode: import("@angular/core").WritableSignal<ChessimalsLocalMode>;
@@ -135,9 +135,12 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     readonly turnSecondsRemaining: import("@angular/core").WritableSignal<number>;
     readonly selectedPieceId: import("@angular/core").WritableSignal<string>;
     readonly selectedAnimal: import("@angular/core").WritableSignal<ChessimalsAnimalType>;
+    readonly isPlayOptionsModalOpen: import("@angular/core").WritableSignal<boolean>;
     readonly isRulesModalOpen: import("@angular/core").WritableSignal<boolean>;
     readonly isSettingsModalOpen: import("@angular/core").WritableSignal<boolean>;
     readonly isAboutModalOpen: import("@angular/core").WritableSignal<boolean>;
+    private pendingSoloGameStart;
+    private pendingAboutFeedbackNavigation;
     readonly tutorialMode: import("@angular/core").WritableSignal<boolean>;
     readonly isBoardOrienting: import("@angular/core").WritableSignal<boolean>;
     readonly movingPiece: import("@angular/core").WritableSignal<ChessimalsMovingPieceView>;
@@ -178,6 +181,7 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     readonly selectedBotProfile: import("@angular/core").Signal<ChessimalsBotProfile>;
     readonly gameBotProfile: import("@angular/core").Signal<ChessimalsBotProfile>;
     readonly activeChallengeBot: import("@angular/core").Signal<ChessimalsChallengeBot>;
+    readonly resumableChallengeRun: import("@angular/core").Signal<ChessimalsChallengeRun>;
     set onlineGameId(value: string | null | undefined);
     miniGamesRoute: string;
     projectionMode: boolean;
@@ -245,6 +249,7 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     readonly confirmTitle: import("@angular/core").Signal<string>;
     readonly confirmBody: import("@angular/core").Signal<string>;
     readonly confirmActions: import("@angular/core").Signal<ButtonMetadata[]>;
+    readonly playOptionsActions: import("@angular/core").Signal<ButtonMetadata[]>;
     readonly rulesActions: import("@angular/core").Signal<ButtonMetadata[]>;
     readonly aboutActions: import("@angular/core").Signal<ButtonMetadata[]>;
     readonly actionHint: import("@angular/core").Signal<string>;
@@ -255,12 +260,17 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     private shortUserId;
     private rangeValueToNumber;
     startChallenge(): void;
+    requestNewChallenge(): void;
     openChallengeView(): void;
     backToHome(): void;
+    private cancelActiveGameplayFeedback;
     private createNewChallengeRun;
+    private resetChallengeSessionState;
     resumeChallenge(run?: ChessimalsChallengeRun): void;
     continueChallenge(): void;
     private startChallengeRound;
+    private enterChallengeRound;
+    private isResumableChallengeRun;
     startGame(): void;
     private handleChallengeRoundFinished;
     private abandonChallengeIfNeeded;
@@ -272,6 +282,7 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     restartGame(): void;
     exitTutorial(): void;
     resetToModeSetup(): void;
+    private returnChallengeToMenu;
     resetToGamesMenu(): void;
     private resetFinishedLocalGameForNextVisit;
     requestRestartGame(): void;
@@ -282,6 +293,12 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     handleConfirmModalDismissed(): void;
     confirmPendingAction(token?: string): void;
     private resignGame;
+    openPlayOptionsModal(): void;
+    closePlayOptionsModal(): void;
+    handlePlayOptionsModalDismissed(): void;
+    handlePlayOptionsAction(event: {
+        action?: ButtonMetadata;
+    }): void;
     openRulesModal(): void;
     closeRulesModal(): void;
     openSettingsModal(): void;
@@ -289,6 +306,10 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     openPathView(): void;
     openAboutModal(): void;
     closeAboutModal(): void;
+    handleAboutModalDismissed(): void;
+    handleAboutAction(event: {
+        action?: ButtonMetadata;
+    }): void;
     setMusicVolume(value: number | RangeValue): void;
     setSfxVolume(value: number | RangeValue): void;
     private tutorialExpectedMove;
@@ -306,6 +327,9 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     private isPromotionMove;
     private animateMove;
     private applyAnimatedMove;
+    private activeGameForRun;
+    private persistActiveChallengeGame;
+    private cloneChallengeGame;
     private playPowerUnlockSound;
     private queueBotTurnIfNeeded;
     private playBotTurn;
@@ -397,10 +421,14 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     botProfileDescription(profile: ChessimalsBotProfile): string;
     botProfileTendency(profile: ChessimalsBotProfile): string;
     botProfileAvatar(profileId: ChessimalsBotProfileId): string;
+    botProfileAvatarSrc(profileId: ChessimalsBotProfileId): string;
     challengeBotProfile(bot: ChessimalsChallengeBot): ChessimalsBotProfile | undefined;
     challengeOpeningBot(): ChessimalsChallengeBot;
     challengeMenuBot(): ChessimalsChallengeBot;
     challengeMenuRoundLabel(): string;
+    challengeMenuLivesLabel(): string;
+    challengeMenuClearedRound(): number;
+    private challengeMenuRun;
     challengeBotName(bot: ChessimalsChallengeBot): string;
     challengeBotDifficultyLabel(bot: ChessimalsChallengeBot): string;
     challengeBotStyleLine(bot: ChessimalsChallengeBot): string;
@@ -412,6 +440,7 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     showChallengeIntro(): void;
     dismissChallengeIntro(): void;
     challengeLiveAvatar(): string;
+    challengeLiveAvatarSrc(): string;
     challengeLiveRivalName(): string;
     challengeLiveRivalLine(): string;
     challengeLiveStreakLabel(): string;
@@ -422,10 +451,12 @@ export declare class ChessimalsGameComponent implements OnInit, OnDestroy {
     challengeOutcomeTitle(): string;
     challengeOutcomeBody(): string;
     challengeSummaryAvatar(): string;
+    challengeSummaryAvatarSrc(): string;
     challengeRoundStageLabel(): string;
     challengeRivalVoiceLabel(): string;
     challengeRivalVoiceTitle(): string;
     challengeRivalVoiceBody(): string;
+    private challengeVoiceText;
     challengeNextRivalLabel(): string;
     challengeContinueLabel(): string;
     challengeNextRivalHint(): string;

package/lib/components/organisms/mini-games/retro-audio.service.d.ts

@@ -10,6 +10,7 @@ export declare class RetroAudioService {
     private pausedMelody?;
     private suspendTimer?;
     private readonly activeSamples;
+    private readonly activeBufferSources;
     private sampleMusic?;
     private sampleMusicConfig?;
     private sampleMusicSource?;
@@ -91,6 +92,7 @@ export declare class RetroAudioService {
     private sampleMusicVolume;
     private sampleVolume;
     private applyActiveSampleVolumes;
+    private stopActiveSamples;
     private connectSampleMusic;
     private disconnectSampleMusicGraph;
     private tone;

package/lib/components/organisms/mini-games/types.d.ts

@@ -58,6 +58,7 @@ export interface ChessimalsBotProfile {
     id: ChessimalsBotProfileId;
     difficulty: ChessimalsBotDifficulty;
     avatar: string;
+    avatarSrc?: string;
     labelKey: string;
     descriptionKey: string;
 }
@@ -107,6 +108,7 @@ export interface ChessimalsChallengeRun {
     currentStreak: number;
     botLadder: string[];
     roundResults: ChessimalsChallengeRoundResult[];
+    activeGame?: ChessimalsGameState;
     startedAt: string;
     lastEventAt?: string;
     updatedAt: string;

package/lib/components/organisms/toolbar/types.d.ts

@@ -10,6 +10,7 @@ import { FontSizeSelectorMetadata } from '../../molecules/font-size-selector/typ
  * Metadatos para la barra de herramientas.
  * @property withBack Si muestra botón de retroceso.
  * @property withMenu (opcional) Si muestra botón de menú.
+ * @property menuId (opcional) ID del menú Ionic que abre el botón de menú.
  * @property backText (opcional) Texto del botón de retroceso.
  * @property withActions Si muestra acciones.
  * @property color (opcional) Color de fondo.
@@ -21,6 +22,7 @@ import { FontSizeSelectorMetadata } from '../../molecules/font-size-selector/typ
 export type ToolbarMetadata = {
     withBack: boolean;
     withMenu?: boolean;
+    menuId?: string;
     backText?: string;
     withActions: boolean;
     color?: Color;

package/lib/services/forms/form-schema-builder.service.d.ts

@@ -1,12 +1,26 @@
 import { ValidatorFn } from '@angular/forms';
 import { ComponentState, FormMetadata, InputMetadata, InputType } from '../../components/types';
-import { FieldSchemaDef } from './types';
+import { CanonicalFieldAliases, FieldSchemaDef, FormSchemaConfig } from './types';
 import * as i0 from "@angular/core";
 export declare class FormSchemaBuilderService {
     private i18n;
     buildForm(schema: FieldSchemaDef[], i18nNamespace: string, formName: string, submitLabelKey?: string, state?: ComponentState): FormMetadata;
     protected buildField(def: FieldSchemaDef, i18nNamespace: string, state: ComponentState): InputMetadata;
+    createFieldSchema(field: Partial<FieldSchemaDef> & Pick<FieldSchemaDef, 'name' | 'label'>, order: number): FieldSchemaDef;
+    createFormSchemaConfig(input: {
+        schemaId: string;
+        schemaVersion?: string;
+        labelEs?: string;
+        labelEn?: string;
+        fields: FieldSchemaDef[];
+        canonicalAliases?: CanonicalFieldAliases;
+    }): FormSchemaConfig;
+    buildCanonicalMap(fields: FieldSchemaDef[], aliases?: CanonicalFieldAliases): Record<string, string>;
+    toToken(value: string): string;
+    uniqueFieldName(value: string, existingFields: Array<Pick<FieldSchemaDef, 'name'>>): string;
     protected parseValidators(def: FieldSchemaDef): ValidatorFn[];
+    defaultValidatorsFor(type: string, required: boolean): string[];
+    private normalizeOptions;
     protected parseInputType(typeStr: string): InputType;
     static ɵfac: i0.ɵɵFactoryDeclaration<FormSchemaBuilderService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<FormSchemaBuilderService>;

package/lib/services/forms/types.d.ts

@@ -33,3 +33,7 @@ export interface FormSchemaConfig {
     canonicalMap?: Record<string, string>;
     fieldSchema: FieldSchemaDef[];
 }
+export interface CanonicalFieldAliases {
+    [canonicalName: string]: string[];
+}
+export declare const DEFAULT_CANONICAL_FIELD_ALIASES: CanonicalFieldAliases;

package/lib/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export declare const VERSION = "4.0.540";
+export declare const VERSION = "4.0.542";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "4.0.540",
+  "version": "4.0.542",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"

package/public-api.d.ts

@@ -288,6 +288,7 @@ export * from './lib/components/organisms/terminal-404/terminal-404.component';
 export * from './lib/components/organisms/terminal-404/types';
 export * from './lib/components/organisms/bottom-nav/bottom-nav.component';
 export * from './lib/components/organisms/bottom-nav/types';
+export * from './lib/components/organisms/bottom-nav/side-nav-adapter';
 export * from './lib/components/organisms/avatar-upload/avatar-upload.component';
 export * from './lib/components/organisms/avatar-upload/types';
 export * from './lib/components/organisms/profile-view/profile-view.component';
@@ -525,3 +526,4 @@ export { TypingIndicatorComponent } from './lib/components/molecules/typing-indi
 export { ChatWindowComponent } from './lib/components/organisms/chat-window/chat-window.component';
 export * from './lib/components/organisms/chat-window/types';
 export { ThreadPanelComponent } from './lib/components/organisms/thread-panel/thread-panel.component';
+export * from './lib/services/forms';

package/src/lib/assets/games/README.md

@@ -0,0 +1,149 @@
+# Game Art Assets
+
+Guia breve para generar, limpiar y guardar arte raster para mini juegos.
+
+## Cuando usar este flujo
+
+Usar `image_gen` para assets visuales de juego que deban sentirse hechos a medida:
+
+- avatares de rivales o jugadores;
+- cartas, fichas, piezas, power-ups o insignias;
+- fondos, escenas, tableros decorativos o banners internos;
+- sprites o sprite sheets simples.
+
+No usar este flujo para iconos que ya pertenezcan al sistema visual, SVGs deterministas, diagramas simples o UI que pueda resolverse mejor con CSS/HTML.
+
+## Flujo recomendado
+
+1. Generar el asset con `image_gen`.
+2. Si se necesita transparencia, pedir fondo chroma plano.
+3. Copiar el resultado desde `$CODEX_HOME/generated_images/...` al workspace.
+4. Remover chroma localmente.
+5. Recortar, centrar y normalizar tamanos.
+6. Revisar sobre fondo claro y oscuro.
+7. Guardar solo los assets finales usados por la app.
+8. Conectar el asset con fallback textual o emoji si aplica.
+
+## Prompt base para transparencia
+
+```text
+Create the requested game asset on a perfectly flat solid #00ff00 chroma-key background for background removal.
+The background must be one uniform color with no shadows, gradients, texture, reflections, floor plane, or lighting variation.
+Keep the subject fully separated from the background with crisp edges and generous padding.
+Do not use #00ff00 anywhere in the subject.
+No cast shadow, no contact shadow, no reflection, no watermark, and no text unless explicitly requested.
+```
+
+Para sujetos verdes, usar otro chroma improbable, por ejemplo `#ff00ff`.
+
+## Remover chroma
+
+Preferir el helper instalado por Codex:
+
+```bash
+python "${CODEX_HOME:-$HOME/.codex}/skills/.system/imagegen/scripts/remove_chroma_key.py" \
+  --input <source.png> \
+  --out <final.png> \
+  --auto-key border \
+  --soft-matte \
+  --transparent-threshold 12 \
+  --opaque-threshold 220 \
+  --despill
+```
+
+Si el borde queda con halo, reintentar una vez con:
+
+```bash
+python "${CODEX_HOME:-$HOME/.codex}/skills/.system/imagegen/scripts/remove_chroma_key.py" \
+  --input <source.png> \
+  --out <final.png> \
+  --auto-key border \
+  --soft-matte \
+  --transparent-threshold 12 \
+  --opaque-threshold 220 \
+  --edge-contract 1 \
+  --despill
+```
+
+## Sprite sheets
+
+Para varios personajes, suele funcionar mejor pedir una sprite sheet consistente:
+
+```text
+Create 8 cute pixel art rival avatar portraits in a single 4x2 sprite sheet.
+Each cell must have the same size, consistent outline thickness, same lighting and generous padding.
+No text, no letters, no numbers, no watermark.
+```
+
+Despues recortar cada celda, remover chroma, centrar en un canvas cuadrado y exportar cada item con nombre semantico:
+
+```text
+explorer.png
+guardian.png
+hunter.png
+```
+
+## Ubicacion
+
+Guardar assets finales en:
+
+```text
+frontend/valtech-components/src/lib/assets/games/<game-id>/
+```
+
+Ejemplo:
+
+```text
+frontend/valtech-components/src/lib/assets/games/chessimals/challenge-avatars/explorer.png
+```
+
+Para marcas oficiales de un juego, usar un subdirectorio `brand`:
+
+```text
+frontend/valtech-components/src/lib/assets/games/chessimals/brand/chessimals-emblem.png
+```
+
+No dejar archivos fuente temporales, hojas generadas o variantes descartadas en el repo salvo que sean necesarios para mantenimiento.
+
+## Validacion visual
+
+Antes de conectar el asset:
+
+- revisar esquinas transparentes;
+- revisar que no exista halo del chroma;
+- probar sobre fondo claro y oscuro;
+- verificar que se lea bien al tamano real de UI;
+- comprobar que no se pueda arrastrar desde la interfaz (`draggable="false"` y CSS anti-drag si aplica);
+- mantener `alt=""` cuando el asset sea decorativo y ya exista texto visible con el nombre.
+
+## Conexion en Angular
+
+Preferir rutas relativas servidas como assets:
+
+```ts
+avatarSrc: 'assets/games/chessimals/challenge-avatars/explorer.png'
+```
+
+En template, mantener fallback:
+
+```html
+@if (avatarSrc; as src) {
+  <img [src]="src" alt="" draggable="false" />
+} @else {
+  {{ fallbackAvatar }}
+}
+```
+
+## Caso de referencia
+
+Chessimals usa este flujo para los avatares pixel art del modo Desafio:
+
+```text
+frontend/valtech-components/src/lib/assets/games/chessimals/challenge-avatars/
+```
+
+Documentacion ampliada:
+
+```text
+docs/frontend/mini-games-art-assets.md
+```

package/src/lib/assets/games/chessimals/brand/README.md

@@ -0,0 +1,23 @@
+# Chessimals Brand Assets
+
+Assets oficiales de marca para Chessimals.
+
+## Archivos
+
+- `chessimals-wordmark.png`: palabra CHESSIMALS transparente. Usar cuando ya exista otro elemento visual fuerte cerca.
+- `chessimals-emblem.png`: escudo transparente con las cuatro caritas. Usar como icono, card de selector, about o marca compacta.
+- `chessimals-app-icon.png`: icono maestro 1024x1024 para app stores, PWA o superficies grandes.
+- `chessimals-app-icon-capacitor.png`: fuente 1024x1024 RGB, opaca y sin borde transparente para generar assets con Capacitor.
+- `chessimals-app-icon-512.png`: icono 512x512 para manifiestos PWA.
+- `chessimals-app-icon-192.png`: icono 192x192 para manifiestos PWA.
+- `chessimals-favicon.png`: favicon PNG 64x64.
+
+## Reglas
+
+- No volver a usar `logo.jpg` o `menu-logo.jpg` para superficies nuevas.
+- Componer emblema y wordmark en HTML/CSS cuando se necesite una portada o splash.
+- Usar `chessimals-app-icon.png` como fuente maestra si se necesitan nuevos tamanos de icono.
+- Usar `chessimals-app-icon-capacitor.png` para `@capacitor/assets`; no usar PNGs transparentes como fuente de iconos nativos.
+- Mantener `alt=""` cuando el logo acompane texto visible de Chessimals.
+- Usar `draggable="false"` o CSS anti-drag si aparece en superficies interactivas.
+- Si se genera una nueva version, preservar estos nombres solo cuando se reemplace oficialmente el asset.

package/src/lib/assets/games/chessimals/powers/README.md

@@ -0,0 +1,12 @@
+# Chessimals Power Assets
+
+Official UI assets for the animal power cards.
+
+- `eagle-power.png`: diagonal flight power.
+- `bull-power.png`: straight charge power.
+- `kangaroo-power.png`: jump power.
+- `lion-power.png`: wide board power.
+
+Each asset is a transparent 512x512 PNG generated from the current Chessimals
+brand direction. Keep new power assets text-free so labels can remain localized
+in the Angular UI.