stimeo-ui 0.16.0 → 0.18.0

package/dist/controllers/conditional_fields_controller.d.ts

@@ -28,6 +28,11 @@ type Trigger = HTMLInputElement | HTMLSelectElement;
  * another region being hidden in the same pass — the controller root temporarily
  * receives `tabindex="-1"` and focus.
  *
+ * An element that stops being a region gets back what this controller wrote on
+ * it: `aria-hidden`, `data-visible`, the `hidden` a declared condition set, and
+ * the marked `disabled` of each control no hidden region still covers. The
+ * `hidden` of a region without a condition and every authored `disabled` stay.
+ *
  * `change` and `reconcile` dispatch `{ region, visible }`.
  *
  * @remarks
@@ -71,8 +76,16 @@ declare class ConditionalFieldsController extends Controller<HTMLElement> {
     triggerTargetDisconnected(): void;
     /** Initializes a region target inserted or restored at runtime. */
     regionTargetConnected(): void;
-    /** Reconciles the remaining region set after a target leaves. */
-    regionTargetDisconnected(): void;
+    /**
+     * Queues a departed region for the return of its written state and reconciles the rest.
+     *
+     * The return is queued rather than immediate because teardown reports every
+     * region as disconnected, and a disconnected controller leaves its derived state
+     * in the DOM. The pass that drains the queue skips an element that is still a
+     * region, which drops what teardown queued, and keeps a departure queued before
+     * a disconnect for the pass after the reconnect.
+     */
+    regionTargetDisconnected(region: HTMLElement): void;
     /** Reconciles when application code or a morph changes the match policy. */
     matchValueChanged(): void;
     /** Reconciles control ownership when hidden controls become enabled or excluded. */