@dao42/d42paas-front 0.9.238 → 0.9.239

package/dist/DaoPaaS.d.ts

@@ -86,7 +86,38 @@ export type ComponentType =
   | 'Browser'
   | 'Console'
   | 'Shell'
-  | 'MarkdownPreview';
+  | 'MarkdownPreview'
+  | 'ClaudeJson'
+  | 'ClaudeCode';
+
+/**
+ * ClaudeJson 组件不可用原因。
+ *
+ * 业务方判定后通过 setClaudeJsonAvailability 写入；SDK 仅按此渲染禁用 banner / 占位 / 隐藏输入栏。
+ */
+export type ClaudeJsonAvailabilityReason =
+  | 'not_enabled'
+  | 'team_disabled'
+  | 'quota_exhausted'
+  | 'connection_error'
+  | 'unsupported_environment'
+  | 'preview_not_supported';
+
+/**
+ * ClaudeJson 组件可用性状态。`disabled=false` 时其它字段被忽略。
+ */
+export interface ClaudeJsonAvailability {
+  disabled: boolean;
+  reason?: ClaudeJsonAvailabilityReason;
+  /** 显示在 sticky banner / 禁用 tooltip 上的文案；业务方负责 i18n */
+  message?: string;
+  /** 角色，仅作样式 hook，不影响文案 */
+  role?: 'interviewer' | 'candidate';
+  /** 是否隐藏底部输入栏，默认与 disabled 同步 */
+  hideInput?: boolean;
+  /** 是否隐藏底部状态栏，默认与 disabled 同步 */
+  hideStatusBar?: boolean;
+}
 
 /**
  * Playground状态类型
@@ -458,6 +489,26 @@ export interface IDaoPaaS {
    * @returns {boolean} 之前是否真的挂载过该组件
    */
   unmapRender(componentName: string): boolean;
+  /**
+   * 设置 ClaudeJson 组件可用性。
+   *
+   * 业务方根据自身状态（团队开关、本场开关、配额、长连接等）判定后调用，SDK 内部 ClaudeJson 组件
+   * 据此渲染禁用 banner / ready 占位 / 隐藏输入栏。partial merge：未传字段保持原值。
+   *
+   * 注：`reason='connection_error'` SDK 已自动接管（来自 isReadyOffline()），
+   * 业务方传 connection_error 一般是冗余的；如果业务方有更准确的连接判定也可手动传，
+   * 与 SDK 自动判定取 OR。
+   *
+   * @param {Partial<ClaudeJsonAvailability>} next 待合并的字段
+   */
+  setClaudeJsonAvailability(next: Partial<ClaudeJsonAvailability>): void;
+  /**
+   * 读取 ClaudeJson 组件当前可用性。
+   *
+   * 注意返回的是业务方写入的值；SDK 内部对 connection_error 的自动覆盖只在渲染层生效，
+   * 不会通过这个方法暴露。
+   */
+  getClaudeJsonAvailability(): ClaudeJsonAvailability;
   /**
    * 设置本地logger打印是否开启的方法
    * @param {any} data 设置的值，当这个值存在就会打印logger