@xihan-ui/cli 0.0.0-stage → 5.0.0

package/dist/index.d.ts

@@ -0,0 +1,213 @@
+import { Readable, Writable } from "node:stream";
+//#region src/cli.d.ts
+/** 命令行的输入输出环境，缺省为当前进程。 */
+interface CliEnvironment {
+  readonly stdout: (text: string) => void;
+  readonly stderr: (text: string) => void;
+  /** 离线数据目录，缺省为包内 data/。 */
+  readonly dataDir?: string;
+  /** 识别项目所用的目录，缺省为 process.cwd()。 */
+  readonly cwd?: string;
+}
+/** 运行一次命令行，返回退出码；mcp 命令在输入流结束后返回。 */
+declare function runCli(argv: readonly string[], environment?: Partial<CliEnvironment>): Promise<number>;
+//#endregion
+//#region src/knowledge.d.ts
+/** 示例与文档可选的三种写法。 */
+type Framework = 'vue' | 'react' | 'web-components';
+interface FieldRow {
+  readonly name: string;
+  readonly type: string;
+  readonly optional: boolean;
+  readonly doc: string;
+}
+interface AttributeRow {
+  readonly part: string;
+  readonly attr: string;
+  readonly value: string;
+}
+interface ComponentToken {
+  readonly name: string;
+  readonly part: readonly string[];
+  readonly property: readonly string[];
+  readonly state: readonly string[];
+  readonly defaultToken: readonly string[];
+  readonly description: string;
+}
+interface DemoEntry {
+  readonly src: string;
+  readonly title: string;
+  readonly description: string;
+}
+interface ComponentEntry {
+  readonly id: string;
+  readonly name: string;
+  readonly title: string;
+  readonly category: string;
+  readonly categoryLabel: string;
+  readonly status: string | null;
+  readonly overview: string | null;
+  readonly guidance: Readonly<Record<string, string>>;
+  readonly artifacts: {
+    readonly components: readonly string[];
+    readonly composable: string | null;
+    readonly tag: string | null;
+    readonly machine: string | null;
+    readonly skin: string | null;
+  };
+  readonly parts: readonly string[];
+  readonly requiredParts: readonly string[];
+  readonly props: readonly FieldRow[];
+  readonly nodes: readonly {
+    readonly name: string;
+    readonly via: string;
+    readonly fields: readonly FieldRow[];
+  }[];
+  readonly events: readonly {
+    readonly name: string;
+    readonly type: string;
+    readonly description: string;
+  }[];
+  readonly slots: readonly {
+    readonly component: string;
+    readonly name: string;
+    readonly optional: boolean;
+    readonly payload: string;
+    readonly doc: string;
+  }[];
+  readonly reactProps: readonly (FieldRow & {
+    readonly component: string;
+  })[];
+  readonly machine: {
+    readonly states: readonly string[] | null;
+    readonly events: readonly string[] | null;
+    readonly guards: readonly string[] | null;
+  };
+  readonly api: readonly {
+    readonly name: string;
+    readonly type: string;
+    readonly doc: string;
+  }[];
+  readonly keyboard: {
+    readonly source: string;
+    readonly rows: readonly {
+      readonly keys: readonly string[];
+      readonly when: string;
+      readonly does: string;
+    }[];
+  };
+  readonly aria: readonly AttributeRow[];
+  readonly dataAttributes: readonly AttributeRow[];
+  readonly componentTokens: readonly ComponentToken[];
+  readonly demos: readonly DemoEntry[];
+}
+interface CategoryEntry {
+  readonly id: string;
+  readonly label: string;
+  readonly description: string;
+}
+interface PageEntry {
+  /** 站内路径，不带扩展名，如 `guide/theme`、`components/select`。 */
+  readonly path: string;
+  readonly title: string;
+  readonly summary: string;
+  readonly markdown: string;
+}
+interface TokenEntry {
+  readonly name: string;
+  readonly type: string;
+  /** tokens.json 里的原始取值，可能引用别的令牌。 */
+  readonly value: string;
+  /** 沿 var() 展开后的取值。 */
+  readonly resolved: string;
+  /** 除缺省档外还改写过它的令牌源。 */
+  readonly layers: readonly string[];
+}
+interface TokenData {
+  readonly tokens: readonly TokenEntry[];
+  /** 只在 data-tone 作用域里有取值的语气族令牌。 */
+  readonly tone: readonly string[];
+}
+interface Meta {
+  readonly version: string;
+  readonly site: string;
+}
+/** 示例源码：键是示例路径（如 `select/01-basic`），值是各写法的源码。 */
+type DemoSources = Readonly<Record<string, Partial<Record<Framework, string>>>>;
+interface Knowledge {
+  readonly meta: Meta;
+  readonly categories: readonly CategoryEntry[];
+  readonly components: readonly ComponentEntry[];
+  pages: () => readonly PageEntry[];
+  demos: () => DemoSources;
+  tokens: () => TokenData;
+  designMd: () => string;
+  changelog: () => string;
+}
+/** 从数据目录读出全部知识；大文件在首次用到时才读。 */
+declare function loadKnowledge(dataDir?: string): Knowledge;
+//#endregion
+//#region src/tools.d.ts
+interface ToolContext {
+  readonly knowledge: Knowledge;
+  /** 未指定写法时使用的写法：项目里识别到的适配器，识别不到时是 Vue。 */
+  readonly framework: Framework;
+}
+type Args = Readonly<Record<string, unknown>>;
+interface JsonSchema {
+  readonly type: 'object';
+  readonly properties: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+  readonly required?: readonly string[];
+  readonly additionalProperties: false;
+}
+interface ToolDefinition {
+  readonly name: string;
+  readonly title: string;
+  readonly description: string;
+  readonly inputSchema: JsonSchema;
+  readonly run: (args: Args, context: ToolContext) => string;
+}
+declare const TOOLS: readonly ToolDefinition[];
+interface PromptArgument {
+  readonly name: string;
+  readonly description: string;
+  readonly required: boolean;
+}
+interface PromptDefinition {
+  readonly name: string;
+  readonly title: string;
+  readonly description: string;
+  readonly arguments: readonly PromptArgument[];
+  readonly render: (args: Readonly<Record<string, string>>, context: ToolContext) => string;
+}
+declare const PROMPTS: readonly PromptDefinition[];
+//#endregion
+//#region src/mcp.d.ts
+/** 按新到旧排列的受支持协议版本。 */
+declare const PROTOCOL_VERSIONS: readonly ["2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"];
+type Id = string | number;
+type Response = {
+  jsonrpc: '2.0';
+  id: Id | null;
+  result: unknown;
+} | {
+  jsonrpc: '2.0';
+  id: Id | null;
+  error: {
+    code: number;
+    message: string;
+  };
+};
+interface McpServerOptions {
+  readonly context: ToolContext;
+  readonly version: string;
+  /** 写进 initialize 结果的使用说明。 */
+  readonly instructions: string;
+}
+/** 处理一条请求；通知（不带 id）返回 undefined。 */
+declare function handleMessage(message: unknown, options: McpServerOptions): Response | undefined;
+/** 在给定的输入输出流上运行服务端，输入结束时返回。 */
+declare function serveStdio(options: McpServerOptions, input?: Readable, output?: Writable): Promise<void>;
+//#endregion
+export { type CliEnvironment, type ComponentEntry, type Framework, type Knowledge, type McpServerOptions, PROMPTS, PROTOCOL_VERSIONS, type PageEntry, type PromptDefinition, TOOLS, type TokenEntry, type ToolContext, type ToolDefinition, handleMessage, loadKnowledge, runCli, serveStdio };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/cli.ts","../src/knowledge.ts","../src/tools.ts","../src/mcp.ts"],"mappings":";;;UAiDiB;WACN,SAAS;WACT,SAAS;;WAET;;WAEA;;;iBA6GW,OAAO,yBAAyB,cAAa,QAAQ,kBAAuB;;;;KCxJtF;UAIK;WACN;WACA;WACA;WACA;;UAGM;WACN;WACA;WACA;;UAGM;WACN;WACA;WACA;WACA;WACA;WACA;;UAGM;WACN;WACA;WACA;;UAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA,UAAU,SAAS;WACnB;aACE;aACA;aACA;aACA;aACA;;WAEF;WACA;WACA,gBAAgB;WAChB;aAA2B;aAAuB;aAAsB,iBAAiB;;WACzF;aAA4B;aAAuB;aAAuB;;WAC1E;aAA2B;aAA4B;aAAuB;aAA4B;aAA0B;;WACpI,sBAAsB;aAAsB;;WAC5C;aACE;aACA;aACA;;WAEF;aAAyB;aAAuB;aAAuB;;WACvE;aACE;aACA;eAA0B;eAAkC;eAAuB;;;WAErF,eAAe;WACf,yBAAyB;WACzB,0BAA0B;WAC1B,gBAAgB;;UAGV;WACN;WACA;WACA;;UAGM;;WAEN;WACA;WACA;WACA;;UAGM;WACN;WACA;;WAEA;;WAEA;;WAEA;;UAGM;WACN,iBAAiB;;WAEjB;;UAGM;WACN;WACA;;;KAIC,cAAc,SAAS,eAAe,QAAQ,OAAO;UAEhD;WACN,MAAM;WACN,qBAAqB;WACrB,qBAAqB;EAC9B,sBAAsB;EACtB,aAAa;EACb,cAAc;EACd;EACA;;;iBAiBc,cAAc,mBAAqC;;;UCpIlD;WACN,WAAW;;WAEX,WAAW;;KAGjB,OAAO,SAAS;UAEJ;WACN;WACA,YAAY,SAAS,eAAe,SAAS;WAC7C;WACA;;UAGM;WACN;WACA;WACA;WACA,aAAa;WACb,MAAM,MAAM,MAAM,SAAS;;cAgDzB,gBAAgB;UAgIZ;WACN;WACA;WACA;;UAGM;WACN;WACA;WACA;WACA,oBAAoB;WACpB,SAAS,MAAM,SAAS,yBAAyB,SAAS;;cASxD,kBAAkB;;;;cCxNlB;KAOR;KASA;EACG;EAAgB,IAAI;EAAW;;EAC/B;EAAgB,IAAI;EAAW;IAAS;IAAc;;;UAW7C;WACN,SAAS;WACT;;WAEA;;;iBAQK,cAAc,kBAAkB,SAAS,mBAAmB;;iBA0H5D,WAAW,SAAS,kBAAkB,QAAO,UAA0B,SAAQ,WAA4B"}