@xiongtao.xt/tau-plugins 0.18.0 → 0.19.0

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

@@ -0,0 +1,29 @@
+export { assertLocalId } from "./ids";
+export { comparePluginVersions } from "./version";
+export declare const PLUGIN_SHARED_MODULES: readonly ["@tau/plugins", "@tau/plugins/whiteboard", "@tau/plugins/sync", "@tau/ui", "react", "react-dom", "react-dom/client", "react/jsx-runtime", "react/jsx-dev-runtime"];
+export interface PluginManifest {
+    formatVersion: 1;
+    id: string;
+    name: string;
+    version: string;
+    minAppVersion?: string;
+    apiVersion: 1;
+    platform: "desktop";
+    format: "cjs";
+    main: string;
+    /** 无界面的同步存储入口，Node产物与UI入口分别校验。 */
+    styles?: string;
+    /** 静态编辑器贡献在窗口启动时装配，启停需重启。 */
+    editor?: true;
+    whiteboard?: true;
+    integrity: Record<string, string>;
+}
+/** 宿主内部传输的已读取产物，不属于作者运行时 API。 */
+export interface DevelopmentPluginPackage {
+    manifest: PluginManifest;
+    code: string;
+    css?: string;
+}
+export declare function validatePluginManifest(value: unknown): PluginManifest;
+/** 静态内容贡献在启动时固定，启停与更新需要重启。 */
+export declare const isContentPlugin: (manifest: Pick<PluginManifest, "editor" | "whiteboard">) => boolean;

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

@@ -0,0 +1,15 @@
+export { validatePluginManifest, PLUGIN_SHARED_MODULES } from "./package";
+export declare const SIDEBAR_GROUPS: Readonly<Record<string, string>>;
+import type { DevelopmentPluginPackage } from "./package";
+export declare const PLUGIN_RENDER_VERSION: 1;
+export type { PublishedPluginRender } from "./render-artifact";
+/** 协议层只检查贡献归属，具体扩展类型由模板选用的渲染器解释。 */
+export interface EvaluatedPluginDefinition {
+    id: string;
+    name: string;
+    version: string;
+    apiVersion: 1;
+    editorExtensions?: readonly unknown[];
+}
+export declare function evaluatePluginPackage(artifact: DevelopmentPluginPackage, modules: Readonly<Record<string, unknown>>): EvaluatedPluginDefinition;
+export declare function assertRenderTypes(definition: EvaluatedPluginDefinition, types: string[]): void;

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

@@ -0,0 +1,8 @@
+import type { DataClient } from "./publish-data";
+export declare class DataError extends Error {
+    code: string;
+    constructor(code: string, message: string);
+}
+export declare function createClient({ manifestUrl }: {
+    manifestUrl: string;
+}): DataClient;

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

@@ -0,0 +1,274 @@
+/** 发布数据协议不包含公开路由、DOM、组件或宿主生命周期。 */
+export type DataKind = "home" | "card" | "article" | "doc" | "quest" | "list";
+export interface ContentRef {
+    key: string;
+    type: DataKind;
+    id?: number;
+}
+export interface ResourceRef {
+    href: string;
+    integrity: string;
+}
+export interface ManifestItem extends ContentRef {
+    collectionType?: "card" | "article" | "doc" | "quest";
+    title: string;
+    projectId?: number;
+    data: string;
+    integrity: string;
+}
+export interface SiteData {
+    title: string;
+    description: string;
+    basePath: string;
+    publicUrl?: string;
+    favicon?: {
+        href: string;
+        format: "svg" | "png" | "ico";
+        mimeType: string;
+    };
+}
+export interface DataManifest {
+    version: 1;
+    site: SiteData;
+    search: {
+        data: string;
+        integrity: string;
+    };
+    items: ManifestItem[];
+}
+export interface ContentNode {
+    [field: string]: unknown;
+    text?: string;
+    type?: string;
+    children?: ContentNode[];
+}
+export interface TreeItem {
+    title: string;
+    target?: ContentRef;
+    children?: TreeItem[];
+}
+export interface Collection {
+    type: "project";
+    label: string;
+    items: {
+        id: number;
+        title: string;
+        target: ContentRef;
+        kind: "project";
+    }[];
+}
+export interface RelatedCard {
+    id: number;
+    target: ContentRef;
+    summary: string;
+    tags: string[];
+}
+export interface CardData {
+    id: number;
+    content: ContentNode[];
+    tags: string[];
+    createTime: number;
+    updateTime: number;
+    linkedCards?: RelatedCard[];
+}
+export interface ArticleData extends Omit<CardData, "linkedCards"> {
+    title: string;
+    author: string;
+    bannerBg?: string;
+}
+export interface DocData {
+    id: number;
+    projectId: number;
+    title: string;
+    content: ContentNode[];
+    breadcrumb: {
+        label: string;
+        target?: ContentRef;
+    }[];
+    prevPage?: {
+        title: string;
+        target: ContentRef;
+    };
+    nextPage?: {
+        title: string;
+        target: ContentRef;
+    };
+    createTime: number;
+    updateTime: number;
+}
+export type QuestStatus = "not_started" | "in_progress" | "resolved";
+export interface QuestAnswer {
+    id: number;
+    createTime: number;
+    updateTime: number;
+    content?: ContentNode[];
+    source?: {
+        type: "card" | "article" | "project-item" | "custom";
+        id?: number;
+        contentId: number;
+        target?: ContentRef;
+        title?: string;
+        published: boolean;
+    };
+}
+export interface QuestMaterial {
+    index: number;
+    kind: string;
+    group: "external" | "note" | "discussion";
+    title: string;
+    meta: string;
+    excerpt: string;
+    note?: string;
+    target?: ContentRef;
+    url?: string;
+    citeKey?: string;
+}
+export interface QuestTrail {
+    time: number;
+    tone: "start" | "milestone" | "plain" | "note" | "done";
+    text: string;
+    refs: number[];
+}
+export interface QuestData {
+    id: number;
+    title: string;
+    summary: string;
+    target: ContentRef;
+    groupId: number;
+    groupTitle: string;
+    groupColor?: string;
+    status: QuestStatus;
+    answers: QuestAnswer[];
+    materials: QuestMaterial[];
+    trail: QuestTrail[];
+    description?: ContentNode[];
+    createTime: number;
+    updateTime: number;
+    resolvedTime?: number | null;
+}
+export interface TimelineItem {
+    type: "card" | "article" | "doc" | "quest";
+    id: number;
+    title?: string;
+    summary: string;
+    target: ContentRef;
+    tags: string[];
+    publishTime: number;
+}
+export interface HomeData {
+    hero?: {
+        title: string;
+        description: string;
+    };
+    timeline: TimelineItem[];
+    stats: {
+        articles: number;
+        cards: number;
+    };
+    docStats: {
+        projects: number;
+    };
+}
+export interface ListItem {
+    id: number;
+    title?: string;
+    summary: string;
+    target: ContentRef;
+    tags: string[];
+    createTime: number;
+    updateTime?: number;
+    groupId?: number;
+    groupTitle?: string;
+    status?: QuestStatus;
+    answerCount?: number;
+}
+export interface ListData {
+    title: string;
+    type: "card" | "article" | "doc" | "quest";
+    items: ListItem[];
+    tags?: {
+        name: string;
+        count: number;
+    }[];
+}
+export interface CardTagTree {
+    tag: string;
+    count: number;
+    cards: {
+        id: number;
+        summary: string;
+        target: ContentRef;
+        createTime: number;
+    }[];
+    children?: CardTagTree[];
+}
+export interface PublishedCommon {
+    version: 1;
+    key: string;
+    tree?: TreeItem[];
+    collections?: Collection[];
+    cardTagTree?: CardTagTree[];
+    contentLinkTargets?: Record<string, ContentRef>;
+    pluginRenderers?: import("./render-artifact").PublishedPluginRender[];
+    contentStyles?: ResourceRef[];
+    settings?: {
+        appearance?: {
+            image?: {
+                borderRadius?: string;
+                shadow?: string | boolean;
+            };
+        };
+    };
+}
+export type PublishedData = {
+    [K in DataKind]: PublishedCommon & {
+        meta: {
+            type: K;
+            publishTime: number;
+        };
+        content: {
+            home: HomeData;
+            card: CardData;
+            article: ArticleData;
+            doc: DocData;
+            quest: QuestData;
+            list: ListData;
+        }[K];
+    };
+}[DataKind];
+export interface DataResult {
+    data: PublishedData;
+    dataUrl: string;
+}
+export interface SearchDocument extends ContentRef {
+    type: "card" | "article" | "doc" | "quest";
+    title: string;
+    summary: string;
+    content: string;
+    tags: string[];
+}
+export interface SearchFile {
+    version: 1;
+    documents: SearchDocument[];
+}
+export interface SearchMatch {
+    field: "title" | "summary" | "content" | "tags";
+    text: string;
+    ranges: [number, number][];
+}
+export interface SearchHit extends Omit<SearchDocument, "content"> {
+    matches?: SearchMatch[];
+}
+export interface DataClient {
+    readManifest(options?: {
+        signal?: AbortSignal;
+    }): Promise<DataManifest>;
+    readData(options: {
+        key: string;
+        signal?: AbortSignal;
+    }): Promise<DataResult>;
+    search(query: string, options?: {
+        limit?: number;
+        signal?: AbortSignal;
+    }): Promise<SearchHit[]>;
+}

package/types/packages/plugins/src/render-artifact.d.ts

@@ -0,0 +1,9 @@
+import type { PluginManifest } from "./package";
+/** 发布内容只携带插件产物元数据，不依赖编辑器或 UI 类型。 */
+export interface PublishedPluginRender {
+    runtimeVersion: 1;
+    manifest: PluginManifest;
+    entry: string;
+    styles?: string;
+    nodeTypes: string[];
+}

package/types/packages/plugins/src/source-editor.d.ts

@@ -1,41 +1,5 @@
-import type { ReactNode, ReactElement } from "react";
-import type { LucideIcon } from "lucide-react";
-import type { Editor, Element, Path } from "slate";
-import type { ElementBehaviors, ParagraphElement, BlockElement } from "../../editor/api";
-export interface SourceBlockEditorProps {
-    mode: string;
-    title: string;
-    icon: LucideIcon;
-    initValue: string;
-    onChange(value: string): void;
-    element: Element;
-    center?: boolean;
-    extend?: boolean;
-    fluid?: boolean;
-    children?: ReactNode;
-}
-export interface PluginRuntimeStyleCompiler {
-    compile(request: {
-        source: string;
-        language: "html" | "tsx";
-    }): Promise<string>;
-}
-export interface SourceEditorRuntime {
-    SourceBlockEditor(props: SourceBlockEditorProps): ReactElement;
-    useSourceBlock(element: Element): {
-        theme: {
-            isDark: boolean;
-            token(word: string): string;
-        };
-        compiler: PluginRuntimeStyleCompiler | undefined;
-        update(properties: Record<string, unknown>): void;
-    };
-    useReportPreviewError(error: string | null, options?: {
-        stale?: boolean;
-    }): boolean;
-    insertSourceBlock(editor: Editor, element: BlockElement, line?: number): Path | undefined;
-    sourceBlockParagraphBehavior(type: string): ElementBehaviors<ParagraphElement>;
-}
+import type { SourceEditorRuntime } from "../../editor/source-contracts";
+export type { SourceBlockEditorProps, RuntimeStyleCompiler as PluginRuntimeStyleCompiler, SourceEditorRuntime, } from "../../editor/source-contracts";
 export declare function configureSourceEditor(value: SourceEditorRuntime): void;
 export declare const SourceBlockEditor: SourceEditorRuntime["SourceBlockEditor"];
 export declare const useSourceBlock: SourceEditorRuntime["useSourceBlock"];

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

@@ -0,0 +1,4 @@
+export declare function comparePluginVersions(left: string, right: string): number;
+export declare function assertPluginCompatibility(manifest: {
+    minAppVersion?: string;
+}, clientVersion: string): void;

package/types/packages/editor/src/types/text.d.ts

@@ -1 +0,0 @@
-export type { FormattedText } from "../../../markdown/src/model";