@compass-framework/core 1.2.59 → 1.2.61

package/@types/canvas/Paint.d.ts

@@ -0,0 +1,475 @@
+import { CharSequence, InterfaceTemplate } from "@compass-framework/library";
+import { Shader } from "./Shader";
+import { Shadow } from "./Shadow";
+import { Rect } from "./Rect";
+import { Typeface } from "./Typeface";
+import { PathEffect } from "./PathEffect";
+import { Context } from "../content/Context";
+import { ColorFilter } from "./ColorFilter";
+import { BlendMode } from "./BlendMode";
+import { ImageFilter } from "./ImageFilter";
+
+/**
+ * 画笔，描述颜色、样式、字体等绘制属性。
+ */
+export interface Paint {
+  /**
+   * 测量整段文本的绘制宽度。
+   */
+  measureText(text: CharSequence): number;
+
+  /**
+   * 测量指定区间文本的绘制宽度。
+   */
+  measureText(text: CharSequence, start: number, end: number): number;
+
+  /**
+   * 从另一支画笔复制全部属性，并返回自身。
+   */
+  set(paint: Paint): Paint
+
+  /**
+   * 按像素对齐调整描边位置，使线条绘制更锐利。
+   */
+  adjustForPixelPerfectLine(pixel: number): void;
+
+  /**
+   * 返回是否启用抗锯齿。
+   */
+  isAntiAlias(): boolean;
+
+  /**
+   * 返回文本是否应用了水平倾斜。
+   */
+  isTextSkewX(): boolean;
+
+  /**
+   * 返回像素对齐描边的调整值。
+   */
+  getPixelPerfectLine(): number
+
+  /**
+   * 返回字体度量信息。
+   */
+  getFontMetrics(): Paint.FontMetrics
+
+  /**
+   * 将字体度量写入指定对象，并返回行距。
+   */
+  getFontMetrics(fontMetrics: Paint.FontMetrics): number
+
+  /**
+   * 获取整段文本中每个字符的宽度，返回测量的字符数。
+   */
+  getTextWidths(text: CharSequence, widths: number[]): number
+
+  /**
+   * 获取指定区间文本中每个字符的宽度，返回测量的字符数。
+   */
+  getTextWidths(text: CharSequence, start: number, end: number, widths: number[]): number
+
+  /**
+   * 从字符串数组指定位置起测量字符宽度，返回测量的字符数。
+   */
+  getTextWidths(text: string[], index:number, count:number, widths: number[]): number
+
+  /**
+   * 将整段文本的包围盒写入指定矩形。
+   */
+  getTextBounds(text: CharSequence, bounds: Rect): void
+
+  /**
+   * 将指定区间文本的包围盒写入指定矩形。
+   */
+  getTextBounds(text: CharSequence, start: number, end: number, bounds: Rect): void
+
+  /**
+   * 在最大宽度内截断文本，返回实际测量的字符数。
+   */
+  breakText(text: CharSequence, measureForwards: boolean, maxWidth: number, measuredWidth: number[]): number
+
+  /**
+   * 在最大宽度内截断指定区间文本，返回实际测量的字符数。
+   */
+  breakText(text: CharSequence, start: number, end: number, measureForwards: boolean, maxWidth: number, measuredWidth: number[]): number
+
+  /**
+   * 返回填充/描边绘制样式。
+   */
+  getStyle(): Paint.Style;
+
+  /**
+   * 复制当前画笔并返回新实例。
+   */
+  copy(): Paint;
+
+  /**
+   * 返回图像滤镜。
+   */
+  getImageFilter(): ImageFilter;
+
+  /**
+   * 返回画笔标志位。
+   */
+  getFlags(): number
+
+  /**
+   * 返回透明度，取值范围为 0–255。
+   */
+  getAlpha(): number
+
+  /**
+   * 返回当前颜色（ARGB 数值）。
+   */
+  getColor(): number
+
+  /**
+   * 返回当前颜色的字符串表示。
+   */
+  getColorString(): string
+
+  /**
+   * 返回描边转角连接样式。
+   */
+  getStrokeJoin(): Paint.Join
+
+  /**
+   * 返回描边端点样式。
+   */
+  getStrokeCap(): Paint.Cap
+
+  /**
+   * 返回阴影效果。
+   */
+  getShadow(): Shadow
+
+  /**
+   * 返回文本字号。
+   */
+  getTextSize(): number
+
+  /**
+   * 返回颜色滤镜。
+   */
+  getColorFilter(): ColorFilter;
+
+  /**
+   * 返回文本水平对齐方式。
+   */
+  getTextAlign(): Paint.Align
+
+  /**
+   * 返回着色器。
+   */
+  getShader(): Shader;
+
+  /**
+   * 返回描边宽度。
+   */
+  getStrokeWidth(): number
+
+  /**
+   * 返回文本水平倾斜值。
+   */
+  getTextSkewX(): number;
+
+  /**
+   * 返回是否启用伪粗体。
+   */
+  getFakeBoldText(): boolean;
+
+  /**
+   * 返回混合模式。
+   */
+  getBlendMode(): BlendMode;
+
+  /**
+   * 返回当前字体。
+   */
+  getTypeface(): Typeface;
+
+  /**
+   * 返回路径效果。
+   */
+  getPathEffect(): PathEffect
+
+  /**
+   * 返回文本水平缩放比例。
+   */
+  getTextScaleX(): number;
+
+  /**
+   * 设置描边宽度。
+   */
+  setStrokeWidth(width: number): void
+
+  /**
+   * 设置路径效果。
+   */
+  setPathEffect(pathEffect: PathEffect): void
+
+  /**
+   * 设置是否启用抗锯齿。
+   */
+  setAntiAlias(aa: boolean): void;
+
+  /**
+   * 设置颜色（ARGB 数值）。
+   */
+  setColor(color: number): void
+
+  /**
+   * 设置描边转角连接样式。
+   */
+  setStrokeJoin(join: Paint.Join): void
+
+  /**
+   * 设置文本字号。
+   */
+  setTextSize(textSize: number): void
+
+  /**
+   * 设置描边端点样式。
+   */
+  setStrokeCap(cap: Paint.Cap): void
+
+  /**
+   * 返回推荐行距。
+   */
+  getFontSpacing(): number;
+
+  /**
+   * 设置文本水平对齐方式。
+   */
+  setTextAlign(textAlign: Paint.Align): void
+
+  /**
+   * 设置画笔标志位。
+   */
+  setFlags(flags: number): void
+
+  /**
+   * 设置图像滤镜。
+   */
+  setImageFilter(imageFilter: ImageFilter): void;
+
+  /**
+   * 设置填充/描边绘制样式。
+   */
+  setStyle(style: Paint.Style): void
+
+  /**
+   * 设置透明度，取值范围为 0–255。
+   */
+  setAlpha(a: number): void
+
+  /**
+   * 设置阴影效果。
+   */
+  setShadow(shadow: Shadow): void
+
+  /**
+   * 设置着色器。
+   */
+  setShader(shader: Shader): void
+
+  /**
+   * 设置颜色滤镜。
+   */
+  setColorFilter(filter: ColorFilter): void;
+
+  /**
+   * 按 Alpha、红、绿、蓝分量设置颜色。
+   */
+  setARGB(a: number, r: number, g: number, b: number): void
+
+  /**
+   * 设置字体。
+   */
+  setTypeface(typeface: Typeface): void;
+
+  /**
+   * 设置文本水平缩放比例。
+   */
+  setTextScaleX(scaleX: number): void;
+
+  /**
+   * 设置文本水平倾斜值。
+   */
+  setTextSkewX(value: number): void;
+
+  /**
+   * 设置是否启用伪粗体。
+   */
+  setFakeBoldText(value: boolean): void;
+
+  /**
+   * 设置混合模式。
+   */
+  setBlendMode(mode: BlendMode): void;
+
+  /**
+   * 设置是否绘制删除线。
+   */
+  setStrikeThruText(value: boolean): void;
+
+  /**
+   * 释放画笔占用的资源。
+   */
+  dispose(): void;
+
+  /**
+   * 返回画笔属性的字符串描述。
+   */
+  toString(): CharSequence;
+}
+
+/**
+ * Paint 接口的实现基类。
+ */
+export abstract class Paint extends InterfaceTemplate {}
+
+/**
+ * Paint 相关类型与工厂方法。
+ */
+export namespace Paint {
+  /**
+   * 下划线文本标志位。
+   */
+  export const UNDERLINE_TEXT_FLAG: number;
+
+  /**
+   * 删除线文本标志位。
+   */
+  export const STRIKE_THRU_TEXT_FLAG: number;
+
+  /**
+   * 字体度量信息。
+   */
+  export class FontMetrics {
+    /**
+     * 基线以上的推荐上升距离（通常为负）。
+     */
+    public ascent: number;
+
+    /**
+     * 基线以下的推荐下降距离（通常为正）。
+     */
+    public descent: number;
+
+    /**
+     * 基线以上的最大上升距离（通常为负）。
+     */
+    public top: number;
+
+    /**
+     * 基线以下的最大下降距离（通常为正）。
+     */
+    public bottom: number;
+
+    /**
+     * 额外行距。
+     */
+    public leading: number;
+
+    /**
+     * 字形相对绘制原点的最左边界。
+     */
+    public left: number;
+
+    /**
+     * 字形相对绘制原点的最右边界。
+     */
+    public right: number;
+
+    /**
+     * 从另一组度量复制全部字段，并返回自身。
+     */
+    public set(metrics: FontMetrics): FontMetrics;
+  }
+
+  /**
+   * 描边转角连接样式。
+   */
+  export enum Join {
+    /**
+     * 斜角连接。
+     */
+    BEVEL = "bevel",
+
+    /**
+     * 尖角连接。
+     */
+    MITER = "miter",
+
+    /**
+     * 圆角连接。
+     */
+    ROUND = "round",
+  }
+
+  /**
+   * 描边端点样式。
+   */
+  export enum Cap {
+    /**
+     * 平端，精确停在路径端点。
+     */
+    BUTT = "butt",
+
+    /**
+     * 圆端，以端点为圆心向外延伸半个线宽。
+     */
+    ROUND = "round",
+
+    /**
+     * 方端，向外延伸半个线宽的矩形。
+     */
+    SQUARE = "square",
+  }
+
+  /**
+   * 填充与描边绘制样式。
+   */
+  export enum Style {
+    /**
+     * 仅填充内部。
+     */
+    FILL,
+
+    /**
+     * 仅描边轮廓。
+     */
+    STROKE,
+
+    /**
+     * 同时填充内部并描边轮廓。
+     */
+    FILL_AND_STROKE,
+  }
+
+  /**
+   * 文本水平对齐方式。
+   */
+  export enum Align {
+    /**
+     * 左对齐。
+     */
+    LEFT = 'left',
+
+    /**
+     * 居中对齐。
+     */
+    CENTER = 'center',
+
+    /**
+     * 右对齐。
+     */
+    RIGHT = 'right',
+  }
+
+  /**
+   * 创建 Paint 实例。
+   */
+  export function create(context: Context): Paint;
+}

package/@types/{Path.d.ts → canvas/Path.d.ts}

@@ -2,7 +2,7 @@ import { InterfaceTemplate } from "@compass-framework/library";
 import { Rect } from "./Rect";
 import { Matrix } from "./Matrix";
 import { PathEffect } from "./PathEffect";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 矢量路径，用于描述可绘制的几何轮廓。

package/@types/{Picture.d.ts → canvas/Picture.d.ts}

@@ -1,6 +1,6 @@
 import { Consumer } from "@compass-framework/library";
-import { Image } from "./Image";
-import { Context } from "./Context";
+import { Image } from "../widget/Image";
+import { Context } from "../content/Context";
 
 /**
  * 图片资源，异步加载并提供位图图像。

package/@types/{Rect.d.ts → canvas/Rect.d.ts}

@@ -1,5 +1,5 @@
 import { InterfaceTemplate } from "@compass-framework/library";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 矩形区域，表示轴对齐的边界框。

package/@types/{Shadow.d.ts → canvas/Shadow.d.ts}

@@ -1,7 +1,7 @@
 import {
   InterfaceTemplate,
 } from "@compass-framework/library";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 阴影效果，描述偏移、模糊半径与颜色。

package/@types/{Surface.d.ts → canvas/Surface.d.ts}

@@ -1,7 +1,7 @@
 import { InterfaceTemplate } from "@compass-framework/library";
-import { Image } from "./Image";
+import { Image } from "../widget/Image";
 import { Canvas } from "./Canvas";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 离屏绘制表面，可获取 Canvas 并生成图像快照。

package/@types/{TypefaceFactory.d.ts → canvas/TypefaceFactory.d.ts}

@@ -1,5 +1,5 @@
 import { InterfaceTemplate } from "@compass-framework/library";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 import { Typeface } from "./Typeface";
 
 /**

package/@types/{ArrayAdapter.d.ts → content/ArrayAdapter.d.ts}

@@ -1,8 +1,8 @@
 import { ArrayList, List, Comparator } from "@compass-framework/library";
-import { View } from "./View";
+import { View } from "../view/View";
 import { BaseAdapter } from "./BaseAdapter";
 import { Context } from "./Context";
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
 
 /**
  * 基于数组/列表数据的通用适配器，支持增删排序与变更通知。

package/@types/{AttributeSet.d.ts → content/AttributeSet.d.ts}

@@ -1,8 +1,8 @@
 import { CharSequence, Influence, Nullable } from "@compass-framework/library";
 import { Resources } from "./Resources";
-import { PictureDrawable } from "./PictureDrawable";
-import { Drawable } from "./Drawable";
-import { ColorDrawable } from "./ColorDrawable";
+import { PictureDrawable } from "../drawable/PictureDrawable";
+import { Drawable } from "../drawable/Drawable";
+import { ColorDrawable } from "../drawable/ColorDrawable";
 
 /**
  * 属性集合，从资源或布局中按名称读取类型化属性值。

package/@types/{BaseAdapter.d.ts → content/BaseAdapter.d.ts}

@@ -1,7 +1,7 @@
 import { Implements } from "@compass-framework/library";
-import { ListAdapter } from "./ListAdapter";
-import { View } from "./View";
-import { ViewGroup } from "./ViewGroup";
+import { ListAdapter } from "../widget/ListAdapter";
+import { View } from "../view/View";
+import { ViewGroup } from "../view/ViewGroup";
 
 /**
  * 列表适配器基类，提供 ListAdapter 的默认实现骨架。

package/@types/content/Context.d.ts

@@ -0,0 +1,28 @@
+import { Environment } from "../evaluate/Environment";
+import { Resources } from "./Resources";
+import { MouseCursor } from "../display/MouseCursor";
+import { RendererBackend } from "../canvas/RendererBackend";
+import { WindowManager } from "../window/WindowManager";
+import { SurfaceProvider } from "../display/SurfaceProvider";
+import { ViewFactoryRegistry } from "./ViewFactoryRegistry";
+
+/**
+ * 全局运行时上下文，提供资源、环境与窗口管理等服务。
+ */
+export declare interface Context {
+  startActivity(intent: Intent): void;
+
+  getSurfaceProvider(): SurfaceProvider
+
+  getEnvironment(): Environment;
+
+  getMouseCursor(): MouseCursor;
+
+  getWindowManager(): WindowManager
+
+  getResources(): Resources
+
+  getRendererBackend(): RendererBackend
+
+  getViewFactoryRegistry() :ViewFactoryRegistry
+}

package/@types/content/ContextWrapper.d.ts

@@ -0,0 +1,29 @@
+import { Context } from "./Context";
+import { Environment } from "../evaluate/Environment";
+import { MouseCursor } from "../display/MouseCursor";
+import { RendererBackend } from "../canvas/RendererBackend";
+import { Resources } from "./Resources";
+import { SurfaceProvider } from "../display/SurfaceProvider";
+import { ViewFactoryRegistry } from "./ViewFactoryRegistry";
+import { WindowManager } from "../window/WindowManager";
+import { Intent } from "../activity/Intent";
+
+export declare class ContextWrapper implements Context {
+  attachBaseContext(context: Context): void;
+
+  startActivity(intent: Intent): void;
+
+  getEnvironment(): Environment;
+
+  getMouseCursor(): MouseCursor;
+
+  getRendererBackend(): RendererBackend;
+
+  getResources(): Resources;
+
+  getWindowManager(): WindowManager;
+
+  getSurfaceProvider(): SurfaceProvider;
+
+  getViewFactoryRegistry(): ViewFactoryRegistry;
+}

package/@types/{LayoutInflater.ts → content/LayoutInflater.ts}

@@ -1,7 +1,7 @@
 import { XML } from "@compass-framework/library";
 import { Context } from "./Context";
-import { View } from "./View";
-import { ViewGroup } from "./ViewGroup";
+import { View } from "../view/View";
+import { ViewGroup } from "../view/ViewGroup";
 
 /**
  * 布局填充器，将 XML 布局膨胀为视图树。

package/@types/{Resources.d.ts → content/Resources.d.ts}

@@ -1,10 +1,9 @@
 import { CharSequence, RefValue, XML } from "@compass-framework/library";
-import { Drawable } from "./Drawable";
+import { Drawable } from "../drawable/Drawable";
 import { DisplayMetrics } from "./DisplayMetrics";
-import { Assets } from "./Assets";
-import { ColorDrawable } from "./ColorDrawable";
-import { Configuration } from "./Configuration";
+import { ColorDrawable } from "../drawable/ColorDrawable";
 import { AttributeSet } from "./AttributeSet";
+import { Configuration } from "./Configuration";
 
 /**
  * 资源管理器，提供布局、drawable、字符串等资源读写。
@@ -12,8 +11,6 @@ import { AttributeSet } from "./AttributeSet";
 export declare class Resources {
   public getDisplayMetrics(): DisplayMetrics;
 
-  public getAssets(): Assets;
-
   public getConfiguration(): Configuration;
 
   /// ///////////////////////////////////////////////////////////////////////////////////////////////////////