cloudlab-ui 0.0.7 → 0.0.9

package/lib/index.d.ts

@@ -0,0 +1,446 @@
+/**
+ * cloudlab-ui 组件库类型声明文件
+ * 
+ * 本文件提供所有导出组件、hooks、工具函数和类型的 TypeScript 声明
+ */
+
+import * as React from 'react';
+
+// ==================== 类型定义 ====================
+
+export type Scenario = 'exam' | 'response' | 'reanswer' | 'editor' | 'write';
+
+export type QuestionType = 'radio' | 'checkbox' | 'answer' | 'completion' | 'ccm';
+
+export interface Style {
+  className?: string;
+  style?: React.CSSProperties;
+}
+
+// 单选题数据结构
+export interface RadioQuestionData {
+  type: 'radio';
+  text: string;
+  options: Array<{ title: string; value: string }>;
+  answer: string;
+  score?: number;
+  analysis?: string;
+  validated?: boolean;
+  validateMessage?: string;
+}
+
+// 多选题数据结构
+export interface MultipleQuestionData {
+  type: 'checkbox';
+  text: string;
+  options: Array<{ title: string; value: string }>;
+  answer: Array<string>;
+  score?: number;
+  analysis?: string;
+  validated?: boolean;
+  validateMessage?: string;
+}
+
+// 问答题数据结构
+export interface AnswerQuestionData {
+  type: 'answer';
+  text: string;
+  answer: string;
+  score?: number;
+  analysis?: string;
+  validated?: boolean;
+  validateMessage?: string;
+}
+
+// 填空题数据结构
+export interface CompletionQuestionData {
+  type: 'completion';
+  text: string;
+  inputList: Array<{
+    id: string;
+    answer: string;
+    userAnswer?: string;
+  }>;
+  answerList: Array<string>;
+  score?: number;
+  validated?: boolean;
+  validateMessage?: string;
+}
+
+// 编码测验题数据结构
+export interface CcmQuestionData {
+  type: string;
+  form: string;
+  topic: string;
+  text: string;
+  codeText: {
+    lang: string;
+    value: string;
+  };
+  example: Array<{ input: string[]; output: string }>;
+  test: Array<{ input: string[]; output: string }>;
+  score?: number;
+  validated?: boolean;
+  validateMessage?: string;
+}
+
+// 代码块数据结构
+export interface CodeBlockData {
+  type: 'codeBlock';
+  text: string;
+  lang: string;
+  langList: Array<string>;
+  meta?: string;
+}
+
+// 自动判分请求参数
+export interface AutoScoreParams {
+  id?: string;
+  type: string;
+  title: string;
+  content: string;
+  score: number;
+  require: string;
+  answer: string;
+  commit: string;
+}
+
+// 判分反馈信息
+export interface ReasonsParams {
+  item?: string;
+  reason: string;
+  score: number;
+}
+
+// 自动判分响应
+export interface AutoScoreResponse {
+  userScore: number;
+  reasons: ReasonsParams[];
+  answer?: string;
+  comment?: string;
+  [key: string]: unknown;
+}
+
+// 基础题目 JSON 结构（新格式）
+export interface BaseQuestionJson {
+  type: string;
+  topic?: string;
+  content?: string | null;
+  difficulty?: string;
+  score?: number;
+  option?: Array<{ key: string; value: string }>;
+  answer?: unknown;
+  description?: string;
+  validated?: boolean;
+  message?: string;
+  [key: string]: unknown;
+}
+
+// ==================== 组件 Props ====================
+
+export interface QuestionRadioProps {
+  scenario?: Scenario;
+  content: string | RadioQuestionData | BaseQuestionJson;
+  index?: number;
+  elements?: React.ReactNode[];
+  className?: string;
+  disabled?: boolean;
+  scoreDisabled?: boolean;
+  showScore?: boolean;
+  elementCheckbox?: React.ReactNode;
+  elementLabel?: React.ReactNode;
+  requestId?: string;
+  onAnswer?: (answer: string) => void;
+  onScore?: (score: number) => void;
+  returnContent?: (content: RadioQuestionData) => void;
+}
+
+export interface QuestionMultipleProps {
+  content: string | MultipleQuestionData | BaseQuestionJson;
+  index?: number;
+  elements?: React.ReactNode[];
+  className?: string;
+  disabled?: boolean;
+  scoreDisabled?: boolean;
+  showScore?: boolean;
+  elementCheckbox?: React.ReactNode;
+  elementLabel?: React.ReactNode;
+  onAnswer?: (answer: string[]) => void;
+  onScore?: (score: number) => void;
+  returnContent?: (content: MultipleQuestionData) => void;
+  scenario?: Scenario;
+  requestId?: string;
+  onAutoScore?: (result: {
+    success: boolean;
+    score?: number;
+    reasons?: Array<{ item?: string; reason: string; score: number }>;
+  }) => void;
+}
+
+export interface QuestionAnswerProps {
+  scenario?: Scenario;
+  content: string | AnswerQuestionData | BaseQuestionJson;
+  index?: number;
+  elements?: React.ReactNode[];
+  className?: string;
+  disabled?: boolean;
+  scoreDisabled?: boolean;
+  showScore?: boolean;
+  elementCheckbox?: React.ReactNode;
+  elementLabel?: React.ReactNode;
+  requestId?: string;
+  onAnswer?: (answer: string) => void;
+  onScore?: (score: number) => void;
+  returnContent?: (content: AnswerQuestionData) => void;
+}
+
+export interface QuestionCompletionProps {
+  scenario?: Scenario;
+  content?: string | CompletionQuestionData | BaseQuestionJson;
+  index?: number;
+  elements?: React.ReactNode;
+  className?: string;
+  disabled?: boolean;
+  scoreDisabled?: boolean;
+  showScore?: boolean;
+  requestId?: string;
+  onAnswer?: (answer: string) => void;
+  onScore?: (score: number, isCorrect: boolean) => void;
+  returnContent?: (content: string) => void;
+}
+
+export interface QuestionCcmProps {
+  content: string | CcmQuestionData | BaseQuestionJson;
+  index?: number;
+  elements?: React.ReactNode[];
+  className?: string;
+  disabled?: boolean;
+  scoreDisabled?: boolean;
+  showScore?: boolean;
+  elementCheckbox?: React.ReactNode;
+  elementLabel?: React.ReactNode;
+  onAnswer?: (answer: string) => void;
+  onScore?: (score: number) => void;
+  onGoAnswer?: (content: CcmQuestionData) => void;
+  returnContent?: (content: CcmQuestionData) => void;
+}
+
+export interface CodeBlockProps {
+  content: string;
+  enviroment?: string[];
+  env?: string;
+  elements?: React.ReactNode[];
+  assistantElements?: React.ReactNode[];
+  assistantShow?: boolean;
+  token?: string;
+  onCodeChange?: (code: string) => void;
+  onLanguageChange?: (lang: string) => void;
+  onEnvChange?: (env: string) => void;
+  returnContent?: (content: CodeBlockData) => void;
+  onExecuteCode?: (content: CodeBlockData) => void;
+  executeResult?: { success?: boolean; output?: string; error?: string } | null;
+  returnAssistantShow?: (show: boolean) => void;
+}
+
+// ==================== Hooks 返回类型 ====================
+
+export interface UseRadioQuestionReturn {
+  data: RadioQuestionData | undefined;
+  parse: (raw: string | BaseQuestionJson | undefined | null) => void;
+  toString: () => string;
+  ask: () => void;
+  updateScore: (score: number | '') => void;
+  value: string;
+  onChange: (e: any) => void;
+  submitted: boolean;
+  analysisSentence: string;
+  tipType: 'correct' | 'incorrect' | 'warning' | 'reanswerIncorrect' | '';
+  isSubmitting: boolean;
+  submitForAutoScore: () => Promise<void>;
+  isExpanded: boolean;
+  setIsExpanded: (expanded: boolean) => void;
+  onChangeSubmit: () => void;
+}
+
+export interface UseMultipleQuestionReturn {
+  data: MultipleQuestionData | undefined;
+  parse: (raw: string | BaseQuestionJson | undefined | null) => void;
+  toString: () => string;
+  ask: () => void;
+  updateScore: (score: number | '') => void;
+  selectedValues: string[];
+  handleMultipleChange: (values: string[]) => void;
+  submitForAutoScore: () => Promise<void>;
+  isSubmitting: boolean;
+  scenario: Scenario;
+  submitted: boolean;
+  isExpanded: boolean;
+  analysisSentence: string;
+  setIsExpanded: (expanded: boolean) => void;
+  tipType: 'correct' | 'incorrect' | 'warning' | 'reanswerIncorrect' | '' | null;
+  onChangeSubmit: () => void;
+}
+
+export interface UseAnswerQuestionReturn {
+  data: AnswerQuestionData | undefined;
+  parse: (raw: string | BaseQuestionJson | undefined | null) => void;
+  toString: () => string;
+  ask: () => void;
+  updateScore: (score: number | '') => void;
+  userAnswer: string;
+  updateUserAnswer: (answer: string) => void;
+  submitted: boolean;
+  analysisSentence: string;
+  tipType: 'correct' | 'incorrect' | 'warning' | 'reanswerIncorrect' | '';
+  isSubmitting: boolean;
+  submitForAutoScore: () => Promise<void>;
+  isExpanded: boolean;
+  setIsExpanded: (expanded: boolean) => void;
+  onChangeSubmit: () => void;
+}
+
+export interface UseCompletionQuestionReturn {
+  data: CompletionQuestionData | undefined;
+  parse: (raw: string | BaseQuestionJson | undefined | null) => void;
+  toString: () => string;
+  updateScore: (score: number | '') => void;
+  updateAnswer: (blankId: string, answer: string) => void;
+  submitForAutoScore: () => Promise<void>;
+  isSubmitting: boolean;
+  submitted: boolean;
+  isExpanded: boolean;
+  analysisSentence: string;
+  setIsExpanded: (expanded: boolean) => void;
+  tipType: 'correct' | 'incorrect' | 'warning' | 'reanswerIncorrect' | '' | null;
+  onChangeSubmit: () => void;
+  elementLabel: React.ReactNode | null;
+}
+
+export interface UseCcmQuestionReturn {
+  data: CcmQuestionData | undefined;
+  parse: (raw: string | BaseQuestionJson | undefined | null) => void;
+  toString: () => string;
+  ask: () => void;
+  updateScore: (score: number | '') => void;
+}
+
+export interface UseCodeBlockReturn {
+  data: CodeBlockData | undefined;
+  parse: (content: string) => void;
+  toString: () => string;
+  height: number;
+  isExecuting: boolean;
+  executeResult: { success?: boolean; output?: string; error?: string } | null;
+  updateCode: (newCode: string) => void;
+  updateLanguage: (newLanguage: string) => void;
+  executeCode: () => Promise<void>;
+  clearResult: () => void;
+  resetCode: () => void;
+  setHeight: (height: number) => void;
+  wsHandler: (
+    runResult: { status?: string; success?: boolean; log?: string; error?: string },
+    finish?: boolean,
+    type?: string
+  ) => void;
+}
+
+// ==================== 组件导出 ====================
+
+export const QuestionRadio: React.FC<QuestionRadioProps>;
+export const QuestionMultiple: React.FC<QuestionMultipleProps>;
+export const QuestionAnswer: React.FC<QuestionAnswerProps>;
+export const QuestionCompletion: React.FC<QuestionCompletionProps>;
+export const QuestionCcm: React.FC<QuestionCcmProps>;
+export const CodeBlock: React.FC<CodeBlockProps>;
+
+// ==================== Hooks 导出 ====================
+
+export function useRadioQuestion(
+  scenario: Scenario,
+  requestId?: string,
+  onScore?: (score: number) => void
+): UseRadioQuestionReturn;
+
+export function useMultipleQuestion(props?: {
+  content?: string;
+  scenario?: Scenario;
+  requestId?: string;
+  onAutoScore?: (result: {
+    success: boolean;
+    score?: number;
+    reasons?: Array<{ item?: string; reason: string; score: number }>;
+  }) => void;
+}): UseMultipleQuestionReturn;
+
+export function useAnswerQuestion(
+  scenario: Scenario,
+  requestId?: string,
+  onScore?: (score: number) => void
+): UseAnswerQuestionReturn;
+
+export function useCompletionQuestion(props?: {
+  content?: string;
+  disabled?: boolean;
+  scoreDisabled?: boolean;
+  requestId?: string;
+  onAnswer?: (answer: string) => void;
+  onScore?: (score: number, isCorrect: boolean) => void;
+  returnContent?: (content: string) => void;
+}): UseCompletionQuestionReturn;
+
+export function useCcmQuestion(): UseCcmQuestionReturn;
+
+export function useCodeBlock(props?: {
+  content?: string;
+  disabled?: boolean;
+  onCodeChange?: (code: string) => void;
+  onLanguageChange?: (language: string) => void;
+}): UseCodeBlockReturn;
+
+// ==================== 工具函数导出 ====================
+
+// 解析函数
+export function parseRadioQuestion(content: string): RadioQuestionData;
+export function parseMultipleQuestion(content: string): MultipleQuestionData;
+export function parseAnswerQuestion(content: string): AnswerQuestionData;
+export function parseCompletionQuestion(content: string): CompletionQuestionData;
+export function parseCcmQuestion(content: string): CcmQuestionData;
+
+// 转换函数
+export function toRadioQuestion(data: RadioQuestionData): string;
+export function toMultipleQuestion(data: MultipleQuestionData): string;
+export function toAnswerQuestion(data: AnswerQuestionData): string;
+export function toCompletionQuestion(data: CompletionQuestionData): string;
+export function toCcmQuestion(data: CcmQuestionData): string;
+
+// 新格式解析函数
+export function parseQuestionsXml(content: string): BaseQuestionJson[];
+export function parseQuestionsPaper(
+  content: string
+): { title?: string; questions: BaseQuestionJson[] };
+
+// JSON 格式转换函数
+export function fromJsonRadioQuestion(json: BaseQuestionJson): RadioQuestionData;
+export function fromJsonMultipleQuestion(json: BaseQuestionJson): MultipleQuestionData;
+export function fromJsonCompletionQuestion(json: BaseQuestionJson): CompletionQuestionData;
+export function fromJsonAnswerQuestion(json: BaseQuestionJson): AnswerQuestionData;
+export function fromJsonCcmQuestion(json: BaseQuestionJson): CcmQuestionData;
+
+// CodeBlock 工具函数
+export function copy(text: string): void;
+
+// ==================== API 函数 ====================
+
+export function sendAutoScoreRequest(params: AutoScoreParams): Promise<AutoScoreResponse>;
+
+// ==================== 常量导出 ====================
+
+export const QuestionTypeList: string[];
+export const QuestionType: {
+  RADIO: 'radio';
+  CHECKBOX: 'checkbox';
+  ANSWER: 'answer';
+  COMPLETION: 'completion';
+  CCM: 'ccm';
+};
+

package/lib/{javascript-D8QY_sz4.js → javascript-C5mlSFsr.js}

@@ -1,4 +1,4 @@
-import { conf as t, language as e } from "./typescript-Ybmmps0S.js";
+import { conf as t, language as e } from "./typescript-Dvrjb3qe.js";
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)

package/lib/{jsonMode-XxxgGGwp.js → jsonMode-D7DH0vNl.js}

@@ -1,4 +1,4 @@
-import { m as Et } from "./index-gOJ0Yx75.js";
+import { m as Et } from "./index-DLAagtyg.js";
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)

package/lib/{liquid-DG_WYkjC.js → liquid-DenQLnAb.js}

@@ -1,4 +1,4 @@
-import { m as l } from "./index-gOJ0Yx75.js";
+import { m as l } from "./index-DLAagtyg.js";
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)

package/lib/{mdx-D9k95IOI.js → mdx-DYAFrYiv.js}

@@ -1,4 +1,4 @@
-import { m as s } from "./index-gOJ0Yx75.js";
+import { m as s } from "./index-DLAagtyg.js";
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)

package/lib/{python-B1rPfCqG.js → python-CqWcttXd.js}

@@ -1,4 +1,4 @@
-import { m as o } from "./index-gOJ0Yx75.js";
+import { m as o } from "./index-DLAagtyg.js";
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)

package/lib/{razor-DVCVdAnj.js → razor-idApS-hc.js}

@@ -1,4 +1,4 @@
-import { m } from "./index-gOJ0Yx75.js";
+import { m } from "./index-DLAagtyg.js";
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)

package/lib/{tsMode-KmVR26wG.js → tsMode-DFex8Ts-.js}

@@ -1,4 +1,4 @@
-import { t as O, m as I } from "./index-gOJ0Yx75.js";
+import { t as O, m as I } from "./index-DLAagtyg.js";
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)

package/lib/{typescript-Ybmmps0S.js → typescript-Dvrjb3qe.js}

@@ -1,4 +1,4 @@
-import { m as s } from "./index-gOJ0Yx75.js";
+import { m as s } from "./index-DLAagtyg.js";
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)

package/lib/{xml-BXm0WHII.js → xml-C2vchR4Q.js}

@@ -1,4 +1,4 @@
-import { m as r } from "./index-gOJ0Yx75.js";
+import { m as r } from "./index-DLAagtyg.js";
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)

package/lib/{yaml-906Iepb3.js → yaml-WcEuzyAj.js}

@@ -1,4 +1,4 @@
-import { m as l } from "./index-gOJ0Yx75.js";
+import { m as l } from "./index-DLAagtyg.js";
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudlab-ui",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "type": "module",
   "files": [
     "lib"
@@ -10,6 +10,7 @@
   "types": "./lib/index.d.ts",
   "exports": {
     ".": {
+      "types": "./lib/index.d.ts",
       "import": "./lib/cloudlab-ui.js",
       "require": "./lib/cloudlab-ui.umd.cjs"
     },
@@ -19,7 +20,7 @@
   "scripts": {
     "start": "vite --open",
     "dev": "vite",
-    "build": "tsc && vite build",
+    "build": "tsc && vite build && cp src/index.d.ts lib/index.d.ts",
     "lint": "eslint .",
     "preview": "vite preview",
     "typecheck": "tsc --noEmit"