@sdcorejs/angular 20.1.3 → 20.1.5

package/services/unsaved-changes/index.d.ts

@@ -0,0 +1,83 @@
+import * as _angular_core from '@angular/core';
+import { Signal, InjectionToken } from '@angular/core';
+import { FormGroup } from '@angular/forms';
+import { CanDeactivateFn } from '@angular/router';
+
+type SdUnsavedChangesMaybeAsync<T> = T | PromiseLike<T>;
+type SdUnsavedChangesDirtySource = boolean | Signal<boolean> | (() => boolean);
+type SdUnsavedChangesDecision = 'save' | 'discard' | 'cancel';
+type SdUnsavedChangesReason = 'navigation' | 'close' | 'manual';
+interface SdUnsavedChangesWatcher {
+    readonly id: string;
+    readonly scope?: unknown;
+    readonly isDirty: SdUnsavedChangesDirtySource;
+    readonly message?: string;
+    readonly save?: () => SdUnsavedChangesMaybeAsync<void | boolean>;
+    readonly reset?: () => SdUnsavedChangesMaybeAsync<void | boolean>;
+    readonly discard?: () => SdUnsavedChangesMaybeAsync<void | boolean>;
+    readonly cleanup?: () => void;
+}
+interface SdUnsavedChangesPromptContext {
+    readonly reason: SdUnsavedChangesReason;
+    readonly scope?: unknown;
+    readonly message: string;
+    readonly watchers: readonly SdUnsavedChangesRegistration[];
+}
+interface SdUnsavedChangesConfirmationAdapter {
+    confirm(context: SdUnsavedChangesPromptContext): SdUnsavedChangesMaybeAsync<SdUnsavedChangesDecision | boolean>;
+}
+interface SdUnsavedChangesRegistration {
+    readonly id: string;
+    readonly scope?: unknown;
+    readonly message?: string;
+    readonly destroyed: Signal<boolean>;
+    readonly dirty: Signal<boolean>;
+    markDirty(): void;
+    markPristine(): void;
+    save(): Promise<boolean>;
+    reset(): Promise<boolean>;
+    discard(): Promise<boolean>;
+    destroy(): void;
+}
+interface SdUnsavedChangesConfirmOptions {
+    readonly scope?: unknown;
+    readonly reason?: SdUnsavedChangesReason;
+}
+
+interface SdUnsavedChangesWindow {
+    addEventListener(type: 'beforeunload', listener: (event: BeforeUnloadEvent) => void): void;
+    removeEventListener(type: 'beforeunload', listener: (event: BeforeUnloadEvent) => void): void;
+    confirm?(message?: string): boolean;
+}
+declare const SD_UNSAVED_CHANGES_WINDOW: InjectionToken<SdUnsavedChangesWindow | null>;
+declare const SD_UNSAVED_CHANGES_CONFIRMATION_ADAPTER: InjectionToken<SdUnsavedChangesConfirmationAdapter>;
+
+declare class SdUnsavedChangesService {
+    #private;
+    readonly registrations: _angular_core.Signal<SdUnsavedChangesRegistration[]>;
+    readonly dirty: _angular_core.Signal<boolean>;
+    constructor();
+    register(watcher: SdUnsavedChangesWatcher): SdUnsavedChangesRegistration;
+    hasChanges(scope?: unknown): boolean;
+    confirmLeave(options?: SdUnsavedChangesConfirmOptions): Promise<boolean>;
+    saveAll(scope?: unknown): Promise<boolean>;
+    resetAll(scope?: unknown): Promise<boolean>;
+    discardAll(scope?: unknown): Promise<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdUnsavedChangesService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdUnsavedChangesService>;
+}
+
+interface SdUnsavedChangesFormOptions<TValue> {
+    readonly id: string;
+    readonly scope?: unknown;
+    readonly message?: string;
+    readonly save?: (value: TValue) => SdUnsavedChangesMaybeAsync<void | boolean>;
+    readonly reset?: (form: FormGroup) => SdUnsavedChangesMaybeAsync<void | boolean>;
+    readonly discard?: (form: FormGroup) => SdUnsavedChangesMaybeAsync<void | boolean>;
+}
+declare function registerSdUnsavedChangesForm<TValue extends Record<string, unknown>>(service: SdUnsavedChangesService, form: FormGroup, options: SdUnsavedChangesFormOptions<TValue>): SdUnsavedChangesRegistration;
+declare function createSdUnsavedChangesCloseGuard(service: SdUnsavedChangesService, options?: Omit<SdUnsavedChangesConfirmOptions, 'reason'>): () => Promise<boolean>;
+declare const sdUnsavedChangesGuard: CanDeactivateFn<unknown>;
+
+export { SD_UNSAVED_CHANGES_CONFIRMATION_ADAPTER, SD_UNSAVED_CHANGES_WINDOW, SdUnsavedChangesService, createSdUnsavedChangesCloseGuard, registerSdUnsavedChangesForm, sdUnsavedChangesGuard };
+export type { SdUnsavedChangesConfirmOptions, SdUnsavedChangesConfirmationAdapter, SdUnsavedChangesDecision, SdUnsavedChangesDirtySource, SdUnsavedChangesFormOptions, SdUnsavedChangesMaybeAsync, SdUnsavedChangesPromptContext, SdUnsavedChangesReason, SdUnsavedChangesRegistration, SdUnsavedChangesWatcher, SdUnsavedChangesWindow };

package/services/viewport/index.d.ts

@@ -0,0 +1,42 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken } from '@angular/core';
+import * as _sdcorejs_angular_services_viewport from '@sdcorejs/angular/services/viewport';
+
+interface SdViewportBreakpoints {
+    mobile: number;
+    tablet: number;
+    desktop: number;
+}
+type SdViewportBreakpoint = keyof SdViewportBreakpoints;
+interface SdViewport {
+    innerWidth: number;
+    innerHeight?: number;
+    addEventListener(type: 'resize', listener: EventListenerOrEventListenerObject): void;
+    removeEventListener(type: 'resize', listener: EventListenerOrEventListenerObject): void;
+}
+
+declare const SD_VIEWPORT_DEFAULT_BREAKPOINTS: Readonly<SdViewportBreakpoints>;
+declare const SD_VIEWPORT: InjectionToken<SdViewport | null>;
+declare const SD_VIEWPORT_BREAKPOINTS: InjectionToken<Readonly<SdViewportBreakpoints>>;
+declare function sdNormalizeViewportBreakpoints(value: Readonly<SdViewportBreakpoints>): Readonly<SdViewportBreakpoints>;
+
+/**
+ * Exposes one SSR-safe, signal-based viewport state for the application.
+ * Breakpoints use min-width semantics and can be configured through `SD_VIEWPORT_BREAKPOINTS`.
+ */
+declare class SdViewportService {
+    #private;
+    readonly breakpoints: Readonly<_sdcorejs_angular_services_viewport.SdViewportBreakpoints>;
+    readonly width: _angular_core.Signal<number>;
+    readonly height: _angular_core.Signal<number>;
+    readonly currentBreakpoint: _angular_core.Signal<keyof _sdcorejs_angular_services_viewport.SdViewportBreakpoints>;
+    readonly isMobile: _angular_core.Signal<boolean>;
+    readonly isTablet: _angular_core.Signal<boolean>;
+    readonly isDesktop: _angular_core.Signal<boolean>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdViewportService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdViewportService>;
+}
+
+export { SD_VIEWPORT, SD_VIEWPORT_BREAKPOINTS, SD_VIEWPORT_DEFAULT_BREAKPOINTS, SdViewportService, sdNormalizeViewportBreakpoints };
+export type { SdViewport, SdViewportBreakpoint, SdViewportBreakpoints };