@nativescript/core 8.9.0-next-01-17-2025-12834437745 → 8.9.0-next-01-22-2025-12918162303

package/global-types.d.ts

@@ -0,0 +1,393 @@
+interface ModuleResolver {
+	/**
+	 * A function used to resolve the exports for a module.
+	 * @param uri The name of the module to be resolved.
+	 */
+	(uri: string): any;
+}
+
+/**
+ * An extended JavaScript Error which will have the nativeException property initialized in case the error is caused by executing platform-specific code.
+ */
+declare interface NativeScriptError extends Error {
+	/**
+	 * Represents the native error object.
+	 */
+	nativeException?: any;
+	/**
+	 * The native stack trace.
+	 */
+	stackTrace?: string;
+	/**
+	 * Javascript portion of stack trace.
+	 */
+	stack?: string;
+}
+
+//Augment the NodeJS global type with our own extensions
+declare module globalThis {
+	var NativeScriptHasInitGlobal: boolean;
+	var NativeScriptGlobals: {
+		/**
+		 * Global framework event handling
+		 */
+		events: {
+			[Key in keyof import('data/observable').Observable]: import('data/observable').Observable[Key];
+		};
+		launched: boolean;
+		// used by various classes to setup callbacks to wire up global app event handling when the app instance is ready
+		appEventWiring: Array<any>;
+		// determines if the app instance is ready upon bootstrap
+		appInstanceReady: boolean;
+
+		/**
+		 * Ability for classes to initialize app event handling early even before the app instance is ready during boot cycle avoiding boot race conditions
+		 * @param callback wire up any global event handling inside the callback
+		 */
+		addEventWiring(callback: () => void): void;
+	};
+	// var android: any;
+	function require(id: string): any;
+
+	function moduleMerge(sourceExports: any, destExports: any): void;
+
+	function registerModule(name: string, loader: (name: string) => any): void;
+	/**
+	 * Register all modules from a webpack context.
+	 * The context is one created using the following webpack utility:
+	 * https://webpack.js.org/guides/dependency-management/#requirecontext
+	 *
+	 * The extension map is optional, modules in the webpack context will have their original file extension (e.g. may be ".ts" or ".scss" etc.),
+	 * while the built-in module builders in {N} will look for ".js", ".css" or ".xml" files. Adding a map such as:
+	 * ```
+	 * { ".ts": ".js" }
+	 * ```
+	 * Will resolve lookups for .js to the .ts file.
+	 * By default scss and ts files are mapped.
+	 */
+	function registerWebpackModules(context: { keys(): string[]; (key: string): any }, extensionMap?: { [originalFileExtension: string]: string });
+
+	/**
+	 * The NativeScript XML builder, style-scope, application modules use various resources such as:
+	 * app.css, page.xml files and modules during the application life-cycle.
+	 * The moduleResolvers can be used to provide additional mechanisms to locate such resources.
+	 * For example:
+	 * ```
+	 * global.moduleResolvers.unshift(uri => uri === "main-page" ? require("main-page") : null);
+	 * ```
+	 * More advanced scenarios will allow for specific bundlers to integrate their module resolving mechanisms.
+	 * When adding resolvers at the start of the array, avoid throwing and return null instead so subsequent resolvers may try to resolve the resource.
+	 * By default the only member of the array is global.require, as last resort - if it fails to find a module it will throw.
+	 */
+	var moduleResolvers: ModuleResolver[];
+
+	/**
+	 *
+	 * @param name Name of the module to be loaded
+	 * @param loadForUI Is this UI module is being loaded for UI from @nativescript/core/ui/builder.
+	 * Xml, css/scss and js/ts modules for pages and custom-components should load with loadForUI=true.
+	 * Passing "true" will enable the HMR mechanics this module. Default value is false.
+	 */
+	function loadModule(name: string, loadForUI?: boolean): any;
+
+	/**
+	 * Checks if the module has been registered with `registerModule` or in `registerWebpackModules`
+	 * @param name Name of the module
+	 */
+	function moduleExists(name: string): boolean;
+
+	function getRegisteredModules(): string[];
+
+	function _unregisterModule(name: string): void;
+
+	function _isModuleLoadedForUI(moduleName: string): boolean;
+
+	var onGlobalLayoutListener: any;
+	function zonedCallback<T = Function>(callback: T): T;
+	var Reflect: any;
+	function Deprecated(target: Object, key?: string | symbol, descriptor?: any): any;
+	function Experimental(target: Object, key?: string | symbol, descriptor?: any): any;
+
+	var __native: any;
+	var __inspector: any;
+	var __extends: any;
+	var __onLiveSync: (context?: { type: string; path: string }) => void;
+	var __onLiveSyncCore: (context?: { type: string; path: string }) => void;
+	var __onUncaughtError: (error: NativeScriptError) => void;
+	var __onDiscardedError: (error: NativeScriptError) => void;
+	var __snapshot: boolean;
+	var TNS_WEBPACK: boolean;
+	var isIOS: boolean;
+	var isAndroid: boolean;
+	var isVisionOS: boolean;
+	var isDisplayedEventFired: boolean;
+	var autoLoadPolyfills: boolean;
+	var __requireOverride: (name: string, dir: string) => any;
+
+	// used to get the rootlayout instance to add/remove childviews
+	var rootLayout: any;
+}
+declare const __DEV__: boolean;
+declare const __CSS_PARSER__: string;
+declare const __NS_WEBPACK__: boolean;
+declare const __UI_USE_EXTERNAL_RENDERER__: boolean;
+declare const __UI_USE_XML_PARSER__: boolean;
+declare const __ANDROID__: boolean;
+declare const __IOS__: boolean;
+declare const __VISIONOS__: boolean;
+declare const __APPLE__: boolean;
+
+declare function setTimeout(callback: (...args: any[]) => void, ms: number, ...args: any[]): number;
+declare function clearTimeout(timeoutId: number): void;
+declare function setInterval(callback: (...args: any[]) => void, ms: number, ...args: any[]): number;
+declare function clearInterval(intervalId: number): void;
+
+declare type ModuleType = 'markup' | 'script' | 'style';
+
+/**
+ * Define a module context for Hot Module Replacement.
+ */
+interface ModuleContext {
+	/**
+	 * The type of the module for replacement.
+	 */
+	type: ModuleType;
+
+	/**
+	 * The path of the module for replacement.
+	 */
+	path: string;
+}
+
+interface NodeModule {
+	exports: any;
+	id: string;
+	filename: string;
+}
+
+declare enum RequestContext {
+	'audio',
+	'beacon',
+	'cspreport',
+	'download',
+	'embed',
+	'eventsource',
+	'favicon',
+	'fetch',
+	'font',
+	'form',
+	'frame',
+	'hyperlink',
+	'iframe',
+	'image',
+	'imageset',
+	'import',
+	'internal',
+	'location',
+	'manifest',
+	'object',
+	'ping',
+	'plugin',
+	'prefetch',
+	'script',
+	'serviceworker',
+	'sharedworker',
+	'subresource',
+	'style',
+	'track',
+	'video',
+	'worker',
+	'xmlhttprequest',
+	'xslt',
+}
+
+// Extend the lib.dom.d.ts Body interface with `formData`
+// interface Body {
+//   formData(): Promise<FormData>;
+// }
+
+declare type HeaderInit = Headers | Array<string>;
+
+declare function fetch(url: string, init?: RequestInit): Promise<Response>;
+
+// declare var console: Console;
+declare var require: NodeRequire;
+
+// Extend NodeRequire with the webpack's require context extension.
+interface RequireContext {
+	keys(): string[];
+	(id: string): any;
+	<T>(id: string): T;
+	resolve(id: string): string;
+}
+
+interface WeakRef<T extends object> {
+	/**
+	 * @deprecated Use deref instead with 8.5+
+	 */
+	get(): T;
+
+	/**
+	 * @deprecated You no longer need to make this call and can be safely removed.
+	 */
+	clear(): void;
+}
+
+declare var __dirname: string;
+declare var __filename: string;
+
+declare var module: NodeModule;
+// Same as module.exports
+declare var exports: any;
+
+// Global functions
+declare function Deprecated(target: Object, key?: string | symbol, value?: any): void;
+declare function Experimental(target: Object, key?: string | symbol, value?: any): void;
+
+declare interface NativeClassOptions {
+	nativeClassName?: string; // for @JavaProxy and
+	protocols?: any[];
+	interfaces?: any[];
+}
+
+/**
+ * Decorates class that extends a native class(iOS or Android)
+ */
+declare function NativeClass<T extends { new (...args: any[]): {} }>(constructor: T);
+declare function NativeClass<T extends { new (...args: any[]): {} }>(options?: NativeClassOptions);
+
+/**
+ * Decorates class that implements native Java interfaces.
+ * @param interfaces Implemented interfaces.
+ */
+declare function Interfaces(...interfaces): ClassDecorator;
+
+/**
+ * Important: Not applicable to Objective-C classes (iOS platform)
+ * Decorates class that extends native Java class
+ * @param interfaces An array of fully-classified Java interface names that the class must implement.
+ */
+declare function Interfaces(interfaces: any[]): ClassDecorator;
+
+/**
+ * Decorates class that extends native Java class
+ * @param nativeClassName The name of the newly generated class. Must be unique in the application.
+ */
+declare function JavaProxy(nativeClassName: string): ClassDecorator;
+
+/**
+ * Important: Not applicable to Java classes (Android platform)
+ * Decorates a class that implements native Objective-C protocols.
+ * @param protocols An array of fully-classified Objective-C protocol names that the class must implement.
+ */
+declare function ObjCClass(...protocols: any[]): ClassDecorator;
+
+/**
+ * Important: Not applicable to Java methods (Android platform)
+ * Decorates method that it is exposed in Objective-C.
+ * The JS name of the method will be used as the name of the native method
+ * and the return type will be set to `interop.types.void`
+ */
+declare function ObjCMethod(): MethodDecorator;
+
+/**
+ * Important: Not applicable to Java methods (Android platform)
+ * Decorates method that it is exposed in Objective-C.
+ * @param name The name of the method to be exposed.
+ * The native return type will be set to `interop.types.void`.
+ */
+declare function ObjCMethod(name: string): MethodDecorator;
+
+/**
+ * Important: Not applicable to Java methods (Android platform)
+ * Decorates a method to be exposed in Objective-C.
+ * The JS name of the method will be used for the name of the native method.
+ * @param returnType The native type of the result.
+ */
+declare function ObjCMethod(returnType: any): MethodDecorator;
+
+/**
+ * Important: Not applicable to Java methods (Android platform)
+ * Decorates a method to be exposed in Objective-C.
+ * @param name The name of the method to be exposed. Can be different than the JS function name
+ * and can follow Objective-C colon syntax (for example `tableView:cellForRowAtIndexPath:`).
+ * @param returnType The native type of the result.
+ */
+declare function ObjCMethod(name: string, returnType: any): MethodDecorator;
+
+/**
+ * Important: Not applicable to Java classes or methods (Android platform)
+ * This is a shorthand decorator that can be used to decorate either a method or a class
+ * to be exposed to Objective-C.
+ * @param params Parameters to send to the ObjCClass or ObjCMethod decorators.
+ */
+declare function ObjC(...params: any[]): ClassDecorator & MethodDecorator;
+
+/**
+ * Important: Not applicable to Java method parameters (Android platform)
+ * Decorates a parameter in an Objective-C exposed method with its native type.
+ * @param type The native type for the parameter.
+ */
+declare function ObjCParam(type: any): ParameterDecorator;
+
+declare function Log(data: any): void;
+declare function log(data: any): void;
+declare function fail(data: any): void;
+
+/**
+ * Calls a function after a specified delay.
+ * @param callback The function to be called.
+ * @param milliseconds The time to wait before the function is called. Defaults to 0.
+ */
+// declare function setTimeout(callback: Function, milliseconds?: number): number;
+
+/**
+ * Clears the delay set by a call to the setTimeout function.
+ * @param id The identifier returned by the previously called setTimeout() method.
+ */
+// declare function clearTimeout(id: number): void;
+
+/**
+ * Calls a function repeatedly with a delay between each call.
+ * @param callback The function to be called.
+ * @param milliseconds The delay between each function call.
+ */
+// declare function setInterval(callback: Function, milliseconds?: number): number;
+
+/**
+ * Clears repeated function which was set up by calling setInterval().
+ * @param id The identifier returned by the setInterval() method.
+ */
+// declare function clearInterval(id: number): void;
+
+declare function zonedCallback<T = Function>(callback: T): T;
+
+/**
+ * Create a Java long from a number
+ */
+declare function long(value: number): any;
+
+/**
+ * Create a Java byte from a number
+ */
+declare function byte(value: number): any;
+
+/**
+ * Create a Java short from a number
+ */
+declare function short(value: number): any;
+
+/**
+ * Create a Java double from a number
+ */
+declare function double(value: number): any;
+
+/**
+ * Create a Java float from a number
+ */
+declare function float(value: number): any;
+
+/**
+ * Create a Java char from a string
+ */
+declare function char(value: string): any;

package/globals/index.d.ts

@@ -1,22 +1,7 @@
 import { Observable } from '../data/observable';
-/**
- * Manages internal framework global state
- */
 export declare class NativeScriptGlobalState {
-    events: Observable;
-    launched: boolean;
-    appEventWiring: Array<any>;
-    private _appInstanceReady;
-    private _setLaunched;
-    constructor();
-    get appInstanceReady(): boolean;
-    set appInstanceReady(value: boolean);
-    /**
-     * Ability for classes to initialize app event handling early even before the app instance is ready during boot cycle avoiding boot race conditions
-     * @param callback wire up any global event handling inside the callback
-     */
-    addEventWiring(callback: () => void): void;
-    private _setLaunchedFn;
+	events: Observable;
+	launched: boolean;
 }
-export declare function installPolyfills(moduleName: string, exportNames: string[]): void;
-export declare function initGlobal(): void;
+export function installPolyfills(moduleName: string, exportNames: string[]): void;
+export function initGlobal(): void;

package/http/http-request/index.d.ts

@@ -0,0 +1,3 @@
+import { HttpRequestOptions, HttpResponse, Headers } from '..';
+export const request: (options: HttpRequestOptions) => Promise<HttpResponse>;
+export function addHeader(headers: Headers, key: string, value: string): void;

package/http/index.d.ts

@@ -1,90 +1,166 @@
-import { ImageSource } from '../image-source';
+import { ImageSource } from '../image-source';
 import { File } from '../file-system';
-export * from './http-request';
+
+/**
+ * Downloads the content from the specified URL as a string.
+ * @param url The URL to request from.
+ */
+export function getString(url: string): Promise<string>;
+
+/**
+ * Downloads the content from the specified URL as a string.
+ * @param options An object that specifies various request options.
+ */
+export function getString(options: HttpRequestOptions): Promise<string>;
+
+/**
+ * Downloads the content from the specified URL as a string and returns its JSON.parse representation.
+ * @param url The URL to request from.
+ */
+export function getJSON<T>(url: string): Promise<T>;
+
+/**
+ * Downloads the content from the specified URL as a string and returns its JSON.parse representation.
+ * @param options An object that specifies various request options.
+ */
+export function getJSON<T>(options: HttpRequestOptions): Promise<T>;
+
+/**
+ * Downloads the content from the specified URL and attempts to decode it as an image.
+ * @param url The URL to request from.
+ */
+export function getImage(url: string): Promise<ImageSource>;
+
+/**
+ * Downloads the content from the specified URL and attempts to decode it as an image.
+ * @param options An object that specifies various request options.
+ */
+export function getImage(options: HttpRequestOptions): Promise<ImageSource>;
+
+/**
+ * Downloads the content from the specified URL and attempts to save it as file.
+ * @param url The URL to request from.
+ * @param destinationFilePath Optional. The downloaded file path.
+ */
+export function getFile(url: string, destinationFilePath?: string): Promise<File>;
+
+/**
+ * Downloads the content from the specified URL and attempts to save it as file.
+ * @param options An object that specifies various request options.
+ * @param destinationFilePath Optional. The downloaded file path.
+ */
+export function getFile(options: HttpRequestOptions, destinationFilePath?: string): Promise<File>;
+
+/**
+ * Downloads the content from the specified URL as binary and returns an ArrayBuffer.
+ * @param url The URL to request from.
+ */
+export function getBinary(url: string): Promise<ArrayBuffer>;
+
+/**
+ * Downloads the content from the specified URL as binary and returns an ArrayBuffer.
+ * @param options An object that specifies various request options.
+ */
+export function getBinary(options: HttpRequestOptions): Promise<ArrayBuffer>;
+
+/**
+ * Makes a generic http request using the provided options and returns a HttpResponse Object.
+ * @param options An object that specifies various request options.
+ */
+export function request(options: HttpRequestOptions): Promise<HttpResponse>;
+
 /**
  * Provides options for the http requests.
  */
 export interface HttpRequestOptions {
-    /**
-     * Gets or sets the request url.
-     */
-    url: string;
-    /**
-     * Gets or sets the request method.
-     */
-    method: string;
-    /**
-     * Gets or sets the request headers in JSON format.
-     */
-    headers?: any;
-    /**
-     * Gets or sets the request body.
-     */
-    content?: string | FormData | ArrayBuffer;
-    /**
-     * Gets or sets the request timeout in milliseconds.
-     */
-    timeout?: number;
-    /**
-     * Gets or sets whether to *not* follow server's redirection responses.
-     */
-    dontFollowRedirects?: boolean;
+	/**
+	 * Gets or sets the request url.
+	 */
+	url: string;
+
+	/**
+	 * Gets or sets the request method.
+	 */
+	method: string;
+
+	/**
+	 * Gets or sets the request headers in JSON format.
+	 */
+	headers?: any;
+
+	/**
+	 * Gets or sets the request body.
+	 */
+	content?: string | FormData | ArrayBuffer;
+
+	/**
+	 * Gets or sets the request timeout in milliseconds.
+	 */
+	timeout?: number;
+
+	/**
+	 * Gets or sets wether to *not* follow server's redirection responses.
+	 */
+	dontFollowRedirects?: boolean;
 }
+
 /**
  * Encapsulates HTTP-response information from an HTTP-request.
  */
 export interface HttpResponse {
-    /**
-     * Gets the response status code.
-     */
-    statusCode: number;
-    /**
-     * Gets the response headers.
-     */
-    headers: Headers;
-    /**
-     * Gets the response content.
-     */
-    content?: HttpContent;
+	/**
+	 * Gets the response status code.
+	 */
+	statusCode: number;
+
+	/**
+	 * Gets the response headers.
+	 */
+	headers: Headers;
+
+	/**
+	 * Gets the response content.
+	 */
+	content?: HttpContent;
 }
-export type Headers = {
-    [key: string]: string | string[];
-};
-export declare enum HttpResponseEncoding {
-    UTF8 = 0,
-    GBK = 1
+
+export type Headers = { [key: string]: string | string[] };
+
+export enum HttpResponseEncoding {
+	UTF8,
+	GBK,
 }
 /**
  * Encapsulates the content of an HttpResponse.
  */
 export interface HttpContent {
-    /**
-     * Gets the response body as raw data.
-     */
-    raw: any;
-    /**
-     * Gets the response body as ArrayBuffer
-     */
-    toArrayBuffer: () => ArrayBuffer;
-    /**
-     * Gets the response body as string.
-     */
-    toString: (encoding?: HttpResponseEncoding) => string;
-    /**
-     * Gets the response body as JSON object.
-     */
-    toJSON: (encoding?: HttpResponseEncoding) => any;
-    /**
-     * Gets the response body as ImageSource.
-     */
-    toImage: () => Promise<ImageSource>;
-    /**
-     * Gets the response body as file.
-     */
-    toFile: (destinationFilePath?: string) => File;
+	/**
+	 * Gets the response body as raw data.
+	 */
+	raw: any;
+
+	/**
+	 * Gets the response body as ArrayBuffer
+	 */
+	toArrayBuffer: () => ArrayBuffer;
+
+	/**
+	 * Gets the response body as string.
+	 */
+	toString: (encoding?: HttpResponseEncoding) => string;
+
+	/**
+	 * Gets the response body as JSON object.
+	 */
+	toJSON: (encoding?: HttpResponseEncoding) => any;
+
+	/**
+	 * Gets the response body as ImageSource.
+	 */
+	toImage: () => Promise<ImageSource>;
+
+	/**
+	 * Gets the response body as file.
+	 */
+	toFile: (destinationFilePath?: string) => File;
 }
-export declare function getString(arg: any): Promise<string>;
-export declare function getJSON<T>(arg: any): Promise<T>;
-export declare function getImage(arg: any): Promise<ImageSource>;
-export declare function getFile(arg: any, destinationFilePath?: string): Promise<any>;
-export declare function getBinary(arg: any): Promise<ArrayBuffer>;

package/image-asset/index.d.ts

@@ -0,0 +1,17 @@
+import { Observable } from '../data/observable';
+
+export class ImageAsset extends Observable {
+	constructor(asset: any);
+	getImageAsync(callback: (image: any, error: any) => void); //UIImage for iOS and android.graphics.Bitmap for Android
+	ios: any; //PHAsset
+	nativeImage: any; //UIImage for iOS and android.graphics.Bitmap for Android
+	android: any;
+	options: ImageAssetOptions;
+}
+
+export interface ImageAssetOptions {
+	width?: number;
+	height?: number;
+	keepAspectRatio?: boolean;
+	autoScaleFactor?: boolean;
+}