drawnui-react 0.1.0-preview.8 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/README.md +229 -22
  2. package/SKIPPED.md +38 -29
  3. package/dist/controls/AnimatedFramesRenderer.d.ts +9 -0
  4. package/dist/controls/AnimatedFramesRenderer.js +18 -1
  5. package/dist/controls/DrawnGame.d.ts +44 -0
  6. package/dist/controls/DrawnGame.js +82 -0
  7. package/dist/controls/GridStructure.d.ts +25 -3
  8. package/dist/controls/GridStructure.js +81 -5
  9. package/dist/controls/SkiaBackdrop.d.ts +8 -2
  10. package/dist/controls/SkiaBackdrop.js +42 -14
  11. package/dist/controls/SkiaButton.d.ts +17 -3
  12. package/dist/controls/SkiaButton.js +26 -8
  13. package/dist/controls/SkiaCarousel.d.ts +22 -3
  14. package/dist/controls/SkiaCarousel.js +85 -9
  15. package/dist/controls/SkiaCheckbox.d.ts +0 -1
  16. package/dist/controls/SkiaCheckbox.js +2 -7
  17. package/dist/controls/SkiaDrawer.d.ts +15 -0
  18. package/dist/controls/SkiaDrawer.js +42 -7
  19. package/dist/controls/SkiaEditor.d.ts +51 -2
  20. package/dist/controls/SkiaEditor.js +292 -58
  21. package/dist/controls/SkiaGif.d.ts +7 -0
  22. package/dist/controls/SkiaGif.js +25 -4
  23. package/dist/controls/SkiaImage.d.ts +10 -0
  24. package/dist/controls/SkiaImage.js +80 -19
  25. package/dist/controls/SkiaLabel.d.ts +200 -11
  26. package/dist/controls/SkiaLabel.js +925 -93
  27. package/dist/controls/SkiaLabelFps.d.ts +12 -0
  28. package/dist/controls/SkiaLabelFps.js +35 -0
  29. package/dist/controls/SkiaLayout.d.ts +89 -9
  30. package/dist/controls/SkiaLayout.js +397 -23
  31. package/dist/controls/SkiaLottie.js +5 -3
  32. package/dist/controls/SkiaProgress.d.ts +2 -1
  33. package/dist/controls/SkiaProgress.js +8 -5
  34. package/dist/controls/SkiaRadioButton.d.ts +2 -0
  35. package/dist/controls/SkiaRadioButton.js +16 -4
  36. package/dist/controls/SkiaRichLabel.d.ts +1 -1
  37. package/dist/controls/SkiaRichLabel.js +11 -1
  38. package/dist/controls/SkiaScroll.d.ts +86 -7
  39. package/dist/controls/SkiaScroll.js +361 -40
  40. package/dist/controls/SkiaScrollBar.d.ts +27 -0
  41. package/dist/controls/SkiaScrollBar.js +51 -2
  42. package/dist/controls/SkiaShaderCarousel.d.ts +11 -1
  43. package/dist/controls/SkiaShaderCarousel.js +27 -5
  44. package/dist/controls/SkiaShape.d.ts +15 -2
  45. package/dist/controls/SkiaShape.js +57 -10
  46. package/dist/controls/SkiaShell.d.ts +282 -0
  47. package/dist/controls/SkiaShell.js +972 -0
  48. package/dist/controls/SkiaSlider.d.ts +20 -2
  49. package/dist/controls/SkiaSlider.js +61 -7
  50. package/dist/controls/SkiaSprite.d.ts +4 -0
  51. package/dist/controls/SkiaSprite.js +27 -11
  52. package/dist/controls/SkiaSvg.d.ts +4 -0
  53. package/dist/controls/SkiaSvg.js +28 -4
  54. package/dist/controls/SkiaSwitch.d.ts +0 -1
  55. package/dist/controls/SkiaSwitch.js +4 -8
  56. package/dist/controls/SkiaToggle.d.ts +25 -5
  57. package/dist/controls/SkiaToggle.js +58 -5
  58. package/dist/controls/SnappingLayout.d.ts +12 -1
  59. package/dist/controls/SnappingLayout.js +21 -2
  60. package/dist/controls/TooltipStyle.d.ts +52 -0
  61. package/dist/controls/TooltipStyle.js +88 -0
  62. package/dist/core/Accessibility.d.ts +162 -11
  63. package/dist/core/Accessibility.js +882 -22
  64. package/dist/core/Animators.d.ts +37 -1
  65. package/dist/core/Animators.js +102 -9
  66. package/dist/core/Canvas.d.ts +307 -8
  67. package/dist/core/Canvas.js +1202 -66
  68. package/dist/core/ControlStyle.d.ts +2 -0
  69. package/dist/core/ControlStyle.js +2 -0
  70. package/dist/core/DesignerActions.d.ts +32 -0
  71. package/dist/core/DesignerActions.js +68 -0
  72. package/dist/core/Easing.d.ts +12 -1
  73. package/dist/core/Easing.js +25 -1
  74. package/dist/core/Gestures.d.ts +86 -2
  75. package/dist/core/Gestures.js +184 -4
  76. package/dist/core/Hover.d.ts +51 -0
  77. package/dist/core/Hover.js +140 -0
  78. package/dist/core/ImageEffects.d.ts +2 -0
  79. package/dist/core/ImageEffects.js +2 -0
  80. package/dist/core/KeyboardManager.d.ts +40 -0
  81. package/dist/core/KeyboardManager.js +98 -8
  82. package/dist/core/PopupWindows.d.ts +94 -0
  83. package/dist/core/PopupWindows.js +207 -0
  84. package/dist/core/Props.d.ts +11 -0
  85. package/dist/core/Props.js +44 -0
  86. package/dist/core/ScrollAnimators.d.ts +6 -0
  87. package/dist/core/ScrollAnimators.js +16 -1
  88. package/dist/core/Shaping.d.ts +40 -0
  89. package/dist/core/Shaping.js +224 -0
  90. package/dist/core/SkiaControl.d.ts +306 -13
  91. package/dist/core/SkiaControl.js +681 -75
  92. package/dist/core/SkiaEffect.d.ts +29 -1
  93. package/dist/core/SkiaEffect.js +78 -16
  94. package/dist/core/SkiaImageManager.d.ts +101 -18
  95. package/dist/core/SkiaImageManager.js +318 -63
  96. package/dist/core/Styles.js +7 -1
  97. package/dist/core/Super.d.ts +33 -2
  98. package/dist/core/Super.js +58 -12
  99. package/dist/core/TextInputProxy.d.ts +31 -1
  100. package/dist/core/TextInputProxy.js +97 -15
  101. package/dist/core/Tooltips.d.ts +71 -0
  102. package/dist/core/Tooltips.js +205 -0
  103. package/dist/core/Types.d.ts +11 -1
  104. package/dist/core/Types.js +32 -1
  105. package/dist/core/ViewsAdapter.d.ts +7 -2
  106. package/dist/core/ViewsAdapter.js +10 -3
  107. package/dist/index.d.ts +8 -0
  108. package/dist/index.js +8 -0
  109. package/dist/react/SkiaShell.d.ts +8 -74
  110. package/dist/react/SkiaShell.js +163 -475
  111. package/dist/react/index.d.ts +48 -4
  112. package/dist/react/index.js +210 -43
  113. package/dist/react/reconciler.d.ts +32 -0
  114. package/dist/react/reconciler.js +71 -40
  115. package/dist/vite/index.d.ts +9 -0
  116. package/dist/vite/index.js +36 -3
  117. package/package.json +103 -5
@@ -0,0 +1,52 @@
1
+ import type { SkiaControl } from "../core/SkiaControl";
2
+ import { type Color, Thickness } from "../core/Types";
3
+ /**
4
+ * Look and timing of the tooltips a canvas shows for controls with a `Tooltip` (drawnui-cross 6ar, C# TooltipStyle).
5
+ * Set app-wide with `Super.TooltipStyle`, or per canvas with `Canvas.TooltipStyle`. Read when a tooltip is built, so a
6
+ * change applies from the next tooltip shown.
7
+ */
8
+ export declare class TooltipStyle {
9
+ /** Background of the tooltip: dark, a step lighter than dark app surfaces. */
10
+ BackgroundColor: Color;
11
+ /** Color of the tooltip text. */
12
+ TextColor: Color;
13
+ /** Color of the 1 pt border, lifts the tooltip off dark surfaces. Undefined or transparent for none. */
14
+ BorderColor?: Color;
15
+ /** Color of the soft shadow under the tooltip. Undefined or transparent for none. */
16
+ ShadowColor?: Color;
17
+ /** Font family of the tooltip text, undefined for the default font. */
18
+ FontFamily?: string;
19
+ /** Font size of the tooltip text, in points. */
20
+ FontSize: number;
21
+ /** Corner radius of the tooltip, in points. */
22
+ CornerRadius: number;
23
+ /** Space around the text, in points. */
24
+ Padding: Thickness;
25
+ /** Longer text wraps at this width, in points. */
26
+ MaxWidth: number;
27
+ /** How long the mouse rests on a control before its tooltip shows, in milliseconds. */
28
+ ShowDelayMs: number;
29
+ /** A tooltip that closed less than this many milliseconds ago lets the next one show at once (moving along a toolbar). */
30
+ FollowWindowMs: number;
31
+ /**
32
+ * False (default): attached to its control, centered 6 pt above it (below it where there is no room). True: below and
33
+ * to the right of the pointer where it rested (above it where there is no room). Either way it stays put while the
34
+ * mouse moves over the control.
35
+ */
36
+ AtCursor: boolean;
37
+ /** Moves the tooltip right (negative: left) from where it would go, in points. */
38
+ OffsetX: number;
39
+ /** Moves the tooltip down (negative: up), in points; on the flipped side it moves the other way, keeping its distance. */
40
+ OffsetY: number;
41
+ /**
42
+ * Builds the tooltip content for a text instead of the default rounded label. The control is measured and drawn on its
43
+ * own, outside the tree: it takes no input and screen readers do not see it.
44
+ */
45
+ CreateTooltip?: (text: string) => SkiaControl;
46
+ constructor(init?: Partial<TooltipStyle>);
47
+ /** Room left around the default tooltip for its shadow, in points. */
48
+ static readonly ShadowRoom = 8;
49
+ private static Visible;
50
+ /** The default tooltip content: the text on a rounded background. */
51
+ CreateDefault(text: string): SkiaControl;
52
+ }
@@ -0,0 +1,88 @@
1
+ import { Aria } from "../core/Accessibility";
2
+ import { Super } from "../core/Super";
3
+ import { SkiaShadow, Thickness } from "../core/Types";
4
+ import { SkiaLabel } from "./SkiaLabel";
5
+ import { SkiaShape } from "./SkiaShape";
6
+ /**
7
+ * Look and timing of the tooltips a canvas shows for controls with a `Tooltip` (drawnui-cross 6ar, C# TooltipStyle).
8
+ * Set app-wide with `Super.TooltipStyle`, or per canvas with `Canvas.TooltipStyle`. Read when a tooltip is built, so a
9
+ * change applies from the next tooltip shown.
10
+ */
11
+ export class TooltipStyle {
12
+ /** Background of the tooltip: dark, a step lighter than dark app surfaces. */
13
+ BackgroundColor = "#2B2D31";
14
+ /** Color of the tooltip text. */
15
+ TextColor = "#F2F3F5";
16
+ /** Color of the 1 pt border, lifts the tooltip off dark surfaces. Undefined or transparent for none. */
17
+ BorderColor = "#24FFFFFF";
18
+ /** Color of the soft shadow under the tooltip. Undefined or transparent for none. */
19
+ ShadowColor = "#59000000";
20
+ /** Font family of the tooltip text, undefined for the default font. */
21
+ FontFamily;
22
+ /** Font size of the tooltip text, in points. */
23
+ FontSize = 13;
24
+ /** Corner radius of the tooltip, in points. */
25
+ CornerRadius = 6;
26
+ /** Space around the text, in points. */
27
+ Padding = new Thickness(12, 8);
28
+ /** Longer text wraps at this width, in points. */
29
+ MaxWidth = 320;
30
+ /** How long the mouse rests on a control before its tooltip shows, in milliseconds. */
31
+ ShowDelayMs = 600;
32
+ /** A tooltip that closed less than this many milliseconds ago lets the next one show at once (moving along a toolbar). */
33
+ FollowWindowMs = 500;
34
+ /**
35
+ * False (default): attached to its control, centered 6 pt above it (below it where there is no room). True: below and
36
+ * to the right of the pointer where it rested (above it where there is no room). Either way it stays put while the
37
+ * mouse moves over the control.
38
+ */
39
+ AtCursor = false;
40
+ /** Moves the tooltip right (negative: left) from where it would go, in points. */
41
+ OffsetX = 0;
42
+ /** Moves the tooltip down (negative: up), in points; on the flipped side it moves the other way, keeping its distance. */
43
+ OffsetY = 0;
44
+ /**
45
+ * Builds the tooltip content for a text instead of the default rounded label. The control is measured and drawn on its
46
+ * own, outside the tree: it takes no input and screen readers do not see it.
47
+ */
48
+ CreateTooltip;
49
+ constructor(init) { if (init)
50
+ Object.assign(this, init); }
51
+ /** Room left around the default tooltip for its shadow, in points. */
52
+ static ShadowRoom = 8;
53
+ static Visible(c) {
54
+ if (!c || c === "Transparent" || c === "transparent")
55
+ return false;
56
+ const p = Super.ParseColor(c);
57
+ return p[3] > 0;
58
+ }
59
+ /** The default tooltip content: the text on a rounded background. */
60
+ CreateDefault(text) {
61
+ const shadow = TooltipStyle.Visible(this.ShadowColor);
62
+ const border = TooltipStyle.Visible(this.BorderColor);
63
+ const shape = new SkiaShape();
64
+ shape.CornerRadius = this.CornerRadius;
65
+ shape.BackgroundColor = this.BackgroundColor;
66
+ if (border) {
67
+ shape.StrokeColor = this.BorderColor;
68
+ shape.StrokeWidth = 1;
69
+ }
70
+ shape.Padding = this.Padding;
71
+ shape.Margin = shadow ? new Thickness(TooltipStyle.ShadowRoom) : Thickness.Zero; // the shadow is drawn inside the measured size
72
+ shape.MaximumWidthRequest = this.MaxWidth;
73
+ shape.UseCache = "Image";
74
+ if (shadow)
75
+ shape.Shadows = [new SkiaShadow({ X: 0, Y: 2, Blur: 6, Opacity: 1, Color: this.ShadowColor })];
76
+ const label = new SkiaLabel();
77
+ label.Text = text;
78
+ label.TextColor = this.TextColor;
79
+ label.FontSize = this.FontSize;
80
+ if (this.FontFamily)
81
+ label.FontFamily = this.FontFamily;
82
+ shape.AddSubView(label);
83
+ shape.AccessibilityRole = Aria.RolePresentation;
84
+ label.AccessibilityRole = Aria.RolePresentation;
85
+ return shape;
86
+ }
87
+ }
88
+ Super.TooltipStyle = new TooltipStyle();
@@ -1,5 +1,8 @@
1
+ import type { InputKey } from "./KeyboardManager";
1
2
  import type { SkiaControl } from "./SkiaControl";
2
3
  import { SKRect } from "./Types";
4
+ /** Controls with `AccessibilityModal` set, on every canvas (drawnui-cross 6av). Empty: no modal work at all. */
5
+ export declare const AccessibilityModals: Set<SkiaControl>;
3
6
  /** ARIA role constants (DrawnUi.Models.Aria) for `AccessibilityRole`. */
4
7
  export declare const Aria: {
5
8
  readonly RoleButton: "button";
@@ -38,21 +41,36 @@ export declare const Aria: {
38
41
  readonly RoleRegion: "region";
39
42
  readonly RoleNavigation: "navigation";
40
43
  readonly RoleMain: "main";
44
+ readonly RoleGrid: "grid";
45
+ readonly RoleToolbar: "toolbar";
46
+ readonly RoleRadioGroup: "radiogroup";
47
+ readonly RoleMenuBar: "menubar";
41
48
  /** Removes the control from the accessibility tree even when a default role would apply (inner label of a button). */
42
49
  readonly RolePresentation: "presentation";
43
50
  readonly LivePolite: "polite";
44
51
  readonly LiveAssertive: "assertive";
52
+ /**
53
+ * Container roles whose items the arrow keys walk (C# Aria.IsCompositeRole): a layout with one of them is one Tab stop,
54
+ * its current item, and the arrow keys move between its items.
55
+ */
56
+ readonly IsCompositeRole: (role?: string) => boolean;
57
+ /**
58
+ * Roles a user operates (C# Aria.IsInteractiveRole, as DrawnUi.Rust is_control_role): a node with one of them that
59
+ * cannot take input is read as disabled (aria-disabled). C# also lists listbox and scrollbar; here a listbox is an
60
+ * arrow-key group and groups are never disabled.
61
+ */
62
+ readonly IsInteractiveRole: (role?: string) => boolean;
45
63
  };
46
- /** One laid-out text line exposed for native selection (AccessibilityTextSelectable): CSS px relative to the node. */
47
- export interface AccessibilityTextLine {
64
+ /**
65
+ * The value of a range control (a slider, a progress bar): what a screen reader reads and adjusts (drawnui-cross 6c,
66
+ * C# AccessibilityValue): aria-valuenow / min / max, and aria-valuetext when Text is not empty ("65%", "20 – 80").
67
+ */
68
+ export interface AccessibilityValue {
69
+ Now: number;
70
+ Min: number;
71
+ Max: number;
72
+ Step: number;
48
73
  Text: string;
49
- Left: number;
50
- Top: number;
51
- Width: number;
52
- Height: number;
53
- FontFamily: string;
54
- FontWeight: number;
55
- FontSize: number;
56
74
  }
57
75
  /** One entry of the accessibility snapshot (DrawnUi AccessibilityNode). Rect is CSS pixels relative to the canvas. */
58
76
  export interface AccessibilityNode {
@@ -62,11 +80,15 @@ export interface AccessibilityNode {
62
80
  Role: string;
63
81
  Rect: SKRect;
64
82
  CanInteract: boolean;
83
+ /** A role a user operates (Aria.IsInteractiveRole) that cannot take input: aria-disabled, no tab stop. */
84
+ Disabled: boolean;
65
85
  IsPressed?: boolean;
86
+ /** A control that opens something (a menu title): open or closed (aria-expanded); undefined when it opens nothing. */
87
+ Expanded?: boolean;
66
88
  Live?: string;
67
89
  Source: SkiaControl;
68
- /** Real text lines rendered into the overlay so the browser can select / copy them (opt-in per control). */
69
- TextLines?: AccessibilityTextLine[];
90
+ /** A range control's value (aria-valuenow / min / max / valuetext); its name stays the app's label. */
91
+ Value?: AccessibilityValue;
70
92
  }
71
93
  /**
72
94
  * Mirrors DrawnUi SkiaAccessibilityManager: registry of accessible controls + a rate-limited snapshot
@@ -81,6 +103,7 @@ export declare class SkiaAccessibilityManager {
81
103
  private pending;
82
104
  private readonly changed;
83
105
  private readonly liveUpdated;
106
+ private readonly keyboardFocusRequested;
84
107
  /** Minimum milliseconds between snapshot rebuilds. */
85
108
  MinUpdateIntervalMs: number;
86
109
  Snapshot: AccessibilityNode[];
@@ -89,10 +112,137 @@ export declare class SkiaAccessibilityManager {
89
112
  OnChanged(cb: () => void): () => void;
90
113
  /** Fired immediately (bypassing the rate limit) when a live-region node's value changes. */
91
114
  OnLiveRegionUpdated(cb: (node: SkiaControl) => void): () => void;
115
+ /**
116
+ * Keyboard focus moved by the manager itself (arrow keys in a group): the overlay moves DOM focus to that node's
117
+ * element (C# KeyboardFocusRequested). Returns the unsubscribe function.
118
+ */
119
+ OnKeyboardFocusRequested(cb: (node: SkiaControl | undefined) => void): () => void;
92
120
  NotifyFocused(node?: SkiaControl): void;
121
+ /**
122
+ * Enter / Space from keyboard navigation or a screen reader: activates the node only while a tap could reach it
123
+ * (AccessibilityCanInteract), the rule every head applies.
124
+ */
125
+ static Activate(node?: SkiaControl): boolean;
126
+ /**
127
+ * Arrow keys, Home / End, PageUp / PageDown for the node in keyboard focus: the control gets them first, only while a
128
+ * pan could reach it (a slider steps its value); keys it does not use move keyboard focus between the items of the
129
+ * group around it (MoveInGroup). True when the key was used.
130
+ */
131
+ static Key(node: SkiaControl | undefined, key: InputKey): boolean;
132
+ /** Last focused node of each group: where Tab enters the group. */
133
+ private readonly groupFocus;
134
+ private groupRequest?;
135
+ /**
136
+ * The arrow-key group around `control`: its nearest ancestor with a composite role (Aria.IsCompositeRole, e.g.
137
+ * Aria.RoleList on a SkiaStack), and the item of that group holding the control (one of its children, a cell).
138
+ */
139
+ static TryFindGroup(control: SkiaControl): {
140
+ Group: SkiaControl;
141
+ Item: SkiaControl;
142
+ Holder: SkiaControl;
143
+ } | undefined;
144
+ /** Remembers where keyboard focus is inside its group, so the next Tab into the group lands there. */
145
+ private NoteFocus;
146
+ /**
147
+ * Whether Tab / Shift+Tab stop on this node. A group of items is one Tab stop, like a native list: its current item
148
+ * (the one keyboard focus last had there, else the group's first usable node) plus the controls inside that same
149
+ * item; the arrow keys move between items. Every node outside a group is a stop.
150
+ */
151
+ IsTabStop(node: SkiaControl): boolean;
152
+ /**
153
+ * Moves keyboard focus between the items of the group around `focused`, by item index like a native list: Down / Up in
154
+ * a Column, Right / Left in a Row, all four in a Wrap, a Grid or a Split layout (Up / Down by one row), Home / End to the
155
+ * first / last item, PageDown / PageUp by one viewport of the scroll around it. The ends stop the arrows, unless the group has KeyboardWrap. The target is the
156
+ * item itself when it is an interactive node, else its first interactive node; items the pointer cannot use are
157
+ * skipped. An item not realized (recycled cells) is scrolled in with ScrollToIndex when the group is the scroll's
158
+ * content, and focused once drawn. True when the key belongs to the group.
159
+ */
160
+ MoveInGroup(focused: SkiaControl, key: InputKey): boolean;
161
+ private focusRequest?;
162
+ private popupFocusRoot?;
163
+ private focusAnyInside;
164
+ private popupFocusDeadline;
165
+ /** The keyboard goes to this control at the end of the next frame (a popup closed: back to what opened it). */
166
+ RequestKeyboardFocus(control: SkiaControl): void;
167
+ /**
168
+ * How long a keyboard focus request waits for its control to take input again (drawnui-cross 6bs): an app that shows
169
+ * the opener of a dialog again only once the dialog is gone (a HUD hidden under it) still gets the keyboard back there.
170
+ */
171
+ static FocusRequestWaitMs: number;
172
+ private focusRequestDeadline;
173
+ private appFocus?;
174
+ private appFocusDeadline;
175
+ private appFocusThisFrame;
176
+ private clearFocusRequest;
177
+ /**
178
+ * App code moves the keyboard and screen-reader focus at the end of the next frame (C# DrawnView.SetAccessibilityFocus,
179
+ * Rust `Cx::set_accessibility_focus`), for a custom menu that moves its highlight: to `control`, which gets it once
180
+ * drawn, within 3 seconds. It wins over the library's own moves in the same frame (a group's arrow move, a closed popup
181
+ * window giving the keyboard back to its opener); undefined cancels a move still waiting, the focus stays where it is.
182
+ * The focus ring shows only if the keyboard is in use (the browser's focus-visible).
183
+ */
184
+ SetAccessibilityFocus(control?: SkiaControl): void;
185
+ /**
186
+ * No drawn control keeps the keyboard and screen-reader focus (C# KeyboardFocusNode = null): at the end of the next
187
+ * frame the DOM focus goes back to the canvas and the keys belong to the app again.
188
+ */
189
+ ClearKeyboardFocus(): void;
190
+ private ProcessAppFocus;
191
+ private popupScope?;
192
+ /**
193
+ * While set, Tab stays inside this control: only its nodes are Tab stops and Tab / Shift+Tab go round them: the top
194
+ * popup window that takes input (a menu, a dropdown; set by the canvas), else the active modal.
195
+ */
196
+ get KeyboardScope(): SkiaControl | undefined;
197
+ set KeyboardScope(v: SkiaControl | undefined);
198
+ /** The modal that accessibility is limited to: the topmost `AccessibilityModal` control that shows. Undefined when none. */
199
+ ActiveModal?: SkiaControl;
200
+ /**
201
+ * The node the overlay names the active modal after (drawnui-cross 6bs): the modal's own when it has a name, else the
202
+ * first named dialog inside it, so a nameless popup host around a dialog reads as that one dialog, not as two.
203
+ */
204
+ get ActiveModalNode(): AccessibilityNode | undefined;
205
+ private readonly modalReturns;
206
+ /** A control behind the active modal (not in it, not in a popup window over it): no focus for navigation. */
207
+ IsOutsideModal(control: SkiaControl): boolean;
208
+ /** Frame end, only while some control is flagged modal or one was active: follows the top modal. */
209
+ private UpdateActiveModal;
210
+ /** The Tab stop after (or before) `from` in reading order; inside a KeyboardScope it goes round, never leaving. */
211
+ NextTabStop(from: SkiaControl | undefined, forward: boolean): SkiaControl | undefined;
212
+ /**
213
+ * Tab and Shift+Tab through a templated list whose cells are made on demand (DrawnUi.Net ac70a1d9): from a cell the
214
+ * keyboard goes to the next (previous) item, scrolled in and focused once drawn, unless the next stop is in the same
215
+ * cell; at the list's end it leaves the list. Entering the list it goes to its first (last) item. The overlay's DOM order
216
+ * lags the cells made while the list scrolls, so inside a list the browser's own Tab order is not used. True when it
217
+ * took the key.
218
+ */
219
+ TabThroughList(from: SkiaControl, forward: boolean): boolean;
220
+ /**
221
+ * A popup window just opened: at the end of the frame that draws it, the keyboard goes to its arrow-key group's current
222
+ * choice (a checked radio, menuitemradio, option or tab), else to its first interactive item, however it was opened.
223
+ */
224
+ FocusOpenedPopup(root: SkiaControl): void;
225
+ private ProcessFocusRequests;
226
+ /** Frame end: focus the requested item once it is drawn, skipping items that cannot take input. */
227
+ private ProcessGroupFocus;
228
+ private FocusFromKeyboard;
229
+ private Focus;
93
230
  Register(node: SkiaControl): void;
94
231
  NotifyUpdated(node: SkiaControl): void;
232
+ /** What the last snapshot says for each live region, to rebuild on the next frame when that changes. */
233
+ private readonly liveSaid;
234
+ private LiveChanged;
95
235
  ForceRebuildOnNextFrame(): void;
236
+ /** The scrolls moving the keyboard's control into view, and when each was asked (FollowScroll). */
237
+ private readonly following;
238
+ /**
239
+ * Scrolls are bringing the keyboard's control into view: every frame they draw rebuilds the overlay until each has
240
+ * stopped, so the overlay's rects are where the controls are and the controls they bring near are there for the next
241
+ * Tab (the timed rebuild could come a second later, and Tab would fall out of the canvas).
242
+ */
243
+ FollowScroll(scrolls: {
244
+ IsScrolling: boolean;
245
+ }[]): void;
96
246
  Unregister(node: SkiaControl): void;
97
247
  UnregisterSubtree(root: SkiaControl): void;
98
248
  /**
@@ -100,5 +250,6 @@ export declare class SkiaAccessibilityManager {
100
250
  * per MinUpdateIntervalMs otherwise (keeps rects in sync with scrolling); notifies only when the snapshot differs.
101
251
  */
102
252
  OnFrameEnd(scale: number, canvasWidthPx: number, canvasHeightPx: number, requestFrame: () => void): void;
253
+ private Rebuild;
103
254
  private static Same;
104
255
  }