fix: improve TypeScript types in documentation examples and simplify code

Author: devin-ai-integration[bot]

browser/websocket/listen.ts

@@ -41,8 +41,16 @@ export type ListenStreamError =
  *                 - once: Listen only once if true
  *
  * Example:
- * ```ts
- * listen(socket, "project:update", (data: ProjectUpdateData) => {
+ * ```typescript
+ * import { type ScrapboxSocket } from "./socket.ts";
+ * import { type ListenEvents } from "./listen-events.ts";
+ * 
+ * // Setup socket and controller
+ * const socket: ScrapboxSocket = /* ... */;
+ * const controller = new AbortController();
+ * 
+ * // Listen for project updates
+ * listen<"project:updates">(socket, "project:updates", (data) => {
  *   console.log("Project updated:", data);
  * }, { signal: controller.signal });
  * ```

browser/websocket/pin.ts

@@ -43,8 +43,7 @@ export const pin = (
       ) return [];
       // Create page and pin it in a single operation
       // Note: The server accepts combined creation and pin operations
-      const pinChange: Change = { pin: pinNumber() };
-      const changes: Change[] = [pinChange];
+      const changes: Change[] = [{ pin: pinNumber() }];
       if (!page.persistent) changes.unshift({ title });
       return changes;
     },

rest/getCodeBlocks.ts

@@ -97,7 +97,7 @@ export const getCodeBlocks = (
   const codeBlocks: TinyCodeBlock[] = [];
 
   let currentCode: CodeTitle & {
-    /** 読み取り中の行がコードブロックかどうか */
+    /** Whether the current line is part of a code block */
     isCodeBlock: boolean;
   } = {
     isCodeBlock: false,
@@ -137,7 +137,7 @@ export const getCodeBlocks = (
   return codeBlocks.filter((codeBlock) => isMatchFilter(codeBlock, filter));
 };
 
-/** コードブロックのフィルターに合致しているか検証する */
+/** Verify if a code block matches the specified filter criteria */
 const isMatchFilter = (
   codeBlock: TinyCodeBlock,
   filter?: GetCodeBlocksFilter,