@ktortu/aaa 0.9.0 → 0.9.2

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

@@ -0,0 +1,112 @@
+import * as i0 from '@angular/core';
+
+/**
+ * Déclencheur d'un [ktDisclosure] : posé sur un **vrai `<button>`** (clavier Entrée/Espace
+ * gratuit). Câble `(click)` → `toggle()` et reflète l'état via `aria-expanded` / `aria-controls`
+ * (cf. ADR-0004). `type="button"` est posé **s'il est absent** (ne pas soumettre un formulaire,
+ * sans écraser un `type` explicite du consommateur).
+ *
+ * Le contenu du bouton appartient au consommateur (texte, icône, libellé piloté par `expanded()`). Un
+ * **chevron** décoratif (qui pivote selon l'état) est affiché par défaut ; le désactiver avec
+ * `[chevron]="false"`. La directive applique elle-même la classe de style — rien à écrire.
+ *
+ * @example
+ * ```html
+ * <button ktDisclosureToggle>Détails</button>                    <!-- avec chevron -->
+ * <button ktDisclosureToggle [chevron]="false">Détails</button>  <!-- sans chevron -->
+ * ```
+ */
+declare class KtDisclosureToggle {
+    readonly disclosure: KtDisclosure;
+    private readonly host;
+    private readonly auditEnabled;
+    private isDestroyed;
+    /** Affiche le chevron décoratif (qui pivote selon l'état). @default true */
+    readonly chevron: i0.InputSignalWithTransform<boolean, unknown>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<KtDisclosureToggle, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<KtDisclosureToggle, "button[ktDisclosureToggle]", never, { "chevron": { "alias": "chevron"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Panneau repliable d'un [ktDisclosure]. **Composant** (et non directive) car l'animation grid
+ * `0fr ↔ 1fr` exige un **unique enfant `overflow:hidden`** autour du contenu projeté — ce wrapper
+ * (`.kt-disclosure-content__inner`) est fourni par le template, le consommateur reste libre d'y
+ * mettre autant de blocs qu'il veut.
+ *
+ * Porte l'`id` (cible de `aria-controls`) et passe **`inert`** quand c'est fermé : le contenu
+ * masqué sort de l'ordre de tabulation et de l'arbre d'accessibilité (jamais de focus dans
+ * l'invisible). Pas de `role=region` (anti-pollution du rotor de régions). Cf. ADR-0004.
+ *
+ * @example
+ * ```html
+ * <kt-disclosure-content>
+ *   <p>Premier bloc</p>
+ *   <p>Second bloc…</p>
+ * </kt-disclosure-content>
+ * ```
+ */
+declare class KtDisclosureContent {
+    readonly disclosure: KtDisclosure;
+    static ɵfac: i0.ɵɵFactoryDeclaration<KtDisclosureContent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<KtDisclosureContent, "kt-disclosure-content", never, {}, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Disclosure : replie/déplie un **bloc d'interface** (volet d'options, module de dashboard,
+ * section d'une fiche produit). Directive HÔTE d'une famille à trois marqueurs — elle possède
+ * l'état, génère l'`id` du panneau et expose des méthodes impératives ; le câblage ARIA et
+ * l'animation vivent sur `[ktDisclosureToggle]` / `<kt-disclosure-content>`.
+ *
+ * Pour une **section de contenu** de page (façon Wikipédia / FAQ), préférer `<details>` natif
+ * (sémantique, find-in-page, SEO, zéro JS) — cf. ADR-0004.
+ *
+ * L'état est exposé via `exportAs: 'ktDisclosure'` : lisez `expanded()` pour piloter le template
+ * (ex. libellé « Voir plus / Voir moins ») sans input de libellé (i18n côté consommateur,
+ * cf. ADR-0003).
+ *
+ * Contrat : **un** `[ktDisclosureToggle]` et **un** `<kt-disclosure-content>` par hôte (id de
+ * panneau unique / `aria-controls` non ambigu) ; un avertissement dev le signale sinon.
+ *
+ * @example
+ * ```html
+ * <div ktDisclosure #d="ktDisclosure">
+ *   <button ktDisclosureToggle>{{ d.expanded() ? 'Voir moins' : 'Voir plus' }}</button>
+ *   <kt-disclosure-content><p>Mon contenu</p></kt-disclosure-content>
+ * </div>
+ * ```
+ */
+declare class KtDisclosure {
+    private readonly idGen;
+    private readonly host;
+    private isDestroyed;
+    /** Identifiant stable du panneau contrôlé : cible de l'`aria-controls` du déclencheur. */
+    readonly contentId: string;
+    /**
+     * État ouvert/fermé. **Toujours utilisé en binding** (`[(expanded)]` / `[expanded]`), jamais en
+     * attribut nu : un `model()` n'accepte pas de `booleanAttribute`, donc `<div ktDisclosure expanded>`
+     * pousserait la chaîne `''` au lieu de `true`. En binding, la valeur est garantie booléenne.
+     * @default false
+     */
+    readonly expanded: i0.ModelSignal<boolean>;
+    private readonly auditEnabled;
+    readonly toggles: i0.Signal<readonly KtDisclosureToggle[]>;
+    readonly contents: i0.Signal<readonly KtDisclosureContent[]>;
+    constructor();
+    /** Bascule l'état. */
+    toggle(): void;
+    /** Ouvre le panneau. */
+    expand(): void;
+    /** Ferme le panneau. */
+    collapse(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<KtDisclosure, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<KtDisclosure, "[ktDisclosure]", ["ktDisclosure"], { "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, ["toggles", "contents"], never, true, never>;
+}
+
+/**
+ * Import ergonomique de toute la famille disclosure en une fois :
+ * `imports: [KtDisclosureImports]` au lieu d'énumérer chaque marqueur.
+ */
+declare const KtDisclosureImports: readonly [typeof KtDisclosure, typeof KtDisclosureToggle, typeof KtDisclosureContent];
+
+export { KtDisclosure, KtDisclosureContent, KtDisclosureImports, KtDisclosureToggle };