@incremark/shared 0.2.3

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 wangyishuai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,44 @@
+# @incremark/shared
+
+Incremark 共享工具包 - Vue 和 React 共享的逻辑和工具函数。
+
+## 功能
+
+- **HTML 处理**：处理 HTML 节点配对，自动补全缺失的结束标签
+- **文本处理**：处理带 chunks 的文本节点，支持渐入动画
+- **类型定义**：共享的类型定义
+
+## 使用
+
+```typescript
+import {
+  type TextNodeWithChunks,
+  hasChunks,
+  getStableText,
+  isHtmlNode,
+  processHtmlNodes
+} from '@incremark/shared'
+```
+
+## API
+
+### `processHtmlNodes(nodes: PhrasingContent[]): PhrasingContent[]`
+
+处理 HTML 节点数组，配对开始和结束标签。如果遇到开始标签但没有对应的结束标签，会自动补上结束标签。
+
+### `hasChunks(node: PhrasingContent): node is TextNodeWithChunks`
+
+类型守卫，检查是否是带 chunks 的文本节点。
+
+### `getStableText(node: TextNodeWithChunks): string`
+
+获取文本节点的稳定部分（不需要动画的部分）。
+
+### `isHtmlNode(node: PhrasingContent): node is HTML`
+
+类型守卫，检查是否是 HTML 节点。
+
+### `extractTagName(html: string): HtmlTagInfo | null`
+
+提取 HTML 标签名和相关信息。
+

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+import { Text, PhrasingContent, HTML } from 'mdast';
+
+interface TextChunk {
+    /** 文本内容 */
+    text: string;
+    /** 创建时间戳 */
+    createdAt: number;
+}
+/**
+ * 扩展的文本节点（支持 chunks）
+ */
+interface TextNodeWithChunks extends Text {
+    stableLength?: number;
+    chunks?: TextChunk[];
+}
+
+/**
+ * HTML 标签信息
+ */
+interface HtmlTagInfo {
+    tagName: string;
+    isClosing: boolean;
+    isSelfClosing: boolean;
+}
+/**
+ * 提取 HTML 标签名（支持自闭合标签）
+ */
+declare function extractTagName(html: string): HtmlTagInfo | null;
+/**
+ * 类型守卫：检查是否是 HTML 节点
+ */
+declare function isHtmlNode(node: PhrasingContent): node is HTML;
+/**
+ * HTML 包装节点：包含开始标签、内容节点、结束标签
+ * 这样可以在渲染时一起处理，避免空标签
+ */
+interface HtmlWrapperNode {
+    type: 'html-wrapper';
+    startTag: string;
+    content: PhrasingContent[];
+    endTag: string;
+    tagName: string;
+}
+/**
+ * 类型守卫：检查是否是 HTML 包装节点
+ */
+declare function isHtmlWrapperNode(node: PhrasingContent | HtmlWrapperNode): node is HtmlWrapperNode;
+/**
+ * 处理 HTML 节点数组，将开始标签、中间内容、结束标签包装在一起
+ * 这样渲染时可以一起处理，避免空标签
+ */
+declare function processHtmlNodes(nodes: PhrasingContent[]): (PhrasingContent | HtmlWrapperNode)[];
+
+/**
+ * 类型守卫：检查是否是带 chunks 的文本节点
+ */
+declare function hasChunks(node: PhrasingContent): node is TextNodeWithChunks;
+/**
+ * 获取文本节点的稳定部分（不需要动画）
+ */
+declare function getStableText(node: TextNodeWithChunks): string;
+
+export { type HtmlTagInfo, type HtmlWrapperNode, type TextNodeWithChunks, extractTagName, getStableText, hasChunks, isHtmlNode, isHtmlWrapperNode, processHtmlNodes };

package/dist/index.js

@@ -0,0 +1,119 @@
+// src/html.ts
+function extractTagName(html) {
+  const match = html.match(/^<\/?([a-zA-Z][a-zA-Z0-9-]*)\s*\/?>?/);
+  if (!match) return null;
+  const isClosing = html.startsWith("</");
+  const isSelfClosing = html.endsWith("/>") || !!html.match(/^<[^>]+\/>$/);
+  return {
+    tagName: match[1].toLowerCase(),
+    isClosing,
+    isSelfClosing
+  };
+}
+function isHtmlNode(node) {
+  return node.type === "html";
+}
+function isHtmlWrapperNode(node) {
+  return node.type === "html-wrapper";
+}
+function processHtmlNodes(nodes) {
+  const result = [];
+  let i = 0;
+  while (i < nodes.length) {
+    const node = nodes[i];
+    if (isHtmlNode(node)) {
+      const tagInfo = extractTagName(node.value);
+      if (tagInfo) {
+        if (tagInfo.isSelfClosing) {
+          result.push(node);
+          i++;
+        } else if (tagInfo.isClosing) {
+          i++;
+          continue;
+        } else {
+          const startTag = node.value;
+          const tagName = tagInfo.tagName;
+          const contentNodes = [];
+          let foundClosing = false;
+          let j = i + 1;
+          let depth = 1;
+          while (j < nodes.length && depth > 0) {
+            const nextNode = nodes[j];
+            if (isHtmlNode(nextNode)) {
+              const nextTagInfo = extractTagName(nextNode.value);
+              if (nextTagInfo) {
+                if (nextTagInfo.isClosing && nextTagInfo.tagName === tagName) {
+                  depth--;
+                  if (depth === 0) {
+                    foundClosing = true;
+                    const endTag = nextNode.value;
+                    const wrapperNode = {
+                      type: "html-wrapper",
+                      startTag,
+                      content: contentNodes,
+                      endTag,
+                      tagName
+                    };
+                    result.push(wrapperNode);
+                    i = j + 1;
+                    break;
+                  } else {
+                    contentNodes.push(nextNode);
+                    j++;
+                  }
+                } else if (!nextTagInfo.isClosing && nextTagInfo.tagName === tagName) {
+                  depth++;
+                  contentNodes.push(nextNode);
+                  j++;
+                } else {
+                  contentNodes.push(nextNode);
+                  j++;
+                }
+              } else {
+                contentNodes.push(nextNode);
+                j++;
+              }
+            } else {
+              contentNodes.push(nextNode);
+              j++;
+            }
+          }
+          if (!foundClosing) {
+            const endTag = `</${tagName}>`;
+            const wrapperNode = {
+              type: "html-wrapper",
+              startTag,
+              content: contentNodes,
+              endTag,
+              tagName
+            };
+            result.push(wrapperNode);
+            i = j;
+          }
+        }
+      } else {
+        result.push(node);
+        i++;
+      }
+    } else {
+      result.push(node);
+      i++;
+    }
+  }
+  return result;
+}
+
+// src/text.ts
+function hasChunks(node) {
+  return node.type === "text" && "chunks" in node && Array.isArray(node.chunks);
+}
+function getStableText(node) {
+  if (!node.chunks || node.chunks.length === 0) {
+    return node.value;
+  }
+  return node.value.slice(0, node.stableLength ?? 0);
+}
+
+export { extractTagName, getStableText, hasChunks, isHtmlNode, isHtmlWrapperNode, processHtmlNodes };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/html.ts","../src/text.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { PhrasingContent, HTML } from 'mdast'\n\n/**\n * HTML 标签信息\n */\nexport interface HtmlTagInfo {\n  tagName: string\n  isClosing: boolean\n  isSelfClosing: boolean\n}\n\n/**\n * 提取 HTML 标签名（支持自闭合标签）\n */\nexport function extractTagName(html: string): HtmlTagInfo | null {\n  const match = html.match(/^<\\/?([a-zA-Z][a-zA-Z0-9-]*)\\s*\\/?>?/)\n  if (!match) return null\n  \n  const isClosing = html.startsWith('</')\n  const isSelfClosing = html.endsWith('/>') || !!html.match(/^<[^>]+\\/>$/)\n  return {\n    tagName: match[1].toLowerCase(),\n    isClosing,\n    isSelfClosing\n  }\n}\n\n/**\n * 类型守卫：检查是否是 HTML 节点\n */\nexport function isHtmlNode(node: PhrasingContent): node is HTML {\n  return node.type === 'html'\n}\n\n/**\n * HTML 包装节点：包含开始标签、内容节点、结束标签\n * 这样可以在渲染时一起处理，避免空标签\n */\nexport interface HtmlWrapperNode {\n  type: 'html-wrapper'\n  startTag: string\n  content: PhrasingContent[]\n  endTag: string\n  tagName: string\n}\n\n/**\n * 类型守卫：检查是否是 HTML 包装节点\n */\nexport function isHtmlWrapperNode(node: PhrasingContent | HtmlWrapperNode): node is HtmlWrapperNode {\n  return (node as HtmlWrapperNode).type === 'html-wrapper'\n}\n\n/**\n * 处理 HTML 节点数组，将开始标签、中间内容、结束标签包装在一起\n * 这样渲染时可以一起处理，避免空标签\n */\nexport function processHtmlNodes(nodes: PhrasingContent[]): (PhrasingContent | HtmlWrapperNode)[] {\n  const result: (PhrasingContent | HtmlWrapperNode)[] = []\n  let i = 0\n  \n  while (i < nodes.length) {\n    const node = nodes[i]\n    \n    if (isHtmlNode(node)) {\n      const tagInfo = extractTagName(node.value)\n      \n      if (tagInfo) {\n        if (tagInfo.isSelfClosing) {\n          // 自闭合标签，直接添加\n          result.push(node)\n          i++\n        } else if (tagInfo.isClosing) {\n          // 结束标签，如果前面没有匹配的开始标签，跳过（可能是之前补上的）\n          // 否则应该已经被包装处理了，这里不应该单独出现\n          i++\n          continue\n        } else {\n          // 开始标签：收集后续内容直到找到对应的结束标签\n          const startTag = node.value\n          const tagName = tagInfo.tagName\n          const contentNodes: PhrasingContent[] = []\n          let foundClosing = false\n          let j = i + 1\n          let depth = 1 // 嵌套深度\n          \n          // 收集开始标签和结束标签之间的所有节点\n          while (j < nodes.length && depth > 0) {\n            const nextNode = nodes[j]\n            \n            if (isHtmlNode(nextNode)) {\n              const nextTagInfo = extractTagName(nextNode.value)\n              if (nextTagInfo) {\n                if (nextTagInfo.isClosing && nextTagInfo.tagName === tagName) {\n                  // 找到匹配的结束标签\n                  depth--\n                  if (depth === 0) {\n                    foundClosing = true\n                    const endTag = nextNode.value\n                    \n                    // 创建包装节点\n                    const wrapperNode: HtmlWrapperNode = {\n                      type: 'html-wrapper',\n                      startTag,\n                      content: contentNodes,\n                      endTag,\n                      tagName\n                    }\n                    \n                    result.push(wrapperNode)\n                    i = j + 1 // 跳过已处理的所有节点\n                    break\n                  } else {\n                    // 嵌套的结束标签，收集到内容中\n                    contentNodes.push(nextNode)\n                    j++\n                  }\n                } else if (!nextTagInfo.isClosing && nextTagInfo.tagName === tagName) {\n                  // 嵌套的同名开始标签\n                  depth++\n                  contentNodes.push(nextNode)\n                  j++\n                } else {\n                  // 其他 HTML 节点，收集到内容中\n                  contentNodes.push(nextNode)\n                  j++\n                }\n              } else {\n                // 无法解析的 HTML，收集到内容中\n                contentNodes.push(nextNode)\n                j++\n              }\n            } else {\n              // 非 HTML 节点（文本等），收集到内容中\n              contentNodes.push(nextNode)\n              j++\n            }\n          }\n          \n          if (!foundClosing) {\n            // 没有找到结束标签，补上一个\n            const endTag = `</${tagName}>`\n            \n            const wrapperNode: HtmlWrapperNode = {\n              type: 'html-wrapper',\n              startTag,\n              content: contentNodes,\n              endTag,\n              tagName\n            }\n            \n            result.push(wrapperNode)\n            i = j // 跳过已处理的所有节点\n          }\n        }\n      } else {\n        // 无法解析的 HTML，直接添加\n        result.push(node)\n        i++\n      }\n    } else {\n      // 非 HTML 节点，直接添加\n      result.push(node)\n      i++\n    }\n  }\n  \n  return result\n}\n\n","import type { PhrasingContent, Text } from 'mdast'\nimport type { TextNodeWithChunks } from './types'\n\n/**\n * 类型守卫：检查是否是带 chunks 的文本节点\n */\nexport function hasChunks(node: PhrasingContent): node is TextNodeWithChunks {\n  return node.type === 'text' && 'chunks' in node && Array.isArray((node as TextNodeWithChunks).chunks)\n}\n\n/**\n * 获取文本节点的稳定部分（不需要动画）\n */\nexport function getStableText(node: TextNodeWithChunks): string {\n  if (!node.chunks || node.chunks.length === 0) {\n    return (node as Text).value\n  }\n  return (node as Text).value.slice(0, node.stableLength ?? 0)\n}\n\n"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@incremark/shared",
+  "version": "0.2.3",
+  "description": "Incremark 共享工具包 - Vue 和 React 共享的逻辑",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "@types/mdast": "^4.0.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "@incremark/core": "0.2.3"
+  },
+  "keywords": [
+    "incremark",
+    "shared",
+    "utils"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kingshuaishuai/incremark.git",
+    "directory": "packages/shared"
+  },
+  "homepage": "https://www.incremark.com/",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}