@xosue-utils/services 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# @xosue-utils/services
+
+Overlays de pantalla completa / root-level reutilizables (alert, toast, context-menu, media viewer, session request, loadings, AI autofill, browser notifications).
+
+**Deben montarse una sola vez en el root del host** (`app.component.html`). Ocupan viewport completo vía `position: fixed`.
+
+## Instalación
+
+```json
+"@xosue-utils/services": "file:../xosue-utils/services"
+```
+
+Peers: `@angular/common|core|forms|platform-browser|router|animations` ^19, `@lucide/angular`, `rxjs`.
+
+El host necesita `provideAnimations()` (o `BrowserAnimationsModule`) por alert/toast/session.
+
+## Configuración
+
+```ts
+import { provideXosueUtilsServices } from '@xosue-utils/services';
+
+providers: [
+  provideXosueUtilsServices({
+    alertAcceptLabel: 'OK',
+    sessionLoginPath: '/login',
+    toastSoundUrl: '/assets/sounds/toast.mp3',
+    mediaFileNameFallback: 'File',
+  }),
+]
+```
+
+Defaults en español (paridad Caludy).
+
+## Mount en el host
+
+```html
+<alert-service></alert-service>
+<toast-service></toast-service>
+<context-menu-service></context-menu-service>
+<media-viewer-service></media-viewer-service>
+<session-request-service></session-request-service>
+<global-loading-service></global-loading-service>
+<navigation-loading-service></navigation-loading-service>
+<ai-autofill-overlay-service></ai-autofill-overlay-service>
+```
+
+Importa los componentes standalone en `AppComponent`.
+
+## Context menu
+
+Copia propia de `ContextMenuService` + `ContextMenuServiceComponent` (+ `FieldHelpTooltipComponent`).  
+`@xosue-utils/inputs` sigue exportando su copia en `vendor/`; más adelante inputs puede re-exportar desde aquí sin romper apps actuales.
+
+## Media viewer
+
+API: `MediaViewerService.open()` / `close()` / `state$`.
+
+El host pasa **URLs ya resueltas** (sin crypto/CDN decrypt en el paquete). Players de video/audio son nativos (sin `hls.js` / `wavesurfer.js`).
+
+## Colores
+
+Sin `#hex` / `rgb()` / `rgba()` en Sass. Solo `var(--…)` y `color-mix(in srgb, var(--…) N%, transparent)`.
+
+## Build
+
+```bash
+cd D:\apps\xosue-utils\services
+npm install
+npm run build
+```

package/config/services-config.d.ts

@@ -0,0 +1,46 @@
+import { InjectionToken, Provider } from '@angular/core';
+export type ToastDurationKey = 'success' | 'warning' | 'error' | 'info';
+export interface XosueUtilsServicesConfig {
+    /** i18n / labels */
+    alertAcceptLabel?: string;
+    alertCancelLabel?: string;
+    loadingDefaultMessage?: string;
+    sessionRegisterPath?: string;
+    sessionLoginPath?: string;
+    sessionRegisterLabel?: string;
+    sessionLoginLabel?: string;
+    /** toast assets (absolute or app-root relative) */
+    toastSoundUrl?: string;
+    toastErrorSoundUrl?: string;
+    toastSuccessGifUrl?: string;
+    toastDurationsMs?: Partial<Record<ToastDurationKey, number>>;
+    /** media viewer */
+    mediaFileNameFallback?: string;
+    /** browser notification */
+    browserNotificationIconUrl?: string;
+    browserNotificationSoundUrl?: string;
+    browserNotificationPermissionPrompt?: string;
+}
+export declare const XOSUE_UTILS_SERVICES_DEFAULTS: Required<Omit<XosueUtilsServicesConfig, 'toastDurationsMs' | 'toastSuccessGifUrl'>> & {
+    toastSuccessGifUrl: string;
+    toastDurationsMs: Record<ToastDurationKey, number>;
+};
+export type ResolvedXosueUtilsServicesConfig = typeof XOSUE_UTILS_SERVICES_DEFAULTS;
+export declare const XOSUE_UTILS_SERVICES_CONFIG: InjectionToken<Required<Omit<XosueUtilsServicesConfig, "toastDurationsMs" | "toastSuccessGifUrl">> & {
+    toastSuccessGifUrl: string;
+    toastDurationsMs: Record<ToastDurationKey, number>;
+}>;
+export declare function resolveXosueUtilsServicesConfig(config?: XosueUtilsServicesConfig): ResolvedXosueUtilsServicesConfig;
+/**
+ * Provide overlay services configuration in the host app.
+ *
+ * ```ts
+ * providers: [
+ *   provideXosueUtilsServices({
+ *     sessionLoginPath: '/login',
+ *     toastSoundUrl: '/assets/sounds/toast.mp3',
+ *   }),
+ * ]
+ * ```
+ */
+export declare function provideXosueUtilsServices(config?: XosueUtilsServicesConfig): Provider[];