@xiongtao.xt/tau-plugins 0.27.0 → 0.29.0

package/types/packages/plugins/src/notifications.d.ts

@@ -0,0 +1,25 @@
+import type { Disposable } from "./contract";
+export type PluginNotificationMode = "auto" | "in-app" | "system";
+export interface PluginNotificationAction {
+    label: string;
+    primary?: boolean;
+    resolvedText?: string;
+    onClick(): void | Promise<void>;
+}
+export interface PluginNotificationOptions {
+    title: string;
+    body?: string;
+    /** 默认 auto：插件所在窗口聚焦时应用内展示，否则进入独立通知窗口。 */
+    mode?: PluginNotificationMode;
+    tone?: "neutral" | "ok" | "danger";
+    /** 常驻到用户处理或关闭，默认 false。 */
+    sticky?: boolean;
+    /** 最多两个按钮，最多一个主按钮；回调在插件所在窗口执行。 */
+    actions?: readonly PluginNotificationAction[];
+}
+export interface PluginNotifications {
+    /** 发送通知，dispose 撤销这一条；停用、激活失败或切库时自动撤销。 */
+    send(options: PluginNotificationOptions): Disposable;
+}
+/** 只复制公开字段，避免插件对象或回调进入跨进程载荷。 */
+export declare function readNotificationOptions(input: PluginNotificationOptions): PluginNotificationOptions;

package/types/packages/plugins/src/pages.d.ts

@@ -1,9 +1,15 @@
 import type { ComponentType } from "react";
 import type { Disposable, PluginContext } from "./index";
+import type { JsonValue } from "./json";
 export type PluginPageParams = Record<string, string | number | boolean>;
+export interface PluginPageContext {
+    /** 在组件 effect 中登记当前状态提供器；返回值的形状由插件决定。 */
+    register(provider: () => JsonValue): Disposable;
+}
 export interface PluginPageProps {
     readonly context: PluginContext;
     readonly params: Readonly<PluginPageParams>;
+    readonly pageContext: PluginPageContext;
 }
 export interface PluginPageDefinition {
     id: string;

package/types/packages/plugins/src/publish-data.d.ts

@@ -56,6 +56,18 @@ export interface ContentNode {
     type?: string;
     children?: ContentNode[];
 }
+/** 由宿主生成发布快照、由博客渲染器内置展示的业务节点。 */
+export declare const PUBLISHED_HOST_ELEMENT_TYPES: readonly ["project-card-list"];
+export interface PublishedProjectCardListNode extends ContentNode {
+    type: "project-card-list";
+    items: {
+        id: number;
+        title: string;
+        summary: string;
+        target: ContentRef;
+    }[];
+    children: ContentNode[];
+}
 export interface TreeItem {
     title: string;
     target?: ContentRef;

package/types/packages/ui/src/index.d.ts

@@ -13,6 +13,7 @@ export * from "./primitives/Button";
 export * from "./primitives/IconButton";
 export * from "./primitives/Loading";
 export * from "./primitives/Panel";
+export * from "./primitives/DocumentCard";
 export * from "./primitives/Toast";
 export * from "./primitives/Notification";
 export * from "./primitives/Tooltip";

package/types/packages/ui/src/primitives/DocumentCard.d.ts

@@ -0,0 +1,11 @@
+import type { ReactNode } from "react";
+export declare function DocumentCardGrid({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** 尺寸使用 em，让编辑器与发布站点的卡片随正文字号一起缩放。 */
+export declare function DocumentCard({ title, description, href, onClick, }: {
+    title: string;
+    description: string;
+    href?: string;
+    onClick?: () => void;
+}): import("react/jsx-runtime").JSX.Element;