From 150b9761df53bf561428df58983f0bbaf7aae131 Mon Sep 17 00:00:00 2001
From: GGGGGGGGGGGGGGG_J <115770858+NaturalSoda4552@users.noreply.github.com>
Date: Tue, 20 Oct 2026 11:37:35 +0900
Subject: [PATCH] docs(useOutsideClickEffect): document nullable container
 arrays

---
 .changeset/nullable-outside-click-containers.md             | 5 +++++
 .../react-simplikit/references/useOutsideClickEffect.md     | 6 +++---
 .../hooks/useOutsideClickEffect/es/useOutsideClickEffect.md | 6 +++---
 .../hooks/useOutsideClickEffect/ja/useOutsideClickEffect.md | 6 +++---
 .../hooks/useOutsideClickEffect/ko/useOutsideClickEffect.md | 6 +++---
 .../hooks/useOutsideClickEffect/useOutsideClickEffect.md    | 6 +++---
 .../hooks/useOutsideClickEffect/useOutsideClickEffect.ts    | 4 ++--
 .../useOutsideClickEffect/zh-Hans/useOutsideClickEffect.md  | 6 +++---
 8 files changed, 25 insertions(+), 20 deletions(-)
 create mode 100644 .changeset/nullable-outside-click-containers.md

diff --git a/.changeset/nullable-outside-click-containers.md b/.changeset/nullable-outside-click-containers.md
new file mode 100644
index 00000000..ecbbd4d5
--- /dev/null
+++ b/.changeset/nullable-outside-click-containers.md
@@ -0,0 +1,5 @@
+---
+'react-simplikit': patch
+---
+
+Document that `useOutsideClickEffect` accepts `null` entries in container arrays, matching its existing type and behavior.
diff --git a/packages/plugin/skills/react-simplikit/references/useOutsideClickEffect.md b/packages/plugin/skills/react-simplikit/references/useOutsideClickEffect.md
index 36d526de..66da3362 100644
--- a/packages/plugin/skills/react-simplikit/references/useOutsideClickEffect.md
+++ b/packages/plugin/skills/react-simplikit/references/useOutsideClickEffect.md
@@ -7,7 +7,7 @@ It is useful for closing modals, dropdowns, tooltips, and other UI components wh
 
 ```ts
 function useOutsideClickEffect(
-  container: HTMLElement | HTMLElement[] | null,
+  container: HTMLElement | (HTMLElement | null)[] | null,
   callback: () => void
 ): void;
 ```
@@ -17,8 +17,8 @@ function useOutsideClickEffect(
 <Interface
   required
   name="container"
-  type="HTMLElement | HTMLElement[] | null"
-  description="A single HTML element, an array of HTML elements, or <code>null</code>. If <code>null</code>, the callback is not executed."
+  type="HTMLElement | (HTMLElement | null)[] | null"
+  description="A single HTML element, an array of HTML elements or <code>null</code> values, or <code>null</code>. <code>null</code> entries are ignored. If no HTML elements remain, the callback is not executed."
 />
 
 <Interface
diff --git a/packages/react-simplikit/src/hooks/useOutsideClickEffect/es/useOutsideClickEffect.md b/packages/react-simplikit/src/hooks/useOutsideClickEffect/es/useOutsideClickEffect.md
index 13209286..3eb22f51 100644
--- a/packages/react-simplikit/src/hooks/useOutsideClickEffect/es/useOutsideClickEffect.md
+++ b/packages/react-simplikit/src/hooks/useOutsideClickEffect/es/useOutsideClickEffect.md
@@ -7,7 +7,7 @@ Es útil para cerrar modales, menús desplegables, descripciones emergentes y ot
 
 ```ts
 function useOutsideClickEffect(
-  container: HTMLElement | HTMLElement[] | null,
+  container: HTMLElement | (HTMLElement | null)[] | null,
   callback: () => void
 ): void;
 ```
@@ -17,8 +17,8 @@ function useOutsideClickEffect(
 <Interface
   required
   name="container"
-  type="HTMLElement | HTMLElement[] | null"
-  description="Un único elemento HTML, un arreglo de elementos HTML o <code>null</code>. Si es <code>null</code>, el callback no se ejecuta."
+  type="HTMLElement | (HTMLElement | null)[] | null"
+  description="Un único elemento HTML, un arreglo de elementos HTML o valores <code>null</code>, o <code>null</code>. Los valores <code>null</code> del arreglo se ignoran. Si no queda ningún elemento HTML, el callback no se ejecuta."
 />
 
 <Interface
diff --git a/packages/react-simplikit/src/hooks/useOutsideClickEffect/ja/useOutsideClickEffect.md b/packages/react-simplikit/src/hooks/useOutsideClickEffect/ja/useOutsideClickEffect.md
index 69659abc..4414c4a5 100644
--- a/packages/react-simplikit/src/hooks/useOutsideClickEffect/ja/useOutsideClickEffect.md
+++ b/packages/react-simplikit/src/hooks/useOutsideClickEffect/ja/useOutsideClickEffect.md
@@ -7,7 +7,7 @@
 
 ```ts
 function useOutsideClickEffect(
-  container: HTMLElement | HTMLElement[] | null,
+  container: HTMLElement | (HTMLElement | null)[] | null,
   callback: () => void
 ): void;
 ```
@@ -17,8 +17,8 @@ function useOutsideClickEffect(
 <Interface
   required
   name="container"
-  type="HTMLElement | HTMLElement[] | null"
-  description="単一の HTML 要素、HTML 要素の配列、または <code>null</code> です。<code>null</code> の場合、コールバックは実行されません。"
+  type="HTMLElement | (HTMLElement | null)[] | null"
+  description="単一の HTML 要素、HTML 要素や <code>null</code> を含む配列、または <code>null</code> です。配列内の <code>null</code> は無視されます。HTML 要素が一つも残らない場合、コールバックは実行されません。"
 />
 
 <Interface
diff --git a/packages/react-simplikit/src/hooks/useOutsideClickEffect/ko/useOutsideClickEffect.md b/packages/react-simplikit/src/hooks/useOutsideClickEffect/ko/useOutsideClickEffect.md
index 6076f873..cfa29700 100644
--- a/packages/react-simplikit/src/hooks/useOutsideClickEffect/ko/useOutsideClickEffect.md
+++ b/packages/react-simplikit/src/hooks/useOutsideClickEffect/ko/useOutsideClickEffect.md
@@ -6,7 +6,7 @@
 
 ```ts
 function useOutsideClickEffect(
-  container: HTMLElement | HTMLElement[] | null,
+  container: HTMLElement | (HTMLElement | null)[] | null,
   callback: () => void
 ): void;
 ```
@@ -16,8 +16,8 @@ function useOutsideClickEffect(
 <Interface
   required
   name="container"
-  type="HTMLElement | HTMLElement[] | null"
-  description="단일 HTML 요소, HTML 요소 배열 또는 <code>null</code>이에요. <code>null</code>인 경우, 콜백이 실행되지 않아요."
+  type="HTMLElement | (HTMLElement | null)[] | null"
+  description="단일 HTML 요소, HTML 요소나 <code>null</code>을 담은 배열 또는 <code>null</code>이에요. 배열의 <code>null</code>은 무시돼요. HTML 요소가 하나도 남지 않으면 콜백이 실행되지 않아요."
 />
 
 <Interface
diff --git a/packages/react-simplikit/src/hooks/useOutsideClickEffect/useOutsideClickEffect.md b/packages/react-simplikit/src/hooks/useOutsideClickEffect/useOutsideClickEffect.md
index 36d526de..66da3362 100644
--- a/packages/react-simplikit/src/hooks/useOutsideClickEffect/useOutsideClickEffect.md
+++ b/packages/react-simplikit/src/hooks/useOutsideClickEffect/useOutsideClickEffect.md
@@ -7,7 +7,7 @@ It is useful for closing modals, dropdowns, tooltips, and other UI components wh
 
 ```ts
 function useOutsideClickEffect(
-  container: HTMLElement | HTMLElement[] | null,
+  container: HTMLElement | (HTMLElement | null)[] | null,
   callback: () => void
 ): void;
 ```
@@ -17,8 +17,8 @@ function useOutsideClickEffect(
 <Interface
   required
   name="container"
-  type="HTMLElement | HTMLElement[] | null"
-  description="A single HTML element, an array of HTML elements, or <code>null</code>. If <code>null</code>, the callback is not executed."
+  type="HTMLElement | (HTMLElement | null)[] | null"
+  description="A single HTML element, an array of HTML elements or <code>null</code> values, or <code>null</code>. <code>null</code> entries are ignored. If no HTML elements remain, the callback is not executed."
 />
 
 <Interface
diff --git a/packages/react-simplikit/src/hooks/useOutsideClickEffect/useOutsideClickEffect.ts b/packages/react-simplikit/src/hooks/useOutsideClickEffect/useOutsideClickEffect.ts
index 4528379d..acf8b610 100644
--- a/packages/react-simplikit/src/hooks/useOutsideClickEffect/useOutsideClickEffect.ts
+++ b/packages/react-simplikit/src/hooks/useOutsideClickEffect/useOutsideClickEffect.ts
@@ -9,8 +9,8 @@ type OneOrMore<T> = T | T[];
  * `useOutsideClickEffect` is a React hook that triggers a callback when a click event occurs outside the specified container(s).
  * It is useful for closing modals, dropdowns, tooltips, and other UI components when clicking outside.
  *
- * @param {HTMLElement | HTMLElement[] | null} container - A single HTML element, an array of HTML elements, or `null`.
- *   If `null`, the callback is not executed.
+ * @param {HTMLElement | (HTMLElement | null)[] | null} container - A single HTML element, an array of HTML elements or `null` values, or `null`.
+ *   `null` entries are ignored. If no HTML elements remain, the callback is not executed.
  * @param {() => void} callback - A function that is executed when clicking outside the specified container(s).
  *
  * @example
diff --git a/packages/react-simplikit/src/hooks/useOutsideClickEffect/zh-Hans/useOutsideClickEffect.md b/packages/react-simplikit/src/hooks/useOutsideClickEffect/zh-Hans/useOutsideClickEffect.md
index 88f96759..f41f9855 100644
--- a/packages/react-simplikit/src/hooks/useOutsideClickEffect/zh-Hans/useOutsideClickEffect.md
+++ b/packages/react-simplikit/src/hooks/useOutsideClickEffect/zh-Hans/useOutsideClickEffect.md
@@ -6,7 +6,7 @@
 
 ```ts
 function useOutsideClickEffect(
-  container: HTMLElement | HTMLElement[] | null,
+  container: HTMLElement | (HTMLElement | null)[] | null,
   callback: () => void
 ): void;
 ```
@@ -16,8 +16,8 @@ function useOutsideClickEffect(
 <Interface
   required
   name="container"
-  type="HTMLElement | HTMLElement[] | null"
-  description="单个 HTML 元素、HTML 元素数组或 <code>null</code>。如果为 <code>null</code>，则不执行回调。"
+  type="HTMLElement | (HTMLElement | null)[] | null"
+  description="单个 HTML 元素、包含 HTML 元素或 <code>null</code> 的数组，或 <code>null</code>。数组中的 <code>null</code> 会被忽略。如果没有剩余的 HTML 元素，则不执行回调。"
 />
 
 <Interface