@ktortu/aaa 0.9.5 → 0.9.7

package/types/ktortu-aaa-layout.d.ts

@@ -0,0 +1,117 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken } from '@angular/core';
+import * as i1 from '@angular/cdk/a11y';
+
+/** Mode d'état de la navigation latérale. */
+type KtSidenavState = 'expanded' | 'rail' | 'hidden';
+declare const KT_LAYOUT_DEFAULT_STATE: InjectionToken<KtSidenavState>;
+/**
+ * Service global de gestion de la mise en page (Layout).
+ * Gère l'état d'ouverture/fermeture de la barre latérale sur mobile et bureau,
+ * ainsi que le comportement spécifique de "rail" sur bureau.
+ *
+ * NOTE: Ce service n'est pas "providedIn: 'root'". Le développeur doit le fournir
+ * (via le tableau providers d'un composant parent ou de l'application) pour
+ * maîtriser le scope (ex: avoir plusieurs layouts indépendants).
+ */
+declare class KtLayoutService {
+    private readonly viewport;
+    private readonly defaultState;
+    /**
+     * Comportement actif lors de la fermeture sur ordinateur (écran non mobile).
+     * Renseigné généralement par le composant racine `KtLayoutComponent`.
+     */
+    readonly desktopCloseBehavior: _angular_core.WritableSignal<"rail" | "hidden">;
+    private readonly _isDesktopOpen;
+    private readonly _isMobileOpen;
+    readonly isMobile: _angular_core.Signal<boolean>;
+    readonly isRail: _angular_core.Signal<boolean>;
+    readonly isExpanded: _angular_core.Signal<boolean>;
+    readonly isHidden: _angular_core.Signal<boolean>;
+    readonly isMobileOpen: _angular_core.Signal<boolean>;
+    toggle(): void;
+    open(): void;
+    close(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtLayoutService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<KtLayoutService>;
+}
+
+/**
+ * Composant racine de l'application qui gère la structure de base (Sidebar, Toolbar, Contenu).
+ * Configure dynamiquement le comportement du layout.
+ */
+declare class KtLayoutComponent {
+    /**
+     * Définit le comportement de la navigation latérale lors de sa fermeture sur bureau (écran large).
+     * - `'hidden'` (défaut) : le menu est complètement masqué et retiré du flux visuel/a11y.
+     * - `'rail'` : le menu est réduit à une fine barre verticale (mini-sidebar), permettant
+     *              d'afficher uniquement les icônes. Idéal si les liens possèdent des icônes explicites.
+     */
+    readonly desktopCloseBehavior: _angular_core.InputSignal<"rail" | "hidden">;
+    protected readonly layout: KtLayoutService;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtLayoutComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtLayoutComponent, "kt-layout", never, { "desktopCloseBehavior": { "alias": "desktopCloseBehavior"; "required": false; "isSignal": true; }; }, {}, never, ["kt-sidenav", "kt-toolbar", "*"], true, never>;
+}
+
+/**
+ * Composant représentant le panneau latéral de navigation.
+ * Se comporte comme un tiroir (drawer) superposé sur mobile, et comme un
+ * menu latéral persistant (réductible ou masquable) sur ordinateur.
+ */
+declare class KtSidenavComponent {
+    protected readonly layout: KtLayoutService;
+    protected readonly isHidden: _angular_core.Signal<boolean>;
+    private readonly trapFocus;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtSidenavComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtSidenavComponent, "kt-sidenav", never, {}, {}, never, ["*"], true, [{ directive: typeof i1.CdkTrapFocus; inputs: {}; outputs: {}; }]>;
+}
+
+/**
+ * Barre d'outils supérieure (Toolbar / Top app bar).
+ * Se place généralement dans un `kt-layout`.
+ */
+declare class KtToolbarComponent {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtToolbarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtToolbarComponent, "kt-toolbar", never, {}, {}, never, ["*"], true, never>;
+}
+
+declare class KtNavItemComponent {
+    label: _angular_core.InputSignal<string>;
+    protected readonly layout: KtLayoutService;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtNavItemComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtNavItemComponent, "kt-nav-item", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; }, {}, never, ["[kt-icon]", "*"], true, never>;
+}
+
+/**
+ * Directive applicable sur n'importe quel élément (souvent un bouton) pour basculer
+ * l'état d'ouverture du panneau latéral (Sidenav).
+ *
+ * Expose l'état du layout pour des utilisations dynamiques dans le template
+ * (ex: changer l'icône selon l'état).
+ *
+ * @example
+ * ```html
+ * <button ktSidenavToggle #btn="ktSidenavToggle" [icon]="btn.isRail() ? 'right' : 'left'">
+ * ```
+ */
+declare class KtSidenavToggleDirective {
+    private readonly layout;
+    /** Indique si le menu est actuellement réduit en mode rail. */
+    readonly isRail: _angular_core.Signal<boolean>;
+    /** Indique si le menu est actuellement complètement étendu sur bureau. */
+    readonly isExpanded: _angular_core.Signal<boolean>;
+    /** Indique si le menu est totalement masqué. */
+    readonly isHidden: _angular_core.Signal<boolean>;
+    /** Indique si le tiroir est actuellement ouvert par-dessus le contenu (mobile). */
+    readonly isMobileOpen: _angular_core.Signal<boolean>;
+    /** Indique si l'écran actuel est de taille compacte (mobile). */
+    readonly isMobile: _angular_core.Signal<boolean>;
+    onClick(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtSidenavToggleDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KtSidenavToggleDirective, "[ktSidenavToggle]", ["ktSidenavToggle"], {}, {}, never, never, true, never>;
+}
+
+export { KT_LAYOUT_DEFAULT_STATE, KtLayoutComponent, KtLayoutService, KtNavItemComponent, KtSidenavComponent, KtSidenavToggleDirective, KtToolbarComponent };
+export type { KtSidenavState };

package/types/ktortu-aaa.d.ts

@@ -10,3 +10,4 @@ export * from '@ktortu/aaa/snackbar';
 export * from '@ktortu/aaa/tabs';
 export * from '@ktortu/aaa/tooltip';
 export * from '@ktortu/aaa/progress-bar';
+export * from '@ktortu/aaa/layout';