@compass-framework/core 1.2.57 → 1.2.59

package/@types/Application.d.ts

@@ -1,6 +1,7 @@
 import { Consumer } from "@compass-framework/library";
 import { Context } from "./Context";
 import { RendererBackend } from "./RendererBackend";
+import { Window } from "./Window";
 import { InputMethodService } from "./InputMethodService";
 
 /**

package/@types/Drawable.d.ts

@@ -11,42 +11,107 @@ import { DisplayMetrics } from "./DisplayMetrics";
  * 可绘制对象的基类，封装边界、透明度与绘制回调。
  */
 export declare abstract class Drawable {
+  /**
+   * 使用运行时上下文构造 Drawable。
+   */
   protected constructor(context: Context);
 
+  /**
+   * 将当前内容绘制到指定画布。
+   */
   public abstract draw(canvas: Canvas): void;
 
+  /**
+   * 设置整体透明度，取值范围为 0–255。
+   */
   public abstract setAlpha(alpha: number): void;
 
+  /**
+   * 返回当前不透明度。
+   */
   public abstract getOpacity(): number;
 
+  /**
+   * 设备或主题等配置变化时回调。
+   */
   public onConfigurationChanged(newConfig: Configuration): void;
 
+  /**
+   * 边界矩形变化时回调。
+   */
   public onBoundsChange(bounds: Rect): void;
 
+  /**
+   * 屏幕密度变化时回调。
+   */
   public onDensityChanged(newConfig: Configuration): void;
 
+  /**
+   * 复制并返回当前边界矩形。
+   */
   public copyBounds() : Rect;
+  /**
+   * 将当前边界复制到指定矩形。
+   */
   public copyBounds(bounds: Rect): void;
 
+  /**
+   * 返回建议的最小宽度。
+   */
   public getMinimumWidth(): number;
 
+  /**
+   * 返回建议的最小高度。
+   */
   public getMinimumHeight(): number;
 
+  /**
+   * 返回当前绘制边界矩形。
+   */
   public getBounds(): Rect;
 
+  /**
+   * 返回关联的运行时上下文。
+   */
+  public getContext(): Context;
+
+  /**
+   * 将外形轮廓写入指定 Outline。
+   */
   public getOutline(outline:Outline):void;
 
+  /**
+   * 返回当前失效与调度回调。
+   */
   public getCallback() :Drawable.Callback;
 
+  /**
+   * 返回固有宽度；未知时为 -1。
+   */
   public getIntrinsicWidth(): number;
 
+  /**
+   * 返回固有高度；未知时为 -1。
+   */
   public getIntrinsicHeight():number;
 
+  /**
+   * 返回当前显示度量。
+   */
   public getDisplayMetrics(): DisplayMetrics;
 
+  /**
+   * 使用矩形设置绘制边界。
+   */
   public setBounds(bounds: Rect): void;
+  /**
+   * 使用左、上、右、下坐标设置绘制边界。
+   */
   public setBounds(left: number, top: number, right: number, bottom: number): void;
 
+  /**
+   * 设置失效与调度回调。
+   */
   public setCallback(callback: Drawable.Callback): void;
 }
 
@@ -58,10 +123,19 @@ export declare namespace Drawable {
    * Drawable 的不可变常量状态，用于创建新实例。
    */
   export abstract class ConstantState {
+    /**
+     * 基于常量状态创建新的 Drawable。
+     */
     public abstract newDrawable(): Drawable;
 
+    /**
+     * 使用指定资源创建新的 Drawable。
+     */
     public newResourcesDrawable(res: Resources): Drawable;
 
+    /**
+     * 返回会影响该状态的配置变更掩码。
+     */
     public abstract getChangingConfigurations(): number;
   }
 
@@ -69,12 +143,24 @@ export declare namespace Drawable {
    * Drawable 失效与调度回调接口。
    */
   export interface Callback {
+    /**
+     * 通知宿主指定 Drawable 需要重绘。
+     */
     invalidateDrawable(who:Drawable): void
 
+    /**
+     * 在指定时间调度 Drawable 的回调。
+     */
     scheduleDrawable(who: Drawable, what: Runnable, when: number): void
 
+    /**
+     * 取消已调度的 Drawable 回调。
+     */
     unScheduleDrawable(who: Drawable, what: Runnable): void
 
+    /**
+     * 返回宿主关联的资源管理器。
+     */
     getResources(): Resources;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@compass-framework/core",
-	"version": "1.2.57",
+	"version": "1.2.59",
 	"description": "@compass-framework/core public api",
 	"types": "./index.d.ts",
 	"main": "./index.js",