tona-utils 1.0.21 → 1.0.22

package/README.md

@@ -0,0 +1,216 @@
+# tona-utils
+
+<p align="center">
+  <img src="../../assets/tona.png" alt="Tona" width="100" />
+</p>
+
+<p align="center">
+  Utility functions for CNBlogs theme development.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/tona-utils"><img src="https://img.shields.io/npm/v/tona-utils?style=flat-square" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/npm/l/tona-utils?style=flat-square" alt="license"></a>
+</p>
+
+**English** | [中文](./README.zh-CN.md)
+
+## Features
+
+- **Blog Context** - Detect page types, user status, and blog info
+- **User Actions** - Follow, unfollow, like posts
+- **URL Helpers** - Generate CNBlogs URLs
+- **DOM Utilities** - jQuery-based DOM helpers
+- **TypeScript Support** - Full type definitions
+
+## Installation
+
+```bash
+npm install tona-utils
+```
+
+```bash
+pnpm add tona-utils
+```
+
+```bash
+yarn add tona-utils
+```
+
+## Usage
+
+```typescript
+import {
+  isOwner,
+  getLoginState,
+  getCurrentPage,
+  getFollowers,
+  likePost,
+} from 'tona-utils'
+```
+
+## User & Authentication
+
+### `isOwner()`
+
+Check if current user is the blog owner.
+
+```typescript
+import { isOwner } from 'tona-utils'
+
+if (isOwner()) {
+  console.log('This is my blog')
+}
+```
+
+### `getLoginState()`
+
+Check if user is logged in.
+
+```typescript
+import { getLoginState } from 'tona-utils'
+
+const isLoggedIn = getLoginState()
+```
+
+### `getFollowState()`
+
+Check if current user follows the blog author.
+
+```typescript
+import { getFollowState } from 'tona-utils'
+
+const isFollowing = getFollowState()
+```
+
+## Page Detection
+
+### `getCurrentPage()`
+
+Detect current page type.
+
+```typescript
+import { getCurrentPage } from 'tona-utils'
+
+const page = getCurrentPage()
+// Returns: 'home' | 'post' | 'tags' | 'post-archive' | 'category' | 'photos' | 'photo-view' | 'unknown'
+```
+
+### Page Type Checks
+
+```typescript
+import {
+  isHomePage,
+  isPostDetailsPage,
+  isTagListPage,
+  isCategoryPage,
+  isAlbumPage,
+} from 'tona-utils'
+
+if (isHomePage()) {
+  // On blog home page
+}
+
+if (isPostDetailsPage()) {
+  // On a blog post page
+}
+```
+
+## Blog Statistics
+
+```typescript
+import {
+  getFollowers,
+  getFollowing,
+  getBlogAge,
+  getPostCount,
+  getArticleCount,
+  getCommentCount,
+  getViewCount,
+} from 'tona-utils'
+
+const followers = getFollowers() // "123"
+const following = getFollowing() // "45"
+const age = getBlogAge() // "3年"
+const posts = getPostCount() // "100"
+```
+
+## User Actions
+
+### `follow()` / `unfollow()`
+
+Follow or unfollow the blog author.
+
+```typescript
+import { follow, unfollow } from 'tona-utils'
+
+follow() // Follow this blog
+unfollow() // Unfollow this blog
+```
+
+### `likePost()` / `unLikePost()`
+
+Recommend or unrecommend a blog post.
+
+```typescript
+import { likePost, unLikePost } from 'tona-utils'
+
+likePost() // Recommend this post
+unLikePost() // Unrecommend this post
+```
+
+## URL Helpers
+
+```typescript
+import {
+  getIndexUrl,
+  getFollowersUrl,
+  getFolloweesUrl,
+  getRssUrl,
+  getNewPostUrl,
+  getAdminUrl,
+} from 'tona-utils'
+
+const blogHome = getIndexUrl() // "https://www.cnblogs.com/username"
+const followers = getFollowersUrl() // "https://home.cnblogs.com/u/username/followers"
+const rss = getRssUrl() // "https://www.cnblogs.com/username/rss"
+```
+
+## Blog Info
+
+```typescript
+import {
+  getCurrentBlogId,
+  getCurrentBlogApp,
+  getNickname,
+  getBlogUserGuid,
+  getSkinName,
+} from 'tona-utils'
+
+const blogId = getCurrentBlogId() // "123456"
+const blogApp = getCurrentBlogApp() // "username"
+const nickname = getNickname() // "博主昵称"
+const guid = getBlogUserGuid() // User GUID
+```
+
+## Code Highlighting
+
+```typescript
+import {
+  setCodeTheme,
+  getCodeHighlightTheme,
+  getDarkModeCodeHighlightTheme,
+  checkEnableCodeLineNumber,
+} from 'tona-utils'
+
+// Set code theme
+setCodeTheme('dark')
+
+// Check settings
+const hasLineNumbers = checkEnableCodeLineNumber()
+```
+
+## Related
+
+- [tona](https://github.com/guangzan/tona/tree/main/packages/core) - Core framework
+- [tona-hooks](https://github.com/guangzan/tona/tree/main/packages/hooks) - React hooks

package/README.zh-CN.md

@@ -0,0 +1,216 @@
+# tona-utils
+
+<p align="center">
+  <img src="../../assets/tona.png" alt="Tona" width="100" />
+</p>
+
+<p align="center">
+  用于博客园主题开发的工具函数库。
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/tona-utils"><img src="https://img.shields.io/npm/v/tona-utils?style=flat-square" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/npm/l/tona-utils?style=flat-square" alt="license"></a>
+</p>
+
+[English](./README.md) | **中文**
+
+## 特性
+
+- **博客上下文** - 检测页面类型、用户状态和博客信息
+- **用户操作** - 关注、取消关注、推荐文章
+- **URL 助手** - 生成博客园 URL
+- **DOM 工具** - 基于 jQuery 的 DOM 辅助函数
+- **TypeScript 支持** - 完整的类型定义
+
+## 安装
+
+```bash
+npm install tona-utils
+```
+
+```bash
+pnpm add tona-utils
+```
+
+```bash
+yarn add tona-utils
+```
+
+## 使用
+
+```typescript
+import {
+  isOwner,
+  getLoginState,
+  getCurrentPage,
+  getFollowers,
+  likePost,
+} from 'tona-utils'
+```
+
+## 用户与认证
+
+### `isOwner()`
+
+检查当前用户是否为博客所有者。
+
+```typescript
+import { isOwner } from 'tona-utils'
+
+if (isOwner()) {
+  console.log('这是我的博客')
+}
+```
+
+### `getLoginState()`
+
+检查用户是否已登录。
+
+```typescript
+import { getLoginState } from 'tona-utils'
+
+const isLoggedIn = getLoginState()
+```
+
+### `getFollowState()`
+
+检查当前用户是否关注了博客作者。
+
+```typescript
+import { getFollowState } from 'tona-utils'
+
+const isFollowing = getFollowState()
+```
+
+## 页面检测
+
+### `getCurrentPage()`
+
+检测当前页面类型。
+
+```typescript
+import { getCurrentPage } from 'tona-utils'
+
+const page = getCurrentPage()
+// 返回: 'home' | 'post' | 'tags' | 'post-archive' | 'category' | 'photos' | 'photo-view' | 'unknown'
+```
+
+### 页面类型检查
+
+```typescript
+import {
+  isHomePage,
+  isPostDetailsPage,
+  isTagListPage,
+  isCategoryPage,
+  isAlbumPage,
+} from 'tona-utils'
+
+if (isHomePage()) {
+  // 在博客首页
+}
+
+if (isPostDetailsPage()) {
+  // 在博客文章页面
+}
+```
+
+## 博客统计
+
+```typescript
+import {
+  getFollowers,
+  getFollowing,
+  getBlogAge,
+  getPostCount,
+  getArticleCount,
+  getCommentCount,
+  getViewCount,
+} from 'tona-utils'
+
+const followers = getFollowers() // "123"
+const following = getFollowing() // "45"
+const age = getBlogAge() // "3年"
+const posts = getPostCount() // "100"
+```
+
+## 用户操作
+
+### `follow()` / `unfollow()`
+
+关注或取消关注博客作者。
+
+```typescript
+import { follow, unfollow } from 'tona-utils'
+
+follow() // 关注此博客
+unfollow() // 取消关注此博客
+```
+
+### `likePost()` / `unLikePost()`
+
+推荐或取消推荐博客文章。
+
+```typescript
+import { likePost, unLikePost } from 'tona-utils'
+
+likePost() // 推荐此文章
+unLikePost() // 取消推荐此文章
+```
+
+## URL 助手
+
+```typescript
+import {
+  getIndexUrl,
+  getFollowersUrl,
+  getFolloweesUrl,
+  getRssUrl,
+  getNewPostUrl,
+  getAdminUrl,
+} from 'tona-utils'
+
+const blogHome = getIndexUrl() // "https://www.cnblogs.com/username"
+const followers = getFollowersUrl() // "https://home.cnblogs.com/u/username/followers"
+const rss = getRssUrl() // "https://www.cnblogs.com/username/rss"
+```
+
+## 博客信息
+
+```typescript
+import {
+  getCurrentBlogId,
+  getCurrentBlogApp,
+  getNickname,
+  getBlogUserGuid,
+  getSkinName,
+} from 'tona-utils'
+
+const blogId = getCurrentBlogId() // "123456"
+const blogApp = getCurrentBlogApp() // "username"
+const nickname = getNickname() // "博主昵称"
+const guid = getBlogUserGuid() // 用户 GUID
+```
+
+## 代码高亮
+
+```typescript
+import {
+  setCodeTheme,
+  getCodeHighlightTheme,
+  getDarkModeCodeHighlightTheme,
+  checkEnableCodeLineNumber,
+} from 'tona-utils'
+
+// 设置代码主题
+setCodeTheme('dark')
+
+// 检查设置
+const hasLineNumbers = checkEnableCodeLineNumber()
+```
+
+## 相关
+
+- [tona](https://github.com/guangzan/tona/tree/main/packages/core) - 核心框架
+- [tona-hooks](https://github.com/guangzan/tona/tree/main/packages/hooks) - React hooks

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;AAIA;AAQA;AAQA;AAQgB,iBAxBA,OAAA,CAAA,CAwBY,EAAA,OAAA;AAU5B;AAUA;AAQA;AAUA;AAUgB,iBAhEA,aAAA,CAAA,CAgEe,EAAA,OAAA;AAsB/B;AAWA;AAYA;AAQA;AAQgB,iBArHA,QAAA,CAAA,CAqHU,EAAA,OAAA;AAQ1B;AAQA;AAQA;AAQA;AAIgB,iBAjJA,YAAA,CAAA,CAiJc,EAAA,MAAA;AA+D9B;AAQA;AAQA;AAWA;AAOgB,iBAxOA,YAAA,CAAA,CAwOU,EAAA,MAAA;AAY1B;AAcA;AAQA;AAQA;AAQgB,iBAhRA,cAAA,CAAA,CAgRe,EAAA,OAAA;AAQ/B;AAIA;AASA;AAIA;AAIgB,iBArSA,UAAA,CAAA,CAqSY,EAAA,MAAA;AAI5B;AAIA;AAIA;AAIA;AAIgB,iBA/SA,iBAAA,CAAA,CA+SkB,EAAA,MAAA;AAIlC;AAIA;AAIA;AAIA;AAIgB,iBAzTA,eAAA,CAAA,CAyT6B,EAAA,MAAA;AAI7C;AAIA;AAIA;AAIgB,iBAnTA,MAAA,CAAA,CAmTA,EAAA,IAAA;AAIhB;AAIA;AAIA;AAIgB,iBAxTA,QAAA,CAAA,CAwTmB,EAAA,IAAA;AAQnC;AAkCA;AAKA;AAKA;AAKgB,iBArWA,iBAAA,CAAA,CAqWgB,EAAA,OAAA;AAKhC;AAKA;AAKA;AAKA;AAKgB,iBAtXA,iBAAA,CAAA,CAsXe,EAAA,OAAA;AAK/B;AAKA;AAKA;AAKA;AAKgB,iBAvYA,UAAA,CAAA,CAuYa,EAAA,OAAA;AAK7B;AAKA;AAKA;AAKA;AAKgB,iBAxZA,aAAA,CAAA,CAwZc,EAAA,OAAA;AAI9B;;;;iBApZgB,eAAA,CAAA;;;;;iBAQA,WAAA,CAAA;;;;;iBAQA,cAAA,CAAA;iBAIA,cAAA,CAAA;;;;;iBA+DA,IAAA,CAAA;;;;iBAQA,UAAA,CAAA;;;;;iBAQA,YAAA,CAAA;;;;;;iBAWA,QAAA,CAAA;iBAOA,UAAA,CAAA;;;;;;iBAYA,WAAA,CAAA,GAAe;;;;;iBAcf,eAAA,CAAA;;;;;iBAQA,YAAA,CAAA;;;;;iBAQA,eAAA,CAAA;;;;;iBAQA,eAAA,CAAA;;;;;iBAQA,YAAA,CAAA;iBAIA,YAAA;iBASA,gBAAA,CAAA;iBAIA,iBAAA,CAAA;iBAIA,YAAA,CAAA;iBAIA,YAAA,CAAA;iBAIA,WAAA,CAAA;iBAIA,gBAAA,CAAA;iBAIA,oBAAA,CAAA;iBAIA,kBAAA,CAAA;iBAIA,aAAA,CAAA;iBAIA,sBAAA,CAAA;iBAIA,yBAAA,CAAA;iBAIA,qBAAA,CAAA;iBAIA,6BAAA,CAAA;iBAIA,6BAAA,CAAA;iBAIA,qCAAA,CAAA;iBAIA,6BAAA,CAAA;iBAIA,oCAAA,CAAA;iBAIA,4BAAA,CAAA;iBAIA,gBAAA,CAAA;iBAIA,uBAAA,CAAA;iBAIA,mBAAA,CAAA;iBAQA,WAAA,CAAA;iBAkCA,YAAA,CAAA;iBAKA,eAAA,CAAA;iBAKA,eAAA,CAAA;iBAKA,gBAAA,CAAA;iBAKA,SAAA,CAAA;iBAKA,WAAA,CAAA;iBAKA,cAAA,CAAA;iBAKA,eAAA,CAAA;iBAKA,eAAA,CAAA;iBAKA,aAAA,CAAA;iBAKA,UAAA,CAAA;iBAKA,WAAA,CAAA;iBAKA,aAAA,CAAA;iBAKA,aAAA,CAAA;iBAKA,WAAA,CAAA;iBAKA,UAAA,CAAA;iBAKA,YAAA,CAAA;iBAKA,cAAA,CAAA;iBAKA,cAAA,CAAA;iBAIA,cAAA,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;AAIA;;;iBAAgB,OAAA,CAAA;;AAQhB;;;iBAAgB,aAAA,CAAA;;AAQhB;;;iBAAgB,QAAA,CAAA;;AAQhB;;;iBAAgB,YAAA,CAAA;;AAUhB;;;iBAAgB,YAAA,CAAA;;AAUhB;;;iBAAgB,cAAA,CAAA;;AAQhB;;;iBAAgB,UAAA,CAAA;;AAUhB;;;iBAAgB,iBAAA,CAAA;;AAUhB;;;iBAAgB,eAAA,CAAA;;AAsBhB;;iBAAgB,MAAA,CAAA;;;AAWhB;iBAAgB,QAAA,CAAA;;;;AAYhB;iBAAgB,iBAAA,CAAA;;;;AAQhB;iBAAgB,iBAAA,CAAA;;;;AAQhB;iBAAgB,UAAA,CAAA;;;;AAQhB;iBAAgB,aAAA,CAAA;;;;AAQhB;iBAAgB,eAAA,CAAA;;;;AAQhB;iBAAgB,WAAA,CAAA;;;;AAQhB;iBAAgB,cAAA,CAAA;AAAA,iBAIA,cAAA,CAAA;;;AAAhB;;iBA+DgB,IAAA,CAAA;;;AAAhB;iBAQgB,UAAA,CAAA;;;;AAAhB;iBAQgB,YAAA,CAAA;;;;AAAhB;;iBAWgB,QAAA,CAAA;AAAA,iBAOA,UAAA,CAAA;;AAPhB;;;;iBAmBgB,WAAA,CAAA,GAAe,OAAA;AAZ/B;;;;AAAA,iBA0BgB,eAAA,CAAA;AAdhB;;;;AAAA,iBAsBgB,YAAA,CAAA;AARhB;;;;AAAA,iBAgBgB,eAAA,CAAA;AARhB;;;;AAAA,iBAgBgB,eAAA,CAAA;AARhB;;;;AAAA,iBAgBgB,YAAA,CAAA;AAAA,iBAIA,YAAA,CAAa,IAAA;AAAA,iBASb,gBAAA,CAAA;AAAA,iBAIA,iBAAA,CAAA;AAAA,iBAIA,YAAA,CAAA;AAAA,iBAIA,YAAA,CAAA;AAAA,iBAIA,WAAA,CAAA;AAAA,iBAIA,gBAAA,CAAA;AAAA,iBAIA,oBAAA,CAAA;AAAA,iBAIA,kBAAA,CAAA;AAAA,iBAIA,aAAA,CAAA;AAAA,iBAIA,sBAAA,CAAA;AAAA,iBAIA,yBAAA,CAAA;AAAA,iBAIA,qBAAA,CAAA;AAAA,iBAIA,6BAAA,CAAA;AAAA,iBAIA,6BAAA,CAAA;AAAA,iBAIA,qCAAA,CAAA;AAAA,iBAIA,6BAAA,CAAA;AAAA,iBAIA,oCAAA,CAAA;AAAA,iBAIA,4BAAA,CAAA;AAAA,iBAIA,gBAAA,CAAA;AAAA,iBAIA,uBAAA,CAAA;AAAA,iBAIA,mBAAA,CAAA;AAAA,iBAQA,WAAA,CAAA;AAAA,iBAkCA,YAAA,CAAA;AAAA,iBAKA,eAAA,CAAA;AAAA,iBAKA,eAAA,CAAA;AAAA,iBAKA,gBAAA,CAAA;AAAA,iBAKA,SAAA,CAAA;AAAA,iBAKA,WAAA,CAAA;AAAA,iBAKA,cAAA,CAAA;AAAA,iBAKA,eAAA,CAAA;AAAA,iBAKA,eAAA,CAAA;AAAA,iBAKA,aAAA,CAAA;AAAA,iBAKA,UAAA,CAAA;AAAA,iBAKA,WAAA,CAAA;AAAA,iBAKA,aAAA,CAAA;AAAA,iBAKA,aAAA,CAAA;AAAA,iBAKA,WAAA,CAAA;AAAA,iBAKA,UAAA,CAAA;AAAA,iBAKA,YAAA,CAAA;AAAA,iBAKA,cAAA,CAAA;AAAA,iBAKA,cAAA,CAAA;AAAA,iBAIA,cAAA,CAAA"}

package/dist/index.mjs

@@ -369,7 +369,7 @@ function getDraftBoxUrl() {
 function getEditPostUrl() {
 	return `${iCnblog}/EditPosts.aspx?postid=${getCurrentPostId()}`;
 }
-
 //#endregion
 export { IsCommentTurnedOn, checkEnableCodeLineNumber, checkEnableCodeThemeTypeFollowSystem, checkEnableMacStyleCodeBlock, checkEnableMathjax, checkHasCustomScript, checkIsDarkCodeHighlightTheme, checkIsDarkModeCodeHighlightThemeDark, checkIsDisableCodeHighlighter, checkIsLogin, checkIsOwner, follow, getAdminUrl, getAntiforgeryToken, getAppGroupUrl, getAppIngUrl, getAppQUrl, getAppWzUrl, getArticleCount, getBlogAge, getBlogUserGuid, getCnblogHomeUrl, getCodeHighlightEngine, getCodeHighlightTheme, getCommentCount, getCommentedUrl, getContactUrl, getCurrentBlogApp, getCurrentBlogId, getCurrentPage, getCurrentPostDateAdded, getCurrentPostId, getCurrentPostUrl, getDarkModeCodeHighlightTheme, getDetailUrl, getDraftBoxUrl, getEditPostUrl, getFollowState, getFolloweesUrl, getFollowers, getFollowersUrl, getFollowing, getFollowingUrl, getIndexUrl, getLoginState, getMathEngine, getMessageCount, getMessageUrl, getMydiggedUrl, getNewPostUrl, getNickname, getPostCount, getRssUrl, getSendUrl, getSkinName, getUserInfo, getViewCount, getVisitorUserId, hasPostTitle, isAlbumPage, isCategoryPage, isEntrylistPage, isHomePage, isMd, isOwner, isPostDetailsPage, isTagListPage, isTinymce5, likePost, openNews, setCodeTheme, unLikePost, unfollow };
+
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,47 +1,47 @@
 {
   "name": "tona-utils",
-  "version": "1.0.21",
-  "type": "module",
+  "version": "1.0.22",
   "description": "",
+  "keywords": [
+    "博客园"
+  ],
+  "homepage": "https://github.com/guangzan/tona/tree/main/packages/utils#readme",
+  "bugs": {
+    "url": "https://github.com/guangzan/tona/issues"
+  },
+  "license": "MIT",
   "author": {
     "name": "guangzan",
-    "url": "https://www.cnblogs.com/guangzan",
-    "email": "guangzan1999@outlook.com"
+    "email": "guangzan1999@outlook.com",
+    "url": "https://www.cnblogs.com/guangzan"
   },
-  "license": "MIT",
-  "homepage": "https://github.com/guangzan/tona/tree/main/packages/utils#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/guangzan/tona.git",
     "directory": "packages/utils"
   },
-  "bugs": {
-    "url": "https://github.com/guangzan/tona/issues"
-  },
-  "keywords": [
-    "博客园"
+  "files": [
+    "dist"
   ],
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs"
     }
   },
-  "main": "./dist/index.mjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
-  "files": [
-    "dist"
-  ],
   "devDependencies": {
-    "@types/jquery": "^3.5.33",
-    "@vitest/ui": "^4.0.16",
-    "happy-dom": "^20.1.0",
-    "tsdown": "latest",
-    "vitest": "^4.0.16"
+    "@types/jquery": "^4.0.0",
+    "@vitest/ui": "^4.1.0",
+    "happy-dom": "^20.8.4",
+    "vite-plus": "latest",
+    "vitest": "npm:@voidzero-dev/vite-plus-test@latest"
   },
   "scripts": {
-    "dev": "tsdown --watch",
-    "build": "tsdown"
+    "dev": "vp pack --watch",
+    "build": "vp pack"
   }
 }