@compass-framework/core 1.2.61 → 1.2.63

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

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

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/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/text/EditorInfo.d.ts

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

package/index.d.ts

@@ -14,9 +14,8 @@ export * from "./@types/widget/ImageView";
 export * from "./@types/misc/DoubleClick";
 export * from "./@types/misc/DoubleClickListener";
 
-export * from "./@types/app/Application";
 export * from "./@types/text/Editable";
-export * from "./@types/shared/ContextUtils";
+export * from "./@types/text/EditorInfo";
 
 export * from "./@types/layout/FrameLayout";
 export * from "./@types/layout/GridLayout";
@@ -25,23 +24,13 @@ export * from "./@types/layout/LinearLayout";
 export * from "./@types/layout/RelativeLayout";
 export * from "./@types/layout/GridLayoutAnimationController";
 
-export * from "./@types/drawable/CornersDrawable";
-export * from "./@types/drawable/Drawable";
-export * from "./@types/drawable/ImageDrawable";
-export * from "./@types/drawable/LayerDrawable";
-export * from "./@types/drawable/LinearGradientDrawable";
-export * from "./@types/drawable/PictureDrawable";
-export * from "./@types/drawable/ColorDrawable";
-
 export * from "./@types/content/AttributeSet";
 export * from "./@types/content/Configuration";
 export * from "./@types/content/Context";
-export * from "./@types/content/DisplayMetrics";
-export * from "./@types/evaluate/Environment";
-export * from "./@types/content/LayoutInflater";
 export * from "./@types/content/PixelFormat";
-export * from "./@types/evaluate/Resolver";
 export * from "./@types/content/Resources";
+export * from "./@types/content/DisplayMetrics";
+export * from "./@types/content/LayoutInflater";
 
 export * from "./@types/canvas/BlendMode";
 export * from "./@types/canvas/Canvas";
@@ -72,13 +61,15 @@ export * from "./@types/animation/BounceInterpolator";
 export * from "./@types/animation/CycleInterpolator";
 export * from "./@types/animation/DecelerateInterpolator";
 
+export * from "./@types/imm/InputConnection";
+export * from "./@types/imm/InputMethod";
+
 export * from "./@types/widget/Slot";
 export * from "./@types/widget/TextView";
 export * from "./@types/widget/ListAdapter";
 export * from "./@types/widget/ListView";
 export * from "./@types/widget/ScrollView";
 
-export * from "./@types/display/SurfaceProvider";
 export * from "./@types/layout/TableLayout";
 export * from "./@types/layout/TableRow";
 export * from "./@types/content/Theme";
@@ -95,6 +86,17 @@ export * from "./@types/animator/ValueAnimator";
 export * from "./@types/animator/Animator";
 export * from "./@types/animator/PropertyValuesHolder";
 
+export * from "./@types/drawable/CornersDrawable";
+export * from "./@types/drawable/Drawable";
+export * from "./@types/drawable/ImageDrawable";
+export * from "./@types/drawable/LayerDrawable";
+export * from "./@types/drawable/LinearGradientDrawable";
+export * from "./@types/drawable/PictureDrawable";
+export * from "./@types/drawable/ColorDrawable";
+
+export * from "./@types/evaluate/Resolver";
+export * from "./@types/evaluate/Environment";
+
 export * from "./@types/view/Gravity";
 export * from "./@types/view/Outline";
 export * from "./@types/view/View";
@@ -107,12 +109,32 @@ export * from "./@types/view/ViewSlot";
 export * from "./@types/view/ViewTreeObserver";
 
 export * from "./@types/animation/Interpolator";
-export * from "./@types/event/KeyEvent";
 export * from "./@types/animation/LayoutAnimationController";
 export * from "./@types/animation/LinearInterpolator";
+
+export * from "./@types/event/KeyEvent";
 export * from "./@types/event/MotionEvent";
+
 export * from "./@types/display/MouseCursor";
+export * from "./@types/display/SurfaceProvider";
 
 export * from "./@types/window/Window";
 export * from "./@types/window/PopupWindow";
 export * from "./@types/window/WindowManager";
+
+export * from "./@types/activity/ActivityType";
+export * from "./@types/activity/Activity";
+export * from "./@types/activity/Intent";
+export * from "./@types/activity/ExtraValue";
+
+export * from "./@types/host/EditContext";
+export * from "./@types/host/backend/NodePlatformHostConfig";
+export * from "./@types/host/backend/WebPlatformHostConfig";
+export * from "./@types/host/backend/CanvaskitPlatformHostConfig";
+
+export * from "./@types/app/ApplicationConfig";
+export * from "./@types/app/Application";
+export * from "./@types/app/ApplicationCreatorConfig";
+export * from "./@types/app/ApplicationCreator";
+
+export * from "./@types/shared/ContextUtils";

package/package.json

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