@lingxia/types 0.9.0 → 0.10.0
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.
- package/dist/app/index.d.ts +52 -2
- package/dist/app/index.d.ts.map +1 -1
- package/dist/generated/i18n.d.ts +1 -1
- package/dist/generated/i18n.d.ts.map +1 -1
- package/dist/generated/i18n.js +18 -25
- package/dist/generated/i18n.js.map +1 -1
- package/dist/index.d.ts +191 -17
- package/dist/index.d.ts.map +1 -1
- package/dist/media/index.d.ts +66 -7
- package/dist/media/index.d.ts.map +1 -1
- package/dist/system/index.d.ts +1 -5
- package/dist/system/index.d.ts.map +1 -1
- package/dist/system/index.js +1 -1
- package/dist/transfer/index.d.ts +65 -20
- package/dist/transfer/index.d.ts.map +1 -1
- package/dist/ui/index.d.ts +36 -49
- package/dist/ui/index.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/app/index.ts +57 -2
- package/src/generated/i18n.ts +18 -25
- package/src/index.ts +216 -15
- package/src/media/index.ts +75 -7
- package/src/system/index.ts +1 -6
- package/src/transfer/index.ts +80 -22
- package/src/ui/index.ts +42 -57
package/dist/app/index.d.ts
CHANGED
|
@@ -72,6 +72,21 @@ export interface HostAppUpdateTask extends PromiseLike<HostAppUpdateResult>, Asy
|
|
|
72
72
|
* for cross-app navigation URLs and uses the truncated `develop` form.
|
|
73
73
|
*/
|
|
74
74
|
export type HostAppEnvVersion = 'developer' | 'preview' | 'release';
|
|
75
|
+
export interface AppScreenshotOptions {
|
|
76
|
+
/**
|
|
77
|
+
* Platform-specific window id to capture (desktop only). Omit to let the
|
|
78
|
+
* platform pick: the key/main window on desktop, the sole window on mobile.
|
|
79
|
+
*/
|
|
80
|
+
windowId?: string;
|
|
81
|
+
}
|
|
82
|
+
export interface AppScreenshotResult {
|
|
83
|
+
/** `lx://` URI of the captured PNG in the lxapp temp directory. */
|
|
84
|
+
tempFilePath: string;
|
|
85
|
+
/** Image width in pixels, when the runtime could read it from the PNG. */
|
|
86
|
+
width?: number;
|
|
87
|
+
/** Image height in pixels, when the runtime could read it from the PNG. */
|
|
88
|
+
height?: number;
|
|
89
|
+
}
|
|
75
90
|
export interface HostAppApi {
|
|
76
91
|
/**
|
|
77
92
|
* The environment this build was produced for, mirroring `app.json::envVersion`.
|
|
@@ -110,6 +125,26 @@ export interface HostAppApi {
|
|
|
110
125
|
* only after the user confirms.
|
|
111
126
|
*/
|
|
112
127
|
exit(): void;
|
|
128
|
+
/**
|
|
129
|
+
* Capture the host app's window as a PNG and save it to the lxapp temp
|
|
130
|
+
* directory.
|
|
131
|
+
*
|
|
132
|
+
* App-level semantics — one level above any page/WebView capture: the image
|
|
133
|
+
* is what the user currently sees of the whole app, including host-drawn
|
|
134
|
+
* navigation chrome, native overlays, and every composited WebView. Because
|
|
135
|
+
* that view can include other lxapps' UI, this API is only available to the
|
|
136
|
+
* home lxapp; other lxapps receive a permission error.
|
|
137
|
+
*/
|
|
138
|
+
screenshot(options?: AppScreenshotOptions): Promise<AppScreenshotResult>;
|
|
139
|
+
/**
|
|
140
|
+
* Set the app-icon badge — e.g. an unread count.
|
|
141
|
+
*
|
|
142
|
+
* Cross-platform: the dock (macOS), the taskbar (Windows), and the home /
|
|
143
|
+
* launcher icon (iOS, Android). Pass `null` or an empty string to clear it.
|
|
144
|
+
* On platforms where it is not wired this is a no-op (it never throws), so it
|
|
145
|
+
* is safe to call from portable code.
|
|
146
|
+
*/
|
|
147
|
+
setBadge(value: string | number | null): void;
|
|
113
148
|
}
|
|
114
149
|
export interface AppLifecycleEventArgs {
|
|
115
150
|
source: 'host' | 'lxapp';
|
|
@@ -172,8 +207,23 @@ export interface SurfaceVisibilityEvent {
|
|
|
172
207
|
kind: 'overlay' | 'window';
|
|
173
208
|
source: 'opener' | 'page';
|
|
174
209
|
}
|
|
175
|
-
export interface
|
|
210
|
+
export interface SurfaceHandle {
|
|
176
211
|
readonly id: string;
|
|
212
|
+
/**
|
|
213
|
+
* Show a host-managed surface. Dynamic page/url surfaces return a Promise;
|
|
214
|
+
* host-declared surfaces may complete synchronously.
|
|
215
|
+
*/
|
|
216
|
+
show(): void | Promise<void>;
|
|
217
|
+
/**
|
|
218
|
+
* Hide without destroying user-visible state when the platform supports it.
|
|
219
|
+
*/
|
|
220
|
+
hide(): void | Promise<void>;
|
|
221
|
+
/**
|
|
222
|
+
* Close or hide the surface depending on how it is managed by the host.
|
|
223
|
+
*/
|
|
224
|
+
close(): void | Promise<void>;
|
|
225
|
+
}
|
|
226
|
+
export interface Surface extends SurfaceHandle {
|
|
177
227
|
readonly kind: 'overlay' | 'window';
|
|
178
228
|
/**
|
|
179
229
|
* Last-known visibility, kept in sync with the native side via show/hide
|
|
@@ -233,7 +283,7 @@ export interface PageInstance<TData extends Record<string, unknown> = Record<str
|
|
|
233
283
|
data: TData;
|
|
234
284
|
route: string;
|
|
235
285
|
/**
|
|
236
|
-
* Available when this page was opened
|
|
286
|
+
* Available when this page was opened as a surface via `lx.openSurface(...)`.
|
|
237
287
|
*/
|
|
238
288
|
surface?: Surface;
|
|
239
289
|
/**
|
package/dist/app/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,KAAK,IAAI,iBAAiB,CAAC;CAC5B;AAED,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7D,MAAM,MAAM,wBAAwB,GAChC;IACE,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB,GACD;IACE,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAC1B;IACE,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACD;IACE,KAAK,EAAE,YAAY,GAAG,kBAAkB,CAAC;CAC1C,GACD;IACE,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,uBAAuB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,iBACf,SAAQ,WAAW,CAAC,mBAAmB,CAAC,EACtC,aAAa,CAAC,kBAAkB,CAAC;IACnC,IAAI,IAAI,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC7C,6FAA6F;IAC7F,MAAM,IAAI,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC/C,KAAK,CAAC,OAAO,GAAG,KAAK,EACnB,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GACxE,OAAO,CAAC,mBAAmB,GAAG,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvE,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtC;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IAEvC,WAAW,IAAI,WAAW,CAAC;IAE3B;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAEjD;;;;;;OAMG;IACH,IAAI,IAAI,IAAI,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"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"}
|
package/dist/generated/i18n.d.ts
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
export declare const I18N_KEYS: readonly ["album_add_more_media", "album_add_more_photos", "album_add_more_videos", "album_all_media", "album_all_photos", "album_all_videos", "album_label", "album_original_image", "album_selected", "camera_access_denied", "camera_audio_init_failed", "camera_cancelling", "camera_init_failed", "camera_label", "camera_long_press_to_record", "camera_max_duration_reached", "camera_preparing", "camera_record_video", "camera_release_to_stop", "camera_switch", "camera_switch_failed", "camera_switch_to_back", "camera_switch_to_front", "camera_switching", "camera_tap_to_capture", "
|
|
1
|
+
export declare const I18N_KEYS: readonly ["album_add_more_media", "album_add_more_photos", "album_add_more_videos", "album_all_media", "album_all_photos", "album_all_videos", "album_label", "album_original_image", "album_selected", "camera_access_denied", "camera_audio_init_failed", "camera_cancelling", "camera_init_failed", "camera_label", "camera_long_press_to_record", "camera_max_duration_reached", "camera_preparing", "camera_record_video", "camera_release_to_stop", "camera_switch", "camera_switch_failed", "camera_switch_to_back", "camera_switch_to_front", "camera_switching", "camera_tap_to_capture", "camera_video_input_failed", "camera_video_output_failed", "capsule_clean_cache", "capsule_restart", "capsule_uninstall", "common_back", "common_cancel", "common_close", "common_confirm", "common_delete", "common_done", "common_loading", "common_ok", "common_refresh", "date_last_30_days", "date_last_7_days", "date_last_month", "date_last_week", "date_this_month", "date_this_week", "err_code_1000", "err_code_1001", "err_code_1002", "err_code_1003", "err_code_1004", "err_code_1005", "err_code_12000", "err_code_12001", "err_code_12002", "err_code_12003", "err_code_12004", "err_code_12005", "err_code_12006", "err_code_12007", "err_code_12008", "err_code_12009", "err_code_12010", "err_code_2000", "err_code_2001", "err_code_3000", "err_code_3001", "err_code_3002", "err_code_3003", "err_code_3004", "err_code_3005", "err_code_3006", "err_code_3007", "err_code_4000", "err_code_4001", "err_code_4002", "err_code_4003", "err_code_5000", "err_code_5001", "err_code_5002", "err_code_5003", "err_code_5004", "err_code_6000", "err_code_6001", "err_code_6002", "error_video_too_short", "file_chooser_choose_images", "file_chooser_choose_media", "file_chooser_choose_videos", "file_chooser_default_title", "file_chooser_empty_subtitle", "file_chooser_empty_title", "file_chooser_filter_audio", "file_chooser_filter_images", "file_chooser_filter_label", "file_chooser_filter_videos", "file_chooser_filtered_empty_subtitle", "file_chooser_filtered_empty_title", "file_chooser_folder_subtitle", "file_chooser_select_file", "file_chooser_select_folder", "permission_limited_access_add_more_media", "permission_limited_access_add_more_photos", "permission_limited_access_add_more_videos", "permission_limited_access_warning", "permission_media_reason", "terminal_change_title", "terminal_close_pane", "terminal_copy", "terminal_new_tab", "terminal_paste", "terminal_read_only", "terminal_reset", "terminal_split_down", "terminal_split_left", "terminal_split_right", "terminal_split_up", "terminal_title", "update_downloading", "video_quality", "video_speed"];
|
|
2
2
|
export type I18nKey = (typeof I18N_KEYS)[number];
|
|
3
3
|
//# sourceMappingURL=i18n.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/generated/i18n.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,
|
|
1
|
+
{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/generated/i18n.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,skFAyHZ,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}
|
package/dist/generated/i18n.js
CHANGED
|
@@ -28,37 +28,26 @@ exports.I18N_KEYS = [
|
|
|
28
28
|
"camera_switch_to_front",
|
|
29
29
|
"camera_switching",
|
|
30
30
|
"camera_tap_to_capture",
|
|
31
|
-
"camera_tap_to_record",
|
|
32
|
-
"camera_tap_to_stop",
|
|
33
31
|
"camera_video_input_failed",
|
|
34
32
|
"camera_video_output_failed",
|
|
35
33
|
"capsule_clean_cache",
|
|
36
34
|
"capsule_restart",
|
|
37
35
|
"capsule_uninstall",
|
|
38
|
-
"common_auto",
|
|
39
36
|
"common_back",
|
|
40
37
|
"common_cancel",
|
|
41
38
|
"common_close",
|
|
42
39
|
"common_confirm",
|
|
43
40
|
"common_delete",
|
|
44
41
|
"common_done",
|
|
45
|
-
"common_edit",
|
|
46
|
-
"common_home",
|
|
47
42
|
"common_loading",
|
|
48
43
|
"common_ok",
|
|
49
|
-
"
|
|
50
|
-
"common_save",
|
|
51
|
-
"common_settings",
|
|
52
|
-
"common_share",
|
|
53
|
-
"common_success",
|
|
54
|
-
"common_warning",
|
|
44
|
+
"common_refresh",
|
|
55
45
|
"date_last_30_days",
|
|
56
46
|
"date_last_7_days",
|
|
57
47
|
"date_last_month",
|
|
58
48
|
"date_last_week",
|
|
59
49
|
"date_this_month",
|
|
60
50
|
"date_this_week",
|
|
61
|
-
"document_pdf_page_preview",
|
|
62
51
|
"err_code_1000",
|
|
63
52
|
"err_code_1001",
|
|
64
53
|
"err_code_1002",
|
|
@@ -98,13 +87,10 @@ exports.I18N_KEYS = [
|
|
|
98
87
|
"err_code_6000",
|
|
99
88
|
"err_code_6001",
|
|
100
89
|
"err_code_6002",
|
|
101
|
-
"error_network_error",
|
|
102
|
-
"error_save_failed",
|
|
103
|
-
"error_server_error",
|
|
104
|
-
"error_timeout",
|
|
105
|
-
"error_unauthorized",
|
|
106
|
-
"error_unknown",
|
|
107
90
|
"error_video_too_short",
|
|
91
|
+
"file_chooser_choose_images",
|
|
92
|
+
"file_chooser_choose_media",
|
|
93
|
+
"file_chooser_choose_videos",
|
|
108
94
|
"file_chooser_default_title",
|
|
109
95
|
"file_chooser_empty_subtitle",
|
|
110
96
|
"file_chooser_empty_title",
|
|
@@ -115,19 +101,26 @@ exports.I18N_KEYS = [
|
|
|
115
101
|
"file_chooser_filtered_empty_subtitle",
|
|
116
102
|
"file_chooser_filtered_empty_title",
|
|
117
103
|
"file_chooser_folder_subtitle",
|
|
104
|
+
"file_chooser_select_file",
|
|
105
|
+
"file_chooser_select_folder",
|
|
118
106
|
"permission_limited_access_add_more_media",
|
|
119
107
|
"permission_limited_access_add_more_photos",
|
|
120
108
|
"permission_limited_access_add_more_videos",
|
|
121
109
|
"permission_limited_access_warning",
|
|
122
|
-
"permission_location_reason",
|
|
123
110
|
"permission_media_reason",
|
|
124
|
-
"
|
|
125
|
-
"
|
|
126
|
-
"
|
|
127
|
-
"
|
|
111
|
+
"terminal_change_title",
|
|
112
|
+
"terminal_close_pane",
|
|
113
|
+
"terminal_copy",
|
|
114
|
+
"terminal_new_tab",
|
|
115
|
+
"terminal_paste",
|
|
116
|
+
"terminal_read_only",
|
|
117
|
+
"terminal_reset",
|
|
118
|
+
"terminal_split_down",
|
|
119
|
+
"terminal_split_left",
|
|
120
|
+
"terminal_split_right",
|
|
121
|
+
"terminal_split_up",
|
|
122
|
+
"terminal_title",
|
|
128
123
|
"update_downloading",
|
|
129
|
-
"update_message",
|
|
130
|
-
"update_title",
|
|
131
124
|
"video_quality",
|
|
132
125
|
"video_speed",
|
|
133
126
|
];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/generated/i18n.ts"],"names":[],"mappings":";AAAA,yEAAyE;;;AAE5D,QAAA,SAAS,GAAG;IACvB,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;IACvB,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,aAAa;IACb,sBAAsB;IACtB,gBAAgB;IAChB,sBAAsB;IACtB,0BAA0B;IAC1B,mBAAmB;IACnB,oBAAoB;IACpB,cAAc;IACd,6BAA6B;IAC7B,6BAA6B;IAC7B,kBAAkB;IAClB,qBAAqB;IACrB,wBAAwB;IACxB,eAAe;IACf,sBAAsB;IACtB,uBAAuB;IACvB,wBAAwB;IACxB,kBAAkB;IAClB,uBAAuB;IACvB,
|
|
1
|
+
{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/generated/i18n.ts"],"names":[],"mappings":";AAAA,yEAAyE;;;AAE5D,QAAA,SAAS,GAAG;IACvB,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;IACvB,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,aAAa;IACb,sBAAsB;IACtB,gBAAgB;IAChB,sBAAsB;IACtB,0BAA0B;IAC1B,mBAAmB;IACnB,oBAAoB;IACpB,cAAc;IACd,6BAA6B;IAC7B,6BAA6B;IAC7B,kBAAkB;IAClB,qBAAqB;IACrB,wBAAwB;IACxB,eAAe;IACf,sBAAsB;IACtB,uBAAuB;IACvB,wBAAwB;IACxB,kBAAkB;IAClB,uBAAuB;IACvB,2BAA2B;IAC3B,4BAA4B;IAC5B,qBAAqB;IACrB,iBAAiB;IACjB,mBAAmB;IACnB,aAAa;IACb,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,eAAe;IACf,aAAa;IACb,gBAAgB;IAChB,WAAW;IACX,gBAAgB;IAChB,mBAAmB;IACnB,kBAAkB;IAClB,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,uBAAuB;IACvB,4BAA4B;IAC5B,2BAA2B;IAC3B,4BAA4B;IAC5B,4BAA4B;IAC5B,6BAA6B;IAC7B,0BAA0B;IAC1B,2BAA2B;IAC3B,4BAA4B;IAC5B,2BAA2B;IAC3B,4BAA4B;IAC5B,sCAAsC;IACtC,mCAAmC;IACnC,8BAA8B;IAC9B,0BAA0B;IAC1B,4BAA4B;IAC5B,0CAA0C;IAC1C,2CAA2C;IAC3C,2CAA2C;IAC3C,mCAAmC;IACnC,yBAAyB;IACzB,uBAAuB;IACvB,qBAAqB;IACrB,eAAe;IACf,kBAAkB;IAClB,gBAAgB;IAChB,oBAAoB;IACpB,gBAAgB;IAChB,qBAAqB;IACrB,qBAAqB;IACrB,sBAAsB;IACtB,mBAAmB;IACnB,gBAAgB;IAChB,oBAAoB;IACpB,eAAe;IACf,aAAa;CACL,CAAC"}
|
package/dist/index.d.ts
CHANGED
|
@@ -22,35 +22,205 @@ export * from './ui';
|
|
|
22
22
|
export * from './error';
|
|
23
23
|
export * from './generated/error';
|
|
24
24
|
export * from './generated/i18n';
|
|
25
|
-
import type { AppConfig, AppInstance, HostAppApi, PageMessagePort, PageConfig, PageInstance, Surface } from './app';
|
|
25
|
+
import type { AppConfig, AppInstance, HostAppApi, PageMessagePort, PageConfig, PageInstance, Surface, SurfaceHandle } from './app';
|
|
26
26
|
import type { LxAppInfo } from './lxapp';
|
|
27
27
|
import type { DeviceInfo, ScreenInfo, MakePhoneCallOptions, WifiInfo, ConnectWifiOptions, WifiConnectedCallback, NetworkInfo, NetworkChangeCallback } from './device';
|
|
28
28
|
import type { KeyEventCallback } from './input';
|
|
29
29
|
import type { LxEnv } from './env';
|
|
30
30
|
import type { Storage } from './storage';
|
|
31
31
|
import type { OpenFileOptions, ChooseDirectoryOptions, ChooseDirectoryResult, ChooseFileOptions, ChooseFileResult, FileManager } from './file';
|
|
32
|
-
import type { DownloadOptions, DownloadTask, UploadOptions, UploadTask } from './transfer';
|
|
32
|
+
import type { AppDownloadOptions, AppDownloadResult, DownloadDestination, DownloadOptions, DownloadResultForDestination, DownloadTask, DownloadsDownloadOptions, DownloadsDownloadResult, UploadOptions, UploadTask } from './transfer';
|
|
33
33
|
import type { DeviceOrientation, DeviceOrientationChangeEvent } from './display';
|
|
34
34
|
import type { GetLocationOptions, LocationInfo } from './location';
|
|
35
|
-
import type { SystemSettingInfo
|
|
35
|
+
import type { SystemSettingInfo } from './system';
|
|
36
36
|
import type { NavigateToLxAppOptions } from './navigator';
|
|
37
37
|
import type { UpdateManager } from './update';
|
|
38
|
-
import type { GetImageInfoOptions, ImageInfo, CompressImageOptions, CompressImageResult, CompressVideoOptions,
|
|
38
|
+
import type { GetImageInfoOptions, ImageInfo, CompressImageOptions, CompressImageResult, CompressVideoOptions, CompressVideoTask, GetVideoInfoOptions, VideoInfo, ExtractVideoThumbnailOptions, ExtractVideoThumbnailResult, ChooseMediaOptions, ChosenMediaEntry, PreviewMediaHandle, PreviewMediaOptions, SaveMediaOptions, ScanCodeOptions, ScanCodeResult, VideoContext } from './media';
|
|
39
39
|
import type { ShareOptions, ShareResult } from './share';
|
|
40
|
-
import type { ShowToastOptions, ShowModalOptions, ModalResult, ShowActionSheetOptions, ActionSheetResult, NavigateToOptions, NavigateBackOptions, RedirectToOptions, SwitchTabOptions, ReLaunchOptions, SetNavigationBarTitleOptions, SetNavigationBarColorOptions, TabBarRedDotOptions, SetTabBarBadgeOptions, RemoveTabBarBadgeOptions, SetTabBarStyleOptions, SetTabBarItemOptions,
|
|
41
|
-
|
|
40
|
+
import type { ShowToastOptions, ShowModalOptions, ModalResult, ShowActionSheetOptions, ActionSheetResult, NavigateToOptions, NavigateBackOptions, RedirectToOptions, SwitchTabOptions, ReLaunchOptions, SetNavigationBarTitleOptions, SetNavigationBarColorOptions, TabBarRedDotOptions, SetTabBarBadgeOptions, RemoveTabBarBadgeOptions, SetTabBarStyleOptions, SetTabBarItemOptions, SurfaceEdge, SurfaceFloatPosition, OverlaySurfaceSize, SurfaceContext, CapsuleRect } from './ui';
|
|
41
|
+
interface WindowSurfaceSize {
|
|
42
|
+
/** Initial window width in logical pixels. */
|
|
43
|
+
width?: number;
|
|
44
|
+
/** Initial window height in logical pixels. */
|
|
45
|
+
height?: number;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Spec for {@link Lx.openSurface}. A discriminated union keyed by source so a
|
|
49
|
+
* page name and a declared surface id never collide (each is its own string
|
|
50
|
+
* space, separately type-checkable).
|
|
51
|
+
*
|
|
52
|
+
* - `{ page }` — one of this lxapp's own pages, by name, arranged as `as`
|
|
53
|
+
* (`aside` is a companion of the main; `float` is a popup; `window` is a bare
|
|
54
|
+
* desktop window, which rejects on mobile). `edge` applies to `aside`,
|
|
55
|
+
* `position` applies to `float`, and `size` is a Host-clamped hint. They are
|
|
56
|
+
* fixed at open (re-open to change).
|
|
57
|
+
*
|
|
58
|
+
* `aside` is **size-class adaptive**, not a fixed form: only on `medium` /
|
|
59
|
+
* `expanded` (room to sit alongside) does it dock and split beside the main at
|
|
60
|
+
* `edge` as a sidebar/split panel. On `compact` (phone, or a folded foldable)
|
|
61
|
+
* there is no room to dock, so the same surface presents **full-screen** —
|
|
62
|
+
* pushed over the main and dismissed by the host back affordance / edge swipe
|
|
63
|
+
* (a drill-in), never a docked panel. So one declaration reads as a side panel
|
|
64
|
+
* on large screens and a full-screen drill-in on small ones. For a destination
|
|
65
|
+
* that should stay switchable on phones, declare it `role: main` instead.
|
|
66
|
+
*
|
|
67
|
+
* `float` is a popup layered above the main at `position` (like a dialog); it
|
|
68
|
+
* takes no layout space. The SDK gives it **no chrome of its own — there is no
|
|
69
|
+
* built-in close button**: the lxapp owns the popup UI and dismisses it by
|
|
70
|
+
* calling `surface.close()` (or `.hide()`). A float sized to the full container
|
|
71
|
+
* (`size: { width: '100%', height: '100%' }`) presents immersively on mobile
|
|
72
|
+
* (system bars hidden) and is likewise chrome-less — draw your own close
|
|
73
|
+
* affordance. (iOS retains a silent left-edge swipe as a last-resort escape so a
|
|
74
|
+
* full-screen float can never trap the user; don't rely on it as the primary
|
|
75
|
+
* dismissal.)
|
|
76
|
+
* - `{ surface }` — a surface declared in `lingxia.yaml` `surfaces:`, by id
|
|
77
|
+
* (e.g. `'terminal'`, `'ai-assistant'`). Form, position, and startup data come
|
|
78
|
+
* from the declaration.
|
|
79
|
+
* - `{ url }` — an `http(s)://` or `lingxia://` url, shown in the in-app chromed
|
|
80
|
+
* browser (always with an address bar — never a chromeless embed). Without
|
|
81
|
+
* `as` it opens as a main browser tab (host chrome, no handle). With
|
|
82
|
+
* `as: 'aside'` it docks an `http(s)://` page beside the main as a single
|
|
83
|
+
* browser aside (its own chrome + close, returns a closable handle); `edge`
|
|
84
|
+
* defaults to `'right'` and `size` is a host-clamped preferred size. At most
|
|
85
|
+
* one browser aside per window — a new one replaces the existing one.
|
|
86
|
+
*/
|
|
87
|
+
export type OpenPageSurfaceSpec = {
|
|
88
|
+
page: string;
|
|
89
|
+
as: 'aside';
|
|
90
|
+
edge?: SurfaceEdge;
|
|
91
|
+
size?: OverlaySurfaceSize;
|
|
92
|
+
query?: Record<string, unknown>;
|
|
93
|
+
position?: never;
|
|
94
|
+
surface?: never;
|
|
95
|
+
url?: never;
|
|
96
|
+
} | {
|
|
97
|
+
page: string;
|
|
98
|
+
/**
|
|
99
|
+
* A chrome-less popup above the main: the lxapp draws its own UI and close
|
|
100
|
+
* affordance — there is no SDK-provided close button (see
|
|
101
|
+
* {@link OpenPageSurfaceSpec}).
|
|
102
|
+
*/
|
|
103
|
+
as: 'float';
|
|
104
|
+
position?: SurfaceFloatPosition;
|
|
105
|
+
size?: OverlaySurfaceSize;
|
|
106
|
+
query?: Record<string, unknown>;
|
|
107
|
+
edge?: never;
|
|
108
|
+
surface?: never;
|
|
109
|
+
url?: never;
|
|
110
|
+
} | {
|
|
111
|
+
page: string;
|
|
112
|
+
as: 'window';
|
|
113
|
+
size?: WindowSurfaceSize;
|
|
114
|
+
query?: Record<string, unknown>;
|
|
115
|
+
edge?: never;
|
|
116
|
+
position?: never;
|
|
117
|
+
surface?: never;
|
|
118
|
+
url?: never;
|
|
119
|
+
};
|
|
120
|
+
export interface OpenDeclaredSurfaceSpec {
|
|
121
|
+
surface: string;
|
|
122
|
+
page?: never;
|
|
123
|
+
url?: never;
|
|
124
|
+
as?: never;
|
|
125
|
+
edge?: never;
|
|
126
|
+
position?: never;
|
|
127
|
+
size?: never;
|
|
128
|
+
query?: never;
|
|
129
|
+
}
|
|
130
|
+
export interface OpenUrlTabSpec {
|
|
131
|
+
url: string;
|
|
132
|
+
as?: never;
|
|
133
|
+
page?: never;
|
|
134
|
+
surface?: never;
|
|
135
|
+
edge?: never;
|
|
136
|
+
position?: never;
|
|
137
|
+
size?: never;
|
|
138
|
+
query?: never;
|
|
139
|
+
}
|
|
140
|
+
export interface OpenUrlAsideSpec {
|
|
141
|
+
url: string;
|
|
142
|
+
as: 'aside';
|
|
143
|
+
edge?: SurfaceEdge;
|
|
144
|
+
size?: OverlaySurfaceSize;
|
|
145
|
+
page?: never;
|
|
146
|
+
surface?: never;
|
|
147
|
+
position?: never;
|
|
148
|
+
query?: never;
|
|
149
|
+
}
|
|
150
|
+
export type OpenSurfaceSpec = OpenPageSurfaceSpec | OpenDeclaredSurfaceSpec | OpenUrlTabSpec | OpenUrlAsideSpec;
|
|
151
|
+
/**
|
|
152
|
+
* Runtime control of the menu-bar (macOS) / system-tray (Windows) status item.
|
|
153
|
+
* The tray is declared in `lingxia.yaml` (`tray:`); these update its dynamic
|
|
154
|
+
* content at runtime.
|
|
155
|
+
*
|
|
156
|
+
* **Desktop only.** Mobile platforms have no tray, so every method here is a
|
|
157
|
+
* no-op there (it never throws) — safe to call from portable code. For an
|
|
158
|
+
* app-icon badge that *is* cross-platform (including mobile), use
|
|
159
|
+
* {@link HostAppApi.setBadge}.
|
|
160
|
+
*/
|
|
161
|
+
export interface TrayMenuItem {
|
|
162
|
+
label: string;
|
|
163
|
+
/** Invoked when this item is clicked. */
|
|
164
|
+
onClick?: () => void;
|
|
165
|
+
enabled?: boolean;
|
|
166
|
+
checked?: boolean;
|
|
167
|
+
}
|
|
168
|
+
export interface TrayMenuSeparator {
|
|
169
|
+
separator: true;
|
|
170
|
+
}
|
|
171
|
+
export interface TrayApi {
|
|
172
|
+
/** Replace the status-item icon (a resource path). */
|
|
173
|
+
setIcon(icon: string): void;
|
|
174
|
+
/** Set the text shown beside the icon (macOS). Pass `null`/empty to clear. */
|
|
175
|
+
setTitle(text: string | null): void;
|
|
176
|
+
/** Set the badge — e.g. an unread count. Pass `null`/empty to clear. */
|
|
177
|
+
setBadge(value: string | number | null): void;
|
|
42
178
|
/**
|
|
43
|
-
*
|
|
179
|
+
* Replace the right-click dropdown menu. There is no default menu — provide
|
|
180
|
+
* your own items (e.g. `{ label: 'Quit', onClick: () => lx.app.exit() }`).
|
|
44
181
|
*
|
|
45
|
-
*
|
|
46
|
-
*
|
|
182
|
+
* The menu is a snapshot: to change an item's `checked`/`enabled`/`label`
|
|
183
|
+
* state, call `setMenu` again with the full updated array. There is no
|
|
184
|
+
* per-item mutation API.
|
|
185
|
+
*/
|
|
186
|
+
setMenu(items: Array<TrayMenuItem | TrayMenuSeparator>): void;
|
|
187
|
+
/**
|
|
188
|
+
* Handle a left-click on the tray icon yourself. While a handler is
|
|
189
|
+
* registered the click runs only the handler — the tray's configured surface
|
|
190
|
+
* `action` is suppressed, so the click is fully yours (e.g. toggle a state and
|
|
191
|
+
* `setIcon`). Returns an unsubscribe function.
|
|
47
192
|
*/
|
|
48
|
-
|
|
193
|
+
onClick(handler: () => void): () => void;
|
|
194
|
+
/** Show the tray status item. */
|
|
195
|
+
show(): void;
|
|
196
|
+
/** Hide the tray status item (without removing the app). */
|
|
197
|
+
hide(): void;
|
|
49
198
|
}
|
|
50
199
|
export interface Lx {
|
|
51
200
|
env: LxEnv;
|
|
52
201
|
app: HostAppApi;
|
|
53
|
-
|
|
202
|
+
tray: TrayApi;
|
|
203
|
+
/**
|
|
204
|
+
* Open a surface.
|
|
205
|
+
*
|
|
206
|
+
* - `{ url }` without `as` opens a host browser tab and resolves to `null`.
|
|
207
|
+
* - `{ surface }` resolves to a host-managed handle with show/hide/close.
|
|
208
|
+
* - page surfaces and `{ url, as: 'aside' }` resolve to a full Surface handle.
|
|
209
|
+
*
|
|
210
|
+
* `as: 'window'` is desktop-only and rejects on mobile. See
|
|
211
|
+
* {@link OpenSurfaceSpec}.
|
|
212
|
+
*/
|
|
213
|
+
openSurface(spec: OpenUrlTabSpec): Promise<null>;
|
|
214
|
+
openSurface(spec: OpenDeclaredSurfaceSpec): Promise<SurfaceHandle>;
|
|
215
|
+
openSurface(spec: OpenPageSurfaceSpec | OpenUrlAsideSpec): Promise<Surface>;
|
|
216
|
+
openSurface(spec: OpenSurfaceSpec): Promise<Surface | SurfaceHandle | null>;
|
|
217
|
+
/** Hand a url off to the OS default browser (leaves the app). */
|
|
218
|
+
openExternal(url: string): void;
|
|
219
|
+
/**
|
|
220
|
+
* Subscribe to adaptive-context changes ({@link SurfaceContext}); the handler
|
|
221
|
+
* fires with the new context. Returns an unsubscribe function.
|
|
222
|
+
*/
|
|
223
|
+
onSurfaceContext(handler: (context: SurfaceContext) => void): () => void;
|
|
54
224
|
getDeviceInfo(): DeviceInfo;
|
|
55
225
|
getScreenInfo(): ScreenInfo;
|
|
56
226
|
vibrateShort(): boolean;
|
|
@@ -75,7 +245,9 @@ export interface Lx {
|
|
|
75
245
|
* otherwise prefer `mode: 'auto'`.
|
|
76
246
|
*/
|
|
77
247
|
openFile(options: OpenFileOptions): void;
|
|
78
|
-
downloadFile(options:
|
|
248
|
+
downloadFile(options: DownloadsDownloadOptions): DownloadTask<DownloadsDownloadResult>;
|
|
249
|
+
downloadFile(options: AppDownloadOptions): DownloadTask<AppDownloadResult>;
|
|
250
|
+
downloadFile<TDestination extends DownloadDestination = 'app'>(options: DownloadOptions<TDestination>): DownloadTask<DownloadResultForDestination<TDestination>>;
|
|
79
251
|
uploadFile(options: UploadOptions): UploadTask;
|
|
80
252
|
getFileManager(): FileManager;
|
|
81
253
|
getStorage(): Storage;
|
|
@@ -84,11 +256,10 @@ export interface Lx {
|
|
|
84
256
|
navigateBackLxApp(): Promise<void>;
|
|
85
257
|
getLxAppInfo(): LxAppInfo;
|
|
86
258
|
getSystemSetting(): SystemSettingInfo;
|
|
87
|
-
openURL(options: OpenURLOptions): void;
|
|
88
259
|
getUpdateManager(): UpdateManager;
|
|
89
260
|
getImageInfo(options: GetImageInfoOptions): Promise<ImageInfo>;
|
|
90
261
|
compressImage(options: CompressImageOptions): Promise<CompressImageResult>;
|
|
91
|
-
compressVideo(options: CompressVideoOptions):
|
|
262
|
+
compressVideo(options: CompressVideoOptions): CompressVideoTask;
|
|
92
263
|
getVideoInfo(options: GetVideoInfoOptions): Promise<VideoInfo>;
|
|
93
264
|
extractVideoThumbnail(options: ExtractVideoThumbnailOptions): Promise<ExtractVideoThumbnailResult>;
|
|
94
265
|
chooseMedia(options?: ChooseMediaOptions): Promise<ChosenMediaEntry[]>;
|
|
@@ -101,9 +272,12 @@ export interface Lx {
|
|
|
101
272
|
* - a sequence object for multi-item preview with `sources`, `startIndex`, and `advance`
|
|
102
273
|
*
|
|
103
274
|
* Returns a {@link PreviewMediaHandle} synchronously. Await `handle.completed`
|
|
104
|
-
* for the final session result (`reason`, `
|
|
105
|
-
*
|
|
106
|
-
*
|
|
275
|
+
* for the final session result (`reason`, `index`, `source` — the item the
|
|
276
|
+
* user was viewing when the preview closed). Subscribe to
|
|
277
|
+
* `handle.onChange(...)` / read `handle.current` to follow the viewed item
|
|
278
|
+
* live, and to `handle.presented` to learn when the first pixel hits the
|
|
279
|
+
* screen — useful for coordinating a hide of any overlay surface that was
|
|
280
|
+
* previously visible.
|
|
107
281
|
*
|
|
108
282
|
* `handle.completed` rejects with a cancellation error if `signal` is aborted;
|
|
109
283
|
* abort also requests the active native preview session to close immediately.
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC;AACrB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAEjC,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,eAAe,EACf,UAAU,EACV,YAAY,EACZ,OAAO,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/media/index.d.ts
CHANGED
|
@@ -65,6 +65,34 @@ export interface CompressVideoResult {
|
|
|
65
65
|
size: number;
|
|
66
66
|
type: string;
|
|
67
67
|
}
|
|
68
|
+
export interface CompressVideoProgressEvent {
|
|
69
|
+
/** Transcode progress in percent, `0`-`100`. */
|
|
70
|
+
progress: number;
|
|
71
|
+
}
|
|
72
|
+
export interface CompressVideoIteratorResult {
|
|
73
|
+
done: boolean;
|
|
74
|
+
value?: CompressVideoProgressEvent;
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Handle returned by `lx.compressVideo`.
|
|
78
|
+
*
|
|
79
|
+
* Awaiting the task resolves with the final {@link CompressVideoResult}.
|
|
80
|
+
* Iterating it with `for await` yields {@link CompressVideoProgressEvent}s
|
|
81
|
+
* while the transcode runs.
|
|
82
|
+
*/
|
|
83
|
+
export interface CompressVideoTask extends PromiseLike<CompressVideoResult>, AsyncIterable<CompressVideoProgressEvent> {
|
|
84
|
+
next(): Promise<CompressVideoIteratorResult>;
|
|
85
|
+
/** Stops iteration only. Does not cancel the compression. */
|
|
86
|
+
return(): Promise<CompressVideoIteratorResult>;
|
|
87
|
+
catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<CompressVideoResult | TResult>;
|
|
88
|
+
finally(onfinally?: (() => void) | null): Promise<CompressVideoResult>;
|
|
89
|
+
/**
|
|
90
|
+
* Cancels the transcode and deletes any partial output.
|
|
91
|
+
* The task promise rejects with an `AbortError` (`code: 'E_ABORT'`).
|
|
92
|
+
*/
|
|
93
|
+
cancel(): void;
|
|
94
|
+
wait(): Promise<CompressVideoResult>;
|
|
95
|
+
}
|
|
68
96
|
export interface GetVideoInfoOptions {
|
|
69
97
|
/**
|
|
70
98
|
* Video file path or `lx://` URI.
|
|
@@ -254,34 +282,65 @@ export interface PreviewMediaSequenceOptions {
|
|
|
254
282
|
}
|
|
255
283
|
export type PreviewMediaOptions = string | PreviewMediaSingleOptions | PreviewMediaSequenceOptions;
|
|
256
284
|
export type PreviewMediaCloseReason = 'manual' | 'completed' | 'interrupted' | 'error';
|
|
285
|
+
/**
|
|
286
|
+
* The item the user is (or was) looking at, handed back as the caller
|
|
287
|
+
* described it — `path` is returned verbatim, so it can be matched against
|
|
288
|
+
* the caller's own data without re-indexing an array.
|
|
289
|
+
*/
|
|
290
|
+
export interface PreviewMediaShownSource {
|
|
291
|
+
/** The path exactly as passed in the request. */
|
|
292
|
+
path: string;
|
|
293
|
+
/** Resolved media kind (after extension inference when `type` was omitted). */
|
|
294
|
+
type: 'image' | 'video';
|
|
295
|
+
}
|
|
296
|
+
/** One change-stream event / the `current` snapshot. */
|
|
297
|
+
export interface PreviewMediaChange {
|
|
298
|
+
index: number;
|
|
299
|
+
source: PreviewMediaShownSource;
|
|
300
|
+
}
|
|
257
301
|
export interface PreviewMediaResult {
|
|
258
302
|
/**
|
|
259
303
|
* Why the preview session finished.
|
|
260
304
|
*/
|
|
261
305
|
reason: PreviewMediaCloseReason;
|
|
262
306
|
/**
|
|
263
|
-
*
|
|
307
|
+
* Index of the item on screen when the session closed.
|
|
264
308
|
*/
|
|
265
|
-
|
|
309
|
+
index: number;
|
|
310
|
+
/**
|
|
311
|
+
* The item on screen when the session closed — "what the user just
|
|
312
|
+
* viewed/played", without mapping `index` back yourself.
|
|
313
|
+
*/
|
|
314
|
+
source: PreviewMediaShownSource;
|
|
266
315
|
}
|
|
267
316
|
/**
|
|
268
|
-
* Handle returned synchronously from `lx.previewMedia(...)
|
|
269
|
-
*
|
|
317
|
+
* Handle returned synchronously from `lx.previewMedia(...)` — synchronous so
|
|
318
|
+
* listeners can be attached before the first event fires:
|
|
270
319
|
*
|
|
271
320
|
* - `presented` resolves once the first pixel of the underlying media has
|
|
272
321
|
* been composited to screen. Use this to time the hide of an overlay
|
|
273
322
|
* surface above the preview so the swap is seamless. Never rejects;
|
|
274
323
|
* resolves with no value when the first frame is up. Safe to ignore.
|
|
275
|
-
* - `
|
|
276
|
-
*
|
|
277
|
-
*
|
|
324
|
+
* - `current` is a live `{ index, source }` snapshot of the item on screen,
|
|
325
|
+
* updated as the user swipes and as the session auto-advances.
|
|
326
|
+
* - `onChange(listener)` fires for every item change. Returns an
|
|
327
|
+
* unsubscribe function.
|
|
328
|
+
* - `completed` resolves `{ reason, index, source }` when the preview
|
|
329
|
+
* session ends (manual / auto / interrupted / error), or rejects on abort.
|
|
278
330
|
*
|
|
279
331
|
* If the call was aborted before any frame was presented, `presented` still
|
|
280
332
|
* resolves (with no value) once the abort takes effect — it never rejects,
|
|
281
333
|
* to keep fire-and-forget usage safe.
|
|
334
|
+
*
|
|
335
|
+
* @example
|
|
336
|
+
* const preview = lx.previewMedia({ sources, startIndex: 2 });
|
|
337
|
+
* preview.onChange(({ source }) => markAsViewed(source.path));
|
|
338
|
+
* const { reason, source } = await preview.completed;
|
|
282
339
|
*/
|
|
283
340
|
export interface PreviewMediaHandle {
|
|
284
341
|
readonly presented: Promise<void>;
|
|
342
|
+
readonly current: PreviewMediaChange;
|
|
343
|
+
onChange(listener: (change: PreviewMediaChange) => void): () => void;
|
|
285
344
|
readonly completed: Promise<PreviewMediaResult>;
|
|
286
345
|
}
|
|
287
346
|
export interface SaveMediaOptions {
|