@web-mods/articles 1.1.2 → 1.1.4

package/README.md

@@ -8,6 +8,26 @@
 pnpm add @web-mods/articles
 ```
 
+## 导航设置
+
+文章保存时提交 `navEnabled`、`navname`、`navPlacements`，编辑时回显接口配置。启用导航需填写名称并选择至少一个展示位置，网站地址必填。
+
+父导航从 `GET /navigation/groups?host=...&position=...` 读取，通过 `POST /navigation/groups` 创建并选中真实 ID，不提供前端示例选项。切换网站地址会清空父导航选择并重新加载；关闭导航会保留名称和位置。页眉暂时仅支持顶级导航，已有父导航只读保留；页尾可选父导航。
+
+自定义 `ArticleService` 可实现 `getNavigationGroups`、`createNavigationGroup`；未实现查询方法时禁用导航编辑，文章保存省略导航字段，兼容旧宿主。
+
+写操作需要 Bearer Token。默认 service 每次请求会读取当前页面的 `localStorage.accessToken`，并加入 `Authorization: Bearer ...`。自定义 service 可复用宿主凭证：
+
+```ts
+const articleService = createArticleService('https://api-blog.aisee.live', {
+  headers: () => ({ Authorization: `Bearer ${getAccessToken()}` }),
+})
+```
+
+本地调试运行 `pnpm dev`（或 `pnpm playground`），访问 `http://localhost:5173/articles`。页面使用默认 service，直接请求 `src/service.ts` 中配置的 `https://api-blog.aisee.live`。仅监听组件库构建请运行 `pnpm build:watch`。
+
+接口约定见 [技术交接文档](docs/article-navigation-implementation.md)。
+
 > **Peer dependencies**：`react >=18`、`react-dom >=18`
 >
 > `react-router` 仅在 **react-router 环境**下需要（见下方适配说明）。`dayjs`、`lucide-react`、`@monaco-editor/react` 均已打包在内，无需单独安装。
@@ -76,6 +96,8 @@ export default [
 
 用 `ReactRouterAdapter` 桥接路由，这是唯一需要 `react-router` 的地方：
 
+适配器应放在 `ArticlesProvider` 内，可包裹 `<Outlet />` 或整个 `<Routes>`。编辑和详情页的文章 ID 会从当前 URL 匹配，因此刷新或直接访问也能正常加载，不依赖跳转时的 `state`。
+
 ```tsx
 // pages/articles/layout.tsx
 import { Outlet } from 'react-router'

package/dist/components/ArticleNavigationSettings.d.ts

@@ -0,0 +1,9 @@
+import type { ArticleNavigation, ArticleService } from "../types";
+interface ArticleNavigationSettingsProps {
+    host: string;
+    service: ArticleService;
+    value: ArticleNavigation;
+    onChange: (value: ArticleNavigation) => void;
+}
+export declare function ArticleNavigationSettings({ host, service, value, onChange }: ArticleNavigationSettingsProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/ValidationIssues.d.ts

@@ -0,0 +1,5 @@
+import type { W3CMessage } from '../utils/validateHtml';
+export declare function ValidationIssues({ errors, source }: {
+    errors: W3CMessage[];
+    source: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/Tooltip.d.ts

@@ -3,6 +3,8 @@ interface TooltipProps {
     title: ReactNode;
     children: ReactNode;
     placement?: 'top' | 'bottom';
+    align?: 'center' | 'end';
+    variant?: 'default' | 'card';
 }
-export declare function Tooltip({ title, children, placement }: TooltipProps): import("react/jsx-runtime").JSX.Element;
+export declare function Tooltip({ title, children, placement, align, variant }: TooltipProps): import("react/jsx-runtime").JSX.Element;
 export {};