@unbound-app/api 2.2.0 → 3.1.0

package/src/_internal.d.ts

@@ -35,8 +35,8 @@ export declare const ADDON_SCOPE_GLOBALS: readonly [
 	'clearInterval',
 	'commands',
 ];
-/** The core settings store; each addon's settings store is named after the addon id. */
-export declare const CORE_SETTINGS_STORE = 'unbound';
+/** The core Bucket; each addon's Bucket is named after the addon id. */
+export declare const CORE_BUCKET = 'unbound';
 /** The components of Discord's design module, each of which Unbound can stand in for when Discord drops it. */
 export declare const DESIGN_COMPONENTS: readonly [
 	'SearchBar',
@@ -78,7 +78,7 @@ export declare const DESIGN_COMPONENTS: readonly [
 	'ContextMenu',
 ];
 /** Every capability name a manifest may declare; an unknown name fails manifest validation. */
-export declare const NATIVE_PLUGIN_CAPABILITIES: readonly [
+export declare const NATIVE_BRIDGE_CAPABILITIES: readonly [
 	'native.objc.classes',
 	'native.objc.invoke',
 	'native.objc.invokeAsync',
@@ -103,8 +103,11 @@ export declare const NATIVE_PLUGIN_CAPABILITIES: readonly [
 	'native.debug.evaluations',
 	'native.debug.environment',
 ];
-/** The Capability each native bridge method needs. */
-export declare const NATIVE_PLUGIN_METHOD_CAPABILITIES: {
+/**
+ * The Capability each native bridge method needs; the source of every Capability name. Edit it, then run
+ * `bun run generate-native-capabilities` to regenerate the client's and the loader's Capability lists.
+ */
+export declare const NATIVE_BRIDGE_METHOD_CAPABILITIES: {
 	readonly 'objc.getClass': 'native.objc.classes';
 	readonly 'objc.alloc': 'native.objc.classes';
 	readonly 'objc.create': 'native.objc.invoke';
@@ -145,6 +148,7 @@ export declare const NATIVE_PLUGIN_METHOD_CAPABILITIES: {
 	readonly 'fabric.updateAsync': 'native.fabric.async';
 	readonly 'fabric.setSizeAsync': 'native.fabric.async';
 	readonly 'fabric.setFrameAsync': 'native.fabric.async';
+	readonly 'fabric.batchAsync': 'native.fabric.async';
 	readonly 'fabric.measureAsync': 'native.fabric.async';
 	readonly 'fabric.unmountAsync': 'native.fabric.async';
 	readonly 'fabric.releaseIdleAsync': 'native.fabric.async';
@@ -176,43 +180,44 @@ export declare const NATIVE_PLUGIN_METHOD_CAPABILITIES: {
 	readonly 'hooks.removeReturnValue': 'native.java.hooks';
 	readonly 'hooks.clearReturnValues': 'native.java.hooks';
 	readonly 'hooks.remove': 'native.java.hooks';
+	readonly 'hooks.proxy': 'native.java.hooks';
 };
 /** The host platforms a native bridge runs on. */
-export declare const NATIVE_PLUGIN_PLATFORMS: readonly ['ios', 'android'];
+export declare const NATIVE_BRIDGE_PLATFORMS: readonly ['ios', 'android'];
 /** The capabilities each platform's loader offers; Objective-C ones are iOS only and Java ones Android only. */
-export declare const NATIVE_PLUGIN_PLATFORM_CAPABILITIES: {
+export declare const NATIVE_BRIDGE_PLATFORM_CAPABILITIES: {
+	readonly ios: readonly [
+		'native.objc.classes',
+		'native.objc.invoke',
+		'native.objc.invokeAsync',
+		'native.objc.batch',
+		'native.objc.snapshot',
+		'native.objc.ivars',
+		'native.objc.associations',
+		'native.objc.hooks',
+		'native.ffi.symbols',
+		'native.ffi.call',
+		'native.fabric.mount',
+		'native.fabric.async',
+		'native.runtime.events',
+		'native.debug.evaluations',
+		'native.debug.environment',
+	];
 	readonly android: readonly [
+		'native.ffi.symbols',
+		'native.ffi.call',
+		'native.fabric.async',
+		'native.runtime.events',
 		'native.java.classes',
 		'native.java.construct',
 		'native.java.fields',
 		'native.java.invoke',
-		'native.fabric.async',
-		'native.ffi.call',
-		'native.ffi.symbols',
-		'native.java.associations',
-		'native.java.batch',
-		'native.java.hooks',
 		'native.java.invokeAsync',
-		'native.runtime.events',
-		'native.debug.environment',
+		'native.java.hooks',
+		'native.java.batch',
+		'native.java.associations',
 		'native.debug.evaluations',
-	];
-	readonly ios: readonly [
-		'native.fabric.async',
-		'native.fabric.mount',
-		'native.ffi.call',
-		'native.ffi.symbols',
-		'native.objc.associations',
-		'native.objc.batch',
-		'native.objc.classes',
-		'native.objc.hooks',
-		'native.objc.invoke',
-		'native.objc.invokeAsync',
-		'native.objc.ivars',
-		'native.objc.snapshot',
 		'native.debug.environment',
-		'native.debug.evaluations',
-		'native.runtime.events',
 	];
 };
 /** The design components Discord added after the build the generated types describe; see {@link NewerDesignComponents}. */
@@ -470,8 +475,12 @@ export type AddonLogger = Record<
 	'log' | 'info' | 'success' | 'warn' | 'error' | 'debug',
 	(...args: unknown[]) => void
 >;
-/** A loaded addon's manifest: the {@link AuthoredAddonManifest} plus what the loader and installer record. */
+/** A loaded addon's manifest: the {@link AuthoredAddonManifest} plus what `ubd build`, the loader and installer record. */
 export type AddonManifest = AuthoredAddonManifest & {
+	/** Written by `ubd build` from the native calls in the code: the platforms the addon runs on, each with the capabilities it needs there; absent means every platform. */
+	platforms?: AddonPlatforms;
+	/** Legacy: capabilities needed on every platform, from a manifest that declares them by hand; `ubd build` writes `platforms` instead. */
+	capabilities?: NativeBridgeCapability[];
 	/** Set by the loader for an addon it read from disk: the addon's folder name. */
 	folder?: string;
 	/** Set by the loader for an addon it read from disk: the addon's absolute directory. */
@@ -480,13 +489,13 @@ export type AddonManifest = AuthoredAddonManifest & {
 	trust?: AddonTrust;
 };
 /** What an addon declares for one platform it runs on: the capabilities that platform provides which it needs. */
-export type AddonPlatform<P extends NativePluginPlatform = NativePluginPlatform> = {
+export type AddonPlatform<P extends NativeBridgePlatform = NativeBridgePlatform> = {
 	/** Capabilities needed on this platform only, added to the manifest's top-level `capabilities`. */
-	capabilities?: NativePluginPlatformCapability<P>[];
+	capabilities?: NativeBridgePlatformCapability<P>[];
 };
 /** The platforms an addon runs on, keyed by platform. */
 export type AddonPlatforms = {
-	[P in NativePluginPlatform]?: AddonPlatform<P>;
+	[P in NativeBridgePlatform]?: AddonPlatform<P>;
 };
 /** Whether an addon's bundle carries a valid Unbound signature. */
 export type AddonTrust = 'signed' | 'unsigned';
@@ -564,12 +573,8 @@ export type AuthoredAddonManifest = {
 	main: string;
 	/** The addon's version, in strict SemVer 2.0.0 with no `v` prefix. */
 	version: string;
-	/** The platforms the addon runs on, each with the capabilities it needs there; absent means every platform. */
-	platforms?: AddonPlatforms;
-	/** Capabilities the addon needs on every platform it runs on. */
-	capabilities?: NativePluginCapability[];
-	/** The lowest native plugin API version the addon supports; an older native bridge fails its start. */
-	minNativePluginApi?: string;
+	/** The lowest native bridge API version the addon supports; an older native bridge fails its start. */
+	minNativeBridgeApi?: string;
 	/** The Ed25519 signature the Unbound team's publish pipeline puts on first-party plugins. */
 	signature?: {
 		version: 1;
@@ -3085,8 +3090,8 @@ export type FloatingActionButtonProps = Omit<
 	/** @default 16 */
 	positionRight?: number;
 };
-/** A font face managed by the Fonts manager, as `UnboundNative.fonts.list()` returns it. */
-export type FontEntity = UnboundInstalledFont;
+/** An installed font, as `UnboundNative.fonts.list()` returns it. */
+export type Font = UnboundInstalledFont;
 /**
  * Props of `FormLabel` (function). Exports: default.
  * @see design/void/Form/native/FormLabel.tsx
@@ -3401,6 +3406,15 @@ export type LayerScopeProps = {
 	children?: React$1.ReactNode;
 	zIndex?: number;
 };
+/** The raw bridge the loader publishes as `globalThis.NativePlugin`; `objc` exists only on iOS, `java` and `hooks` only on Android. */
+export type LoaderNativeBridge = Pick<
+	NativeBridge,
+	'apiVersion' | 'abiVersion' | 'capabilities' | 'ffi' | 'fabric' | 'debug'
+> &
+	Partial<Pick<NativeBridge, 'hooks'>> & {
+		readonly objc?: LoaderObjCBridge;
+		readonly java?: NativeJavaBridge & NativeUIScopeFactory;
+	};
 /** The `objc` namespace the loader publishes, before the client adds `create` and scopes it to a plugin. */
 export type LoaderObjCBridge = Omit<NativeObjCBridge, 'create'> & NativeUIScopeFactory;
 /**
@@ -3784,6 +3798,65 @@ export type NativeBatchStep = {
 	/** The call's arguments, at most 16; each may be an earlier step's result. */
 	args: unknown[];
 };
+/** The native bridge a plugin reaches through `context.native`, gated by the capabilities it declares. */
+export type NativeBridge = {
+	/** The version of the JavaScript API plugins use, compared with a manifest's `minNativeBridgeApi`. */
+	readonly apiVersion: string;
+	/** The version of the native ABI the loader implements. */
+	readonly abiVersion: string;
+	/** Every capability this loader build provides, not only the ones the plugin declares. */
+	readonly capabilities: readonly NativeBridgeCapability[];
+	/** The Objective-C runtime; iOS only. */
+	readonly objc: NativeObjCBridge;
+	/** Raw calls to C functions. */
+	readonly ffi: NativeFFIBridge;
+	/** React Native surfaces mounted in native views. */
+	readonly fabric: NativeFabricBridge;
+	/** Subscriptions to Discord activity. */
+	readonly runtime: NativeRuntimeBridge;
+	/** Java reflection; Android only. */
+	readonly java: NativeJavaBridge;
+	/** Java method hooks; Android only. */
+	readonly hooks: NativeJavaHooksBridge;
+	/** Debugger support. */
+	readonly debug: NativeDebugBridge;
+	/** Worklets on the UI runtime. */
+	readonly ui: NativeUIBridge;
+};
+/** A named permission to use one part of the native bridge, declared in an addon's manifest. */
+export type NativeBridgeCapability = (typeof NATIVE_BRIDGE_METHOD_CAPABILITIES)[NativeBridgeMethod];
+/** The shape of an error the native bridge or its plugin scope throws. */
+export type NativeBridgeError = {
+	/** Which failure it is; native failures without their own code use `NATIVE_BRIDGE_ERROR`. */
+	code: NativeBridgeErrorCode;
+	/** A human-readable description. */
+	message: string;
+	/** The capability the plugin lacks, for `NATIVE_PLUGIN_CAPABILITY_DENIED`. */
+	capability?: NativeBridgeCapability;
+};
+/** The stable `code` on an error the native bridge or its plugin scope throws. */
+export type NativeBridgeErrorCode =
+	| 'NATIVE_BRIDGE_ERROR'
+	| 'NATIVE_PLUGIN_API_VERSION_UNSUPPORTED'
+	| 'NATIVE_PLUGIN_CALL_CANCELLED'
+	| 'NATIVE_PLUGIN_CALL_TIMEOUT'
+	| 'NATIVE_PLUGIN_CAPABILITY_DENIED'
+	| 'NATIVE_PLUGIN_SCOPE_DISPOSED'
+	| 'NATIVE_PLUGIN_UNAVAILABLE';
+/** A native bridge method by the path a plugin calls it through, such as `objc.invoke`. */
+export type NativeBridgeMethod = {
+	[N in NativeBridgeNamespace]: `${N}.${keyof NativeBridge[N] & string}`;
+}[NativeBridgeNamespace];
+/** A {@link NativeBridge} namespace whose methods a plugin calls, such as `objc` or `java`. */
+export type NativeBridgeNamespace = Exclude<
+	keyof NativeBridge,
+	'apiVersion' | 'abiVersion' | 'capabilities' | 'ui'
+>;
+/** A host platform the loader reports, `ios` or `android`. */
+export type NativeBridgePlatform = (typeof NATIVE_BRIDGE_PLATFORMS)[number];
+/** A capability the native bridge on platform `P` provides. */
+export type NativeBridgePlatformCapability<P extends NativeBridgePlatform> =
+	(typeof NATIVE_BRIDGE_PLATFORM_CAPABILITIES)[P][number];
 /** Options for a synchronous Objective-C call. */
 export type NativeCallOptions = {
 	/** The thread to run on. Defaults to `current`. */
@@ -3898,6 +3971,20 @@ export type NativeFFITypeName =
 	| 'object'
 	| 'class'
 	| 'selector';
+/** One surface's changes in a `batchAsync` call, applied as properties, then size, then frame. */
+export type NativeFabricBatchMutation = {
+	/** The surface these changes apply to. */
+	surface: NativeFabricSurface;
+	/** New properties, as `update` sends them. */
+	properties?: NativeSerializableObject;
+	/** The view's frame, as `setFrame` sets it. */
+	frame?: NativeFabricFrame;
+	/** The layout bounds, as `setSize` sets them. */
+	size?: {
+		minimum: NativeFabricSize;
+		maximum: NativeFabricSize;
+	};
+};
 /** Mounts registered React Native components inside existing native views. Sync methods are iOS only. */
 export type NativeFabricBridge = {
 	/** Starts a surface for a registered component inside a container view. Needs `native.fabric.mount`. */
@@ -3940,6 +4027,8 @@ export type NativeFabricBridge = {
 		surface: NativeFabricSurface,
 		frame: NativeFabricFrame,
 	): NativeCancelablePromise<void>;
+	/** Applies every mutation in order on the main thread's next display frame, skipping stopped surfaces. Needs `native.fabric.async`. */
+	batchAsync(mutations: NativeFabricBatchMutation[]): NativeCancelablePromise<void>;
 	/** Reads a view's frame. */
 	measure(view: NativeObjectHandle): NativeFabricFrame;
 	/** Like `measure`, on the main thread. */
@@ -4213,9 +4302,16 @@ export type NativeJavaHookOptions<Receiver extends boolean = boolean> = {
 	replace?: boolean;
 	/** Whether the listener hears calls: before the method by default, `after` once it has run, `false` never. */
 	notify?: boolean | 'after';
+	/** Lets a `before` listener hooked from a UI scope return `{ arguments }` to run the method with them instead. */
+	rewriteArguments?: boolean;
 	/** Trims the receiver, arguments and phase each event sends, to cut crossing cost on hot methods. */
 	payload?: NativeHookPayload<Receiver>;
 };
+/** What a `rewriteArguments` listener returns to run the hooked method with other arguments, one per parameter. */
+export type NativeJavaHookRewrite = {
+	/** The arguments to run the method with, in parameter order. */
+	arguments: NativeJavaArgument[];
+};
 /** An installed Java hook; the plugin scope removes it on dispose. */
 export type NativeJavaHookToken = {
 	/** The id the loader issued, such as `hook-1`. */
@@ -4229,7 +4325,7 @@ export type NativeJavaHooksBridge = {
 		methodName: string,
 		parameterTypes: string[],
 		options?: NativeJavaHookOptions<Receiver>,
-		listener?: (event: NativeJavaHookEvent<Receiver>) => void,
+		listener?: (event: NativeJavaHookEvent<Receiver>) => NativeJavaHookRewrite | void,
 	): NativeJavaHookToken;
 	/** Sets the result a `replace` hook returns for calls with this receiver and these arguments. */
 	setReturnValue(
@@ -4246,8 +4342,16 @@ export type NativeJavaHooksBridge = {
 	): void;
 	/** Removes every result set on a hook. */
 	clearReturnValues(token: NativeJavaHookToken): void;
-	/** Removes a hook. */
+	/** Removes a hook or a proxy. */
 	remove(token: NativeJavaHookToken): void;
+	/**
+	 * Creates a Java object implementing `interfaces`, from a UI scope only. Calls on the main thread run `handler`
+	 * inline and return its value; calls on other threads reach it later and return the type's default.
+	 */
+	proxy(
+		interfaces: string[],
+		handler: (call: NativeJavaProxyCall) => NativeJavaArgument | void,
+	): NativeJavaProxy;
 };
 /** One method a Java class declares, from `java.describe`. */
 export type NativeJavaMethodDescription = {
@@ -4260,6 +4364,20 @@ export type NativeJavaMethodDescription = {
 	/** Whether the method is static. */
 	static: boolean;
 };
+/** A Java object implementing interfaces through a handler; remove its token to stop it answering. */
+export type NativeJavaProxy = {
+	/** Removes the proxy with `hooks.remove`; the UI scope removes it on dispose. */
+	token: NativeJavaHookToken;
+	/** The object to pass wherever Java expects one of the interfaces. */
+	object: NativeJavaHandle;
+};
+/** What a proxy handler receives for one call of an interface method. */
+export type NativeJavaProxyCall = {
+	/** The interface method's name, such as `onPreDraw`. */
+	method: string;
+	/** The call's arguments. */
+	args: NativeJavaValue[];
+};
 /** A Java object, as a handle or as a tagged handle value from a result. */
 export type NativeJavaReference = NativeJavaHandle | NativeJavaHandleValue;
 /** A Java value tagged with its type, as the Java bridge returns and accepts it. */
@@ -4489,6 +4607,8 @@ export type NativePlatformAndroidInstaller = {
 export type NativePlatformApp = {
 	/** Where Discord was installed from, such as `App Store` or `Google Play`. */
 	getAppSource(): string;
+	/** How an iOS install was signed: certificate kind, team, profile expiry, sideload tool marker and entitlement source. */
+	getInstallDetails?(): string;
 	/** The framework that injected the loader, such as Vector or LSPosed on Android and ElleKit on iOS, or an empty string. */
 	getFramework(): string;
 	/** Whether the loader's embedded attestation verified against Unbound's pinned key. False for development builds. */
@@ -4499,7 +4619,7 @@ export type NativePlatformApp = {
 /** Platform-wide helpers the loader publishes as `globalThis.NativePlatform`, not scoped to a plugin. */
 export type NativePlatformBridge = {
 	/** The host platform. */
-	readonly platform: NativePluginPlatform;
+	readonly platform: NativeBridgePlatform;
 	/** Evaluates Hermes bytecode in the current runtime; `tag` names it in errors. Throws on invalid bytecode. */
 	evaluateBytecode(bytecode: ArrayBuffer, tag?: string): unknown;
 	/** Facts about the device. */
@@ -4539,7 +4659,7 @@ export type NativePlatformCrashGuard = {
 /** Facts about the device Discord runs on. */
 export type NativePlatformDevice = {
 	/** The host platform. */
-	readonly platform: NativePluginPlatform;
+	readonly platform: NativeBridgePlatform;
 	/** The device's model name. */
 	getDeviceModel(): string;
 	/** The operating system's version. */
@@ -4592,74 +4712,6 @@ export type NativePlatformSettings = {
 	/** Reads every Bucket with no arguments, one Bucket with `store`, or one dot-path `key`; `undefined` when unset. */
 	get(store?: string, key?: string): NativeSerializable | undefined;
 };
-/** The native bridge a plugin reaches through `context.native`, gated by the capabilities it declares. */
-export type NativePluginBridge = {
-	/** The version of the JavaScript API plugins use, compared with a manifest's `minNativePluginApi`. */
-	readonly apiVersion: string;
-	/** The version of the native ABI the loader implements. */
-	readonly abiVersion: string;
-	/** Every capability this loader build provides, not only the ones the plugin declares. */
-	readonly capabilities: readonly NativePluginCapability[];
-	/** The Objective-C runtime; iOS only. */
-	readonly objc: NativeObjCBridge;
-	/** Raw calls to C functions. */
-	readonly ffi: NativeFFIBridge;
-	/** React Native surfaces mounted in native views. */
-	readonly fabric: NativeFabricBridge;
-	/** Subscriptions to Discord activity. */
-	readonly runtime: NativeRuntimeBridge;
-	/** Java reflection; Android only. */
-	readonly java: NativeJavaBridge;
-	/** Java method hooks; Android only. */
-	readonly hooks: NativeJavaHooksBridge;
-	/** Debugger support. */
-	readonly debug: NativeDebugBridge;
-	/** Worklets on the UI runtime. */
-	readonly ui: NativeUIBridge;
-};
-/** A named permission to use one part of the native bridge, declared in an addon's manifest. */
-export type NativePluginCapability = (typeof NATIVE_PLUGIN_CAPABILITIES)[number];
-/** The shape of an error the native bridge or its plugin scope throws. */
-export type NativePluginError = {
-	/** Which failure it is; native failures without their own code use `NATIVE_BRIDGE_ERROR`. */
-	code: NativePluginErrorCode;
-	/** A human-readable description. */
-	message: string;
-	/** The capability the plugin lacks, for `NATIVE_PLUGIN_CAPABILITY_DENIED`. */
-	capability?: NativePluginCapability;
-};
-/** The stable `code` on an error the native bridge or its plugin scope throws. */
-export type NativePluginErrorCode =
-	| 'NATIVE_BRIDGE_ERROR'
-	| 'NATIVE_PLUGIN_API_VERSION_UNSUPPORTED'
-	| 'NATIVE_PLUGIN_CALL_CANCELLED'
-	| 'NATIVE_PLUGIN_CALL_TIMEOUT'
-	| 'NATIVE_PLUGIN_CAPABILITY_DENIED'
-	| 'NATIVE_PLUGIN_SCOPE_DISPOSED'
-	| 'NATIVE_PLUGIN_UNAVAILABLE';
-/** A native bridge method by the path a plugin calls it through, such as `objc.invoke`. */
-export type NativePluginMethod = {
-	[N in NativePluginNamespace]: `${N}.${keyof NativePluginBridge[N] & string}`;
-}[NativePluginNamespace];
-/** A {@link NativePluginBridge} namespace whose methods a plugin calls, such as `objc` or `java`. */
-export type NativePluginNamespace = Exclude<
-	keyof NativePluginBridge,
-	'apiVersion' | 'abiVersion' | 'capabilities' | 'ui'
->;
-/** A host platform the loader reports, `ios` or `android`. */
-export type NativePluginPlatform = (typeof NATIVE_PLUGIN_PLATFORMS)[number];
-/** A capability the native bridge on platform `P` provides. */
-export type NativePluginPlatformCapability<P extends NativePluginPlatform> =
-	(typeof NATIVE_PLUGIN_PLATFORM_CAPABILITIES)[P][number];
-/** The raw bridge the loader publishes as `globalThis.NativePlugin`; `objc` exists only on iOS, `java` and `hooks` only on Android. */
-export type NativePluginRuntimeBridge = Pick<
-	NativePluginBridge,
-	'apiVersion' | 'abiVersion' | 'capabilities' | 'ffi' | 'fabric' | 'debug'
-> &
-	Partial<Pick<NativePluginBridge, 'hooks'>> & {
-		readonly objc?: LoaderObjCBridge;
-		readonly java?: NativeJavaBridge & NativeUIScopeFactory;
-	};
 /** A handle to a native symbol's address, from `ffi.symbol`; `ffi.call` accepts only these. */
 export type NativePointer = NativeHandle;
 /** How many native resources the loader holds across every plugin. */
@@ -5148,21 +5200,34 @@ export type PluginContext = {
 	/** The plugin's id, from its manifest. */
 	readonly id: string;
 	/** The host platform, or `undefined` when the loader reports none. */
-	readonly platform?: NativePluginPlatform;
+	readonly platform?: NativeBridgePlatform;
 	/** The capabilities the manifest declares for this platform; `native` allows only these. */
-	readonly capabilities: readonly NativePluginCapability[];
+	readonly capabilities: readonly NativeBridgeCapability[];
 	/** The native bridge, scoped to the plugin's capabilities. */
-	readonly native: NativePluginBridge;
+	readonly native: NativeBridge;
 	/** Releases the plugin's hooks, surfaces, handles and subscriptions; the addon manager calls it on stop, unload, reload or a failed start. */
 	dispose(): void;
 };
 /** What a plugin's self-test found: whether the plugin works on this device, and why. */
-export type PluginSelfTestResult = {
-	/** `true` when the plugin works on this device. */
-	ok: boolean;
-	/** A human-readable reason for the result. */
-	detail: string;
-};
+export type PluginSelfTestResult =
+	| {
+			/** The plugin works on this device. */
+			ok: true;
+			/** A human-readable reason for the result. */
+			detail: string;
+			/** Set when the plugin works but has nothing on screen to draw, which says where the chat is rather than that drawing is wrong. */
+			nothingDrawn?: boolean;
+			/** Set while the plugin is still drawing what is on screen, so the device matrix waits before timing or judging it. */
+			settling?: boolean;
+	  }
+	| {
+			/** The plugin does not work on this device. */
+			ok: false;
+			/** A human-readable reason for the result. */
+			detail: string;
+			/** Set when the plugin failed only because it has nothing on screen to draw. */
+			nothingDrawn?: boolean;
+	  };
 /**
  * Props of `PostponeRender` (function). Exports: PostponeRender.
  * @see design/components/Navigator/native/PostponeRender.native.tsx
@@ -5531,7 +5596,7 @@ export type SettingsGroupSchema = SettingCommon & {
 	displayAs: 'group' | 'collapsible';
 	properties: Record<string, SettingSchema | StorelessSchema>;
 };
-/** A settings store, or a nested group of settings within one. */
+/** A Bucket, or a nested group of settings within one. */
 export type SettingsObject = {
 	[key: string]: SettingsValue;
 };
@@ -5551,7 +5616,7 @@ export type SettingsScreen = {
 	/** Discord's navigator renders the screen with its own route props, so any component fits. */
 	getComponent: () => React$1.ComponentType<never>;
 };
-/** A JSON value held in a settings store. */
+/** A JSON value held in a Bucket. */
 export type SettingsValue = string | number | boolean | null | SettingsValue[] | SettingsObject;
 export type SheetBottomSheetComponent = React$1.ComponentType<
 	SheetBottomSheetProps & Record<string, unknown>
@@ -6483,6 +6548,21 @@ export type UnboundAsset = DiscordAsset & {
 	/** The URI of a registered plugin asset at each scale; set while it is registered. */
 	unboundSources?: Record<number, string>;
 };
+/** One design axis of a variable font, such as `wght` from 100 to 900. */
+export type UnboundFontAxis = {
+	/** The four-letter tag, such as `wght`, `wdth` or `slnt`. */
+	tag: string;
+	/** The name the font gives it, such as `Weight`. */
+	name: string;
+	/** The lowest value the axis accepts. */
+	min: number;
+	/** The value a face draws at when the axis is not set. */
+	default: number;
+	/** The highest value the axis accepts. */
+	max: number;
+	/** The font asks apps not to offer it. */
+	hidden: boolean;
+};
 /**
  * One installed face in the loader's font store.
  * @internal
@@ -6500,6 +6580,10 @@ type UnboundInstalledFont = {
 	/** The file's absolute path; `list()` adds it. */
 	path?: string;
 	source: UnboundFontSource;
+	/** A variable font's design axes; absent for a static face. */
+	axes?: UnboundFontAxis[];
+	/** The coordinate on each axis this face draws at, such as `{ wght: 650 }`; absent for a static face. */
+	variations?: Record<string, number>;
 };
 /** A value the generator could not type with confidence, so a loose prop accepts anything for it. */
 export type UncertainValue = any;

package/src/builtins.d.ts

@@ -4,10 +4,12 @@
 export declare const register: (name: string, builtin: BuiltIn) => void;
 /** Stops the built-in feature registered under a name. */
 export declare const unregister: (name: string) => void;
-/** A built-in feature exposing optional `start`/`stop` lifecycle hooks. */
+/** A built-in feature exposing optional `start`/`afterAddons`/`stop` lifecycle hooks. */
 export type BuiltIn = {
-	/** Runs when the built-in is registered; if it throws, the built-in is logged and left inactive. */
+	/** Runs when the built-in is registered, before the addon managers load; if it throws, the built-in is logged and left inactive. */
 	start?: () => void;
+	/** Runs once the addon managers have loaded their addons, for work that reads them. */
+	afterAddons?: () => void;
 	/** Runs when the built-in is unregistered or the built-ins shut down, in reverse start order. */
 	stop?: () => void;
 	/** Checked once at initialisation; returning `false` skips registering the built-in. */

package/src/global.d.ts

@@ -90,7 +90,7 @@ export type {
 	ButtonPillProps,
 	ButtonSchema,
 	ButtonShineProps,
-	CORE_SETTINGS_STORE,
+	CORE_BUCKET,
 	Callback,
 	CameraLottieComponent,
 	CameraLottieProps,
@@ -145,7 +145,7 @@ export type {
 	FauxHeaderProps,
 	FloatingActionButtonComponent,
 	FloatingActionButtonProps,
-	FontEntity,
+	Font,
 	FormLabelProps,
 	FormRowProps,
 	FormSubLabelProps,
@@ -181,6 +181,7 @@ export type {
 	InternalToastOptions,
 	LayerScopeComponent,
 	LayerScopeProps,
+	LoaderNativeBridge,
 	LoaderObjCBridge,
 	LoadingButtonPillProps,
 	LooseComponent,
@@ -228,10 +229,10 @@ export type {
 	ModalScreenProps,
 	ModalStepIndicatorComponent,
 	ModalStepIndicatorProps,
-	NATIVE_PLUGIN_CAPABILITIES,
-	NATIVE_PLUGIN_METHOD_CAPABILITIES,
-	NATIVE_PLUGIN_PLATFORMS,
-	NATIVE_PLUGIN_PLATFORM_CAPABILITIES,
+	NATIVE_BRIDGE_CAPABILITIES,
+	NATIVE_BRIDGE_METHOD_CAPABILITIES,
+	NATIVE_BRIDGE_PLATFORMS,
+	NATIVE_BRIDGE_PLATFORM_CAPABILITIES,
 	NEWER_DESIGN_COMPONENTS,
 	NativeAddonVerification,
 	NativeAndroidInstallPhase,
@@ -242,6 +243,14 @@ export type {
 	NativeAssociationKey,
 	NativeBatchReference,
 	NativeBatchStep,
+	NativeBridge,
+	NativeBridgeCapability,
+	NativeBridgeError,
+	NativeBridgeErrorCode,
+	NativeBridgeMethod,
+	NativeBridgeNamespace,
+	NativeBridgePlatform,
+	NativeBridgePlatformCapability,
 	NativeCallOptions,
 	NativeCancelablePromise,
 	NativeClassHandle,
@@ -257,6 +266,7 @@ export type {
 	NativeFFISignature,
 	NativeFFIType,
 	NativeFFITypeName,
+	NativeFabricBatchMutation,
 	NativeFabricBridge,
 	NativeFabricFrame,
 	NativeFabricMountOptions,
@@ -282,9 +292,12 @@ export type {
 	NativeJavaHandleValue,
 	NativeJavaHookEvent,
 	NativeJavaHookOptions,
+	NativeJavaHookRewrite,
 	NativeJavaHookToken,
 	NativeJavaHooksBridge,
 	NativeJavaMethodDescription,
+	NativeJavaProxy,
+	NativeJavaProxyCall,
 	NativeJavaReference,
 	NativeJavaValue,
 	NativeMainWaitCounts,
@@ -305,15 +318,6 @@ export type {
 	NativePlatformIOSBridge,
 	NativePlatformProfiler,
 	NativePlatformSettings,
-	NativePluginBridge,
-	NativePluginCapability,
-	NativePluginError,
-	NativePluginErrorCode,
-	NativePluginMethod,
-	NativePluginNamespace,
-	NativePluginPlatform,
-	NativePluginPlatformCapability,
-	NativePluginRuntimeBridge,
 	NativePointer,
 	NativeResourceCounts,
 	NativeRuntimeBridge,
@@ -512,6 +516,7 @@ export type {
 	TransitionState,
 	UnboundAppIcon,
 	UnboundAsset,
+	UnboundFontAxis,
 	UncertainValue,
 	VisualEffectViewProps,
 	VoidIconProps,
@@ -563,13 +568,13 @@ export type AddonScope = {
 /** The lifecycle entry points, all the global `unbound` object keeps after {@link shutdown}. */
 export interface UnboundLifecycle {
 	/**
-	 * @description Brings up the client, initialising the built-ins, plugins, and themes managers in turn. Twin of
-	 * {@link shutdown}.
+	 * @description Brings up the client: registers the addon managers, starts the built-ins, loads each kind's addons,
+	 * then runs the built-ins' `afterAddons` hooks. Twin of {@link shutdown}.
 	 */
 	initialize(): void;
 	/**
-	 * @description Tears the client back down, shutting down the built-ins, plugins, and themes managers and persisting
-	 * settings before clearing the global down to the lifecycle entry points. Twin of {@link initialize}.
+	 * @description Tears the client back down: stops the built-ins, shuts down each kind's manager, persists settings,
+	 * unregisters the managers and clears the global down to the lifecycle entry points. Twin of {@link initialize}.
 	 * @returns A promise that resolves once settings have been persisted and shutdown is complete.
 	 */
 	shutdown(): Promise<void>;