Use unified takumi-js package

Author: Wesley-Young

.changeset/clean-takumi-dependencies.md

@@ -0,0 +1,5 @@
+---
+'@fraqjs/plugin-takumi': patch
+---
+
+将 `@takumi-rs` 下的依赖统一成 `takumi-js`

docs/content/docs/plugins/takumi.mdx

@@ -28,7 +28,7 @@ plugins:
 
 {/* prettier-ignore */}
 <Callout type="warning">
-`@fraqjs/plugin-takumi` 依赖 `@takumi-rs/core` 包。Takumi 是一个 Rust 项目，在 Node.js 环境下只支持如下平台：
+`@fraqjs/plugin-takumi` 通过 `takumi-js/node` 使用 Takumi 的原生 Node.js 后端。Takumi 是一个 Rust 项目，在 Node.js 环境下只支持如下平台：
 
 - Windows x64/arm64
 - macOS x64/arm64
@@ -214,9 +214,9 @@ npx takumi-preview src/templates/MyCard.tsx
 预览工具默认使用的渲染选项为 `{ devicePixelRatio: 1.5 }`。你可以通过在模板文件中导出一个名为 `previewRenderOptions` 的对象来覆盖默认选项：
 
 ```ts
-import type { RenderOptions } from '@takumi-rs/core';
+import type { RenderCallOptions } from '@fraqjs/plugin-takumi';
 
-export const previewRenderOptions: RenderOptions = {
+export const previewRenderOptions: RenderCallOptions = {
   width: 800,
   height: 600,
   devicePixelRatio: 1,
@@ -241,11 +241,11 @@ const img = await ctx.takumi.renderJsx(<img src={src} alt="Example" />, {
 });
 ```
 
-如果同一个模板需要使用多张远程图片，可以使用 `@takumi-rs/helpers` 提供的 `prepareImages` 来收集节点中的图片地址并获取资源。`fetchCache` 可以在多次渲染之间复用图片字节，避免重复请求同一个 URL。
+如果同一个模板需要使用多张远程图片，可以使用 `takumi-js` 提供的 `prepareImages` 来收集节点中的图片地址并获取资源。由于模板直接使用这些辅助 API，需要将 `takumi-js` 添加到模板所在项目的依赖中。`fetchCache` 可以在多次渲染之间复用图片字节，避免重复请求同一个 URL。
 
 ```tsx
-import { prepareImages } from '@takumi-rs/helpers';
-import { fromJsx } from '@takumi-rs/helpers/jsx';
+import { prepareImages } from 'takumi-js/helpers';
+import { fromJsx } from 'takumi-js/helpers/jsx';
 
 const element = (
   <div>

packages/takumi-preview/package.json

@@ -29,8 +29,8 @@
   },
   "devDependencies": {
     "@fraqjs/plugin-takumi": "workspace:^",
-    "@takumi-rs/helpers": "^2.10.0",
-    "@types/react": "^19.2.18"
+    "@types/react": "^19.2.18",
+    "takumi-js": "^2.12.0"
   },
   "dependencies": {
     "@hono/node-server": "^2.1.1",

packages/takumi-preview/test/ExampleCard.tsx

@@ -1,4 +1,4 @@
-/// <reference types="@takumi-rs/helpers/jsx" />
+/// <reference types="takumi-js/helpers/jsx" />
 
 import { PluginName, PreviewModuleId } from './dependency';
 

plugins/takumi/package.json

@@ -31,8 +31,7 @@
   },
   "dependencies": {
     "@fraqjs/takumi-builtin-fonts": "^1.0.0",
-    "@takumi-rs/core": "^2.10.0",
-    "@takumi-rs/helpers": "^2.10.0"
+    "takumi-js": "^2.12.0"
   },
   "devDependencies": {
     "@fraqjs/plugin-mock": "workspace:^",

plugins/takumi/src/service.ts

@@ -1,10 +1,10 @@
 import { type Context, type Disposable, serviceToken } from '@fraqjs/fraq';
-import { type FontLoader, type ImageLoader, type ImagesInput, Renderer, type RenderOptions } from '@takumi-rs/core';
-import { fontFromUrl, type Node, prepareImages, type ReactElementLike } from '@takumi-rs/helpers';
-import { type EmojiType, extractEmojis } from '@takumi-rs/helpers/emoji';
-import { fromHtml } from '@takumi-rs/helpers/html';
-import { fromJsx } from '@takumi-rs/helpers/jsx';
 import type { ReactNode } from 'react';
+import { fontFromUrl, type Node, prepareImages, type ReactElementLike } from 'takumi-js/helpers';
+import { type EmojiType, extractEmojis } from 'takumi-js/helpers/emoji';
+import { fromHtml } from 'takumi-js/helpers/html';
+import { fromJsx } from 'takumi-js/helpers/jsx';
+import { type FontLoader, type ImageLoader, type ImagesInput, Renderer, type RenderOptions } from 'takumi-js/node';
 
 import fs from 'node:fs/promises';