@wcstack/intersection 1.15.0 → 1.16.0

package/README.ja.md

@@ -137,7 +137,8 @@ export default {
 
 | コマンド       | 説明 |
 |---------------|-------------|
-| `observe()`   | DOM から `target` / `root` を再解決し、観測を（再）開始する。 |
+| `observe()`   | DOM から `target` / `root` を再解決し、観測を（再）開始する。冪等: ターゲット + オプションが不変なら no-op（新しいコールバックは発火しない）。 |
+| `reobserve()` | ターゲット / オプションが不変でも強制的に新規観測を行う — オブザーバを破棄して作り直すため、*現在の*可視状態に対して新しい初回コールバックが発火する。可視状態の遷移を伴わずレイアウトが変化した後（例: 無限スクロールで短いページが追加された）にエッジ駆動のコンシューマを再武装するのに使う。再武装成功中も `observing` は `true` のまま（誤った瞬断が起きない）。 |
 | `unobserve()` | 現在のターゲットの観測を停止する。 |
 | `disconnect()`| すべての観測を停止する。 |
 | `reset()`     | `visible` ラッチをクリアし、後の交差が再びそれを設定できるようにする。 |
@@ -159,7 +160,7 @@ IntersectionCore.wcBindable = {
     { name: "observing", event: "wcs-intersect:observing-changed" },
   ],
   commands: [
-    { name: "observe" }, { name: "unobserve" }, { name: "disconnect" }, { name: "reset" },
+    { name: "observe" }, { name: "reobserve" }, { name: "unobserve" }, { name: "disconnect" }, { name: "reset" },
   ],
 };
 ```

package/dist/index.d.ts

@@ -125,7 +125,9 @@ interface WcsIntersectInputs {
     trigger: boolean;
 }
 interface WcsIntersectCoreCommands {
-    observe(element: Element, options?: IntersectOptions): void;
+    observe(element: Element, options?: IntersectOptions): Promise<void>;
+    /** Force a fresh observation even when target+options are unchanged (rebuilds the observer). */
+    reobserve(element: Element, options?: IntersectOptions): void;
     unobserve(element: Element): void;
     disconnect(): void;
     /** Clear the `visible` latch so it can be set again by a later intersection. */
@@ -134,6 +136,8 @@ interface WcsIntersectCoreCommands {
 interface WcsIntersectCommands {
     /** Re-resolve the target/root from the DOM and (re)start observing. */
     observe(): void;
+    /** Re-resolve the target/root and force a fresh observation (rebuilds the observer). */
+    reobserve(): void;
     unobserve(): void;
     disconnect(): void;
     reset(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wcstack/intersection",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Declarative IntersectionObserver component for Web Components. Framework-agnostic visibility primitive via wc-bindable-protocol.",
   "type": "module",
   "main": "./dist/index.esm.js",