Fix component bugs across hooks, elements, form, layout, editors and utils

- Hooks: per-instance timers in useReady; cleanup for useIntersectionObserver;
  useWebSocket no longer reconnects after unmount/refresh, drains the queue
  and dispatches non-JSON messages
- Modal/Popover/Dropdown: onClose only on close, Escape to close, no stray
  DOM props, hooks before early return, scrollbar-aware positioning,
  top-left/top-right dropdown positions
- Elements: Toast/Search/StarRating per-instance timers, Pagination labels
  and empty state, Breadcrumbs titles, LinkList dividers/props, segment-wise
  active-link matching (new utils/link-matches-path), Table object cells
- Form: Select with a default option is changeable, Input clear notifies
  controlled parents and copy works on textareas, Checkbox random label,
  NumberInputButtons runaway interval, upload prop/spread fixes
- Layout: Button disabled while loading, Stack gap and Span truncate via
  inline styles, Img fallbackImageSrc, className/JSDoc fixes
- Editors/MDX/AI: TinyMCE id/cleanup/stale handler/duplicate scripts,
  AceEditor debounce, markdown heights and frontmatter regex, last
  assistant message, AIPromptBlock prompt ref
- Utils: fetchApi headers/FormData/fetchOptions/no mutation, base64 file
  names and read errors, slugify underscore trim, serializeQuery zero values
- Tests for fetchApi, link matching, slugify and serializeQuery
- AGENTS.md updated for the package layout

Co-Authored-By: Claude Opus 5.5 <[email protected]>

src/utils/link-matches-path.test.ts

@@ -0,0 +1,63 @@
+import { describe, expect, test } from "bun:test";
+import twuiLinkMatchesPath from "./link-matches-path";
+
+describe("twuiLinkMatchesPath", () => {
+    test("matches the exact path", () => {
+        expect(twuiLinkMatchesPath({ href: "/blog", pathname: "/blog" })).toBe(
+            true,
+        );
+    });
+
+    test("matches sub-paths when not strict", () => {
+        expect(
+            twuiLinkMatchesPath({ href: "/blog", pathname: "/blog/post-1" }),
+        ).toBe(true);
+    });
+
+    test("does not match sub-paths when strict", () => {
+        expect(
+            twuiLinkMatchesPath({
+                href: "/blog",
+                pathname: "/blog/post-1",
+                strict: true,
+            }),
+        ).toBe(false);
+    });
+
+    test("does not match a path that only shares a prefix", () => {
+        expect(
+            twuiLinkMatchesPath({ href: "/blog", pathname: "/blogging" }),
+        ).toBe(false);
+    });
+
+    test("root link only matches the root path", () => {
+        expect(twuiLinkMatchesPath({ href: "/", pathname: "/" })).toBe(true);
+        expect(twuiLinkMatchesPath({ href: "/", pathname: "/about" })).toBe(
+            false,
+        );
+    });
+
+    test("ignores trailing slashes, query strings and hashes", () => {
+        expect(
+            twuiLinkMatchesPath({ href: "/docs/?tab=1#top", pathname: "/docs" }),
+        ).toBe(true);
+        expect(twuiLinkMatchesPath({ href: "/docs", pathname: "/docs/" })).toBe(
+            true,
+        );
+    });
+
+    test("never matches links to other origins", () => {
+        expect(
+            twuiLinkMatchesPath({
+                href: "https://example.com/blog",
+                pathname: "/blog",
+            }),
+        ).toBe(false);
+    });
+
+    test("does not match hash-only links", () => {
+        expect(
+            twuiLinkMatchesPath({ href: "#section", pathname: "/blog" }),
+        ).toBe(false);
+    });
+});