gs-x-parser 1.0.2 → 1.0.3

package/lib/dom.cjs

@@ -0,0 +1,141 @@
+"use strict";
+var frsProbe = require('gs-dom/frs-probe');
+const DomIdReg = /status\/(\d+)/;
+function parseTweetIdByDom(el) {
+  const href = el?.querySelector('a[href*="/status/"]')?.href;
+  return DomIdReg.exec(href || "")?.[1];
+}
+function parseTweetIdByProps(el) {
+  return getTweetIdByProps(frsProbe.getReactProps(el)) || parseTweetIdByDom(el);
+}
+function getTweetIdByProps(props) {
+  if (props.entry?.content?.targetTweets?.["0"])
+    return props.entry.content.targetTweets[0];
+  if (props.children?.entry?.content?.targetTweets?.["0"])
+    return props.children.entry.content.targetTweets[0];
+  if (props.children?.props?.entry?.content?.targetTweets?.["0"])
+    return props.children.props.entry.content.targetTweets[0];
+  if (props.children?.props?.children?.props?.entry?.content?.targetTweets?.["0"])
+    return props.children.props.children.props.entry.content.targetTweets[0];
+  if (props.entry?.content?.url?.url) {
+    const tweetIdFromUrl = extractTweetIdFromUrl(props.entry.content.url.url);
+    if (tweetIdFromUrl)
+      return tweetIdFromUrl;
+  } else if (props.children?.entry?.content?.url?.url) {
+    const tweetIdFromUrl = extractTweetIdFromUrl(props.children.entry.content.url.url);
+    if (tweetIdFromUrl)
+      return tweetIdFromUrl;
+  } else if (props.children?.props?.entry?.content?.url?.url) {
+    const tweetIdFromUrl = extractTweetIdFromUrl(props.children.props.entry.content.url.url);
+    if (tweetIdFromUrl)
+      return tweetIdFromUrl;
+  } else if (props.children?.props?.children?.props?.entry?.content?.url?.url) {
+    const tweetIdFromUrl = extractTweetIdFromUrl(props.children.props.children.props.entry.content.url.url);
+    if (tweetIdFromUrl)
+      return tweetIdFromUrl;
+  }
+  if (props.children?.["2"]?.props?.tweet?.id_str)
+    return props.children?.[2].props.tweet.id_str;
+  if (props.children?.props?.tweet?.id_str)
+    return props.children.props.tweet.id_str;
+  if (props.children?.props?.children?.props?.tweet?.id_str)
+    return props.children.props.children.props.tweet.id_str;
+  let displayType;
+  if (props.displayType ? displayType = props.displayType : props.children?.displayType ? displayType = props.children.displayType : props.children?.props?.displayType ? displayType = props.children.props.displayType : props.children?.props?.children?.props?.displayType ? displayType = props.children.props.children.props.displayType : props.entry?.content?.displayType ? displayType = props.entry.content.displayType : props.children?.entry?.content?.displayType ? displayType = props.children.entry.content.displayType : props.children?.props?.entry?.content?.displayType ? displayType = props.children.props.entry.content.displayType : props.children?.props?.children?.props?.entry?.content?.displayType && (displayType = props.children.props.children.props.entry.content.displayType), displayType !== "Tweet" && displayType !== "FocalTweet" && displayType !== "MediaGrid")
+    return props.children?.sibling ? getTweetIdFromSibling(props.children.sibling) : props.children?._owner?.sibling ? getTweetIdFromSibling(props.children._owner.sibling) : props.children?.props?.sibling ? getTweetIdFromSibling(props.children.props.sibling) : props.children?._owner?.return?.sibling ? getTweetIdFromSibling(props.children._owner.return.sibling) : void 0;
+  let contentId;
+  if (props.entry?.content?.id ? contentId = props.entry.content.id : props.children?.entry?.content?.id ? contentId = props.children.entry.content.id : props.children?.props?.entry?.content?.id ? contentId = props.children.props.entry.content.id : props.children?.props?.children?.props?.entry?.content?.id ? contentId = props.children.props.children.props.entry.content.id : props.item?.id ? contentId = props.item.id : props.children?.item?.id ? contentId = props.children.item.id : props.children?.props?.item?.id ? contentId = props.children.props.item.id : props.item?.data?.content?.id ? contentId = props.item.data.content.id : props.children?.item?.data?.content?.id ? contentId = props.children.item.data.content.id : props.children?.props?.item?.data?.content?.id && (contentId = props.children.props.item.data.content.id), contentId)
+    return contentId;
+  let entryId;
+  if (props.entry?.entryId ? entryId = props.entry.entryId : props.children?.entry?.entryId ? entryId = props.children.entry.entryId : props.children?.props?.entry?.entryId ? entryId = props.children.props.entry.entryId : props.children?.props?.children?.props?.entry?.entryId ? entryId = props.children.props.children.props.entry.entryId : props.item?.data?.entryId ? entryId = props.item.data.entryId : props.children?.item?.data?.entryId ? entryId = props.children.item.data.entryId : props.children?.props?.item?.data?.entryId && (entryId = props.children.props.item.data.entryId), entryId && entryId.startsWith("tweet-"))
+    return entryId.substring(6);
+}
+function extractTweetIdFromUrl(url) {
+  const match = url.match(/\/status\/(\d+)/);
+  if (match && match[1])
+    return match[1];
+}
+function getTweetIdFromSibling(sibling) {
+  if (sibling.key && sibling.key.startsWith("tweet-"))
+    return sibling.key.substring(6);
+  if (sibling.props?.item?.id && sibling.props.item.id.startsWith("tweet-"))
+    return sibling.props.item.id.substring(6);
+  if (sibling.props?.item?.data?.content?.id)
+    return sibling.props.item.data.content.id;
+  if (sibling.props?.item?.data?.entryId && sibling.props.item.data.entryId.startsWith("tweet-"))
+    return sibling.props.item.data.entryId.substring(6);
+  if (sibling.sibling)
+    return getTweetIdFromSibling(sibling.sibling);
+}
+function parseUserIdByProps(el) {
+  return getTweetUserIdByProps(frsProbe.getReactProps(el)) || parseTweetIdByDom(el);
+}
+function getTweetUserIdByProps(props) {
+  if (!props)
+    return;
+  if (props.entry?.content?.fromUsers?.["0"])
+    return props.entry.content.fromUsers[0];
+  if (props.children?.entry?.content?.fromUsers?.["0"])
+    return props.children.entry.content.fromUsers[0];
+  if (props.children?.props?.entry?.content?.fromUsers?.["0"])
+    return props.children.props.entry.content.fromUsers[0];
+  if (props.children?.props?.children?.props?.entry?.content?.fromUsers?.["0"])
+    return props.children.props.children.props.entry.content.fromUsers[0];
+  let displayType;
+  if (props.displayType ? displayType = props.displayType : props.children?.displayType ? displayType = props.children.displayType : props.children?.props?.displayType ? displayType = props.children.props.displayType : props.children?.props?.children?.props?.displayType ? displayType = props.children.props.children.props.displayType : props.entry?.content?.displayType ? displayType = props.entry.content.displayType : props.children?.entry?.content?.displayType ? displayType = props.children.entry.content.displayType : props.children?.props?.entry?.content?.displayType ? displayType = props.children.props.entry.content.displayType : props.children?.props?.children?.props?.entry?.content?.displayType && (displayType = props.children.props.children.props.entry.content.displayType), displayType === "User") {
+    if (props.entry?.content?.id)
+      return props.entry.content.id;
+    if (props.children?.entry?.content?.id)
+      return props.children.entry.content.id;
+    if (props.children?.props?.entry?.content?.id)
+      return props.children.props.entry.content.id;
+    if (props.children?.props?.children?.props?.entry?.content?.id)
+      return props.children.props.children.props.entry.content.id;
+    if (props.item?.id)
+      return props.item.id;
+    if (props.children?.item?.id)
+      return props.children.item.id;
+    if (props.children?.props?.item?.id)
+      return props.children.props.item.id;
+    if (props.item?.data?.content?.id)
+      return props.item.data.content.id;
+    if (props.children?.item?.data?.content?.id)
+      return props.children.item.data.content.id;
+    if (props.children?.props?.item?.data?.content?.id)
+      return props.children.props.item.data.content.id;
+  }
+}
+const cellSelector = '[data-testid="cellInnerDiv"]', cellInnerSelector = `${cellSelector} [aria-labelledby^="id__"]`, cellPreviewSelector = `${cellSelector} [data-testid="previewInterstitial"]`, itemSelector = `${cellSelector} [role="listitem"]`, previewVideoSelector = `${cellPreviewSelector}:not([aria-label*=GIF])`, primaryRegionSelector = 'main [data-testid="primaryColumn"] [role="region"]', primaryCellSelector = `${primaryRegionSelector} ${cellSelector}`, primaryCellInnerSelector = `${primaryRegionSelector} ${cellInnerSelector}`, primaryItemSelector = `${primaryRegionSelector} ${itemSelector}`, primaryTweetSelector = [primaryCellSelector, primaryItemSelector].join(","), primaryPreviewVideoSelector = `${primaryRegionSelector} ${previewVideoSelector}`, ImageVideoIdRegex = /(?:video_thumb|card_img)\/(\d+)/, LinkVideoIdRegex = /status\/(\d+)\/video\/(\d+)/;
+function parseTweetVideoId(el) {
+  if (!el) return;
+  const itemEl = el.matches(primaryItemSelector) ? el : el.closest(primaryItemSelector);
+  return itemEl ? parseTweetVideoIdByVideoContainer(itemEl) : parseTweetVideoIdByVideoContainer(el.matches(primaryPreviewVideoSelector) ? el : el.closest(primaryPreviewVideoSelector), !0);
+}
+function parseTweetVideoIdByVideoContainer(el, defaultTweet) {
+  if (!el)
+    return;
+  const img = el.querySelector('img[src*="video_thumb/"],img[src*="card_img/"]');
+  if (img) {
+    const videoId = ImageVideoIdRegex.exec(img.src)?.[1];
+    if (videoId)
+      return { videoId };
+  }
+  const link = el.querySelector('a[href*="/status/"][href*="/video/"]');
+  if (!link) {
+    if (!defaultTweet)
+      return;
+    const tweetId2 = parseTweetIdByDom(el);
+    if (tweetId2) {
+      let index = Array.from(el.querySelectorAll(primaryPreviewVideoSelector)).indexOf(el);
+      return index === -1 && (index = 0), { index, tweetId: tweetId2 };
+    }
+    return;
+  }
+  const match = LinkVideoIdRegex.exec(link.href), tweetId = match?.[1];
+  if (!tweetId)
+    return {
+      tweetId,
+      index: parseInt(match[2]) || 0
+    };
+}
+exports.cellInnerSelector = cellInnerSelector, exports.cellPreviewSelector = cellPreviewSelector, exports.cellSelector = cellSelector, exports.getTweetIdByProps = getTweetIdByProps, exports.itemSelector = itemSelector, exports.parseTweetIdByDom = parseTweetIdByDom, exports.parseTweetIdByProps = parseTweetIdByProps, exports.parseTweetVideoId = parseTweetVideoId, exports.parseTweetVideoIdByVideoContainer = parseTweetVideoIdByVideoContainer, exports.parseUserIdByProps = parseUserIdByProps, exports.previewVideoSelector = previewVideoSelector, exports.primaryCellInnerSelector = primaryCellInnerSelector, exports.primaryCellSelector = primaryCellSelector, exports.primaryItemSelector = primaryItemSelector, exports.primaryPreviewVideoSelector = primaryPreviewVideoSelector, exports.primaryRegionSelector = primaryRegionSelector, exports.primaryTweetSelector = primaryTweetSelector;

package/lib/dom.d.ts

@@ -0,0 +1,30 @@
+import { IReactXCellDivProps, IGetTweetVideoIdResult } from './type.d.ts';
+
+declare function parseTweetIdByProps(el: Element): string | undefined;
+/**
+ * 获取 Tweet 或 FocalTweet 类型的内容 ID
+ * @param props React 组件属性
+ * @returns 内容 ID，如果不存在则返回 undefined
+ */
+declare function getTweetIdByProps(props: IReactXCellDivProps): string | undefined;
+
+declare function parseUserIdByProps(el: Element): string | undefined;
+
+declare function parseTweetIdByDom(el: Element): string | undefined;
+
+declare function parseTweetVideoId(el: Element): IGetTweetVideoIdResult | undefined;
+declare function parseTweetVideoIdByVideoContainer(el: HTMLElement, defaultTweet?: boolean): IGetTweetVideoIdResult | undefined;
+
+declare const cellSelector = "[data-testid=\"cellInnerDiv\"]";
+declare const cellInnerSelector = "[data-testid=\"cellInnerDiv\"] [aria-labelledby^=\"id__\"]";
+declare const cellPreviewSelector = "[data-testid=\"cellInnerDiv\"] [data-testid=\"previewInterstitial\"]";
+declare const itemSelector = "[data-testid=\"cellInnerDiv\"] [role=\"listitem\"]";
+declare const previewVideoSelector = "[data-testid=\"cellInnerDiv\"] [data-testid=\"previewInterstitial\"]:not([aria-label*=GIF])";
+declare const primaryRegionSelector = "main [data-testid=\"primaryColumn\"] [role=\"region\"]";
+declare const primaryCellSelector = "main [data-testid=\"primaryColumn\"] [role=\"region\"] [data-testid=\"cellInnerDiv\"]";
+declare const primaryCellInnerSelector = "main [data-testid=\"primaryColumn\"] [role=\"region\"] [data-testid=\"cellInnerDiv\"] [aria-labelledby^=\"id__\"]";
+declare const primaryItemSelector = "main [data-testid=\"primaryColumn\"] [role=\"region\"] [data-testid=\"cellInnerDiv\"] [role=\"listitem\"]";
+declare const primaryTweetSelector: string;
+declare const primaryPreviewVideoSelector = "main [data-testid=\"primaryColumn\"] [role=\"region\"] [data-testid=\"cellInnerDiv\"] [data-testid=\"previewInterstitial\"]:not([aria-label*=GIF])";
+
+export { cellInnerSelector, cellPreviewSelector, cellSelector, getTweetIdByProps, itemSelector, parseTweetIdByDom, parseTweetIdByProps, parseTweetVideoId, parseTweetVideoIdByVideoContainer, parseUserIdByProps, previewVideoSelector, primaryCellInnerSelector, primaryCellSelector, primaryItemSelector, primaryPreviewVideoSelector, primaryRegionSelector, primaryTweetSelector };

package/lib/dom.mjs

@@ -0,0 +1,158 @@
+import { getReactProps } from 'gs-dom/frs-probe';
+const DomIdReg = /status\/(\d+)/;
+function parseTweetIdByDom(el) {
+  const href = el?.querySelector('a[href*="/status/"]')?.href;
+  return DomIdReg.exec(href || "")?.[1];
+}
+function parseTweetIdByProps(el) {
+  return getTweetIdByProps(getReactProps(el)) || parseTweetIdByDom(el);
+}
+function getTweetIdByProps(props) {
+  if (props.entry?.content?.targetTweets?.["0"])
+    return props.entry.content.targetTweets[0];
+  if (props.children?.entry?.content?.targetTweets?.["0"])
+    return props.children.entry.content.targetTweets[0];
+  if (props.children?.props?.entry?.content?.targetTweets?.["0"])
+    return props.children.props.entry.content.targetTweets[0];
+  if (props.children?.props?.children?.props?.entry?.content?.targetTweets?.["0"])
+    return props.children.props.children.props.entry.content.targetTweets[0];
+  if (props.entry?.content?.url?.url) {
+    const tweetIdFromUrl = extractTweetIdFromUrl(props.entry.content.url.url);
+    if (tweetIdFromUrl)
+      return tweetIdFromUrl;
+  } else if (props.children?.entry?.content?.url?.url) {
+    const tweetIdFromUrl = extractTweetIdFromUrl(props.children.entry.content.url.url);
+    if (tweetIdFromUrl)
+      return tweetIdFromUrl;
+  } else if (props.children?.props?.entry?.content?.url?.url) {
+    const tweetIdFromUrl = extractTweetIdFromUrl(props.children.props.entry.content.url.url);
+    if (tweetIdFromUrl)
+      return tweetIdFromUrl;
+  } else if (props.children?.props?.children?.props?.entry?.content?.url?.url) {
+    const tweetIdFromUrl = extractTweetIdFromUrl(props.children.props.children.props.entry.content.url.url);
+    if (tweetIdFromUrl)
+      return tweetIdFromUrl;
+  }
+  if (props.children?.["2"]?.props?.tweet?.id_str)
+    return props.children?.[2].props.tweet.id_str;
+  if (props.children?.props?.tweet?.id_str)
+    return props.children.props.tweet.id_str;
+  if (props.children?.props?.children?.props?.tweet?.id_str)
+    return props.children.props.children.props.tweet.id_str;
+  let displayType;
+  if (props.displayType ? displayType = props.displayType : props.children?.displayType ? displayType = props.children.displayType : props.children?.props?.displayType ? displayType = props.children.props.displayType : props.children?.props?.children?.props?.displayType ? displayType = props.children.props.children.props.displayType : props.entry?.content?.displayType ? displayType = props.entry.content.displayType : props.children?.entry?.content?.displayType ? displayType = props.children.entry.content.displayType : props.children?.props?.entry?.content?.displayType ? displayType = props.children.props.entry.content.displayType : props.children?.props?.children?.props?.entry?.content?.displayType && (displayType = props.children.props.children.props.entry.content.displayType), displayType !== "Tweet" && displayType !== "FocalTweet" && displayType !== "MediaGrid")
+    return props.children?.sibling ? getTweetIdFromSibling(props.children.sibling) : props.children?._owner?.sibling ? getTweetIdFromSibling(props.children._owner.sibling) : props.children?.props?.sibling ? getTweetIdFromSibling(props.children.props.sibling) : props.children?._owner?.return?.sibling ? getTweetIdFromSibling(props.children._owner.return.sibling) : void 0;
+  let contentId;
+  if (props.entry?.content?.id ? contentId = props.entry.content.id : props.children?.entry?.content?.id ? contentId = props.children.entry.content.id : props.children?.props?.entry?.content?.id ? contentId = props.children.props.entry.content.id : props.children?.props?.children?.props?.entry?.content?.id ? contentId = props.children.props.children.props.entry.content.id : props.item?.id ? contentId = props.item.id : props.children?.item?.id ? contentId = props.children.item.id : props.children?.props?.item?.id ? contentId = props.children.props.item.id : props.item?.data?.content?.id ? contentId = props.item.data.content.id : props.children?.item?.data?.content?.id ? contentId = props.children.item.data.content.id : props.children?.props?.item?.data?.content?.id && (contentId = props.children.props.item.data.content.id), contentId)
+    return contentId;
+  let entryId;
+  if (props.entry?.entryId ? entryId = props.entry.entryId : props.children?.entry?.entryId ? entryId = props.children.entry.entryId : props.children?.props?.entry?.entryId ? entryId = props.children.props.entry.entryId : props.children?.props?.children?.props?.entry?.entryId ? entryId = props.children.props.children.props.entry.entryId : props.item?.data?.entryId ? entryId = props.item.data.entryId : props.children?.item?.data?.entryId ? entryId = props.children.item.data.entryId : props.children?.props?.item?.data?.entryId && (entryId = props.children.props.item.data.entryId), entryId && entryId.startsWith("tweet-"))
+    return entryId.substring(6);
+}
+function extractTweetIdFromUrl(url) {
+  const match = url.match(/\/status\/(\d+)/);
+  if (match && match[1])
+    return match[1];
+}
+function getTweetIdFromSibling(sibling) {
+  if (sibling.key && sibling.key.startsWith("tweet-"))
+    return sibling.key.substring(6);
+  if (sibling.props?.item?.id && sibling.props.item.id.startsWith("tweet-"))
+    return sibling.props.item.id.substring(6);
+  if (sibling.props?.item?.data?.content?.id)
+    return sibling.props.item.data.content.id;
+  if (sibling.props?.item?.data?.entryId && sibling.props.item.data.entryId.startsWith("tweet-"))
+    return sibling.props.item.data.entryId.substring(6);
+  if (sibling.sibling)
+    return getTweetIdFromSibling(sibling.sibling);
+}
+function parseUserIdByProps(el) {
+  return getTweetUserIdByProps(getReactProps(el)) || parseTweetIdByDom(el);
+}
+function getTweetUserIdByProps(props) {
+  if (!props)
+    return;
+  if (props.entry?.content?.fromUsers?.["0"])
+    return props.entry.content.fromUsers[0];
+  if (props.children?.entry?.content?.fromUsers?.["0"])
+    return props.children.entry.content.fromUsers[0];
+  if (props.children?.props?.entry?.content?.fromUsers?.["0"])
+    return props.children.props.entry.content.fromUsers[0];
+  if (props.children?.props?.children?.props?.entry?.content?.fromUsers?.["0"])
+    return props.children.props.children.props.entry.content.fromUsers[0];
+  let displayType;
+  if (props.displayType ? displayType = props.displayType : props.children?.displayType ? displayType = props.children.displayType : props.children?.props?.displayType ? displayType = props.children.props.displayType : props.children?.props?.children?.props?.displayType ? displayType = props.children.props.children.props.displayType : props.entry?.content?.displayType ? displayType = props.entry.content.displayType : props.children?.entry?.content?.displayType ? displayType = props.children.entry.content.displayType : props.children?.props?.entry?.content?.displayType ? displayType = props.children.props.entry.content.displayType : props.children?.props?.children?.props?.entry?.content?.displayType && (displayType = props.children.props.children.props.entry.content.displayType), displayType === "User") {
+    if (props.entry?.content?.id)
+      return props.entry.content.id;
+    if (props.children?.entry?.content?.id)
+      return props.children.entry.content.id;
+    if (props.children?.props?.entry?.content?.id)
+      return props.children.props.entry.content.id;
+    if (props.children?.props?.children?.props?.entry?.content?.id)
+      return props.children.props.children.props.entry.content.id;
+    if (props.item?.id)
+      return props.item.id;
+    if (props.children?.item?.id)
+      return props.children.item.id;
+    if (props.children?.props?.item?.id)
+      return props.children.props.item.id;
+    if (props.item?.data?.content?.id)
+      return props.item.data.content.id;
+    if (props.children?.item?.data?.content?.id)
+      return props.children.item.data.content.id;
+    if (props.children?.props?.item?.data?.content?.id)
+      return props.children.props.item.data.content.id;
+  }
+}
+const cellSelector = '[data-testid="cellInnerDiv"]', cellInnerSelector = `${cellSelector} [aria-labelledby^="id__"]`, cellPreviewSelector = `${cellSelector} [data-testid="previewInterstitial"]`, itemSelector = `${cellSelector} [role="listitem"]`, previewVideoSelector = `${cellPreviewSelector}:not([aria-label*=GIF])`, primaryRegionSelector = 'main [data-testid="primaryColumn"] [role="region"]', primaryCellSelector = `${primaryRegionSelector} ${cellSelector}`, primaryCellInnerSelector = `${primaryRegionSelector} ${cellInnerSelector}`, primaryItemSelector = `${primaryRegionSelector} ${itemSelector}`, primaryTweetSelector = [primaryCellSelector, primaryItemSelector].join(","), primaryPreviewVideoSelector = `${primaryRegionSelector} ${previewVideoSelector}`, ImageVideoIdRegex = /(?:video_thumb|card_img)\/(\d+)/, LinkVideoIdRegex = /status\/(\d+)\/video\/(\d+)/;
+function parseTweetVideoId(el) {
+  if (!el) return;
+  const itemEl = el.matches(primaryItemSelector) ? el : el.closest(primaryItemSelector);
+  return itemEl ? parseTweetVideoIdByVideoContainer(itemEl) : parseTweetVideoIdByVideoContainer(el.matches(primaryPreviewVideoSelector) ? el : el.closest(primaryPreviewVideoSelector), !0);
+}
+function parseTweetVideoIdByVideoContainer(el, defaultTweet) {
+  if (!el)
+    return;
+  const img = el.querySelector('img[src*="video_thumb/"],img[src*="card_img/"]');
+  if (img) {
+    const videoId = ImageVideoIdRegex.exec(img.src)?.[1];
+    if (videoId)
+      return { videoId };
+  }
+  const link = el.querySelector('a[href*="/status/"][href*="/video/"]');
+  if (!link) {
+    if (!defaultTweet)
+      return;
+    const tweetId2 = parseTweetIdByDom(el);
+    if (tweetId2) {
+      let index = Array.from(el.querySelectorAll(primaryPreviewVideoSelector)).indexOf(el);
+      return index === -1 && (index = 0), { index, tweetId: tweetId2 };
+    }
+    return;
+  }
+  const match = LinkVideoIdRegex.exec(link.href), tweetId = match?.[1];
+  if (!tweetId)
+    return {
+      tweetId,
+      index: parseInt(match[2]) || 0
+    };
+}
+export {
+  cellInnerSelector,
+  cellPreviewSelector,
+  cellSelector,
+  getTweetIdByProps,
+  itemSelector,
+  parseTweetIdByDom,
+  parseTweetIdByProps,
+  parseTweetVideoId,
+  parseTweetVideoIdByVideoContainer,
+  parseUserIdByProps,
+  previewVideoSelector,
+  primaryCellInnerSelector,
+  primaryCellSelector,
+  primaryItemSelector,
+  primaryPreviewVideoSelector,
+  primaryRegionSelector,
+  primaryTweetSelector
+};

package/lib/index.cjs

@@ -1,5 +1,5 @@
 "use strict";
-var type = require('./type.cjs'), parser = require('./parser.cjs');
+var type = require('./type.cjs'), parser = require('./parser.cjs'), listenTweetRegister = require('./listen-tweet-register.cjs'), listenTweetStarter = require('./listen-tweet-starter.cjs'), dom = require('./dom.cjs');
 Object.keys(type).forEach(function(k) {
   k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k) && Object.defineProperty(exports, k, {
     enumerable: !0,
@@ -14,4 +14,25 @@ Object.keys(type).forEach(function(k) {
       return parser[k];
     }
   });
+}), Object.keys(listenTweetRegister).forEach(function(k) {
+  k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k) && Object.defineProperty(exports, k, {
+    enumerable: !0,
+    get: function() {
+      return listenTweetRegister[k];
+    }
+  });
+}), Object.keys(listenTweetStarter).forEach(function(k) {
+  k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k) && Object.defineProperty(exports, k, {
+    enumerable: !0,
+    get: function() {
+      return listenTweetStarter[k];
+    }
+  });
+}), Object.keys(dom).forEach(function(k) {
+  k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k) && Object.defineProperty(exports, k, {
+    enumerable: !0,
+    get: function() {
+      return dom[k];
+    }
+  });
 });

package/lib/index.d.ts

@@ -1,2 +1,5 @@
 export * from './type.d.ts';
 export * from './parser.d.ts';
+export * from './listen-tweet-register.d.ts';
+export * from './listen-tweet-starter.d.ts';
+export * from './dom.d.ts';

package/lib/index.mjs

@@ -1,2 +1,5 @@
 export * from './type.mjs';
 export * from './parser.mjs';
+export * from './listen-tweet-register.mjs';
+export * from './listen-tweet-starter.mjs';
+export * from './dom.mjs';

package/lib/listen-tweet-register.cjs

@@ -0,0 +1,20 @@
+"use strict";
+var type = require('./type.cjs'), gsDom = require('gs-dom');
+class ListenRegister {
+  static addVideoDetectedListener(listener) {
+    gsDom.on(type.ListenTweetEvents.VideoDetected, ({ detail }) => listener(detail));
+  }
+  static addTweetDetectedListener(listener) {
+    gsDom.on(type.ListenTweetEvents.TweetDetected, ({ detail }) => listener(detail));
+  }
+  static addUserDetectedListener(listener) {
+    gsDom.on(type.ListenTweetEvents.UserDetected, ({ detail }) => listener(detail));
+  }
+  static addTweetRenderedListener(listener) {
+    gsDom.on(type.ListenTweetEvents.TweetRendered, ({ detail }) => listener(detail));
+  }
+  // static addVideoRenderedListener(listener: (tweetIds: IGetTweetVideoIdResult[]) => void) {
+  // 	on(ListenTweetEvents.VideoRendered, ({detail}: CustomEvent) => listener(detail))
+  // }
+}
+exports.ListenRegister = ListenRegister;

package/lib/listen-tweet-register.d.ts

@@ -0,0 +1,10 @@
+import { ISimpleTweet, ISimpleUser } from './type.d.ts';
+
+declare class ListenRegister {
+    static addVideoDetectedListener(listener: (videos: ISimpleTweet[]) => void): void;
+    static addTweetDetectedListener(listener: (tweets: ISimpleTweet[]) => void): void;
+    static addUserDetectedListener(listener: (users: ISimpleUser[]) => void): void;
+    static addTweetRenderedListener(listener: (tweetIds: string[]) => void): void;
+}
+
+export { ListenRegister };

package/lib/listen-tweet-register.mjs

@@ -0,0 +1,22 @@
+import { ListenTweetEvents } from './type.mjs';
+import { on } from 'gs-dom';
+class ListenRegister {
+  static addVideoDetectedListener(listener) {
+    on(ListenTweetEvents.VideoDetected, ({ detail }) => listener(detail));
+  }
+  static addTweetDetectedListener(listener) {
+    on(ListenTweetEvents.TweetDetected, ({ detail }) => listener(detail));
+  }
+  static addUserDetectedListener(listener) {
+    on(ListenTweetEvents.UserDetected, ({ detail }) => listener(detail));
+  }
+  static addTweetRenderedListener(listener) {
+    on(ListenTweetEvents.TweetRendered, ({ detail }) => listener(detail));
+  }
+  // static addVideoRenderedListener(listener: (tweetIds: IGetTweetVideoIdResult[]) => void) {
+  // 	on(ListenTweetEvents.VideoRendered, ({detail}: CustomEvent) => listener(detail))
+  // }
+}
+export {
+  ListenRegister
+};

package/lib/listen-tweet-start.cjs

@@ -0,0 +1,68 @@
+"use strict";
+var xhr = require('gs-web-hooks/xhr'), parser = require('./parser.cjs'), event = require('gs-dom/event'), type = require('./type.cjs'), frsProbe = require('gs-dom/frs-probe'), observer = require('gs-dom/observer');
+const ListenFlagKey = "__listen-tweet-flag-key";
+class ListenFlag {
+  static #flag;
+  static get flag() {
+    return this.#flag || (this.#flag = self[ListenFlagKey]);
+  }
+  static isInit(arg) {
+    const init = !!this.flag;
+    return arg && this.update(arg), init;
+  }
+  static update(arg) {
+    self[ListenFlagKey] ? (arg?.enableTweetDetected && (self[ListenFlagKey].enableTweetDetected = !0), arg?.enableUserDetected && (self[ListenFlagKey].enableUserDetected = !0)) : Object.defineProperty(self, ListenFlagKey, {
+      value: { ...arg },
+      enumerable: !1,
+      configurable: !1,
+      writable: !1
+    }), this.#flag = self[ListenFlagKey];
+  }
+}
+const timelineRegex = /TweetDetail|Timeline|Bookmarks|UserTweets|UserMedia|Likes/, id = "__listen-tweet-interceptor";
+function listenNet() {
+  xhr.addXhrInterceptor({
+    id,
+    before: (url) => timelineRegex.test(url) ? url : void 0,
+    after: (text) => {
+      const json = JSON.parse(text), { tweets, users, videos } = parser.XParser.parseSimple(json);
+      if (videos?.length) try {
+        event.trigger(type.ListenTweetEvents.VideoDetected, { detail: videos });
+      } catch {
+      }
+      const flag = ListenFlag.flag || {};
+      if (flag.enableTweetDetected && tweets?.length) try {
+        event.trigger(type.ListenTweetEvents.UserDetected, { detail: tweets });
+      } catch {
+      }
+      if (flag.enableUserDetected && users?.length) try {
+        event.trigger(type.ListenTweetEvents.UserDetected, { detail: users });
+      } catch {
+      }
+    }
+  });
+}
+const containerSelector = "main,main *", regionSelector = 'main [data-testid="primaryColumn"] [role="region"]', cellSelector = `${regionSelector} [data-testid="cellInnerDiv"]`, itemSelector = `${cellSelector} [role="listitem"]`, tweetSelector = [cellSelector, itemSelector].join(",");
+function addedElements(els) {
+  const tweets = [];
+  function processTarget(el) {
+    if (el.matches(tweetSelector)) {
+      const id2 = frsProbe.getTweetId(el);
+      id2 && tweets.push(id2);
+    } else el.matches(containerSelector) && el.clientHeight > 300 && els.push(...el.querySelectorAll(tweetSelector));
+  }
+  for (let i = 0; i < els.length; i++)
+    try {
+      processTarget(els[i]);
+    } catch (e) {
+      console.warn(e);
+    }
+  tweets.length && event.trigger(type.ListenTweetEvents.TweetRendered, { detail: tweets });
+}
+function observePage() {
+  observer.observe({ subtree: !0, addedElements });
+}
+function startListen(option) {
+  ListenFlag.isInit(option) || (listenNet(), observePage());
+}
+exports.startListen = startListen;

package/lib/listen-tweet-start.d.ts

@@ -0,0 +1,9 @@
+interface IListenTweetOption {
+    enableTweetDetected?: boolean;
+    enableUserDetected?: boolean;
+}
+
+declare function startListen(option?: IListenTweetOption): void;
+
+export { startListen };
+export type { IListenTweetOption };

package/lib/listen-tweet-start.mjs

@@ -0,0 +1,74 @@
+import { addXhrInterceptor } from 'gs-web-hooks/xhr';
+import { XParser } from './parser.mjs';
+import { trigger } from 'gs-dom/event';
+import { ListenTweetEvents } from './type.mjs';
+import { getTweetId } from 'gs-dom/frs-probe';
+import { observe } from 'gs-dom/observer';
+const ListenFlagKey = "__listen-tweet-flag-key";
+class ListenFlag {
+  static #flag;
+  static get flag() {
+    return this.#flag || (this.#flag = self[ListenFlagKey]);
+  }
+  static isInit(arg) {
+    const init = !!this.flag;
+    return arg && this.update(arg), init;
+  }
+  static update(arg) {
+    self[ListenFlagKey] ? (arg?.enableTweetDetected && (self[ListenFlagKey].enableTweetDetected = !0), arg?.enableUserDetected && (self[ListenFlagKey].enableUserDetected = !0)) : Object.defineProperty(self, ListenFlagKey, {
+      value: { ...arg },
+      enumerable: !1,
+      configurable: !1,
+      writable: !1
+    }), this.#flag = self[ListenFlagKey];
+  }
+}
+const timelineRegex = /TweetDetail|Timeline|Bookmarks|UserTweets|UserMedia|Likes/, id = "__listen-tweet-interceptor";
+function listenNet() {
+  addXhrInterceptor({
+    id,
+    before: (url) => timelineRegex.test(url) ? url : void 0,
+    after: (text) => {
+      const json = JSON.parse(text), { tweets, users, videos } = XParser.parseSimple(json);
+      if (videos?.length) try {
+        trigger(ListenTweetEvents.VideoDetected, { detail: videos });
+      } catch {
+      }
+      const flag = ListenFlag.flag || {};
+      if (flag.enableTweetDetected && tweets?.length) try {
+        trigger(ListenTweetEvents.UserDetected, { detail: tweets });
+      } catch {
+      }
+      if (flag.enableUserDetected && users?.length) try {
+        trigger(ListenTweetEvents.UserDetected, { detail: users });
+      } catch {
+      }
+    }
+  });
+}
+const containerSelector = "main,main *", regionSelector = 'main [data-testid="primaryColumn"] [role="region"]', cellSelector = `${regionSelector} [data-testid="cellInnerDiv"]`, itemSelector = `${cellSelector} [role="listitem"]`, tweetSelector = [cellSelector, itemSelector].join(",");
+function addedElements(els) {
+  const tweets = [];
+  function processTarget(el) {
+    if (el.matches(tweetSelector)) {
+      const id2 = getTweetId(el);
+      id2 && tweets.push(id2);
+    } else el.matches(containerSelector) && el.clientHeight > 300 && els.push(...el.querySelectorAll(tweetSelector));
+  }
+  for (let i = 0; i < els.length; i++)
+    try {
+      processTarget(els[i]);
+    } catch (e) {
+      console.warn(e);
+    }
+  tweets.length && trigger(ListenTweetEvents.TweetRendered, { detail: tweets });
+}
+function observePage() {
+  observe({ subtree: !0, addedElements });
+}
+function startListen(option) {
+  ListenFlag.isInit(option) || (listenNet(), observePage());
+}
+export {
+  startListen
+};