@egret/runtime 0.0.0-stage → 7.0.2

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 (157) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +70 -2
  4. package/README.zh-CN.md +71 -0
  5. package/dist/AssetLease.d.ts +23 -0
  6. package/dist/AssetLease.js +69 -0
  7. package/dist/AssetManager.d.ts +58 -0
  8. package/dist/AssetManager.js +451 -0
  9. package/dist/AssetRef.d.ts +21 -0
  10. package/dist/AssetRef.js +33 -0
  11. package/dist/Bitmap.d.ts +40 -0
  12. package/dist/Bitmap.js +545 -0
  13. package/dist/ByteReader.d.ts +32 -0
  14. package/dist/ByteReader.js +178 -0
  15. package/dist/ByteWriter.d.ts +30 -0
  16. package/dist/ByteWriter.js +181 -0
  17. package/dist/CancellationController.d.ts +10 -0
  18. package/dist/CancellationController.js +66 -0
  19. package/dist/DisplayObject.d.ts +97 -0
  20. package/dist/DisplayObject.js +366 -0
  21. package/dist/DisplayObjectContainer.d.ts +28 -0
  22. package/dist/DisplayObjectContainer.js +226 -0
  23. package/dist/EgretError.d.ts +12 -0
  24. package/dist/EgretError.js +36 -0
  25. package/dist/Event.d.ts +47 -0
  26. package/dist/Event.js +84 -0
  27. package/dist/EventDispatcher.d.ts +24 -0
  28. package/dist/EventDispatcher.js +178 -0
  29. package/dist/Graphics.d.ts +117 -0
  30. package/dist/Graphics.js +548 -0
  31. package/dist/Mesh2D.d.ts +27 -0
  32. package/dist/Mesh2D.js +200 -0
  33. package/dist/NineSliceBitmap.d.ts +24 -0
  34. package/dist/NineSliceBitmap.js +164 -0
  35. package/dist/NineSliceGeometry2D.d.ts +19 -0
  36. package/dist/NineSliceGeometry2D.js +126 -0
  37. package/dist/Scope.d.ts +19 -0
  38. package/dist/Scope.js +133 -0
  39. package/dist/SequencePlayer.d.ts +12 -0
  40. package/dist/SequencePlayer.js +69 -0
  41. package/dist/Sprite.d.ts +8 -0
  42. package/dist/Sprite.js +12 -0
  43. package/dist/Stage.d.ts +14 -0
  44. package/dist/Stage.js +31 -0
  45. package/dist/Texture.d.ts +30 -0
  46. package/dist/Texture.js +178 -0
  47. package/dist/assetManagerOwnerState.d.ts +36 -0
  48. package/dist/assetManagerOwnerState.js +115 -0
  49. package/dist/assetState.d.ts +45 -0
  50. package/dist/assetState.js +2 -0
  51. package/dist/atlasFrameLayout.d.ts +21 -0
  52. package/dist/atlasFrameLayout.js +48 -0
  53. package/dist/bitmapDisplayState.d.ts +24 -0
  54. package/dist/bitmapDisplayState.js +22 -0
  55. package/dist/coordinateInverse.d.ts +4 -0
  56. package/dist/coordinateInverse.js +107 -0
  57. package/dist/diagnostics.d.ts +4 -0
  58. package/dist/diagnostics.js +13 -0
  59. package/dist/displayBounds.d.ts +9 -0
  60. package/dist/displayBounds.js +181 -0
  61. package/dist/displayCoordinates.d.ts +8 -0
  62. package/dist/displayCoordinates.js +81 -0
  63. package/dist/displayHitState.d.ts +18 -0
  64. package/dist/displayHitState.js +97 -0
  65. package/dist/displayHitTest.d.ts +8 -0
  66. package/dist/displayHitTest.js +219 -0
  67. package/dist/displayInputOperations.d.ts +12 -0
  68. package/dist/displayInputOperations.js +71 -0
  69. package/dist/displayTransform.d.ts +5 -0
  70. package/dist/displayTransform.js +38 -0
  71. package/dist/displayTreeState.d.ts +90 -0
  72. package/dist/displayTreeState.js +450 -0
  73. package/dist/displayVisualState.d.ts +76 -0
  74. package/dist/displayVisualState.js +141 -0
  75. package/dist/errorHelp.d.ts +15 -0
  76. package/dist/errorHelp.js +435 -0
  77. package/dist/errorHelpZh.d.ts +5 -0
  78. package/dist/errorHelpZh.js +342 -0
  79. package/dist/geometry.d.ts +173 -0
  80. package/dist/geometry.js +311 -0
  81. package/dist/graphicsFill.d.ts +37 -0
  82. package/dist/graphicsFill.js +302 -0
  83. package/dist/graphicsShape.d.ts +170 -0
  84. package/dist/graphicsShape.js +961 -0
  85. package/dist/index.d.ts +53 -0
  86. package/dist/index.js +31 -0
  87. package/dist/input/PointerRouter.d.ts +4 -0
  88. package/dist/input/PointerRouter.js +453 -0
  89. package/dist/input/index.d.ts +3 -0
  90. package/dist/input/index.js +3 -0
  91. package/dist/input/types.d.ts +64 -0
  92. package/dist/input/types.js +3 -0
  93. package/dist/meshCaptureSnapshot.d.ts +5 -0
  94. package/dist/meshCaptureSnapshot.js +13 -0
  95. package/dist/meshDisplayState.d.ts +18 -0
  96. package/dist/meshDisplayState.js +21 -0
  97. package/dist/ownership.d.ts +75 -0
  98. package/dist/ownership.js +157 -0
  99. package/dist/paragraph/Paragraph.d.ts +13 -0
  100. package/dist/paragraph/Paragraph.js +193 -0
  101. package/dist/paragraph/ParagraphCache.d.ts +5 -0
  102. package/dist/paragraph/ParagraphCache.js +354 -0
  103. package/dist/paragraph/geometry.d.ts +4 -0
  104. package/dist/paragraph/geometry.js +180 -0
  105. package/dist/paragraph/index.d.ts +3 -0
  106. package/dist/paragraph/index.js +3 -0
  107. package/dist/paragraph/request.d.ts +6 -0
  108. package/dist/paragraph/request.js +191 -0
  109. package/dist/paragraph/types.d.ts +183 -0
  110. package/dist/paragraph/types.js +2 -0
  111. package/dist/preparedDisplaySubtree.d.ts +7 -0
  112. package/dist/preparedDisplaySubtree.js +205 -0
  113. package/dist/renderEffect.d.ts +57 -0
  114. package/dist/renderEffect.js +109 -0
  115. package/dist/sequenceClip.d.ts +48 -0
  116. package/dist/sequenceClip.js +197 -0
  117. package/dist/sharedFrameCapture.d.ts +24 -0
  118. package/dist/sharedFrameCapture.js +1128 -0
  119. package/dist/spriteSheet.d.ts +34 -0
  120. package/dist/spriteSheet.js +321 -0
  121. package/dist/srgbBytes.d.ts +3 -0
  122. package/dist/srgbBytes.js +64 -0
  123. package/dist/text/TextField.d.ts +13 -0
  124. package/dist/text/TextField.js +261 -0
  125. package/dist/text/TextRasterCache.d.ts +5 -0
  126. package/dist/text/TextRasterCache.js +1191 -0
  127. package/dist/text/budget.d.ts +51 -0
  128. package/dist/text/budget.js +116 -0
  129. package/dist/text/index.d.ts +4 -0
  130. package/dist/text/index.js +3 -0
  131. package/dist/text/plan.d.ts +16 -0
  132. package/dist/text/plan.js +238 -0
  133. package/dist/text/request.d.ts +44 -0
  134. package/dist/text/request.js +303 -0
  135. package/dist/text/types.d.ts +179 -0
  136. package/dist/text/types.js +2 -0
  137. package/dist/textDisplayState.d.ts +21 -0
  138. package/dist/textDisplayState.js +27 -0
  139. package/dist/ui/displayCommit.d.ts +43 -0
  140. package/dist/ui/displayCommit.js +384 -0
  141. package/dist/ui/editing.d.ts +3 -0
  142. package/dist/ui/editing.js +3 -0
  143. package/dist/ui/heightIndex.d.ts +35 -0
  144. package/dist/ui/heightIndex.js +295 -0
  145. package/dist/ui/index.d.ts +6 -0
  146. package/dist/ui/index.js +6 -0
  147. package/dist/ui/layout.d.ts +9 -0
  148. package/dist/ui/layout.js +349 -0
  149. package/dist/ui/managedState.d.ts +12 -0
  150. package/dist/ui/managedState.js +44 -0
  151. package/dist/ui/textEditState.d.ts +4 -0
  152. package/dist/ui/textEditState.js +206 -0
  153. package/dist/ui/textEditTypes.d.ts +48 -0
  154. package/dist/ui/textEditTypes.js +2 -0
  155. package/dist/ui/types.d.ts +99 -0
  156. package/dist/ui/types.js +2 -0
  157. package/package.json +44 -4
@@ -0,0 +1,53 @@
1
+ export { CancellationController } from "./CancellationController.js";
2
+ export { EgretError } from "./EgretError.js";
3
+ export { describeErrorCode, setErrorLanguage, getErrorLanguage } from "./errorHelp.js";
4
+ export type { ErrorLanguage } from "./errorHelp.js";
5
+ export type { EgretErrorOptions } from "./EgretError.js";
6
+ export { Scope, createScope } from "./Scope.js";
7
+ export type { ScopeState } from "./Scope.js";
8
+ export { Event, createEventType } from "./Event.js";
9
+ export type { EventType, EventTypeOptions, EventPhase } from "./Event.js";
10
+ export { EventDispatcher } from "./EventDispatcher.js";
11
+ export type { EventListenerOptions } from "./EventDispatcher.js";
12
+ export { DisplayObject } from "./DisplayObject.js";
13
+ export type { CoordinateQueryOptions } from "./displayCoordinates.js";
14
+ export type { BoundsQueryOptions } from "./displayBounds.js";
15
+ export type { HitTestOptions } from "./displayHitTest.js";
16
+ export { DisplayObjectContainer } from "./DisplayObjectContainer.js";
17
+ export { Stage, createStage } from "./Stage.js";
18
+ export type { EngineContext } from "./ownership.js";
19
+ export { reportDiagnostic } from "./diagnostics.js";
20
+ export { AssetManager, createAssetManager } from "./AssetManager.js";
21
+ export type { AssetProvider, AssetAcquireOptions, AssetLoadContext } from "./AssetManager.js";
22
+ export type { AssetGroupOperations } from "./assetManagerOwnerState.js";
23
+ export { AssetLease } from "./AssetLease.js";
24
+ export { createAssetType, createAssetRef } from "./AssetRef.js";
25
+ export type { AssetType, AssetRef } from "./AssetRef.js";
26
+ export { Sprite } from "./Sprite.js";
27
+ export { Sprite as Shape } from "./Sprite.js";
28
+ export { Point, Rectangle, Matrix } from "./geometry.js";
29
+ export type { RectangleLike, MatrixLike } from "./geometry.js";
30
+ export { Graphics } from "./Graphics.js";
31
+ export type { LineStyleOptions, GradientColorStop, GradientBoxMatrix } from "./Graphics.js";
32
+ export { collectSharedFrameContent } from "./sharedFrameCapture.js";
33
+ export type { CapturedSharedContent2D } from "./sharedFrameCapture.js";
34
+ export { Texture, createTexture, createTextureView, isTexture } from "./Texture.js";
35
+ export { Bitmap } from "./Bitmap.js";
36
+ export { Mesh2D } from "./Mesh2D.js";
37
+ export { createSequenceClip } from "./sequenceClip.js";
38
+ export type { SequenceFrameInput, SequenceClipInput, SequenceClip, SequenceRegion, SequenceSample, SequencePlaybackMode } from "./sequenceClip.js";
39
+ export { SequencePlayer } from "./SequencePlayer.js";
40
+ export { ByteReader, BYTE_READER_LIMITS } from "./ByteReader.js";
41
+ export type { ByteOrder } from "./ByteReader.js";
42
+ export { createDisplayInputOperations } from "./displayInputOperations.js";
43
+ export type { DisplayInputOperations } from "./displayInputOperations.js";
44
+ export { ByteWriter, BYTE_WRITER_LIMITS } from "./ByteWriter.js";
45
+ export { createNineSliceGeometry2D } from "./NineSliceGeometry2D.js";
46
+ export type { NineSliceInsets2D, NineSliceGeometry2DOptions } from "./NineSliceGeometry2D.js";
47
+ export { NineSliceBitmap } from "./NineSliceBitmap.js";
48
+ export type { NineSliceBitmapOptions } from "./NineSliceBitmap.js";
49
+ export { createSpriteSheet } from "./spriteSheet.js";
50
+ export type { SpriteSheet, SpriteSheetFrameInput } from "./spriteSheet.js";
51
+ export type { AtlasFrameLayout } from "./atlasFrameLayout.js";
52
+ export type { RenderEffect2D, RenderGlow2D, RenderOutline2D } from "./renderEffect.js";
53
+ //# sourceMappingURL=index.d.ts.map
package/dist/index.js ADDED
@@ -0,0 +1,31 @@
1
+ export { CancellationController } from "./CancellationController.js";
2
+ export { EgretError } from "./EgretError.js";
3
+ export { describeErrorCode, setErrorLanguage, getErrorLanguage } from "./errorHelp.js";
4
+ export { Scope, createScope } from "./Scope.js";
5
+ export { Event, createEventType } from "./Event.js";
6
+ export { EventDispatcher } from "./EventDispatcher.js";
7
+ export { DisplayObject } from "./DisplayObject.js";
8
+ export { DisplayObjectContainer } from "./DisplayObjectContainer.js";
9
+ export { Stage, createStage } from "./Stage.js";
10
+ export { reportDiagnostic } from "./diagnostics.js";
11
+ export { AssetManager, createAssetManager } from "./AssetManager.js";
12
+ export { AssetLease } from "./AssetLease.js";
13
+ export { createAssetType, createAssetRef } from "./AssetRef.js";
14
+ export { Sprite } from "./Sprite.js";
15
+ // Egret 5's Shape is a Sprite here: it has graphics, and may hold children too.
16
+ export { Sprite as Shape } from "./Sprite.js";
17
+ export { Point, Rectangle, Matrix } from "./geometry.js";
18
+ export { Graphics } from "./Graphics.js";
19
+ export { collectSharedFrameContent } from "./sharedFrameCapture.js";
20
+ export { Texture, createTexture, createTextureView, isTexture } from "./Texture.js";
21
+ export { Bitmap } from "./Bitmap.js";
22
+ export { Mesh2D } from "./Mesh2D.js";
23
+ export { createSequenceClip } from "./sequenceClip.js";
24
+ export { SequencePlayer } from "./SequencePlayer.js";
25
+ export { ByteReader, BYTE_READER_LIMITS } from "./ByteReader.js";
26
+ export { createDisplayInputOperations } from "./displayInputOperations.js";
27
+ export { ByteWriter, BYTE_WRITER_LIMITS } from "./ByteWriter.js";
28
+ export { createNineSliceGeometry2D } from "./NineSliceGeometry2D.js";
29
+ export { NineSliceBitmap } from "./NineSliceBitmap.js";
30
+ export { createSpriteSheet } from "./spriteSheet.js";
31
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,4 @@
1
+ import type { PointerRouter, PointerRouterOptions } from "./types.js";
2
+ /** Independent simultaneous contacts, with no host access or retained event history. */
3
+ export declare function createPointerRouter<T extends object>(options: PointerRouterOptions<T>): PointerRouter<T>;
4
+ //# sourceMappingURL=PointerRouter.d.ts.map
@@ -0,0 +1,453 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from "../EgretError.js";
3
+ let nextGeneration = 1;
4
+ const reasons = Object.freeze([
5
+ "pointercancel",
6
+ "lostcapture",
7
+ "blur",
8
+ "hidden",
9
+ "pagehide",
10
+ "viewport",
11
+ "owner",
12
+ "suspended",
13
+ "dispose",
14
+ "error"
15
+ ]);
16
+ function finite(value) {
17
+ return typeof value === "number" && Number.isFinite(value);
18
+ }
19
+ function safeNonnegative(value) {
20
+ return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
21
+ }
22
+ function object(value) {
23
+ return value !== null && typeof value === "object";
24
+ }
25
+ function checkReason(reason) {
26
+ if (!reasons.includes(reason))
27
+ throw new EgretError("POINTER_INPUT_REASON");
28
+ }
29
+ /** Copy and validate every scalar before the caller publishes an observation. */
30
+ function copyUpdate(input, observedTime) {
31
+ try {
32
+ if (!object(input))
33
+ throw new EgretError("POINTER_INPUT_SAMPLE");
34
+ const { globalX, globalY, buttons, timestamp, pressure, width, height } = input;
35
+ if (!finite(globalX) ||
36
+ !finite(globalY) ||
37
+ !safeNonnegative(buttons) ||
38
+ buttons > 65535 ||
39
+ !finite(timestamp) ||
40
+ timestamp < 0 ||
41
+ timestamp < observedTime ||
42
+ (pressure !== undefined && (!finite(pressure) || pressure < 0 || pressure > 1)) ||
43
+ (width !== undefined && (!finite(width) || width < 0)) ||
44
+ (height !== undefined && (!finite(height) || height < 0)))
45
+ throw new EgretError("POINTER_INPUT_SAMPLE");
46
+ return Object.freeze({
47
+ globalX,
48
+ globalY,
49
+ buttons,
50
+ timestamp,
51
+ ...(pressure === undefined ? {} : { pressure }),
52
+ ...(width === undefined ? {} : { width }),
53
+ ...(height === undefined ? {} : { height })
54
+ });
55
+ }
56
+ catch (cause) {
57
+ if (cause instanceof EgretError && cause.code === "POINTER_INPUT_SAMPLE")
58
+ throw cause;
59
+ throw new EgretError("POINTER_INPUT_SAMPLE", { cause });
60
+ }
61
+ }
62
+ /** Independent simultaneous contacts, with no host access or retained event history. */
63
+ export function createPointerRouter(options) {
64
+ if (!object(options))
65
+ throw new EgretError("POINTER_INPUT_OPTIONS");
66
+ const { capacity = 10, viewportRevision = 0, pick, eligible, dispatch } = options;
67
+ if (!Number.isInteger(capacity) ||
68
+ capacity < 5 ||
69
+ capacity > 32 ||
70
+ !safeNonnegative(viewportRevision) ||
71
+ typeof pick !== "function" ||
72
+ typeof eligible !== "function" ||
73
+ typeof dispatch !== "function") {
74
+ throw new EgretError("POINTER_INPUT_OPTIONS");
75
+ }
76
+ if (!Number.isSafeInteger(nextGeneration))
77
+ throw new EgretError("POINTER_INPUT_EXHAUSTED");
78
+ const generation = nextGeneration++;
79
+ let ports = { pick, eligible, dispatch };
80
+ const entries = new Map();
81
+ const hostIds = new Map();
82
+ const checking = new Set();
83
+ let state = "active";
84
+ let revision = viewportRevision;
85
+ let observedTime = 0;
86
+ let nextId = 1;
87
+ let sequence = 0;
88
+ let operationDepth = 0;
89
+ let cancellingDepth = 0;
90
+ let changingViewport = false;
91
+ let syncing = false;
92
+ let failure;
93
+ function run(action) {
94
+ operationDepth++;
95
+ try {
96
+ return action();
97
+ }
98
+ finally {
99
+ operationDepth--;
100
+ if (operationDepth === 0)
101
+ failure = undefined;
102
+ }
103
+ }
104
+ function sampleOperation(action) {
105
+ if (operationDepth !== 0)
106
+ throw new EgretError("POINTER_INPUT_REENTRANT");
107
+ return run(action);
108
+ }
109
+ function alive(entry) {
110
+ return entries.get(entry.session) === entry;
111
+ }
112
+ function closed() {
113
+ return state === "closed";
114
+ }
115
+ function snapshot(session, update) {
116
+ if (!Number.isSafeInteger(sequence + 1))
117
+ throw new EgretError("POINTER_INPUT_EXHAUSTED");
118
+ return Object.freeze({ ...update, session, sequence: ++sequence, viewportRevision: revision });
119
+ }
120
+ function remove(entry) {
121
+ entries.delete(entry.session);
122
+ hostIds.delete(entry.session.pointerId);
123
+ }
124
+ // Publish closure and remove the complete active set before any cleanup callback.
125
+ // Raw calls here keep the original error separate from later cleanup failures.
126
+ function fail(cause) {
127
+ if (failure !== undefined)
128
+ throw failure;
129
+ state = "closed";
130
+ const pending = [...entries.values()];
131
+ const cleanupEligible = ports?.eligible;
132
+ const cleanupDispatch = ports?.dispatch;
133
+ entries.clear();
134
+ hostIds.clear();
135
+ const cleanupErrors = [];
136
+ for (const entry of pending) {
137
+ let target = entry.captured ? entry.captureTarget : entry.lastTarget;
138
+ const targets = new Set([entry.owner, target]);
139
+ for (const candidate of targets) {
140
+ if (candidate === undefined)
141
+ continue;
142
+ try {
143
+ if (!cleanupEligible?.(candidate))
144
+ target = undefined;
145
+ }
146
+ catch (error) {
147
+ target = undefined;
148
+ cleanupErrors.push(error);
149
+ }
150
+ }
151
+ try {
152
+ const contact = snapshot(entry.session, entry.contact);
153
+ cleanupDispatch?.("cancel", contact, target, "error");
154
+ }
155
+ catch (error) {
156
+ cleanupErrors.push(error);
157
+ }
158
+ }
159
+ ports = undefined;
160
+ checking.clear();
161
+ failure = new EgretError("POINTER_INPUT_CALLBACK_FAILED", { cause, cleanupErrors });
162
+ throw failure;
163
+ }
164
+ function invoke(action) {
165
+ try {
166
+ const result = action();
167
+ if (failure !== undefined)
168
+ throw failure;
169
+ return result;
170
+ }
171
+ catch (cause) {
172
+ return fail(cause);
173
+ }
174
+ }
175
+ function isEligible(target) {
176
+ // A nested cancel may consult the same target while its eligibility port runs.
177
+ // Let that terminal operation finish; its exact session check wins afterward.
178
+ if (checking.has(target))
179
+ return true;
180
+ checking.add(target);
181
+ const callback = ports?.eligible;
182
+ try {
183
+ return invoke(() => callback?.(target) ?? false);
184
+ }
185
+ finally {
186
+ checking.delete(target);
187
+ }
188
+ }
189
+ function valid(entry) {
190
+ const targets = new Set([entry.owner, entry.captured ? entry.captureTarget : entry.lastTarget]);
191
+ for (const target of targets) {
192
+ if (target !== undefined && !isEligible(target))
193
+ return false;
194
+ if (!alive(entry))
195
+ return false;
196
+ }
197
+ return alive(entry);
198
+ }
199
+ function deliver(kind, contact, target, reason) {
200
+ const callback = ports?.dispatch;
201
+ invoke(() => callback?.(kind, contact, target, reason));
202
+ synchronize();
203
+ }
204
+ function cancelEntry(entry, reason) {
205
+ if (!alive(entry))
206
+ return false;
207
+ const target = valid(entry) ? (entry.captured ? entry.captureTarget : entry.lastTarget) : undefined;
208
+ if (!alive(entry))
209
+ return false;
210
+ const contact = snapshot(entry.session, entry.contact);
211
+ remove(entry);
212
+ deliver("cancel", contact, target, reason);
213
+ return true;
214
+ }
215
+ function synchronize() {
216
+ if (syncing || state === "closed")
217
+ return;
218
+ syncing = true;
219
+ try {
220
+ // Each restarted pass follows a removal. No new sample is admitted during it.
221
+ let removed;
222
+ do {
223
+ removed = false;
224
+ for (const entry of entries.values()) {
225
+ if (!valid(entry) && alive(entry)) {
226
+ cancelEntry(entry, "owner");
227
+ removed = true;
228
+ break;
229
+ }
230
+ }
231
+ } while (removed && !closed());
232
+ }
233
+ finally {
234
+ syncing = false;
235
+ }
236
+ }
237
+ function cancelEvery(reason) {
238
+ cancellingDepth++;
239
+ try {
240
+ for (const entry of [...entries.values()])
241
+ cancelEntry(entry, reason);
242
+ }
243
+ finally {
244
+ cancellingDepth--;
245
+ }
246
+ }
247
+ function route(entry, update) {
248
+ if (entry.captured)
249
+ return entry.captureTarget;
250
+ const callback = ports?.pick;
251
+ const target = invoke(() => callback?.(update.globalX, update.globalY));
252
+ return target === undefined || !isEligible(target) ? undefined : target;
253
+ }
254
+ function updateContact(kind, session, input) {
255
+ return sampleOperation(() => {
256
+ const entry = entries.get(session);
257
+ if (entry === undefined || state !== "active")
258
+ return false;
259
+ const copied = copyUpdate(input, observedTime);
260
+ synchronize();
261
+ if (!alive(entry) || state !== "active")
262
+ return false;
263
+ const target = route(entry, copied);
264
+ if (!alive(entry) || state !== "active")
265
+ return false;
266
+ if (!valid(entry)) {
267
+ cancelEntry(entry, "owner");
268
+ return false;
269
+ }
270
+ const contact = snapshot(session, copied);
271
+ observedTime = copied.timestamp;
272
+ entry.contact = contact;
273
+ entry.lastTarget = target;
274
+ if (kind === "end")
275
+ remove(entry);
276
+ deliver(kind, contact, target);
277
+ return true;
278
+ });
279
+ }
280
+ return Object.freeze({
281
+ get state() {
282
+ return state;
283
+ },
284
+ get contacts() {
285
+ return Object.freeze([...entries.values()].map(entry => entry.contact));
286
+ },
287
+ get viewportRevision() {
288
+ return revision;
289
+ },
290
+ begin(input) {
291
+ return sampleOperation(() => {
292
+ if (state !== "active")
293
+ return undefined;
294
+ const copied = copyUpdate(input, observedTime);
295
+ let pointerId, pointerType;
296
+ try {
297
+ ({ pointerId, pointerType } = input);
298
+ }
299
+ catch (cause) {
300
+ throw new EgretError("POINTER_INPUT_SAMPLE", { cause });
301
+ }
302
+ if (!safeNonnegative(pointerId) || !["mouse", "touch", "pen"].includes(pointerType))
303
+ throw new EgretError("POINTER_INPUT_SAMPLE");
304
+ if (hostIds.has(pointerId))
305
+ throw new EgretError("POINTER_INPUT_DUPLICATE");
306
+ if (entries.size >= capacity)
307
+ throw new EgretError("POINTER_INPUT_CAPACITY");
308
+ if (!Number.isSafeInteger(nextId))
309
+ throw new EgretError("POINTER_INPUT_EXHAUSTED");
310
+ synchronize();
311
+ if (state !== "active")
312
+ return undefined;
313
+ const callback = ports?.pick;
314
+ const picked = invoke(() => callback?.(copied.globalX, copied.globalY));
315
+ const owner = picked === undefined || !isEligible(picked) ? undefined : picked;
316
+ if (state !== "active")
317
+ return undefined;
318
+ const session = Object.freeze({ generation, id: nextId++, pointerId, pointerType });
319
+ const contact = snapshot(session, copied);
320
+ const entry = {
321
+ session,
322
+ contact,
323
+ owner,
324
+ captured: owner !== undefined,
325
+ captureTarget: owner,
326
+ lastTarget: owner
327
+ };
328
+ entries.set(session, entry);
329
+ hostIds.set(pointerId, session);
330
+ observedTime = copied.timestamp;
331
+ deliver("begin", contact, owner);
332
+ return alive(entry) ? session : undefined;
333
+ });
334
+ },
335
+ move(session, update) {
336
+ return updateContact("move", session, update);
337
+ },
338
+ end(session, update) {
339
+ return updateContact("end", session, update);
340
+ },
341
+ cancel(session, reason) {
342
+ return run(() => {
343
+ const entry = entries.get(session);
344
+ if (entry === undefined)
345
+ return false;
346
+ checkReason(reason);
347
+ return cancelEntry(entry, reason);
348
+ });
349
+ },
350
+ cancelAll(reason) {
351
+ run(() => {
352
+ checkReason(reason);
353
+ cancelEvery(reason);
354
+ });
355
+ },
356
+ capture(session, target) {
357
+ return run(() => {
358
+ const entry = entries.get(session);
359
+ if (entry === undefined || state !== "active")
360
+ return false;
361
+ if (!object(target))
362
+ return false;
363
+ if (!isEligible(target)) {
364
+ synchronize();
365
+ return false;
366
+ }
367
+ if (!valid(entry)) {
368
+ cancelEntry(entry, "owner");
369
+ return false;
370
+ }
371
+ if (!alive(entry) || state !== "active")
372
+ return false;
373
+ entry.captured = true;
374
+ entry.captureTarget = target;
375
+ entry.lastTarget = target;
376
+ synchronize();
377
+ return alive(entry) && state === "active";
378
+ });
379
+ },
380
+ releaseCapture(session) {
381
+ return run(() => {
382
+ const entry = entries.get(session);
383
+ if (entry === undefined || state !== "active")
384
+ return false;
385
+ if (!valid(entry)) {
386
+ cancelEntry(entry, "owner");
387
+ return false;
388
+ }
389
+ if (!alive(entry) || state !== "active")
390
+ return false;
391
+ entry.captured = false;
392
+ entry.captureTarget = undefined;
393
+ synchronize();
394
+ return alive(entry) && state === "active";
395
+ });
396
+ },
397
+ sync() {
398
+ run(synchronize);
399
+ },
400
+ setViewportRevision(next) {
401
+ run(() => {
402
+ if (!safeNonnegative(next) || next <= revision)
403
+ throw new EgretError("POINTER_INPUT_VIEWPORT");
404
+ if (state === "closed")
405
+ return;
406
+ if (changingViewport)
407
+ throw new EgretError("POINTER_INPUT_REENTRANT");
408
+ changingViewport = true;
409
+ try {
410
+ cancelEvery("viewport");
411
+ if (!closed())
412
+ revision = next;
413
+ }
414
+ finally {
415
+ changingViewport = false;
416
+ }
417
+ });
418
+ },
419
+ setInteractive(interactive) {
420
+ run(() => {
421
+ if (typeof interactive !== "boolean")
422
+ throw new EgretError("POINTER_INPUT_OPTIONS");
423
+ if (state === "closed")
424
+ return;
425
+ if (interactive) {
426
+ if (cancellingDepth === 0)
427
+ state = "active";
428
+ }
429
+ else {
430
+ state = "suspended";
431
+ cancelEvery("suspended");
432
+ }
433
+ });
434
+ },
435
+ dispose() {
436
+ run(() => {
437
+ if (state === "closed")
438
+ return;
439
+ state = "closed";
440
+ try {
441
+ cancelEvery("dispose");
442
+ }
443
+ finally {
444
+ ports = undefined;
445
+ entries.clear();
446
+ hostIds.clear();
447
+ checking.clear();
448
+ }
449
+ });
450
+ }
451
+ });
452
+ }
453
+ //# sourceMappingURL=PointerRouter.js.map
@@ -0,0 +1,3 @@
1
+ export { createPointerRouter } from "./PointerRouter.js";
2
+ export type { PointerType, PointerEventKind, PointerRouterState, PointerCancelReason, PointerSession, PointerSample, PointerUpdate, PointerContact, PointerRouterOptions, PointerRouter } from "./types.js";
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,3 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ export { createPointerRouter } from "./PointerRouter.js";
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,64 @@
1
+ /** What made a pointer: a mouse, a finger or a pen. */
2
+ export type PointerType = "mouse" | "touch" | "pen";
3
+ /** What happened to a pointer: it went down, moved, went up or was cancelled. */
4
+ export type PointerEventKind = "begin" | "move" | "end" | "cancel";
5
+ /** Whether a pointer router passes input on, holds it, or has closed. */
6
+ export type PointerRouterState = "active" | "suspended" | "closed";
7
+ /** Why a pointer was cancelled. */
8
+ export type PointerCancelReason = "pointercancel" | "lostcapture" | "blur" | "hidden" | "pagehide" | "viewport" | "owner" | "suspended" | "dispose" | "error";
9
+ declare const sessionIdentity: unique symbol;
10
+ /** Only the creating router admits this frozen identity; host IDs may be reused. */
11
+ export interface PointerSession {
12
+ readonly [sessionIdentity]: true;
13
+ readonly generation: number;
14
+ readonly id: number;
15
+ readonly pointerId: number;
16
+ readonly pointerType: PointerType;
17
+ }
18
+ /** Where a pointer is on the stage, which buttons it holds, and when, with its pressure and size where the device gives them. */
19
+ export interface PointerUpdate {
20
+ readonly globalX: number;
21
+ readonly globalY: number;
22
+ readonly buttons: number;
23
+ readonly timestamp: number;
24
+ readonly pressure?: number;
25
+ readonly width?: number;
26
+ readonly height?: number;
27
+ }
28
+ /** One pointer's state at one moment: which pointer it is, what made it and where it is. */
29
+ export interface PointerSample extends PointerUpdate {
30
+ readonly pointerId: number;
31
+ readonly pointerType: PointerType;
32
+ }
33
+ /** A retained value: sequence orders all contacts on this router. */
34
+ export interface PointerContact extends PointerUpdate {
35
+ readonly session: PointerSession;
36
+ readonly sequence: number;
37
+ readonly viewportRevision: number;
38
+ }
39
+ export interface PointerRouterOptions<T extends object> {
40
+ readonly capacity?: number;
41
+ readonly viewportRevision?: number;
42
+ readonly pick: (globalX: number, globalY: number) => T | undefined;
43
+ readonly eligible: (target: T) => boolean;
44
+ readonly dispatch: (kind: PointerEventKind, contact: PointerContact, target: T | undefined, reason?: PointerCancelReason) => void;
45
+ }
46
+ /** DOM-free routing kernel; the owner supplies picking and eligibility authority. */
47
+ export interface PointerRouter<T extends object> {
48
+ readonly state: PointerRouterState;
49
+ readonly contacts: readonly PointerContact[];
50
+ readonly viewportRevision: number;
51
+ begin(sample: PointerSample): PointerSession | undefined;
52
+ move(session: PointerSession, update: PointerUpdate): boolean;
53
+ end(session: PointerSession, update: PointerUpdate): boolean;
54
+ cancel(session: PointerSession, reason: PointerCancelReason): boolean;
55
+ cancelAll(reason: PointerCancelReason): void;
56
+ capture(session: PointerSession, target: T): boolean;
57
+ releaseCapture(session: PointerSession): boolean;
58
+ sync(): void;
59
+ setViewportRevision(revision: number): void;
60
+ setInteractive(interactive: boolean): void;
61
+ dispose(): void;
62
+ }
63
+ export {};
64
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1,3 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ export {};
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1,5 @@
1
+ import type { TextureSnapshot2D } from './Texture.js';
2
+ import type { MeshCaptureState } from './meshDisplayState.js';
3
+ /** Exact lease entitlement precedes Texture brand and live-image authority. */
4
+ export declare function readMeshCaptureImage(slot: MeshCaptureState): TextureSnapshot2D;
5
+ //# sourceMappingURL=meshCaptureSnapshot.d.ts.map
@@ -0,0 +1,13 @@
1
+ import { isAssetLease, readAssetLeaseValue } from './AssetLease.js';
2
+ import { isTexture, readTextureSnapshot } from './Texture.js';
3
+ import { EgretError } from './EgretError.js';
4
+ /** Exact lease entitlement precedes Texture brand and live-image authority. */
5
+ export function readMeshCaptureImage(slot) {
6
+ if (!isAssetLease(slot.lease))
7
+ throw new EgretError('MESH_LEASE_INVALID');
8
+ const value = readAssetLeaseValue(slot.lease);
9
+ if (!isTexture(value))
10
+ throw new EgretError('MESH_TEXTURE_INVALID');
11
+ return readTextureSnapshot(value);
12
+ }
13
+ //# sourceMappingURL=meshCaptureSnapshot.js.map
@@ -0,0 +1,18 @@
1
+ import type { TexturedGeometry2D, SharedGeometry2D, TextureRegion2D, TextureViewRegion2D } from "@egret/contracts";
2
+ import type { AssetLease } from "./AssetLease.js";
3
+ import type { DisplayObject } from "./DisplayObject.js";
4
+ import type { Texture } from "./Texture.js";
5
+ export interface MeshCaptureState {
6
+ readonly lease: AssetLease<Texture>;
7
+ readonly geometry: TexturedGeometry2D | SharedGeometry2D;
8
+ readonly sourceRect: TextureRegion2D;
9
+ readonly viewRegion: TextureViewRegion2D | null;
10
+ readonly regionOnly: boolean;
11
+ }
12
+ /** Slot registration survives cleanup; it is not display-class identity. */
13
+ export declare function hasMeshState(value: unknown): boolean;
14
+ /** Cached content conveys no active lease entitlement or live Texture authority. */
15
+ export declare function readMeshState(node: DisplayObject): MeshCaptureState | undefined;
16
+ /** Authentic Mesh2D/NineSliceBitmap operations publish only privately admitted content. */
17
+ export declare function writeMeshState(node: DisplayObject, value: MeshCaptureState | undefined): void;
18
+ //# sourceMappingURL=meshDisplayState.d.ts.map