@compass-framework/core 1.2.60 → 1.2.62

package/@types/activity/Activity.d.ts

@@ -0,0 +1,24 @@
+import { ContextWrapper } from "../content/ContextWrapper";
+import { View } from "../view/View";
+import { DecorView } from "../widget/DecorView";
+import { ApplicationWindow } from "../window/ApplicationWindow";
+
+export declare class Activity extends ContextWrapper {
+  public onCreate(): void;
+
+  public onStart(): void;
+
+  public onResume(): void;
+
+  public onPause(): void;
+
+  public onStop(): void;
+
+  public onDestroy(): void;
+
+  public setContentView(viewOrXml: View | string): void;
+
+  public getDecorView(): DecorView;
+
+  public getWindow(): ApplicationWindow;
+}

package/@types/activity/ActivityType.ts

@@ -0,0 +1,3 @@
+import { Activity } from "./Activity";
+
+export type ActivityType = new () => Activity;

package/@types/activity/ExtraValue.d.ts

@@ -0,0 +1 @@
+export type ExtraValue = string | number | boolean;

package/@types/activity/Intent.ts

@@ -0,0 +1,14 @@
+import { ExtraValue } from "./ExtraValue";
+import { ActivityType } from "./ActivityType";
+
+export declare class Intent {
+  public constructor(component?: ActivityType);
+
+  public getStringExtra(key: string, fallback?: string): string;
+
+  public putExtra(key: string, value: ExtraValue): this;
+
+  public getIntExtra(key: string, fallback?: string): number;
+
+  public getBooleanExtra(key: string, fallback?: string): boolean;
+}

package/@types/{AlphaAnimation.d.ts → animation/AlphaAnimation.d.ts}

@@ -1,6 +1,6 @@
 import { Transformation } from "./Transformation";
 import { Animation } from "./Animation";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 透明度动画。

package/@types/{Animation.d.ts → animation/Animation.d.ts}

@@ -1,9 +1,9 @@
 import { InterfaceTemplate } from "@compass-framework/library";
-import { Rect } from './Rect';
+import { Rect } from '../canvas/Rect';
 import { Transformation } from './Transformation';
 import { Interpolator } from './Interpolator';
-import { AttributeSet } from "./AttributeSet";
-import { Context } from "./Context";
+import { AttributeSet } from "../content/AttributeSet";
+import { Context } from "../content/Context";
 
 /**
  * 视图动画的基类。

package/@types/{AnimationSet.d.ts → animation/AnimationSet.d.ts}

@@ -1,7 +1,7 @@
 import { List } from "@compass-framework/library";
 import { Animation } from "./Animation";
 import { Transformation } from "./Transformation";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 动画集合，可组合多个动画同时播放。

package/@types/{Interpolator.d.ts → animation/Interpolator.d.ts}

@@ -2,7 +2,7 @@ import { Implements, InterfaceTemplate } from "@compass-framework/library";
 
 import {
   TimeInterpolator,
-} from "./TimeInterpolator";
+} from "../animator/TimeInterpolator";
 
 /**
  * 插值器接口。

package/@types/{LayoutAnimationController.d.ts → animation/LayoutAnimationController.d.ts}

@@ -1,6 +1,6 @@
-import { AttributeSet } from "./AttributeSet";
-import { Context } from "./Context";
-import { View } from "./View";
+import { AttributeSet } from "../content/AttributeSet";
+import { Context } from "../content/Context";
+import { View } from "../view/View";
 import { Interpolator } from "./Interpolator";
 
 /**

package/@types/{RotateAnimation.d.ts → animation/RotateAnimation.d.ts}

@@ -1,6 +1,6 @@
 import { Animation } from "./Animation";
 import { Transformation } from "./Transformation";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 旋转动画。

package/@types/{ScaleAnimation.d.ts → animation/ScaleAnimation.d.ts}

@@ -1,6 +1,6 @@
 import { Animation } from "./Animation";
 import { Transformation } from "./Transformation";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 缩放动画。

package/@types/{Transformation.d.ts → animation/Transformation.d.ts}

@@ -1,5 +1,5 @@
-import { Matrix } from './Matrix';
-import { Context } from "./Context";
+import { Matrix } from '../canvas/Matrix';
+import { Context } from "../content/Context";
 
 /**
  * 变换信息，组合透明度与矩阵用于动画插值结果。

package/@types/{TranslateAnimation.d.ts → animation/TranslateAnimation.d.ts}

@@ -1,6 +1,6 @@
 import { Animation } from "./Animation";
 import { Transformation } from "./Transformation";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 平移动画。

package/@types/{Animator.d.ts → animator/Animator.d.ts}

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

package/@types/{ValueAnimator.d.ts → animator/ValueAnimator.d.ts}

@@ -1,6 +1,6 @@
 import { InterfaceTemplate } from "@compass-framework/library";
 import { Animator } from "./Animator";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 import { PropertyValuesHolder } from "./PropertyValuesHolder";
 import { TimeInterpolator } from "./TimeInterpolator";
 import { TypeEvaluator } from "./TypeEvaluator";

package/@types/app/Application.d.ts

@@ -0,0 +1,11 @@
+import { ContextWrapper } from "../content/ContextWrapper";
+import { InputMethod } from "../imm/InputMethod";
+
+/**
+ * 应用程序入口与生命周期管理。
+ */
+export class Application extends ContextWrapper {
+  public constructor();
+
+  public setInputMethod(inputMethod: InputMethod): void;
+}

package/@types/app/ApplicationConfig.d.ts

@@ -0,0 +1,5 @@
+import { ActivityType } from "../activity/ActivityType";
+
+export interface ApplicationConfig {
+  launcher: ActivityType;
+}

package/@types/app/ApplicationCreator.d.ts

@@ -0,0 +1,9 @@
+import { ApplicationCreatorConfig } from "./ApplicationCreatorConfig";
+import { ApplicationConfig } from "./ApplicationConfig";
+import { Application } from "./Application";
+
+export declare class ApplicationCreator<T extends keyof ApplicationCreatorConfig> {
+  public constructor(backend: T, creatorConfig: ApplicationCreatorConfig[T]);
+
+  public create(appConfig: ApplicationConfig): Promise<Application>;
+}

package/@types/app/ApplicationCreatorConfig.d.ts

@@ -0,0 +1,10 @@
+import { RendererBackend } from "../canvas/RendererBackend";
+import { CanvaskitPlatformHostConfig } from "../host/backend/CanvaskitPlatformHostConfig";
+import { WebPlatformHostConfig } from "../host/backend/WebPlatformHostConfig";
+import { NodePlatformHostConfig } from "../host/backend/NodePlatformHostConfig";
+
+export interface ApplicationCreatorConfig {
+  [RendererBackend.CanvasKit]: CanvaskitPlatformHostConfig,
+  [RendererBackend.Web]: WebPlatformHostConfig,
+  [RendererBackend.Node]: NodePlatformHostConfig,
+}

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

@@ -3,7 +3,7 @@ import { Rect } from "./Rect";
 import { Paint } from "./Paint";
 import { Matrix } from "./Matrix";
 import { Path } from "./Path";
-import { Image } from "./Image";
+import { Image } from "../widget/Image";
 import { ImageFilter } from "./ImageFilter";
 
 /**

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

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

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

@@ -1,6 +1,6 @@
 import { InterfaceTemplate } from "@compass-framework/library";
 import { Shader } from "./Shader";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 线性渐变着色器。

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

@@ -1,6 +1,6 @@
 import { InterfaceTemplate } from "@compass-framework/library";
 import { Rect } from "./Rect";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 二维变换矩阵，用于平移、缩放、旋转等几何变换。

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

@@ -4,7 +4,7 @@ import { Shadow } from "./Shadow";
 import { Rect } from "./Rect";
 import { Typeface } from "./Typeface";
 import { PathEffect } from "./PathEffect";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 import { ColorFilter } from "./ColorFilter";
 import { BlendMode } from "./BlendMode";
 import { ImageFilter } from "./ImageFilter";

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;
 
   /// ///////////////////////////////////////////////////////////////////////////////////////////////////////

package/@types/{XMLViewFactoryRegistry.d.ts → content/ViewFactoryRegistry.d.ts}

@@ -1,33 +1,33 @@
 import { BiFunction, Class } from "@compass-framework/library";
 import { Context } from "./Context";
-import { View } from "./View";
+import { View } from "../view/View";
 import { AttributeSet } from "./AttributeSet";
 
 /**
  * XML 视图工厂注册表，按标签名创建视图实例。
  */
-export declare class XMLViewFactoryRegistry {
-  public registryViewFactory<T extends View>(name: string, factory: XMLViewFactoryRegistry.Factory<T>, overwrite?: boolean): XMLViewFactoryRegistry;
+export declare class ViewFactoryRegistry {
+  public registryViewFactory<T extends View>(name: string, factory: ViewFactoryRegistry.Factory<T>, overwrite?: boolean): ViewFactoryRegistry;
 
-  public removeViewFactory(name: string): XMLViewFactoryRegistry;
+  public removeViewFactory(name: string): ViewFactoryRegistry;
 
-  public registryViewClass<T extends View>(name: string, clazz: Class<T>, overwrite?: boolean): XMLViewFactoryRegistry;
+  public registryViewClass<T extends View>(name: string, clazz: Class<T>, overwrite?: boolean): ViewFactoryRegistry;
 
   public hasViewFactory(name: string): boolean;
 
-  public setDefaultAttribute(name: string, value: string): XMLViewFactoryRegistry;
+  public setDefaultAttribute(name: string, value: string): ViewFactoryRegistry;
 
-  public removeDefaultAttribute(name: string): XMLViewFactoryRegistry;
+  public removeDefaultAttribute(name: string): ViewFactoryRegistry;
 
-  public getViewFactory<T extends View>(name: string): XMLViewFactoryRegistry.Factory<T>;
+  public getViewFactory<T extends View>(name: string): ViewFactoryRegistry.Factory<T>;
 
-  public getDefaultAttribute(attr?: XMLViewFactoryRegistry.Attribute): XMLViewFactoryRegistry.Attribute;
+  public getDefaultAttribute(attr?: ViewFactoryRegistry.Attribute): ViewFactoryRegistry.Attribute;
 }
 
 /**
  * XMLViewFactoryRegistry 相关工厂与属性类型。
  */
-export declare namespace XMLViewFactoryRegistry {
+export declare namespace ViewFactoryRegistry {
   /**
    * 默认属性键值映射。
    */

package/@types/{MouseCursor.ts → display/MouseCursor.ts}

@@ -1,4 +1,4 @@
-import { View } from "./View";
+import { View } from "../view/View";
 
 /**
  * 鼠标光标控制，支持锁定、悬停与重置。

package/@types/{SurfaceProvider.d.ts → display/SurfaceProvider.d.ts}

@@ -1,6 +1,6 @@
 import { InterfaceTemplate } from "@compass-framework/library";
-import { Context } from "./Context";
-import { Surface } from "./Surface";
+import { Context } from "../content/Context";
+import { Surface } from "../canvas/Surface";
 
 /**
  * Surface 提供者，按设备尺寸创建绘制表面。

package/@types/{ColorDrawable.d.ts → drawable/ColorDrawable.d.ts}

@@ -1,6 +1,6 @@
 import { Drawable } from "./Drawable";
-import { Canvas } from "./Canvas";
-import { Context } from "./Context";
+import { Canvas } from "../canvas/Canvas";
+import { Context } from "../content/Context";
 
 /**
  * 纯色 Drawable，用单一颜色填充自身边界。

package/@types/{CornersDrawable.d.ts → drawable/CornersDrawable.d.ts}

@@ -1,6 +1,6 @@
 import { Drawable } from "./Drawable";
-import { Canvas } from "./Canvas";
-import { Context } from "./Context";
+import { Canvas } from "../canvas/Canvas";
+import { Context } from "../content/Context";
 
 /**
  * 圆角矩形 Drawable，支持填充色与描边。

package/@types/{Drawable.d.ts → drawable/Drawable.d.ts}

@@ -1,11 +1,11 @@
 import { InterfaceTemplate, Runnable } from "@compass-framework/library";
-import { Resources } from "./Resources";
-import { Canvas } from "./Canvas";
-import { Outline } from "./Outline";
-import { Rect } from "./Rect";
-import { Configuration } from "./Configuration";
-import { Context } from "./Context";
-import { DisplayMetrics } from "./DisplayMetrics";
+import { Resources } from "../content/Resources";
+import { Canvas } from "../canvas/Canvas";
+import { Outline } from "../view/Outline";
+import { Rect } from "../canvas/Rect";
+import { Configuration } from "../content/Configuration";
+import { Context } from "../content/Context";
+import { DisplayMetrics } from "../content/DisplayMetrics";
 
 /**
  * 可绘制对象的基类，封装边界、透明度与绘制回调。

package/@types/{ImageDrawable.ts → drawable/ImageDrawable.ts}

@@ -1,7 +1,7 @@
 import { Drawable } from "./Drawable";
-import { Image } from "./Image";
-import { Canvas } from "./Canvas";
-import { Context } from "./Context";
+import { Image } from "../widget/Image";
+import { Canvas } from "../canvas/Canvas";
+import { Context } from "../content/Context";
 
 /**
  * 图像 Drawable，将 Image 按重力对齐绘制到边界内。

package/@types/{LayerDrawable.d.ts → drawable/LayerDrawable.d.ts}

@@ -1,8 +1,8 @@
 import { Implements, Runnable } from "@compass-framework/library";
 import { Drawable } from "./Drawable";
-import { Canvas } from "./Canvas";
-import { Resources } from "./Resources";
-import { Context } from "./Context";
+import { Canvas } from "../canvas/Canvas";
+import { Resources } from "../content/Resources";
+import { Context } from "../content/Context";
 
 /**
  * 图层 Drawable，按顺序叠加绘制多个子 Drawable。

package/@types/{LinearGradientDrawable.d.ts → drawable/LinearGradientDrawable.d.ts}

@@ -1,4 +1,4 @@
-import { Canvas } from "./Canvas";
+import { Canvas } from "../canvas/Canvas";
 
 /**
  * 线性渐变 Drawable，按角度或方向填充渐变色。

package/@types/{PictureDrawable.d.ts → drawable/PictureDrawable.d.ts}

@@ -1,9 +1,9 @@
 import { Consumer, Implements } from "@compass-framework/library";
-import { Paint } from "./Paint";
+import { Paint } from "../canvas/Paint";
 import { ImageDrawable } from "./ImageDrawable";
-import { Picture } from "./Picture";
-import { ImageView } from "./ImageView";
-import { Context } from "./Context";
+import { Picture } from "../canvas/Picture";
+import { ImageView } from "../widget/ImageView";
+import { Context } from "../content/Context";
 
 /**
  * 基于 Picture 的图像 Drawable，支持加载状态通知。

package/@types/{Resolver.ts → evaluate/Resolver.ts}

@@ -1,4 +1,4 @@
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 环境解析器，在 Context 挂载后解析命名参数。