From bc1de360946ec81d24633d5dcf32410eda5084a5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C2=A1ke?= <77801554+front42@users.noreply.github.com>
Date: Mon, 9 Feb 2026 13:41:52 +0300
Subject: [PATCH] fix: correct terms and restore the lost option in
 dispatch-events article.md en

---
 2-ui/2-events/05-dispatch-events/article.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/2-ui/2-events/05-dispatch-events/article.md b/2-ui/2-events/05-dispatch-events/article.md
index 047413fd3d..528373afea 100644
--- a/2-ui/2-events/05-dispatch-events/article.md
+++ b/2-ui/2-events/05-dispatch-events/article.md
@@ -19,11 +19,12 @@ let event = new Event(type[, options]);
 Arguments:
 
 - *type* -- event type, a string like `"click"` or our own like `"my-event"`.
-- *options* -- the object with two optional properties:
+- *options* -- the object with three optional properties:
   - `bubbles: true/false` -- if `true`, then the event bubbles.
   - `cancelable: true/false` -- if `true`, then the "default action"  may be prevented. Later we'll see what it means for custom events.
+  - `composed: true/false` -- if `true`, then the event will trigger listeners outside of a shadow root, exiting the Shadow DOM. Later we’ll cover this in [Web Components](https://javascript.info/shadow-dom-events#event-composed) section.
 
-  By default both are false: `{bubbles: false, cancelable: false}`.
+By default all three are **false**: `{bubbles: false, cancelable: false, composed: false}`.
 
 ## dispatchEvent
 
@@ -274,9 +275,10 @@ The output order becomes: 1 -> 2 -> nested.
 
 To generate an event from code, we first need to create an event object.
 
-The generic `Event(name, options)` constructor accepts an arbitrary event name and the `options` object with two properties:
+The generic `Event(type[, options])` constructor accepts a required `type` parameter -- a string that specifies the event name (type), and an optional `options` object with three properties (all false by default):
 - `bubbles: true` if the event should bubble.
 - `cancelable: true` if the `event.preventDefault()` should work.
+- `composed: true` if the event should exit the Shadow DOM, becoming available to listeners outside of a shadow root.
 
 Other constructors of native events like `MouseEvent`, `KeyboardEvent` and so on accept properties specific to that event type. For instance, `clientX` for mouse events.