@compass-framework/core 1.2.60 → 1.2.62

package/@types/host/EditContext.d.ts

@@ -0,0 +1,179 @@
+/**
+ * EditContext API contract
+ *
+ * Aligned with W3C EditContext IDL: https://w3c.github.io/edit-context/
+ *
+ * Portable TypeScript surface for the upcoming cross-platform C++ implementation.
+ * Index units are UTF-16 code units. Ranges are [start, end).
+ */
+
+/* =============================================================================
+ * Geometry
+ * ============================================================================= */
+
+/** Axis-aligned rect in client / viewport coordinates. */
+export interface DOMRectLike {
+  x?: number;
+  y?: number;
+  width?: number;
+  height?: number;
+}
+
+export type RectInput = DOMRectLike;
+
+/* =============================================================================
+ * Enums (W3C)
+ * ============================================================================= */
+
+export type UnderlineStyle = "none" | "solid" | "dotted" | "dashed" | "wavy";
+export type UnderlineThickness = "none" | "thin" | "thick";
+
+/* =============================================================================
+ * Init dictionaries
+ * ============================================================================= */
+
+export interface EditContextInit {
+  text?: string;
+  selectionStart?: number;
+  selectionEnd?: number;
+}
+
+export interface TextUpdateEventInit {
+  updateRangeStart?: number;
+  updateRangeEnd?: number;
+  text?: string;
+  selectionStart?: number;
+  selectionEnd?: number;
+}
+
+export interface TextFormatInit {
+  rangeStart?: number;
+  rangeEnd?: number;
+  underlineStyle?: UnderlineStyle;
+  underlineThickness?: UnderlineThickness;
+}
+
+export interface TextFormatUpdateEventInit {
+  textFormats?: TextFormat[];
+}
+
+export interface CharacterBoundsUpdateEventInit {
+  rangeStart?: number;
+  rangeEnd?: number;
+}
+
+/* =============================================================================
+ * Formats & events
+ * ============================================================================= */
+
+export interface TextFormat {
+  readonly rangeStart: number;
+  readonly rangeEnd: number;
+  readonly underlineStyle: UnderlineStyle;
+  readonly underlineThickness: UnderlineThickness;
+}
+
+export interface TextUpdateEvent {
+  readonly updateRangeStart: number;
+  readonly updateRangeEnd: number;
+  readonly text: string;
+  readonly selectionStart: number;
+  readonly selectionEnd: number;
+}
+
+export interface TextFormatUpdateEvent {
+  getTextFormats(): TextFormat[];
+}
+
+export interface CharacterBoundsUpdateEvent {
+  readonly rangeStart: number;
+  readonly rangeEnd: number;
+}
+
+export interface CompositionEvent {
+  readonly type: "compositionstart" | "compositionend";
+  readonly data: string;
+}
+
+export interface EditContextEventMap {
+  textupdate: TextUpdateEvent;
+  textformatupdate: TextFormatUpdateEvent;
+  characterboundsupdate: CharacterBoundsUpdateEvent;
+  compositionstart: CompositionEvent;
+  compositionend: CompositionEvent;
+}
+
+export type EditContextEventType = keyof EditContextEventMap;
+
+export type EditContextEventListener<K extends EditContextEventType> = (ev: EditContextEventMap[K],) => void;
+
+/* =============================================================================
+ * Host element
+ * ============================================================================= */
+
+export interface EditContextHostElement {
+  readonly id?: string;
+}
+
+/* =============================================================================
+ * EditContext
+ * ============================================================================= */
+
+export declare class EditContext {
+  readonly text: string;
+  readonly selectionStart: number;
+  readonly selectionEnd: number;
+  readonly characterBoundsRangeStart: number;
+  readonly isComposing: boolean;
+
+  startInput(): void;
+
+  updateText(rangeStart: number, rangeEnd: number, text: string): void;
+
+  updateSelection(start: number, end: number): void;
+
+  updateControlBounds(controlBounds: RectInput): void;
+
+  updateSelectionBounds(selectionBounds: RectInput): void;
+
+  updateCharacterBounds(rangeStart: number, characterBounds: readonly RectInput[]): void;
+
+  finishInput(): void;
+
+  characterBounds(): DOMRectLike[];
+
+  /** Associated host view(s); empty if not attached. */
+  attachedElements(): EditContextHostElement[];
+
+  addEventListener<K extends EditContextEventType>(type: K, listener: EditContextEventListener<K>): void;
+
+  removeEventListener<K extends EditContextEventType>(type: K, listener: EditContextEventListener<K>): void;
+
+  ontextupdate: EditContextEventListener<"textupdate"> | null;
+  oncompositionstart: EditContextEventListener<"compositionstart"> | null;
+  oncompositionend: EditContextEventListener<"compositionend"> | null;
+  ontextformatupdate: EditContextEventListener<"textformatupdate"> | null;
+  oncharacterboundsupdate: EditContextEventListener<"characterboundsupdate"> | null;
+}
+
+export interface EditContextConstructor {
+  new(options?: EditContextInit): EditContext;
+}
+
+export type EditContextCompositionPhase =
+    | "idle"
+    | "composing"
+    | "awaiting-character-bounds";
+
+/* =============================================================================
+ * Virtual Keyboard (mobile companion; optional)
+ * ============================================================================= */
+
+export interface VirtualKeyboard {
+  readonly boundingRect: DOMRectLike;
+  overlaysContent: boolean;
+  show(): void;
+  hide(): void;
+  addEventListener(type: "geometrychange", listener: () => void): void;
+  removeEventListener(type: "geometrychange", listener: () => void): void;
+}

package/@types/host/backend/CanvaskitPlatformHostConfig.d.ts

@@ -0,0 +1,3 @@
+export interface CanvaskitPlatformHostConfig {
+  container?: string | HTMLElement
+}

package/@types/host/backend/NodePlatformHostConfig.d.ts

@@ -0,0 +1,4 @@
+export interface NodePlatformHostConfig {
+  width: number;
+  height: number;
+}

package/@types/host/backend/WebPlatformHostConfig.d.ts

@@ -0,0 +1,3 @@
+export interface WebPlatformHostConfig {
+  container?: string | HTMLElement
+}

package/@types/imm/InputConnection.ts

@@ -0,0 +1,17 @@
+import { CharSequence } from "@compass-framework/library";
+import { Rect } from "../canvas/Rect";
+import { KeyEvent } from "../event/KeyEvent";
+
+export interface InputConnection {
+  getCursor(flags: number): Rect;
+
+  setSelection(start: number, end: number): boolean;
+
+  getInputRect(): Rect;
+
+  sendKeyEvent(event: KeyEvent): boolean;
+
+  finishComposingText(): boolean
+
+  setComposingText(text: CharSequence, newCursorPosition: number): boolean;
+}

package/@types/imm/InputMethod.d.ts

@@ -0,0 +1,3 @@
+export interface InputMethod {
+
+}

package/@types/{AbsoluteLayout.d.ts → layout/AbsoluteLayout.d.ts}

@@ -1,4 +1,4 @@
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
 
 /**
  * 绝对定位布局，子视图按指定坐标放置。

package/@types/{FrameLayout.d.ts → layout/FrameLayout.d.ts}

@@ -1,4 +1,4 @@
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
 
 /**
  * 帧布局，子视图按添加顺序叠放，可通过 gravity 对齐。

package/@types/{GridLayout.d.ts → layout/GridLayout.d.ts}

@@ -1,4 +1,4 @@
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
 
 /**
  * 网格布局，按行与列排列子视图。

package/@types/{GridLayoutAnimationController.d.ts → layout/GridLayoutAnimationController.d.ts}

@@ -1,4 +1,4 @@
-import { LayoutAnimationController } from "./LayoutAnimationController";
+import { LayoutAnimationController } from "../animation/LayoutAnimationController";
 
 /**
  * 网格布局动画控制器。

package/@types/{LinearLayout.d.ts → layout/LinearLayout.d.ts}

@@ -1,4 +1,4 @@
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
 
 /**
  * 线性布局，按水平或垂直方向依次排列子视图。

package/@types/{RelativeLayout.d.ts → layout/RelativeLayout.d.ts}

@@ -1,4 +1,4 @@
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
 
 /**
  * 相对布局，按相对关系定位子视图。

package/@types/{TabBarLayout.d.ts → layout/TabBarLayout.d.ts}

@@ -1,5 +1,5 @@
 import { InterfaceTemplate } from "@compass-framework/library";
-import { View } from "./View";
+import { View } from "../view/View";
 import { LinearLayout } from "./LinearLayout";
 
 /**

package/@types/{TableLayout.d.ts → layout/TableLayout.d.ts}

@@ -1,4 +1,4 @@
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
 import { LinearLayout } from "./LinearLayout";
 
 /**

package/@types/{TableRow.d.ts → layout/TableRow.d.ts}

@@ -1,4 +1,4 @@
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
 import { LinearLayout } from "./LinearLayout";
 
 /**

package/@types/{DoubleClick.d.ts → misc/DoubleClick.d.ts}

@@ -1,7 +1,7 @@
 import { Implements } from "@compass-framework/library";
 import { DoubleClickListener } from "./DoubleClickListener";
-import { View } from "./View";
-import { MotionEvent } from "./MotionEvent";
+import { View } from "../view/View";
+import { MotionEvent } from "../event/MotionEvent";
 
 /**
  * 双击手势识别器，将触摸事件转换为单击/双击回调。

package/@types/{DoubleClickListener.d.ts → misc/DoubleClickListener.d.ts}

@@ -1,6 +1,6 @@
 import { InterfaceTemplate } from "@compass-framework/library";
-import { View } from "./View";
-import { MotionEvent } from "./MotionEvent";
+import { View } from "../view/View";
+import { MotionEvent } from "../event/MotionEvent";
 
 /**
  * 双击监听器，处理单击、双击与指针触摸回调。

package/@types/{ContextUtils.d.ts → shared/ContextUtils.d.ts}

@@ -1,4 +1,4 @@
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * Context 工具类，用于创建子作用域上下文。

package/@types/text/EditorInfo.d.ts

@@ -0,0 +1,7 @@
+import { EditContext } from "../host/EditContext";
+
+export interface EditorInfo {
+  initialSelStart: number
+  initialSelEnd: number
+  editContext: EditContext;
+}

package/@types/{Gravity.d.ts → view/Gravity.d.ts}

@@ -1,4 +1,4 @@
-import { Rect } from "./Rect";
+import { Rect } from "../canvas/Rect";
 
 /**
  * 重力对齐常量与布局定位工具。

package/@types/{Outline.d.ts → view/Outline.d.ts}

@@ -1,5 +1,5 @@
-import { Rect } from "./Rect";
-import { Context } from "./Context";
+import { Rect } from "../canvas/Rect";
+import { Context } from "../content/Context";
 
 /**
  * 轮廓，用于描述视图或 Drawable 的外形边界。

package/@types/{View.d.ts → view/View.d.ts}

@@ -5,25 +5,25 @@ import {
 } from "@compass-framework/library";
 
 import { ViewOverlay } from "./ViewOverlay";
-import { Context } from "./Context";
-import { Configuration } from "./Configuration";
-import { Rect } from "./Rect";
-import { AttributeSet } from "./AttributeSet";
-import { Canvas } from "./Canvas";
-import { Transformation } from "./Transformation";
-import { KeyEvent } from "./KeyEvent";
-import { Drawable } from "./Drawable";
+import { Context } from "../content/Context";
+import { Configuration } from "../content/Configuration";
+import { Rect } from "../canvas/Rect";
+import { AttributeSet } from "../content/AttributeSet";
+import { Canvas } from "../canvas/Canvas";
+import { Transformation } from "../animation/Transformation";
+import { KeyEvent } from "../event/KeyEvent";
+import { Drawable } from "../drawable/Drawable";
 import { Outline } from "./Outline";
 import { ViewTreeObserver } from "./ViewTreeObserver";
 import { ViewGroup } from "./ViewGroup";
-import { Animation } from "./Animation";
-import { MotionEvent } from "./MotionEvent";
-import { Matrix } from "./Matrix";
-import { Resources } from "./Resources";
+import { Animation } from "../animation/Animation";
+import { MotionEvent } from "../event/MotionEvent";
+import { Matrix } from "../canvas/Matrix";
+import { Resources } from "../content/Resources";
 import { ViewParent } from "./ViewParent";
 import { ViewOutlineProvider } from "./ViewOutlineProvider";
-import { DisplayMetrics } from "./DisplayMetrics";
-import { Window } from "./Window";
+import { DisplayMetrics } from "../content/DisplayMetrics";
+import { Window } from "../window/Window";
 
 /**
  * 基础视图，负责测量、布局、绘制与事件分发。

package/@types/{ViewGroup.d.ts → view/ViewGroup.d.ts}

@@ -1,10 +1,10 @@
 import { Implements } from "@compass-framework/library";
 import { View } from "./View";
-import { AttributeSet } from "./AttributeSet";
-import { Configuration } from "./Configuration";
+import { AttributeSet } from "../content/AttributeSet";
+import { Configuration } from "../content/Configuration";
 import { ViewParent } from "./ViewParent";
-import { MotionEvent } from "./MotionEvent";
-import { DisplayMetrics } from "./DisplayMetrics";
+import { MotionEvent } from "../event/MotionEvent";
+import { DisplayMetrics } from "../content/DisplayMetrics";
 
 /**
  * 视图组，可容纳并管理子视图的测量、布局与触摸分发。

package/@types/{ViewGroupOverlay.d.ts → view/ViewGroupOverlay.d.ts}

@@ -1,5 +1,5 @@
 import { ViewOverlay } from "./ViewOverlay";
-import { Drawable } from "./Drawable";
+import { Drawable } from "../drawable/Drawable";
 import { View } from "./View";
 
 /**

package/@types/{ViewOverlay.d.ts → view/ViewOverlay.d.ts}

@@ -1,4 +1,4 @@
-import { Drawable } from "./Drawable";
+import { Drawable } from "../drawable/Drawable";
 import { ViewGroup } from "./ViewGroup";
 
 /**

package/@types/{ViewSlot.d.ts → view/ViewSlot.d.ts}

@@ -1,6 +1,6 @@
 import { Implements } from "@compass-framework/library";
-import { FrameLayout } from "./FrameLayout";
-import { Slot } from "./Slot";
+import { FrameLayout } from "../layout/FrameLayout";
+import { Slot } from "../widget/Slot";
 import { View } from "./View";
 
 /**

package/@types/{ViewTreeObserver.d.ts → view/ViewTreeObserver.d.ts}

@@ -1,6 +1,6 @@
 import { InterfaceTemplate } from "@compass-framework/library";
 import { View } from "./View";
-import { MotionEvent } from "./MotionEvent";
+import { MotionEvent } from "../event/MotionEvent";
 
 /**
  * 视图树观察者，监听全局布局、绘制前与焦点/触摸变化。

package/@types/{Adapter.d.ts → widget/Adapter.d.ts}

@@ -1,6 +1,6 @@
 import { InterfaceTemplate } from "@compass-framework/library";
-import { View } from "./View";
-import { ViewGroup } from "./ViewGroup";
+import { View } from "../view/View";
+import { ViewGroup } from "../view/ViewGroup";
 
 /**
  * 适配器接口，为列表类控件提供数据与视图绑定。

package/@types/widget/DecorView.ts

@@ -0,0 +1,5 @@
+import { FrameLayout } from "../layout/FrameLayout";
+
+export interface DecorView extends FrameLayout {
+
+}

package/@types/{EditRichText.d.ts → widget/EditRichText.d.ts}

@@ -1,7 +1,7 @@
-import { FrameLayout } from "./FrameLayout";
-import { Context } from "./Context";
-import { AttributeSet } from "./AttributeSet";
-import { View } from "./View";
+import { FrameLayout } from "../layout/FrameLayout";
+import { Context } from "../content/Context";
+import { AttributeSet } from "../content/AttributeSet";
+import { View } from "../view/View";
 
 /**
  * 富文本编辑器，支持 HTML 互转与选区样式操作。

package/@types/{EditText.d.ts → widget/EditText.d.ts}

@@ -1,5 +1,5 @@
 import { TextView } from "./TextView";
-import { Editable } from "./Editable";
+import { Editable } from "../text/Editable";
 
 /**
  * 可编辑文本框，支持输入、选区与只读控制。

package/@types/{FreezeLayoutViewGroup.d.ts → widget/FreezeLayoutViewGroup.d.ts}

@@ -1,4 +1,4 @@
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
 
 /**
  * 支持顶部/左侧区域冻结与独立滚动的视图组基类。

package/@types/{GridView.d.ts → widget/GridView.d.ts}

@@ -1,4 +1,4 @@
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
 import { ListAdapter } from "./ListAdapter";
 
 /**

package/@types/{HorizontalScrollView.ts → widget/HorizontalScrollView.ts}

@@ -1,4 +1,4 @@
-import { FrameLayout } from "./FrameLayout";
+import { FrameLayout } from "../layout/FrameLayout";
 
 /**
  * 水平滚动视图，可横向滚动显示超出范围的内容。

package/@types/{Image.d.ts → widget/Image.d.ts}

@@ -1,5 +1,5 @@
 import { InterfaceTemplate } from "@compass-framework/library";
-import { Context } from "./Context";
+import { Context } from "../content/Context";
 
 /**
  * 位图图像，封装像素缓冲及其尺寸。

package/@types/{ImageView.d.ts → widget/ImageView.d.ts}

@@ -5,7 +5,7 @@ import {
 
 import {
   View,
-} from "./View";
+} from "../view/View";
 
 /**
  * 图片视图，用于展示图像内容。

package/@types/{ListView.d.ts → widget/ListView.d.ts}

@@ -1,5 +1,5 @@
 import { ListAdapter } from "./ListAdapter";
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
 
 /**
  * 列表视图，通过适配器展示可滚动的条目列表。

package/@types/{ScrollView.d.ts → widget/ScrollView.d.ts}

@@ -1,6 +1,6 @@
 import {
   FrameLayout,
-} from "./FrameLayout";
+} from "../layout/FrameLayout";
 
 /**
  * 垂直滚动视图，可滚动显示超出范围的内容。

package/@types/{Slot.d.ts → widget/Slot.d.ts}

@@ -1,5 +1,5 @@
 import { InterfaceTemplate } from "@compass-framework/library";
-import { View } from "./View";
+import { View } from "../view/View";
 
 /**
  * 插槽接口，用于替换目标视图内容。

package/@types/{TextView.d.ts → widget/TextView.d.ts}

@@ -1,5 +1,5 @@
 import { CharSequence } from "@compass-framework/library";
-import { View } from "./View";
+import { View } from "../view/View";
 
 /**
  * 文本视图，负责显示与样式化文本内容。

package/@types/window/ApplicationWindow.ts

@@ -0,0 +1,12 @@
+import { Context } from "../content/Context";
+import { View } from "../view/View";
+import { DecorView } from "../widget/DecorView";
+import { Window } from "./Window";
+
+export declare class ApplicationWindow extends Window {
+  public getCurrentFocus(): View;
+
+  public getContext(): Context;
+
+  public getDecorView(): DecorView;
+}

package/@types/window/PopupWindow.d.ts

@@ -0,0 +1,41 @@
+import { WindowManager } from "./WindowManager";
+import { View } from "../view/View";
+import { Context } from "../content/Context";
+import { DecorView } from "../widget/DecorView";
+
+/**
+ * 弹出窗口，在指定位置展示浮动内容视图。
+ */
+export declare class PopupWindow {
+  public constructor();
+
+  public showAtLocation(parent: View, gravity: number, x: number, y: number): void;
+
+  public isShowing() : boolean;
+
+  public isOutsideTouchable():boolean;
+
+  public dismiss(): void;
+
+  public update(x: number, y: number, width: number, height: number): void;
+
+  public getDecorView(): DecorView;
+
+  public getContentView(): View;
+
+  public getOnGenericMotionListener(): View.OnGenericMotionListener;
+
+  public getOnTouchListener(): View.OnTouchListener;
+
+  public getContext(): Context;
+
+  public getLayoutParams(): WindowManager.LayoutParams;
+
+  public setOnTouchListener(l: View.OnTouchListener): void;
+
+  public setContentView(contentView: View): void;
+
+  public setOutsideTouchable(touchable: boolean):void;
+
+  public setOnGenericMotionListener(l: View.OnGenericMotionListener): void;
+}

package/@types/window/Window.d.ts

@@ -0,0 +1,24 @@
+import { ArrayList } from "@compass-framework/library";
+import { View } from "../view/View";
+import { DecorView } from "../widget/DecorView";
+import { Context } from "../content/Context";
+import { WindowManager } from "./WindowManager";
+
+export declare abstract class Window {
+  public findViewById(id: number): View;
+  public findViewById(id: string): View;
+
+  public findViewByTag(tag: string): View;
+
+  public findViewsByTag(tag: string): ArrayList<View>;
+
+  public abstract getCurrentFocus(): View;
+
+  public abstract getContext(): Context;
+
+  public abstract getDecorView(): DecorView;
+
+  public getAttributes(): WindowManager.LayoutParams;
+
+  public setAttributes(a: WindowManager.LayoutParams): void;
+}

package/@types/{WindowManager.d.ts → window/WindowManager.d.ts}

@@ -1,16 +1,18 @@
-import { ViewGroup } from "./ViewGroup";
+import { ViewGroup } from "../view/ViewGroup";
+import { View } from "../view/View";
 
 /**
  * 窗口管理器，负责添加、移除与更新窗口布局。
  */
 export declare class WindowManager {
-  public addWindow(window: Window): void;
-  public addWindow(window: Window, params: WindowManager.LayoutParams): void;
+  public addView(view: View): void;
+  public addView(view: View, params: WindowManager.LayoutParams): void;
+  public addView(view: View, params: WindowManager.LayoutParams, nest: boolean): void;
 
-  public removeWindow(window: Window): void;
+  public removeView(view: View): void;
 
-  public updateWindowLayout(window: Window): void;
-  public updateWindowLayout(window: Window, params: WindowManager.LayoutParams): void;
+  public updateViewLayout(view: View): void;
+  public updateViewLayout(view: View, params: WindowManager.LayoutParams): void;
 }
 
 /**