@unbound-app/api 0.11.0 → 1.1.1

package/src/_internal.d.ts

@@ -1,8 +1,8 @@
 // Auto-generated by generate-plugin-sdk.ts - DO NOT EDIT
 
-import type { LiteralUnion } from './utils';
+import type { LiteralUnion } from './_types';
 import * as React$1 from 'react';
-import { ComponentType, ReactNode } from 'react';
+import { ComponentType, FunctionComponent, ReactElement, ReactNode } from 'react';
 import * as RN from 'react-native';
 import { ImageSourcePropType, ImageStyle, TextStyle, ViewStyle } from 'react-native';
 
@@ -15,10 +15,32 @@ declare const THEME_FLAG_KEYS: readonly [
 ];
 declare const TRANSITION_STATE_KEYS: readonly ['MOUNTED', 'ENTERED', 'YEETED'];
 declare const nativeHandle: unique symbol;
-/** The kinds of addon a manifest can declare. */
-export declare const ADDON_TYPES: readonly ['plugin', 'theme', 'icon-pack', 'font'];
+declare const nativeJavaCallPlan: unique symbol;
+declare const nativeObjCCallPlan: unique symbol;
+/** The kinds of addon, as a manifest's `type` declares them. One manager governs each, in this start order. */
+export declare const ADDON_KINDS: readonly ['plugin', 'theme', 'icon-pack', 'font'];
+/**
+ * The globals a plugin bundle is evaluated with, in parameter order. Bytecode compiled against an earlier
+ * list receives them by position, so new globals are only ever appended.
+ */
+export declare const ADDON_SCOPE_GLOBALS: readonly [
+	'React',
+	'unbound',
+	'addon',
+	'patcher',
+	'logger',
+	'setTimeout',
+	'setInterval',
+	'clearTimeout',
+	'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 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',
+	'Badge',
 	'Text',
 	'Heading',
 	'TableRow',
@@ -55,6 +77,7 @@ export declare const DESIGN_COMPONENTS: readonly [
 	'ActionSheetRow',
 	'ContextMenu',
 ];
+/** Every capability name a manifest may declare; an unknown name fails manifest validation. */
 export declare const NATIVE_PLUGIN_CAPABILITIES: readonly [
 	'native.objc.classes',
 	'native.objc.invoke',
@@ -80,6 +103,83 @@ 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: {
+	readonly 'objc.getClass': 'native.objc.classes';
+	readonly 'objc.alloc': 'native.objc.classes';
+	readonly 'objc.create': 'native.objc.invoke';
+	readonly 'objc.className': 'native.objc.classes';
+	readonly 'objc.respondsTo': 'native.objc.classes';
+	readonly 'objc.call': 'native.objc.invoke';
+	readonly 'objc.callSuper': 'native.objc.invoke';
+	readonly 'objc.invoke': 'native.objc.invoke';
+	readonly 'objc.prepare': 'native.objc.invoke';
+	readonly 'objc.invokePrepared': 'native.objc.invoke';
+	readonly 'objc.disposePlan': 'native.objc.invoke';
+	readonly 'objc.invokeAsync': 'native.objc.invokeAsync';
+	readonly 'objc.invokePreparedAsync': 'native.objc.invokeAsync';
+	readonly 'objc.batch': 'native.objc.batch';
+	readonly 'objc.snapshot': 'native.objc.snapshot';
+	readonly 'objc.findViews': 'native.objc.snapshot';
+	readonly 'objc.invokeSuper': 'native.objc.invoke';
+	readonly 'objc.invokeSuperAsync': 'native.objc.invokeAsync';
+	readonly 'objc.getIvar': 'native.objc.ivars';
+	readonly 'objc.setIvar': 'native.objc.ivars';
+	readonly 'objc.createAssociationKey': 'native.objc.associations';
+	readonly 'objc.getAssociatedObject': 'native.objc.associations';
+	readonly 'objc.setAssociatedObject': 'native.objc.associations';
+	readonly 'objc.struct': 'native.objc.classes';
+	readonly 'objc.array': 'native.objc.classes';
+	readonly 'objc.data': 'native.objc.classes';
+	readonly 'objc.hook': 'native.objc.hooks';
+	readonly 'ffi.symbol': 'native.ffi.symbols';
+	readonly 'ffi.call': 'native.ffi.call';
+	readonly 'fabric.mount': 'native.fabric.mount';
+	readonly 'fabric.update': 'native.fabric.mount';
+	readonly 'fabric.setSize': 'native.fabric.mount';
+	readonly 'fabric.setFrame': 'native.fabric.mount';
+	readonly 'fabric.measure': 'native.fabric.mount';
+	readonly 'fabric.unmount': 'native.fabric.mount';
+	readonly 'fabric.releaseIdle': 'native.fabric.mount';
+	readonly 'fabric.mountAsync': 'native.fabric.async';
+	readonly 'fabric.updateAsync': 'native.fabric.async';
+	readonly 'fabric.setSizeAsync': 'native.fabric.async';
+	readonly 'fabric.setFrameAsync': 'native.fabric.async';
+	readonly 'fabric.measureAsync': 'native.fabric.async';
+	readonly 'fabric.unmountAsync': 'native.fabric.async';
+	readonly 'fabric.releaseIdleAsync': 'native.fabric.async';
+	readonly 'runtime.subscribe': 'native.runtime.events';
+	readonly 'java.getClass': 'native.java.classes';
+	readonly 'java.className': 'native.java.classes';
+	readonly 'java.describe': 'native.java.classes';
+	readonly 'java.construct': 'native.java.construct';
+	readonly 'java.respondsTo': 'native.java.classes';
+	readonly 'java.invoke': 'native.java.invoke';
+	readonly 'java.invokeAsync': 'native.java.invokeAsync';
+	readonly 'java.prepare': 'native.java.invoke';
+	readonly 'java.invokePrepared': 'native.java.invoke';
+	readonly 'java.invokePreparedAsync': 'native.java.invokeAsync';
+	readonly 'java.disposePlan': 'native.java.invoke';
+	readonly 'java.getField': 'native.java.fields';
+	readonly 'java.setField': 'native.java.fields';
+	readonly 'java.release': 'native.java.classes';
+	readonly 'java.batch': 'native.java.batch';
+	readonly 'java.batchAsync': 'native.java.batch';
+	readonly 'java.findViews': 'native.java.invoke';
+	readonly 'java.createAssociationKey': 'native.java.associations';
+	readonly 'java.getAssociatedObject': 'native.java.associations';
+	readonly 'java.setAssociatedObject': 'native.java.associations';
+	readonly 'debug.recordEvaluation': 'native.debug.evaluations';
+	readonly 'debug.environment': 'native.debug.environment';
+	readonly 'hooks.hook': 'native.java.hooks';
+	readonly 'hooks.setReturnValue': 'native.java.hooks';
+	readonly 'hooks.removeReturnValue': 'native.java.hooks';
+	readonly 'hooks.clearReturnValues': 'native.java.hooks';
+	readonly 'hooks.remove': 'native.java.hooks';
+};
+/** The host platforms a native bridge runs on. */
+export declare const NATIVE_PLUGIN_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: {
 	readonly android: readonly [
 		'native.java.classes',
@@ -115,6 +215,8 @@ export declare const NATIVE_PLUGIN_PLATFORM_CAPABILITIES: {
 		'native.runtime.events',
 	];
 };
+/** The design components Discord added after the build the generated types describe; see {@link NewerDesignComponents}. */
+export declare const NEWER_DESIGN_COMPONENTS: readonly ['SearchBar', 'Badge'];
 /**
  * Props of `AIGlyphText` (function). Exports: AIGlyphText.
  * @see design/visual-identities/ai/AIGlyphText.native.tsx
@@ -311,69 +413,83 @@ export type ActionSheetSwitchRowComponent = React$1.ComponentType<
  * @see design/components/Sheet/native/ActionSheetRow.native.tsx
  */
 export type ActionSheetSwitchRowProps = TableSwitchRowProps;
-/** A loaded addon entity: its runtime state, instance, source bundle, and {@link AddonManifest}. */
-export type Addon = {
-	started: boolean;
-	/** What the bundle evaluated to. Every addon kind may implement the {@link Plugin} lifecycle hooks. */
-	instance: Plugin$1 | null;
-	context?: PluginContext;
-	id: string;
-	failed: boolean;
-	data: AddonManifest;
-	bundle: string;
+/** One image a plugin ships beside its bundle, as `ubd build` lists it in the manifest. */
+export type AddonAsset = {
+	/** The file type. */
+	type: 'png' | 'jpg' | 'webp' | 'gif';
+	/** Width in points at scale 1. */
+	width: number;
+	/** Height in points at scale 1. */
+	height: number;
+	/** The SHA-256 of the file at each pixel density it ships at; the file is `assets/<sha256>.<type>` beside the bundle. */
+	scales: Partial<Record<'1' | '2' | '3', string>>;
 };
 /** The author of an addon: a display name and a numeric user id. */
 export type AddonAuthor = {
+	/** The name shown for the author. */
 	name: string;
+	/** The author's Discord user id, as a string of digits. */
 	id: `${number}`;
 };
-/** The manifest describing an addon's metadata, entry point, and source. */
-export type AddonManifest = {
-	id: string;
-	/** The addon kind this manifest describes; used to validate installs. */
-	type?: AddonType;
-	name: string;
-	description: string;
-	authors: AddonAuthor[];
-	icon:
-		| (string & {})
-		| {
-				uri: string;
-		  };
-	updates: string;
-	main: string;
-	version: string;
-	folder: string;
-	path: string;
-	url: string;
-	platforms?: NativePluginPlatform[];
-	capabilities?: NativePluginCapability[];
-	platformCapabilities?: Partial<Record<NativePluginPlatform, NativePluginCapability[]>>;
-	minNativePluginApi?: string;
-	/** The Ed25519 signature the Unbound team's publish pipeline puts on first-party plugins. */
-	signature?: {
-		version: 1;
-		ed25519: string;
-	};
-	/** Marks a plugin other plugins build on, which the plugin list hides by default. */
-	library?: boolean;
-	/** The addons this one needs, by id, each with the semver range it accepts, such as `^1.2.0`. */
-	dependencies?: Record<string, string>;
-	/** The SHA-512 of each bundle compiled to Hermes bytecode, by bytecode version; covered by `signature`. */
-	bytecode?: Record<string, string>;
+/**
+ * A loaded plugin, theme or icon pack its manager governs: its manifest and state, and what its manager
+ * does to it. Stringifies to its {@link AddonManifest}.
+ */
+export type AddonHandle = {
+	/** The manifest's `id`. */
+	readonly id: string;
+	/** The manifest's display `name`. */
+	readonly name: string;
+	/** The manifest's `version`. */
+	readonly version: string;
+	/** The manifest's `authors`. */
+	readonly authors: AddonAuthor[];
+	/** The loaded manifest, including what the loader and installer recorded. */
+	readonly manifest: AddonManifest;
+	/** Whether the addon is running. */
+	readonly started: boolean;
+	/** Whether the addon failed to start. */
+	readonly failed: boolean;
+	/** Whether the user has the addon enabled, as its manager records it. */
+	isEnabled(): boolean;
+	/** Whether the plugin manager governs this addon. */
+	isPlugin(): boolean;
+	/** Asks the addon's manager to enable it. */
+	enable(): void | Promise<void>;
+	/** Asks the addon's manager to disable it. */
+	disable(): void;
+	/** Restarts the addon on its current bundle if it is running; settles once it is running again. */
+	reload(): Promise<void>;
+	/** Returns the manifest, so serializing the addon never leaks its bundle or instance. */
+	toJSON(): AddonManifest;
+};
+/** One addon kind, such as `plugin` or `icon-pack`; each has its own manager. */
+export type AddonKind = (typeof ADDON_KINDS)[number];
+/** The `logger` global a plugin runs with: console levels prefixed with the plugin's name. */
+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. */
+export type AddonManifest = AuthoredAddonManifest & {
+	/** 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. */
+	path?: string;
 	/** Set by the loader and installer: whether the bundle carries a valid Unbound signature. */
 	trust?: AddonTrust;
-	/** Requirements on the Unbound client running the addon. */
-	unbound?: {
-		/** The minimum Unbound client version (semver) the addon supports. */
-		min?: string;
-	};
 };
-/** An addon referenced either by its id string or the {@link Addon} entity itself. */
-export type AddonResolveable = string | Addon;
+/** 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> = {
+	/** Capabilities needed on this platform only, added to the manifest's top-level `capabilities`. */
+	capabilities?: NativePluginPlatformCapability<P>[];
+};
+/** The platforms an addon runs on, keyed by platform. */
+export type AddonPlatforms = {
+	[P in NativePluginPlatform]?: AddonPlatform<P>;
+};
 /** Whether an addon's bundle carries a valid Unbound signature. */
 export type AddonTrust = 'signed' | 'unsigned';
-export type AddonType = (typeof ADDON_TYPES)[number];
 export type AlertActionButtonComponent = React$1.ComponentType<
 	AlertActionButtonProps & Record<string, unknown>
 >;
@@ -410,11 +526,73 @@ export type AlertModalProps = {
 	header?: StackProps['children'];
 	title?: DesignTextProps['children'];
 };
+/**
+ * An asset name of file type `T`: the names Discord's generated build registers as suggestions, and any other
+ * string, since a build may register names the generator never saw.
+ */
+export type AssetName<T extends string = DiscordAssetType> = LiteralUnion<
+	DiscordAssetName<Extract<T, DiscordAssetType>>
+>;
+/** A file type the asset lookups take: Discord's types as suggestions, and any other string. */
+export type AssetType = LiteralUnion<DiscordAssetType>;
 /** The native module used to register and resolve {@link DiscordAsset}s by id. */
 export type AssetsModule = {
+	/** Adds an asset to the registry and returns its new asset id. */
 	registerAsset: (asset: DiscordAsset) => number;
+	/** Returns the asset registered under `id`; `null` or `undefined` when there is none. */
 	getAssetByID: (id: number) => DiscordAsset | null;
 };
+/** The manifest an author ships in an addon's `manifest.json`: its metadata and entry point. */
+export type AuthoredAddonManifest = {
+	/** The unique id: alphanumeric runs joined by single `.`, `_` or `-`, at most 100 characters. */
+	id: string;
+	/** The addon kind this manifest describes; used to validate installs. */
+	type?: AddonKind;
+	/** The display name; must not be empty. */
+	name: string;
+	/** A short summary shown with the addon; may be empty. */
+	description: string;
+	/** Who made the addon; a published manifest lists at least one. */
+	authors: AddonAuthor[];
+	/** An image for the addon, as a URL or an `{ uri }` image source. */
+	icon?:
+		| string
+		| {
+				uri: string;
+		  };
+	/** The bundle's path relative to the manifest, such as `index.js`; it may not leave the addon's directory. */
+	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 Ed25519 signature the Unbound team's publish pipeline puts on first-party plugins. */
+	signature?: {
+		version: 1;
+		ed25519: string;
+	};
+	/** Marks a plugin other plugins build on, which the plugin list hides by default. */
+	library?: boolean;
+	/** Starts the plugin once Discord has drawn its first frame, for one that changes nothing on the first screen. */
+	startAfterFirstFrame?: boolean;
+	/** The addons this one needs, by id, each with the semver range it accepts, such as `^1.2.0`. */
+	dependencies?: Record<string, string>;
+	/** The SHA-512 of each bundle compiled to Hermes bytecode, by bytecode version; covered by `signature`. */
+	bytecode?: Record<string, string>;
+	/** The SHA-256 of each locale file beside the bundle (`i18n/<code>.json`), by locale code; en-US is in the bundle. */
+	locales?: Record<string, string>;
+	/** The images `ubd build` emits beside the bundle, by asset name, such as `icons/star`. */
+	assets?: Record<string, AddonAsset>;
+	/** Requirements on the Unbound client running the addon. */
+	unbound?: {
+		/** The minimum Unbound client version (semver) the addon supports. */
+		min?: string;
+	};
+};
 export type AvatarDuoPileComponent = React$1.ComponentType<
 	AvatarDuoPileProps & Record<string, unknown>
 >;
@@ -504,6 +682,34 @@ export type BackgroundBlurViewComponentProps = Omit<
 	ref?: React$1.Ref<any>;
 	style?: React$1.ComponentProps<typeof RN.View>['style'];
 };
+/** The props of Discord's `Badge`, read from Discord 352's `design/components/Badge/native/Badge.native.tsx`. */
+export type BadgeProps = {
+	/** A built-in label, or `{ text }` for custom text. */
+	type:
+		| 'new'
+		| 'beta'
+		| 'early_access'
+		| 'free_trial'
+		| {
+				text: string;
+		  };
+	/** The badge's colour scheme. */
+	variant?: BadgeVariant;
+	/** A leading icon component, such as `StarIcon`, drawn at `xxs`. */
+	icon?: React$1.ComponentType<DiscordIconProps>;
+};
+/** The colours of Discord's `Badge`; with none, it is grey. `primary` is the brand colour. */
+export type BadgeVariant =
+	| 'primary'
+	| 'secondary'
+	| 'expressive'
+	| 'premium'
+	| 'inverted'
+	| 'notification'
+	| 'rarity-common'
+	| 'rarity-rare'
+	| 'rarity-epic'
+	| 'rarity-mythic';
 /**
  * Props of `BaseIconButton` (function). Exports: BaseIconButton.
  * @see design/components/Button/native/BaseIconButton.native.tsx
@@ -810,6 +1016,14 @@ export type ButtonIconButtonProps = Omit<
 export type ButtonPillProps = Omit<LoadingButtonPillProps, 'loading'> & {
 	loading?: boolean;
 };
+/** A button row: it stores nothing, and calls the export `action` of the plugin's `src/actions.ts`. */
+export type ButtonSchema = SettingCommon & {
+	kind: 'button';
+	displayAs: 'button' | 'danger';
+	action: string;
+	/** The message key of a confirmation asked before `run`. */
+	confirm?: string;
+};
 /**
  * Props of `ButtonShine` (function). Exports: ButtonShine.
  * @see design/components/Button/native/ButtonShine.native.tsx
@@ -817,6 +1031,8 @@ export type ButtonPillProps = Omit<LoadingButtonPillProps, 'loading'> & {
 export type ButtonShineProps = {
 	variant?: 'primary' | 'secondary' | 'tertiary' | (string & {});
 };
+/** A callback the generator typed: kept as is, since its parameters and arity are what a caller relies on. */
+export type Callback = (...args: never[]) => unknown;
 export type CameraLottieComponent = React$1.ComponentType<
 	CameraLottieProps & Record<string, unknown>
 >;
@@ -827,6 +1043,17 @@ export type CameraLottieComponent = React$1.ComponentType<
 export type CameraLottieProps = Omit<LottieIconProps, 'ref'> & {
 	ref?: LottieIconProps['ref'];
 };
+/** A choice setting: one of its options' keys. */
+export type ChoiceSettingSchema = {
+	/** Marks a setting that stores one of a fixed set of options. */
+	kind: 'choice';
+	/** Draws the options as a radio group, a picker sheet or a segmented control. */
+	displayAs: 'radio' | 'picker' | 'segmented';
+	/** The `const` of the option picked before the user changes it. */
+	default: string;
+	/** The options, in the order they are drawn. */
+	options: SettingChoice[];
+};
 export type CoachmarkComponent = React$1.ComponentType<CoachmarkProps>;
 /**
  * Props of `Coachmark` (function). Exports: Coachmark.
@@ -1107,28 +1334,50 @@ export type DesignCheckboxProps = {
 	onToggle: (...args: any[]) => unknown;
 	required?: unknown;
 };
+/** The name of one component in {@link DESIGN_COMPONENTS}. */
 export type DesignComponentName = (typeof DESIGN_COMPONENTS)[number];
-/** Every component the `design/native.tsx` barrel exports, typed only by `bun run generate-discord-types`. */
-export type DesignComponents = DesignBarrelComponents;
+/**
+ * Every component the `design/native.tsx` barrel exports, typed by `bun run generate-discord-types` and made
+ * {@link LooseModule | loose}: known props optional and checked where concrete, unknown props allowed.
+ */
+export type DesignComponents = LooseModule<DesignBarrelComponents & NewerDesignComponents>;
 /** The design module's non-component exports (hooks, functions, constants), which the generator does not type. */
 export type DesignHelpers = {
+	/** Discord's theme-aware style factory; see {@link CreateStyles}. */
 	createStyles: CreateStyles;
+	/** The text style Discord uses for each typography variant. */
 	TextStyleSheet: Record<TextVariant, TextStyle>;
+	/** Hook that resolves a semantic colour token, such as `Theme.colors.TEXT_DEFAULT`, to a colour for the current theme. */
 	useToken: (token: SemanticColorToken) => string;
+	/** Hook that builds the state a `SegmentedControl` and its `SegmentedControlPages` share. */
 	useSegmentedControlState: (options: SegmentedControlStateOptions) => SegmentedControlState;
+	/** Opens an alert as `openAlert(key, element)`; pass the same key to `dismissAlert` to close it. */
 	openAlert: DiscordFunction<void>;
+	/** Closes the alert opened under `key`. */
 	dismissAlert: (key: string) => void;
+	/** Closes every open alert. */
 	dismissAlerts: DiscordFunction<void>;
+	/** Shows a confirm modal from `{ title, content, confirmText, cancelText, onConfirm }`. */
 	showConfirmModal: DiscordFunction;
+	/** Shows an action sheet from `{ key, header: { title }, options: [{ label, icon, onPress }] }`. */
 	showSimpleActionSheet: DiscordFunction;
+	/** Closes the open context menu, such as after a plugin's menu item runs. */
 	hideContextMenu: DiscordFunction<void>;
+	/** Hook that returns the navigation of the screen the calling component renders in. */
 	useNavigation: <T = any>() => Navigation<T>;
+	/** Returns `color` with its opacity set to `opacity`. */
 	setColorOpacity: (color: string, opacity: number) => string;
+	/** Returns `color` darkened by `amount`. */
 	darkenColor: (color: string, amount: number) => string;
+	/** Returns `color` brightened by `amount`. */
 	brightenColor: (color: string, amount: number) => string;
+	/** Returns a colour that contrasts with `color`, for content drawn on it. */
 	getContrastingColor: (color: string) => string;
+	/** Discord's transition state enum; see {@link TransitionState}. */
 	TransitionStates: EnumLike<typeof TRANSITION_STATE_KEYS>;
+	/** Discord's theme flag enum: gradient themes, reduced or increased contrast, and reduced saturation. */
 	ThemeContextFlags: EnumLike<typeof THEME_FLAG_KEYS>;
+	/** The minimum WCAG contrast ratios Discord applies to non-text, text and high-contrast text. */
 	WCAGContrastRatios: Record<'NonText' | 'Text' | 'HighContrastText', number>;
 };
 export type DesignModalComponent = React$1.ComponentType<
@@ -1318,17 +1567,1458 @@ export type DisableCustomThemeProps = {
 };
 /** An asset registered with Discord's packager (its metadata and dimensions). */
 export type DiscordAsset = {
+	/** `true` on assets the React Native packager generated. */
 	__packager_asset?: boolean;
+	/** The file name without extension, such as `ic_close`; `assets.getByName` matches on it. */
 	name: string;
+	/** The asset's directory in the bundle, such as `/assets/images`. */
 	httpServerLocation: string;
+	/** Width in points at scale 1. */
 	width: number;
+	/** Height in points at scale 1. */
 	height: number;
+	/** The pixel densities the bundle ships the file at, such as `[1, 2, 3]`. */
 	scales: number[];
+	/** The packager's content hash of the file. */
 	hash: string;
+	/** The file extension, such as `png` or `svg`. */
 	type: string;
 };
+/** The name of an asset Discord registers, of the given file types. */
+export type DiscordAssetName<T extends DiscordAssetType = DiscordAssetType> = DiscordAssetNames[T];
+/** The names of the assets Discord discord-350 registers, by file type, as `assets.getIdByName` takes them. */
+export type DiscordAssetNames = {
+	jpg: 'background-splash-dev';
+	lottie:
+		| 'Camera'
+		| 'MessageRequest'
+		| 'MessagesTab'
+		| 'Microphone'
+		| 'NitroGem1'
+		| 'NitroGem12'
+		| 'NitroGem15'
+		| 'NitroGem18'
+		| 'NitroGem2'
+		| 'NitroGem24'
+		| 'NitroGem3'
+		| 'NitroGem6'
+		| 'NitroGem9'
+		| 'NotificationsTab'
+		| 'ServerTab'
+		| 'SpendEarnOrbs'
+		| 'SpendEarnOrbsLightTheme'
+		| 'YouTab';
+	png:
+		| 'AccessibilityIcon'
+		| 'AchievementsIcon'
+		| 'ActivitiesIcon'
+		| 'AnalyticsIcon'
+		| 'AngryIcon'
+		| 'AnnouncementsIcon'
+		| 'AnnouncementsLockIcon'
+		| 'AnnouncementsSpoilerIcon'
+		| 'AnnouncementsWarningIcon'
+		| 'AppIcon'
+		| 'AppleNeutralIcon'
+		| 'AppsIcon'
+		| 'AppsLockIcon'
+		| 'AppsSpoilerIcon'
+		| 'AppsWarningIcon'
+		| 'ArrowAngleLeftUpIcon'
+		| 'ArrowAngleRightUpIcon'
+		| 'ArrowLargeDownIcon'
+		| 'ArrowLargeLeftIcon'
+		| 'ArrowLargeRightIcon'
+		| 'ArrowLargeUpIcon'
+		| 'ArrowSmallDownIcon'
+		| 'ArrowSmallLeftIcon'
+		| 'ArrowSmallRightIcon'
+		| 'ArrowSmallUpIcon'
+		| 'ArrowsLeftRightIcon'
+		| 'ArrowsUpDownIcon'
+		| 'AtIcon'
+		| 'AttachmentIcon'
+		| 'BackspaceIcon'
+		| 'BattlenetNeutralIcon'
+		| 'BeakerIcon'
+		| 'BeanieIcon'
+		| 'BellIcon'
+		| 'BellSlashIcon'
+		| 'BellZIcon'
+		| 'BicycleIcon'
+		| 'BillIcon'
+		| 'BlueskyNeutralIcon'
+		| 'BlurBackgroundIcon'
+		| 'BlurpleTwilightIcon'
+		| 'BlushIcon'
+		| 'BookCheckIcon'
+		| 'BookmarkIcon'
+		| 'BookmarkOutlineIcon'
+		| 'BoostGemIcon'
+		| 'BoostGemOutlineIcon'
+		| 'BoostGemSlashIcon'
+		| 'BoostTier1Icon'
+		| 'BoostTier2Icon'
+		| 'BoostTier3Icon'
+		| 'BrandDarkIcon'
+		| 'BrandInvertedIcon'
+		| 'BugIcon'
+		| 'BurgerIcon'
+		| 'CalendarIcon'
+		| 'CalendarMinusIcon'
+		| 'CalendarPlusIcon'
+		| 'CameraIcon'
+		| 'CamoIcon'
+		| 'CarIcon'
+		| 'ChannelListIcon'
+		| 'ChannelListMagnifyingGlassIcon'
+		| 'ChannelListPlusIcon'
+		| 'ChannelNotificationIcon'
+		| 'ChannelsFollowedIcon'
+		| 'ChatArrowRightIcon'
+		| 'ChatCheckIcon'
+		| 'ChatDotsIcon'
+		| 'ChatIcon'
+		| 'ChatMarkUnreadIcon'
+		| 'ChatPlusIcon'
+		| 'ChatShieldIcon'
+		| 'ChatSmileIcon'
+		| 'ChatWarningIcon'
+		| 'ChatXIcon'
+		| 'Check'
+		| 'CheckmarkLargeBoldIcon'
+		| 'CheckmarkLargeIcon'
+		| 'CheckmarkSmallBoldIcon'
+		| 'CheckmarkSmallIcon'
+		| 'CherryBlossomIcon'
+		| 'ChevronLargeDownIcon'
+		| 'ChevronLargeLeftIcon'
+		| 'ChevronLargeRightIcon'
+		| 'ChevronLargeUpIcon'
+		| 'ChevronSmallDownIcon'
+		| 'ChevronSmallRightIcon'
+		| 'ChevronSmallUpIcon'
+		| 'CircleCheckIcon'
+		| 'CircleCheckIcon-primary'
+		| 'CircleCheckIcon-secondary'
+		| 'CircleErrorIcon'
+		| 'CircleErrorIcon-primary'
+		| 'CircleErrorIcon-secondary'
+		| 'CircleInformationIcon'
+		| 'CircleInformationIcon-primary'
+		| 'CircleInformationIcon-secondary'
+		| 'CircleMinusIcon-primary'
+		| 'CircleMinusIcon-secondary'
+		| 'CirclePlayIcon-primary'
+		| 'CirclePlayIcon-secondary'
+		| 'CirclePlusIcon-primary'
+		| 'CirclePlusIcon-secondary'
+		| 'CircleQuestionIcon'
+		| 'CircleQuestionIcon-primary'
+		| 'CircleQuestionIcon-secondary'
+		| 'CircleXIcon'
+		| 'CircleXIcon-primary'
+		| 'CircleXIcon-secondary'
+		| 'CircuitIcon'
+		| 'ClipboardCheckIcon'
+		| 'ClipboardListIcon'
+		| 'ClipsIcon'
+		| 'ClockIcon'
+		| 'ClockWarningIcon'
+		| 'ClockXIcon'
+		| 'ClosedCaptionsOutlineIcon'
+		| 'CloudDownloadIcon'
+		| 'CloudIcon'
+		| 'ClydeIcon'
+		| 'ColorWaveIcon'
+		| 'CompassIcon'
+		| 'ConnectionAverageIcon'
+		| 'ConnectionBadIcon'
+		| 'ConnectionFineIcon'
+		| 'ConnectionUnknownIcon'
+		| 'ControllerIcon'
+		| 'CopyIcon'
+		| 'CreditCardIcon'
+		| 'CrownIcon'
+		| 'CrunchyrollNeutralIcon'
+		| 'DenyIcon'
+		| 'DiceIcon'
+		| 'Discord'
+		| 'DoorExitIcon'
+		| 'DoubleCheckmarkIcon'
+		| 'DoubleChevronSmallRightIcon'
+		| 'DownloadIcon'
+		| 'DragIcon'
+		| 'EducationIcon'
+		| 'EmbedIcon'
+		| 'EmojiAngryFaceWithHornsIcon'
+		| 'EmojiColdFaceIcon'
+		| 'EmojiCowboyHatFaceIcon'
+		| 'EmojiCryingFaceIcon'
+		| 'EmojiDisguisedFaceIcon'
+		| 'EmojiFaceVomitingIcon'
+		| 'EmojiFaceWithMonocleIcon'
+		| 'EmojiFaceWithSpiralEyesIcon'
+		| 'EmojiMeltingFaceIcon'
+		| 'EmojiMoneyMouthFaceIcon'
+		| 'EmojiNerdFaceIcon'
+		| 'EmojiPartyingFaceIcon'
+		| 'EmojiRollingOnTheFloorLaughingIcon'
+		| 'EmojiSalutingFaceIcon'
+		| 'EmojiSkullIcon'
+		| 'EmojiSmilingFaceWithHeartsIcon'
+		| 'EmojiSmilingFaceWithHornsIcon'
+		| 'EmojiSmilingFaceWithSunglassesIcon'
+		| 'EmojiSquintingFaceWithTongueIcon'
+		| 'EmojiUpsideDownFaceIcon'
+		| 'EmojiWoozyFaceIcon'
+		| 'EmojiZanyFaceIcon'
+		| 'EnvelopeIcon'
+		| 'EpicGamesNeutralIcon'
+		| 'ExampleSketchheadsActivity'
+		| 'ExampleVoiceChatActivity'
+		| 'ExperimentalCommonIcon'
+		| 'ExperimentalDirectSelectIcon'
+		| 'ExperimentalEpicIcon'
+		| 'ExperimentalGameControllerLinkIcon'
+		| 'ExperimentalLfgIcon'
+		| 'ExperimentalLfgLockIcon'
+		| 'ExperimentalMythicIcon'
+		| 'ExperimentalRareIcon'
+		| 'EyeDropperIcon'
+		| 'EyeIcon'
+		| 'EyeSlashIcon'
+		| 'FacebookNeutralIcon'
+		| 'FileIcon'
+		| 'FileUpIcon'
+		| 'FileWarningIcon'
+		| 'FiltersHorizontalIcon'
+		| 'FireIcon'
+		| 'FlagIcon'
+		| 'FlashIcon'
+		| 'FolderIcon'
+		| 'FolderPlusIcon'
+		| 'FoodIcon'
+		| 'ForumIcon'
+		| 'ForumLockIcon'
+		| 'ForumSpoilerIcon'
+		| 'ForumWarningIcon'
+		| 'FriendsIcon'
+		| 'FullscreenEnterIcon'
+		| 'GalaxyIcon'
+		| 'GameControllerIcon'
+		| 'GamingIcon'
+		| 'GifIcon'
+		| 'GiftIcon'
+		| 'GlobeEarthIcon'
+		| 'Glow'
+		| 'GoogleNeutralIcon'
+		| 'GridSquareIcon'
+		| 'GroupArrowDownIcon'
+		| 'GroupIcon'
+		| 'GroupPlusIcon'
+		| 'HammerIcon'
+		| 'HandRequestDenyIcon'
+		| 'HandRequestSpeakIcon'
+		| 'HandRequestSpeakListIcon'
+		| 'HashmarkIcon'
+		| 'HeadphonesDenyIcon'
+		| 'HeadphonesIcon'
+		| 'HeadphonesSlashIcon'
+		| 'HeartIcon'
+		| 'HeartOutlineIcon'
+		| 'HoloWavesIcon'
+		| 'HomeIcon'
+		| 'HourglassIcon'
+		| 'HubIcon'
+		| 'IAP_feature_education'
+		| 'IdCardIcon'
+		| 'IdIcon'
+		| 'ImageBrokenIcon'
+		| 'ImageFileIcon'
+		| 'ImageIcon'
+		| 'ImageLockIcon'
+		| 'ImagePlusIcon'
+		| 'ImageSparkleIcon'
+		| 'ImageTextIcon'
+		| 'ImageWarningIcon'
+		| 'ImagesIcon'
+		| 'InRainbowsIcon'
+		| 'InboxIcon'
+		| 'InstagramNeutralIcon'
+		| 'InventoryIcon'
+		| 'KeyIcon'
+		| 'KeyboardIcon'
+		| 'LanguageIcon'
+		| 'LaptopPhoneIcon'
+		| 'LettersIcon'
+		| 'LightbulbIcon'
+		| 'LinkExternalMediumIcon'
+		| 'LinkExternalSmallIcon'
+		| 'LinkIcon'
+		| 'LinkPlusIcon'
+		| 'ListBulletsIcon'
+		| 'ListNumberedIcon'
+		| 'ListViewIcon'
+		| 'LocationIcon'
+		| 'LockIcon'
+		| 'LockUnlockedIcon'
+		| 'MagicDoorIcon'
+		| 'MagicWandIcon'
+		| 'MagnifyingGlassIcon'
+		| 'MangaIcon'
+		| 'MatteDarkIcon'
+		| 'MatteLightIcon'
+		| 'MaximizeIcon'
+		| 'MedalIcon'
+		| 'MenuIcon'
+		| 'MicrophoneArrowRightIcon'
+		| 'MicrophoneDenyIcon'
+		| 'MicrophoneIcon'
+		| 'MicrophoneSlashIcon'
+		| 'MidnightPrismIcon'
+		| 'MinecraftNeutralIcon-primary'
+		| 'MinecraftNeutralIcon-secondary'
+		| 'MinecraftNeutralIcon-tertiary'
+		| 'MobilePhoneDenyIcon'
+		| 'MobilePhoneIcon'
+		| 'MobilePhoneSettingsIcon'
+		| 'MobilePhoneShareIcon'
+		| 'ModerationIcon'
+		| 'MoreHorizontalIcon'
+		| 'MoreVerticalIcon'
+		| 'MushroomIcon'
+		| 'MusicIcon'
+		| 'MusicSlashIcon'
+		| 'NatureIcon'
+		| 'NewUserIcon'
+		| 'NewUserSimpleIcon'
+		| 'NintendoSwitchNeutralIcon'
+		| 'NitroWheelIcon'
+		| 'NitroWheelIconWithGradient'
+		| 'NotificationCenter'
+		| 'ObjectIcon'
+		| 'OrbsIcon'
+		| 'PaintPaletteIcon'
+		| 'PaintbrushThinIcon'
+		| 'PaperIcon'
+		| 'PaperPlusIcon'
+		| 'PastelIcon'
+		| 'PauseIcon'
+		| 'PawPrintIcon'
+		| 'PencilIcon'
+		| 'PencilSparkleIcon'
+		| 'PhoneCallIcon'
+		| 'PhoneHangUpIcon'
+		| 'PhoneIcon'
+		| 'PiggyBankIcon'
+		| 'PinIcon'
+		| 'PirateIcon'
+		| 'PlayIcon'
+		| 'PlaystationNeutralIcon'
+		| 'PlusLargeIcon'
+		| 'PlusMediumIcon'
+		| 'PlusSmallIcon'
+		| 'PollsIcon'
+		| 'PremiumGroupEmbedImage'
+		| 'PuzzlePieceIcon'
+		| 'QrCodeIcon'
+		| 'QuestsIcon'
+		| 'QuoteIcon'
+		| 'ReactionIcon'
+		| 'RecordPlayerIcon'
+		| 'RedditNeutralIcon'
+		| 'RedoIcon'
+		| 'RefreshIcon'
+		| 'RemixIcon'
+		| 'RetryIcon'
+		| 'RibbonIcon'
+		| 'RiotGamesNeutralIcon'
+		| 'RobloxNeutralIcon'
+		| 'RobotIcon'
+		| 'SaveIcon'
+		| 'ScienceIcon'
+		| 'ScreenArrowIcon'
+		| 'ScreenIcon'
+		| 'ScreenStreamIcon'
+		| 'ScreenXIcon'
+		| 'SendMessageIcon'
+		| 'ServerGridIcon'
+		| 'ServerIcon'
+		| 'SettingsIcon'
+		| 'SettingsInfoIcon'
+		| 'Share'
+		| 'ShareIcon'
+		| 'ShieldIcon'
+		| 'ShieldLockIcon'
+		| 'ShieldUserIcon'
+		| 'ShopIcon'
+		| 'SignPostIcon'
+		| 'SlashBoxIcon'
+		| 'SlashIcon'
+		| 'Small'
+		| 'SoundboardIcon'
+		| 'SoundboardSlashIcon'
+		| 'SparklesIcon'
+		| 'SpeedometerIcon'
+		| 'SpoilerIcon'
+		| 'SpotifyNeutralIcon'
+		| 'StaffBadgeIcon'
+		| 'StageIcon'
+		| 'StageLockIcon'
+		| 'StampIcon'
+		| 'StampXIcon'
+		| 'StarIcon'
+		| 'StarOutlineIcon'
+		| 'StatusDND'
+		| 'StatusIdle'
+		| 'StatusMobileOnline'
+		| 'StatusOffline'
+		| 'StatusOnline'
+		| 'StatusStreaming'
+		| 'StatusVROnline'
+		| 'SteamNeutralIcon'
+		| 'StickerIcon'
+		| 'StickerPlusIcon'
+		| 'StopIcon'
+		| 'SubscriptionIcon'
+		| 'SunsetIcon'
+		| 'SuperReactionIcon'
+		| 'TagIcon'
+		| 'TagsIcon'
+		| 'TeacupIcon'
+		| 'TextControllerIcon'
+		| 'TextIcon'
+		| 'TextLockIcon'
+		| 'TextSpoilerIcon'
+		| 'TextWarningIcon'
+		| 'ThemeDarkIcon'
+		| 'ThemeGrayIcon'
+		| 'ThemeLightIcon'
+		| 'ThemeMidnightIcon'
+		| 'ThreadIcon'
+		| 'ThreadLockIcon'
+		| 'ThreadMinusIcon'
+		| 'ThreadPlusIcon'
+		| 'ThumbsDownIcon'
+		| 'ThumbsUpIcon'
+		| 'TicketIcon'
+		| 'TiktokNeutralIcon'
+		| 'TimerIcon'
+		| 'TopicsIcon'
+		| 'TrainIcon'
+		| 'TranscriptOutlineIcon'
+		| 'TrashIcon'
+		| 'TreehouseIcon'
+		| 'TrophyIcon'
+		| 'TvIcon'
+		| 'TwitchNeutralIcon'
+		| 'TwitterNeutralIcon'
+		| 'UndoIcon'
+		| 'UnknownGameIcon'
+		| 'UnsendIcon'
+		| 'UploadIcon'
+		| 'UserCheckIcon'
+		| 'UserCircleIcon'
+		| 'UserClockIcon'
+		| 'UserIcon'
+		| 'UserMinusIcon'
+		| 'UserPlatformIcon'
+		| 'UserPlusIcon'
+		| 'UserSquareIcon'
+		| 'VideoDenyIcon'
+		| 'VideoIcon'
+		| 'VideoSelfieIcon'
+		| 'VideoSlashIcon'
+		| 'VoiceLockIcon'
+		| 'VoiceNormalIcon'
+		| 'VoiceNormalSpoilerIcon'
+		| 'VoiceWarningIcon'
+		| 'VoiceXIcon'
+		| 'VrHeadsetIcon'
+		| 'WarningIcon'
+		| 'WaveformIcon'
+		| 'WebhookIcon'
+		| 'WebhookPlusIcon'
+		| 'WidgetsIcon'
+		| 'WindowLaunchIcon'
+		| 'WrenchIcon'
+		| 'XLargeBoldIcon'
+		| 'XLargeIcon'
+		| 'XNeutralIcon'
+		| 'XSmallBoldIcon'
+		| 'XSmallIcon'
+		| 'XboxNeutralIcon'
+		| 'Y2KIcon'
+		| 'YoutubeNeutralIcon'
+		| 'add'
+		| 'add_friend_32px'
+		| 'add_server'
+		| 'add_white'
+		| 'airplay'
+		| 'alert'
+		| 'amanda_1'
+		| 'amanda_2'
+		| 'announcement_birb'
+		| 'app_dock_no_permissions_dark'
+		| 'app_dock_no_permissions_light'
+		| 'app_dock_not_found_dark'
+		| 'app_dock_not_found_light'
+		| 'app_icon_marketing'
+		| 'app_icons_upsell'
+		| 'app_installed_check'
+		| 'arrow'
+		| 'arrow-right'
+		| 'arrow-sm-down'
+		| 'asset_blurred_media_post_preview'
+		| 'asset_bronze_badge_small'
+		| 'asset_diamond_badge_small'
+		| 'asset_emerald_badge_small'
+		| 'asset_gold_badge_small'
+		| 'asset_gradient'
+		| 'asset_nitro_ticket'
+		| 'asset_opal_badge_small'
+		| 'asset_platinum_badge_small'
+		| 'asset_role_subscription_earnings'
+		| 'asset_role_subscription_exclusive_perks'
+		| 'asset_role_subscription_megaphone'
+		| 'asset_ruby_badge_small'
+		| 'asset_silver_badge_small'
+		| 'audience_welcome'
+		| 'audio'
+		| 'auto_moderation_avatar'
+		| 'avatar_placeholder'
+		| 'back-icon'
+		| 'back-icon-mask'
+		| 'background'
+		| 'background-splash-mobile'
+		| 'badconnection'
+		| 'badge'
+		| 'badge_2'
+		| 'bg'
+		| 'blocked-purchases-dark'
+		| 'blocked-purchases-light'
+		| 'blocked_dark'
+		| 'blocked_darker'
+		| 'blocked_light'
+		| 'blue-pointer-hand'
+		| 'boost'
+		| 'box_idle'
+		| 'breaddog_1'
+		| 'cactus'
+		| 'cake_idle'
+		| 'camera'
+		| 'camera-swap'
+		| 'camera_swap'
+		| 'camera_upload'
+		| 'camera_upload_light'
+		| 'cap_2'
+		| 'channel-following-backdrop-dark'
+		| 'channel-following-backdrop-light'
+		| 'channel_following_success_1'
+		| 'channel_following_success_2'
+		| 'channel_following_success_3'
+		| 'channel_settings_grid_view_example_post'
+		| 'channel_settings_list_view_example_post'
+		| 'channel_setup'
+		| 'channel_setup_darker'
+		| 'channel_setup_light'
+		| 'channels-empty'
+		| 'check-with-stars'
+		| 'chest_idle'
+		| 'clear-icon'
+		| 'client_theme'
+		| 'client_themes_upsell'
+		| 'close'
+		| 'close-icon'
+		| 'clouds_background'
+		| 'clouds_light_background'
+		| 'clyde-avatar'
+		| 'code-illustration-dark'
+		| 'code-illustration-light'
+		| 'coffee_idle'
+		| 'confetti'
+		| 'conjure_activity_dark'
+		| 'conjure_activity_light'
+		| 'connections-profile-steam-dota2'
+		| 'connections-profile-steam-tf2'
+		| 'conversation'
+		| 'copy'
+		| 'crunchyroll_connect'
+		| 'crunchyroll_link_intro'
+		| 'crunchyroll_link_success'
+		| 'cs'
+		| 'cta'
+		| 'custom_icons'
+		| 'custom_profile'
+		| 'custom_sounds'
+		| 'customize_empty'
+		| 'customize_empty_light'
+		| 'da'
+		| 'dark_home_header_placeholder'
+		| 'de'
+		| 'deafen'
+		| 'debug'
+		| 'default_avatar_0'
+		| 'default_avatar_0_small'
+		| 'default_avatar_1'
+		| 'default_avatar_1_small'
+		| 'default_avatar_2'
+		| 'default_avatar_2_small'
+		| 'default_avatar_3'
+		| 'default_avatar_3_small'
+		| 'default_avatar_4'
+		| 'default_avatar_4_small'
+		| 'default_avatar_5'
+		| 'default_avatar_5_small'
+		| 'default_provisional_avatar_0'
+		| 'default_provisional_avatar_1'
+		| 'default_provisional_avatar_2'
+		| 'default_provisional_avatar_3'
+		| 'default_provisional_avatar_4'
+		| 'default_provisional_avatar_5'
+		| 'devices_not_found'
+		| 'discoverability-header'
+		| 'early_access'
+		| 'el'
+		| 'emoji'
+		| 'emoji-negative'
+		| 'emoji-neutral'
+		| 'emoji-positive'
+		| 'empty'
+		| 'empty-suggestions-header'
+		| 'empty_castle'
+		| 'empty_permission'
+		| 'empty_photos'
+		| 'empty_quest_home'
+		| 'empty_quick_switcher'
+		| 'empty_server_settings_audit_log_dark'
+		| 'empty_server_settings_audit_log_darker'
+		| 'empty_server_settings_audit_log_light'
+		| 'empty_server_settings_emoji_dark'
+		| 'empty_server_settings_emoji_darker'
+		| 'empty_server_settings_emoji_light'
+		| 'empty_voice_channel'
+		| 'en-GB'
+		| 'en-US'
+		| 'entrace_sounds'
+		| 'es-419'
+		| 'es-ES'
+		| 'failure-header'
+		| 'family_center_activity_banner_image_parent'
+		| 'family_center_activity_banner_image_teen'
+		| 'family_center_activity_checklist_image'
+		| 'family_center_chat_check_icon'
+		| 'featured_page_footer_dark'
+		| 'featured_page_footer_light'
+		| 'feedback-modal-happy'
+		| 'feedback-modal-happy-desaturated'
+		| 'feedback-modal-happy-desaturated_darker'
+		| 'feedback-modal-neutral'
+		| 'feedback-modal-neutral-desaturated'
+		| 'feedback-modal-neutral-desaturated_darker'
+		| 'feedback-modal-sad'
+		| 'feedback-modal-sad-desaturated'
+		| 'feedback-modal-sad-desaturated_darker'
+		| 'fi'
+		| 'finishing_touches'
+		| 'finishing_touches_light'
+		| 'fist_bump'
+		| 'flash'
+		| 'fr'
+		| 'fullscreen'
+		| 'game-empty-state'
+		| 'game-empty-state-controller'
+		| 'game_icon_placeholder'
+		| 'gif'
+		| 'gift_box'
+		| 'gift_cake'
+		| 'gift_chest'
+		| 'gift_coffee'
+		| 'gmail'
+		| 'googleauth-logo'
+		| 'graggle_2'
+		| 'grey_badge'
+		| 'grey_server_boosts'
+		| 'grid'
+		| 'guild_identity_education_dark'
+		| 'guild_identity_education_light'
+		| 'guild_subscription_no_guilds_dark'
+		| 'guild_subscription_no_guilds_darker'
+		| 'guild_subscription_no_guilds_light'
+		| 'guild_subscription_removal_dark'
+		| 'guild_subscription_removal_darker'
+		| 'guild_subscription_removal_light'
+		| 'hd_video'
+		| 'header-art-onboarding'
+		| 'header_arrow_right'
+		| 'hero-orbs'
+		| 'hi'
+		| 'history'
+		| 'hr'
+		| 'hu'
+		| 'hub-header'
+		| 'hub_header'
+		| 'ic-application-rejected'
+		| 'ic-application-required'
+		| 'ic-application-submitted'
+		| 'ic-customize'
+		| 'ic-location'
+		| 'ic_add_18px'
+		| 'ic_add_24px'
+		| 'ic_add_circle'
+		| 'ic_add_perk_24px'
+		| 'ic_add_reaction_v2'
+		| 'ic_add_super_reaction'
+		| 'ic_add_tier_40px'
+		| 'ic_alert'
+		| 'ic_application_command_24px'
+		| 'ic_application_command_built_in'
+		| 'ic_archived_thread_embed_16px'
+		| 'ic_arrow'
+		| 'ic_arrow_back_24px'
+		| 'ic_arrow_down'
+		| 'ic_arrow_forward_24px'
+		| 'ic_arrow_right'
+		| 'ic_audit_create_24px'
+		| 'ic_audit_delete_24px'
+		| 'ic_audit_update_24px'
+		| 'ic_auto_moderation_shield'
+		| 'ic_badge_nitro'
+		| 'ic_badge_staff'
+		| 'ic_bell_on'
+		| 'ic_block'
+		| 'ic_blocked_chat_bubble_icon'
+		| 'ic_browse_channel'
+		| 'ic_caret_24px'
+		| 'ic_category_16px'
+		| 'ic_channel_arrow'
+		| 'ic_channel_arrow_collapsed_24px'
+		| 'ic_chat_bubble_32px'
+		| 'ic_check_18px'
+		| 'ic_check_24px'
+		| 'ic_checkmark'
+		| 'ic_clock'
+		| 'ic_close'
+		| 'ic_close_16px'
+		| 'ic_close_18px'
+		| 'ic_close_24px'
+		| 'ic_close_circle'
+		| 'ic_close_circle_24px'
+		| 'ic_closed_lock'
+		| 'ic_community_guild_badge_dark_24px'
+		| 'ic_community_guild_badge_light_24px'
+		| 'ic_community_guild_badge_premium_24px'
+		| 'ic_controller_24px'
+		| 'ic_crown_16px'
+		| 'ic_discoverable_guild_badge_dark_24px'
+		| 'ic_discoverable_guild_badge_light_24px'
+		| 'ic_discoverable_guild_badge_premium_24px'
+		| 'ic_download_24px'
+		| 'ic_drag_icon_24px'
+		| 'ic_emoji_picker_20px'
+		| 'ic_emoji_recent_color_24px'
+		| 'ic_emoji_zipper_24px'
+		| 'ic_event_calendar'
+		| 'ic_expand_more_24px'
+		| 'ic_eye'
+		| 'ic_eye_hidden'
+		| 'ic_feed_more'
+		| 'ic_feedback'
+		| 'ic_feedback_dark'
+		| 'ic_file_small_acrobat'
+		| 'ic_file_small_ae'
+		| 'ic_file_small_ai'
+		| 'ic_file_small_archive'
+		| 'ic_file_small_audio'
+		| 'ic_file_small_code'
+		| 'ic_file_small_document'
+		| 'ic_file_small_image'
+		| 'ic_file_small_ps'
+		| 'ic_file_small_sketch'
+		| 'ic_file_small_spreadsheet'
+		| 'ic_file_small_unknown'
+		| 'ic_file_small_video'
+		| 'ic_file_small_webcode'
+		| 'ic_flower_star_18px'
+		| 'ic_flower_star_24px'
+		| 'ic_forward_chevron'
+		| 'ic_friend_wave_24px'
+		| 'ic_full_server_gating_24px'
+		| 'ic_gear'
+		| 'ic_gift'
+		| 'ic_group'
+		| 'ic_group_dm'
+		| 'ic_guild_grid_24px'
+		| 'ic_guild_template'
+		| 'ic_guild_video_24px'
+		| 'ic_guild_voice_24px'
+		| 'ic_header_members_24px'
+		| 'ic_headset_deafened_24px'
+		| 'ic_headset_deafened_dark_24px'
+		| 'ic_headset_neutral'
+		| 'ic_hide_24px'
+		| 'ic_highlight'
+		| 'ic_home'
+		| 'ic_icon_upload'
+		| 'ic_image'
+		| 'ic_image_upload'
+		| 'ic_information_24px'
+		| 'ic_information_filled_24px'
+		| 'ic_input_clear_24px'
+		| 'ic_invite'
+		| 'ic_invites_disabled'
+		| 'ic_launch'
+		| 'ic_leave_24px'
+		| 'ic_leave_stage'
+		| 'ic_link_24px'
+		| 'ic_loading_emoji_dark'
+		| 'ic_loading_emoji_light'
+		| 'ic_lock'
+		| 'ic_lock_short_16px'
+		| 'ic_mail'
+		| 'ic_media_post_share_prompt'
+		| 'ic_members'
+		| 'ic_members_24px'
+		| 'ic_mention_24px'
+		| 'ic_message'
+		| 'ic_mic_24px'
+		| 'ic_mic_muted_24px'
+		| 'ic_mic_muted_dark_24px'
+		| 'ic_mic_muted_light_24px'
+		| 'ic_mic_neutral'
+		| 'ic_minimize'
+		| 'ic_mobile_device'
+		| 'ic_moderator'
+		| 'ic_money_emoji_24px'
+		| 'ic_monitor'
+		| 'ic_more_24px'
+		| 'ic_move_to_audience'
+		| 'ic_move_to_speaker'
+		| 'ic_mute_channel_24px'
+		| 'ic_nitro_basic_wheel_gradient'
+		| 'ic_nitro_wheel'
+		| 'ic_nitro_wheel_gradient_purple'
+		| 'ic_notif'
+		| 'ic_notif_off'
+		| 'ic_overflow_android'
+		| 'ic_paperclip_24px'
+		| 'ic_partnered_guild_icon_black_24px'
+		| 'ic_partnered_guild_icon_blurple_24px'
+		| 'ic_person_shield'
+		| 'ic_person_waving'
+		| 'ic_pins'
+		| 'ic_play'
+		| 'ic_play_dark'
+		| 'ic_playstation_24px'
+		| 'ic_playstation_device_ps5_32px'
+		| 'ic_polls'
+		| 'ic_premium_channel_16px'
+		| 'ic_premium_info_24px'
+		| 'ic_premium_overview_24px'
+		| 'ic_premium_perk_money_24px'
+		| 'ic_premium_tiers_24px'
+		| 'ic_profile_badge_active_developer'
+		| 'ic_public'
+		| 'ic_qr_code_24px'
+		| 'ic_radio_circle'
+		| 'ic_radio_circle_checked'
+		| 'ic_radio_circle_checked_green'
+		| 'ic_radio_square_24px'
+		| 'ic_radio_square_checked_24px'
+		| 'ic_raised_hand'
+		| 'ic_raised_hand_list'
+		| 'ic_report_message'
+		| 'ic_rulebook'
+		| 'ic_rulebook_16px'
+		| 'ic_select_all_24px'
+		| 'ic_select_manually_24px'
+		| 'ic_selection_checked_24px'
+		| 'ic_selection_none_24px'
+		| 'ic_send'
+		| 'ic_settings'
+		| 'ic_settings_grey_24px'
+		| 'ic_settings_white_24px'
+		| 'ic_share_android'
+		| 'ic_share_ios'
+		| 'ic_shield_24px'
+		| 'ic_show_password'
+		| 'ic_sparkle'
+		| 'ic_sparkle2'
+		| 'ic_spotify_white_16px'
+		| 'ic_stage_channel_24px'
+		| 'ic_stage_channel_32px'
+		| 'ic_stage_music'
+		| 'ic_stage_music_disabled'
+		| 'ic_star_filled'
+		| 'ic_sticker_24px'
+		| 'ic_stop_stream_24px'
+		| 'ic_swipe_reply_24px'
+		| 'ic_sync_24px'
+		| 'ic_table_arrow_right'
+		| 'ic_text_channel_16px'
+		| 'ic_text_in_voice_24px'
+		| 'ic_thread_normal_24px'
+		| 'ic_thumbsdown'
+		| 'ic_thumbsup'
+		| 'ic_trash_24px'
+		| 'ic_trash_filled_16px'
+		| 'ic_unmute_channel_24px'
+		| 'ic_update_profile'
+		| 'ic_upload'
+		| 'ic_upload_image_40px'
+		| 'ic_verified_check_18px'
+		| 'ic_verified_check_24px'
+		| 'ic_verified_guild_icon_black_24px'
+		| 'ic_verified_guild_icon_green_24px'
+		| 'ic_verified_icon_white_16px'
+		| 'ic_video'
+		| 'ic_video_disabled_dark'
+		| 'ic_video_disabled_white'
+		| 'ic_voice_channel_16px'
+		| 'ic_voice_channel_24px'
+		| 'ic_volume'
+		| 'ic_volume_locked'
+		| 'ic_volume_mute'
+		| 'ic_vr_headset_24px'
+		| 'ic_wand'
+		| 'ic_warning_24px'
+		| 'ic_wreath'
+		| 'ic_xbox_24px'
+		| 'icon-afk'
+		| 'icon-call'
+		| 'icon-group'
+		| 'icon-new-group'
+		| 'icon-search'
+		| 'icon-server-muted'
+		| 'icon-settings'
+		| 'icon0'
+		| 'icon1'
+		| 'icon2'
+		| 'icon3'
+		| 'icon4'
+		| 'icon5'
+		| 'icon6'
+		| 'icon7'
+		| 'image_role_subscription_badge'
+		| 'image_role_subscription_lanyard'
+		| 'image_role_subscription_purchase_card_bg'
+		| 'img-auth-qrcode-overlay'
+		| 'img_account_sync_battlenet_light_and_dark'
+		| 'img_account_sync_battlenet_white'
+		| 'img_account_sync_bluesky_light_and_dark'
+		| 'img_account_sync_bluesky_white'
+		| 'img_account_sync_crunchyroll_light_and_dark'
+		| 'img_account_sync_ebay_light_and_dark'
+		| 'img_account_sync_ebay_white'
+		| 'img_account_sync_epic_dark_and_white'
+		| 'img_account_sync_epic_light'
+		| 'img_account_sync_facebook_light_and_dark'
+		| 'img_account_sync_facebook_white'
+		| 'img_account_sync_github_light'
+		| 'img_account_sync_github_white'
+		| 'img_account_sync_instagram_light_and_dark'
+		| 'img_account_sync_instagram_white'
+		| 'img_account_sync_league_of_legends_light_and_dark'
+		| 'img_account_sync_league_of_legends_white'
+		| 'img_account_sync_mastodon_light_and_dark'
+		| 'img_account_sync_mastodon_white'
+		| 'img_account_sync_paypal_light_and_dark'
+		| 'img_account_sync_paypal_white'
+		| 'img_account_sync_playstation_light'
+		| 'img_account_sync_playstation_white'
+		| 'img_account_sync_reddit_light_and_dark'
+		| 'img_account_sync_reddit_white'
+		| 'img_account_sync_riot_light_and_dark'
+		| 'img_account_sync_riot_white'
+		| 'img_account_sync_samsung_light_and_dark'
+		| 'img_account_sync_samsung_white'
+		| 'img_account_sync_skype_light_and_dark'
+		| 'img_account_sync_skype_white'
+		| 'img_account_sync_spotify_light_and_dark'
+		| 'img_account_sync_spotify_white'
+		| 'img_account_sync_steam_light'
+		| 'img_account_sync_steam_white'
+		| 'img_account_sync_tiktok_dark'
+		| 'img_account_sync_tiktok_light'
+		| 'img_account_sync_twitch_light_and_dark'
+		| 'img_account_sync_twitch_white'
+		| 'img_account_sync_twitter_light_and_dark'
+		| 'img_account_sync_twitter_white'
+		| 'img_account_sync_x_dark'
+		| 'img_account_sync_x_light'
+		| 'img_account_sync_x_white'
+		| 'img_account_sync_xbox_custom'
+		| 'img_account_sync_xbox_light'
+		| 'img_account_sync_xbox_white'
+		| 'img_account_sync_youtube_light_and_dark'
+		| 'img_account_sync_youtube_white'
+		| 'img_amazon_music'
+		| 'img_app_crash_dark'
+		| 'img_app_crash_darker'
+		| 'img_app_crash_light'
+		| 'img_artists_creators'
+		| 'img_ban'
+		| 'img_bans_empty_dark'
+		| 'img_bans_empty_darker'
+		| 'img_bans_empty_light'
+		| 'img_boost'
+		| 'img_boost_activated_border'
+		| 'img_boost_error_mobile'
+		| 'img_boost_hands'
+		| 'img_boost_mobile'
+		| 'img_boost_resubscribe_mobile'
+		| 'img_boost_subheader_error_mobile'
+		| 'img_boost_subheader_mobile'
+		| 'img_boost_subheader_resub_mobile'
+		| 'img_bundle_banner'
+		| 'img_bundle_mobile'
+		| 'img_bundle_subheader_mobile'
+		| 'img_bungie_dark'
+		| 'img_bungie_light'
+		| 'img_bungie_white'
+		| 'img_classic_error_mobile'
+		| 'img_classic_mobile'
+		| 'img_classic_resubscribe_mobile'
+		| 'img_classic_subheader_mobile'
+		| 'img_clouds_header_tier_0'
+		| 'img_clouds_header_tier_2'
+		| 'img_clubs'
+		| 'img_collectibles_shop'
+		| 'img_create_my_own'
+		| 'img_custom_app_icons'
+		| 'img_discord_nitro_logo_centered_dark'
+		| 'img_discord_nitro_logo_centered_light'
+		| 'img_discord_nitro_logo_left'
+		| 'img_discord_nitro_logo_left_light'
+		| 'img_domain_dark'
+		| 'img_domain_light'
+		| 'img_forum_empty_state_dark'
+		| 'img_forum_empty_state_light'
+		| 'img_friends'
+		| 'img_gaming'
+		| 'img_gifting_empty'
+		| 'img_group_dm_illustration'
+		| 'img_guild_cap_upsell_dark'
+		| 'img_guild_cap_upsell_light'
+		| 'img_guild_folder'
+		| 'img_invalid_link_dark'
+		| 'img_invalid_link_darker'
+		| 'img_invalid_link_light'
+		| 'img_invite_empty_dark'
+		| 'img_invite_empty_darker'
+		| 'img_invite_empty_light'
+		| 'img_keychain'
+		| 'img_kick_member'
+		| 'img_local_community'
+		| 'img_logo_basic_small_dark'
+		| 'img_logo_basic_small_light'
+		| 'img_logo_boost'
+		| 'img_logo_bundle_horizontal'
+		| 'img_logo_bundle_horizontal_black'
+		| 'img_logo_discord'
+		| 'img_logo_nitro_basic_stacked'
+		| 'img_logo_nitro_classic'
+		| 'img_logo_nitro_classic_horizontal'
+		| 'img_logo_nitro_classic_horizontal_light'
+		| 'img_logo_nitro_classic_stacked'
+		| 'img_logo_nitro_dark'
+		| 'img_logo_nitro_small_dark'
+		| 'img_logo_nitro_small_light'
+		| 'img_logo_nitro_tier_0'
+		| 'img_logo_nitro_tier_0_horizontal_dark'
+		| 'img_logo_nitro_tier_0_light'
+		| 'img_logo_nitro_tier_2_horizontal_dark'
+		| 'img_logo_plus_boost'
+		| 'img_logo_premium_tier_0_full'
+		| 'img_logo_premium_tier_1_full'
+		| 'img_marketing_frog'
+		| 'img_marketing_profiles'
+		| 'img_marketing_uploads_light_border'
+		| 'img_meta_quest_dark'
+		| 'img_meta_quest_light'
+		| 'img_meta_quest_white'
+		| 'img_nitro_animated_avatar'
+		| 'img_nitro_animated_emoji'
+		| 'img_nitro_badge'
+		| 'img_nitro_classic_icon_80px'
+		| 'img_nitro_classic_icon_white_80px'
+		| 'img_nitro_file_upload'
+		| 'img_nitro_global_emoji'
+		| 'img_nitro_icon_80px'
+		| 'img_nitro_icon_filled'
+		| 'img_nitro_longer_message_upsell_dark'
+		| 'img_nitro_longer_message_upsell_light'
+		| 'img_nitro_misc_perks_20px'
+		| 'img_nitro_premium_guilds_20px'
+		| 'img_nitro_sticker_yellow_24px'
+		| 'img_nitro_subheader_mobile'
+		| 'img_nitro_ticket_bg'
+		| 'img_nitro_tier_0_activated_dark'
+		| 'img_nitro_tier_0_activated_light'
+		| 'img_nitro_tier_0_icon_80px'
+		| 'img_nitro_tier_1_activated_dark'
+		| 'img_nitro_tier_1_activated_light'
+		| 'img_nitro_tier_2_activated_dark'
+		| 'img_nitro_tier_2_activated_light'
+		| 'img_no_results'
+		| 'img_no_results_alt_darker'
+		| 'img_no_results_dark'
+		| 'img_no_results_dark_theme'
+		| 'img_no_results_darker'
+		| 'img_no_results_light'
+		| 'img_none'
+		| 'img_outbound_promotion_error'
+		| 'img_outbound_promotion_redemption'
+		| 'img_plan_activated'
+		| 'img_plan_activated_light'
+		| 'img_poop_dark'
+		| 'img_poop_light'
+		| 'img_premium_basic_icon'
+		| 'img_premium_canvas_mobile'
+		| 'img_premium_classic_icon_80px'
+		| 'img_premium_embed_background_dark'
+		| 'img_premium_embed_background_light'
+		| 'img_premium_error_mobile'
+		| 'img_premium_icon_80px'
+		| 'img_premium_resubscribe_mobile'
+		| 'img_preview_not_available_dark'
+		| 'img_preview_not_available_light'
+		| 'img_profile_upsell'
+		| 'img_register_header'
+		| 'img_roblox_dark'
+		| 'img_roblox_light'
+		| 'img_roblox_white'
+		| 'img_search_empty_dark'
+		| 'img_search_empty_darker'
+		| 'img_search_empty_light'
+		| 'img_security'
+		| 'img_stream_ended_dark'
+		| 'img_stream_ended_darker'
+		| 'img_stream_full'
+		| 'img_study'
+		| 'img_subheader_error_mobile'
+		| 'img_subheader_error_mobile_v2'
+		| 'img_subheader_error_mobile_v2_light'
+		| 'img_subheader_resub_mobile'
+		| 'img_subscription_activated_dark'
+		| 'img_subscription_activated_light'
+		| 'img_tier_0_clouds'
+		| 'img_tier_0_clouds_bigger'
+		| 'img_tier_0_error_mobile'
+		| 'img_tier_0_marketing_boosting'
+		| 'img_tier_0_marketing_emojis'
+		| 'img_tier_0_mobile'
+		| 'img_tier_0_resubscribe_mobile'
+		| 'img_tier_0_subheader_mobile'
+		| 'img_tier_2_clouds'
+		| 'img_tier_2_clouds_bigger'
+		| 'img_top_pattern_dark'
+		| 'img_top_pattern_darker'
+		| 'img_top_pattern_light'
+		| 'img_transfer_arrow'
+		| 'img_vanity_urls'
+		| 'img_verify_email_sent'
+		| 'img_verify_phone_dark_theme'
+		| 'img_verify_phone_darker'
+		| 'img_verify_phone_light_theme'
+		| 'img_what_you_lose_boost'
+		| 'img_what_you_lose_emojis'
+		| 'img_what_you_lose_hd_video'
+		| 'img_what_you_lose_profile'
+		| 'img_what_you_lose_profile_tier1_dark'
+		| 'img_what_you_lose_profile_tier1_darker'
+		| 'img_what_you_lose_profile_tier1_light'
+		| 'img_what_you_lose_uploads'
+		| 'img_wump_trash_dark'
+		| 'img_wump_trash_darker'
+		| 'img_wumpus_lightro'
+		| 'img_wumpus_nitro'
+		| 'img_wumpus_nitro_boost'
+		| 'img_wumpus_nitro_classic'
+		| 'img_wumpus_nitro_classic_boost'
+		| 'img_wumpus_nitro_rev'
+		| 'img_wumpus_nitro_tier_0'
+		| 'intro_header_dark'
+		| 'intro_header_darker'
+		| 'intro_header_light'
+		| 'invite'
+		| 'invite-bg'
+		| 'it'
+		| 'ja'
+		| 'ko'
+		| 'krisp_logo_dark'
+		| 'krisp_logo_light'
+		| 'large_uploads'
+		| 'light_home_header_placeholder'
+		| 'line'
+		| 'link_expired'
+		| 'link_expired_light'
+		| 'link_failure'
+		| 'load-issue-dark'
+		| 'load-issue-light'
+		| 'lock'
+		| 'locke_2'
+		| 'logo'
+		| 'lt'
+		| 'mac_2'
+		| 'mail'
+		| 'mallow_1'
+		| 'maximize'
+		| 'member_list_badge_16px'
+		| 'member_list_icon'
+		| 'member_pricing'
+		| 'messages'
+		| 'messenger'
+		| 'mfa-server'
+		| 'mobile-empty-state'
+		| 'money_birb_placeholder_dark'
+		| 'money_birb_placeholder_light'
+		| 'nameplate_avatar_placeholder_dark_mode'
+		| 'nameplate_avatar_placeholder_light_mode'
+		| 'nav_header_disconnect'
+		| 'nelly_1'
+		| 'nitro_home_banner'
+		| 'nitro_modal_header_background'
+		| 'nitro_wumpus_avatar'
+		| 'nl'
+		| 'no'
+		| 'no-app-icon'
+		| 'no_mutual_friends_dark'
+		| 'no_mutual_friends_darker'
+		| 'no_mutual_friends_light'
+		| 'no_mutual_servers_dark'
+		| 'no_mutual_servers_darker'
+		| 'no_mutual_servers_light'
+		| 'notification_upsell'
+		| 'nsfw_gate'
+		| 'nsfw_gate_unavailable'
+		| 'nux'
+		| 'onboarding_v2_upsell'
+		| 'partner_icon'
+		| 'partying_face'
+		| 'pending-alert'
+		| 'pending_dark'
+		| 'pending_darker'
+		| 'pending_light'
+		| 'personalize_32px'
+		| 'phibi_1'
+		| 'pl'
+		| 'poop_dark_large'
+		| 'poop_light_large'
+		| 'premium_gift_plan_selection_header'
+		| 'premium_role_unavailable'
+		| 'progress-setup'
+		| 'ps_relink_upsell'
+		| 'pt-BR'
+		| 'quests_embed_mobile_missing'
+		| 'redesign_email_header'
+		| 'register-background-dark'
+		| 'register-background-light'
+		| 'rejected-alert'
+		| 'report'
+		| 'resubscribed_alert_header'
+		| 'ro'
+		| 'role'
+		| 'role_2'
+		| 'role_subscription_benefit_avatar_1'
+		| 'role_subscription_benefit_bunny_avatar'
+		| 'role_subscription_benefit_nelly_avatar'
+		| 'role_subscription_benefit_wise_avatar'
+		| 'role_subscription_earning_illo'
+		| 'role_subscription_earning_metric_avatar'
+		| 'role_subscription_lanyard_illo'
+		| 'role_subscription_settings_hero'
+		| 'role_subscription_social'
+		| 'ru'
+		| 'safety_check'
+		| 'safety_check_light'
+		| 'safety_shield'
+		| 'sample_banner'
+		| 'screenshare'
+		| 'screenshare_end'
+		| 'screenshare_splash'
+		| 'scrubber'
+		| 'search-icon'
+		| 'search_empty_state'
+		| 'search_empty_state_dark'
+		| 'search_empty_state_light'
+		| 'send_message_32px'
+		| 'server-error'
+		| 'server-invite-envelope'
+		| 'server_boost_logo_dark'
+		| 'server_boost_logo_light'
+		| 'server_boosts'
+		| 'settings'
+		| 'share'
+		| 'sparkle_star_elongated'
+		| 'sparkle_star_pointed'
+		| 'speaker'
+		| 'spectator'
+		| 'stack-nav-back'
+		| 'stack-nav-close'
+		| 'stage-channel-upsell'
+		| 'stage-sparkles'
+		| 'stamp-wave'
+		| 'star'
+		| 'sticker'
+		| 'sticker_search_empty'
+		| 'stream'
+		| 'study'
+		| 'subscribe_confirm'
+		| 'subscription_placeholder_pattern_dark'
+		| 'subscription_placeholder_pattern_darker'
+		| 'subscription_placeholder_pattern_light'
+		| 'success-header'
+		| 'summary_indicator_end'
+		| 'summary_indicator_start'
+		| 'sunbeam_gradient_mobile'
+		| 'super_reaction'
+		| 'support'
+		| 'sv-SE'
+		| 'system-user-avatar'
+		| 'telegram'
+		| 'th'
+		| 'tier_0_24px'
+		| 'tier_0_48px_dark'
+		| 'tier_0_48px_darker'
+		| 'tier_0_48px_light'
+		| 'tier_1_24px'
+		| 'tier_1_32px'
+		| 'tier_2_24px'
+		| 'tier_2_32px'
+		| 'tier_3_24px'
+		| 'tier_3_32px'
+		| 'tiny-bronco-spot'
+		| 'top_perk_streaming_quality'
+		| 'top_perk_vanity_url'
+		| 'tr'
+		| 'twitter'
+		| 'uk'
+		| 'updateAppIcon'
+		| 'upload'
+		| 'verify-email'
+		| 'vi'
+		| 'vibing_wumpus_rings'
+		| 'video'
+		| 'video_dark'
+		| 'video_light'
+		| 'voice_bar_bluetooth'
+		| 'voice_bar_deafen_off'
+		| 'voice_bar_deafen_on'
+		| 'voice_bar_mute_off'
+		| 'voice_bar_mute_on'
+		| 'voice_bar_phone'
+		| 'voice_bar_speaker_new'
+		| 'voice_channels'
+		| 'vr'
+		| 'watch'
+		| 'webhook_empty_dark'
+		| 'webhook_empty_darker'
+		| 'webhook_empty_light'
+		| 'welcome-bg'
+		| 'whatsapp'
+		| 'wreath_dark'
+		| 'wreath_light'
+		| 'wumpus-ash'
+		| 'wumpus-link'
+		| 'wumpus-luigi'
+		| 'wumpus-mario'
+		| 'wumpus-pikachu'
+		| 'wumpus-wizard'
+		| 'wumpus-wump'
+		| 'wumpus_1'
+		| 'wumpus_box_premium120'
+		| 'wumpus_cup_premium120'
+		| 'wumpus_snowglobe_premium120'
+		| 'wumpus_wave'
+		| 'xbox'
+		| 'xbox_app_phone'
+		| 'xbox_upsell'
+		| 'yearly_upsell_wumpus'
+		| 'yellow-alert'
+		| 'youtube_icon'
+		| 'zh-CN'
+		| 'zh-TW';
+	svg:
+		| 'img_account_sync_battlenet_light_and_dark'
+		| 'img_account_sync_battlenet_white'
+		| 'img_account_sync_bluesky_light_and_dark'
+		| 'img_account_sync_bluesky_white'
+		| 'img_account_sync_crunchyroll_light_and_dark'
+		| 'img_account_sync_crunchyroll_white'
+		| 'img_account_sync_ebay_light_and_dark'
+		| 'img_account_sync_ebay_white'
+		| 'img_account_sync_epic_dark_and_white'
+		| 'img_account_sync_epic_light'
+		| 'img_account_sync_facebook_light_and_dark'
+		| 'img_account_sync_facebook_white'
+		| 'img_account_sync_github_light'
+		| 'img_account_sync_github_white'
+		| 'img_account_sync_instagram_light_and_dark'
+		| 'img_account_sync_instagram_white'
+		| 'img_account_sync_league_of_legends_light_and_dark'
+		| 'img_account_sync_league_of_legends_white'
+		| 'img_account_sync_mastodon_light_and_dark'
+		| 'img_account_sync_mastodon_white'
+		| 'img_account_sync_paypal_light_and_dark'
+		| 'img_account_sync_paypal_white'
+		| 'img_account_sync_playstation_light'
+		| 'img_account_sync_playstation_white'
+		| 'img_account_sync_reddit_light_and_dark'
+		| 'img_account_sync_reddit_white'
+		| 'img_account_sync_riot_black'
+		| 'img_account_sync_riot_light_and_dark'
+		| 'img_account_sync_riot_white'
+		| 'img_account_sync_samsung_light_and_dark'
+		| 'img_account_sync_samsung_white'
+		| 'img_account_sync_skype_light_and_dark'
+		| 'img_account_sync_skype_white'
+		| 'img_account_sync_spotify_light_and_dark'
+		| 'img_account_sync_spotify_white'
+		| 'img_account_sync_steam_light'
+		| 'img_account_sync_steam_white'
+		| 'img_account_sync_tiktok_dark'
+		| 'img_account_sync_tiktok_light'
+		| 'img_account_sync_twitch_light_and_dark'
+		| 'img_account_sync_twitch_white'
+		| 'img_account_sync_twitter_light_and_dark'
+		| 'img_account_sync_twitter_white'
+		| 'img_account_sync_x_dark'
+		| 'img_account_sync_x_light'
+		| 'img_account_sync_x_white'
+		| 'img_account_sync_xbox_light'
+		| 'img_account_sync_xbox_white'
+		| 'img_account_sync_youtube_light_and_dark'
+		| 'img_account_sync_youtube_white'
+		| 'img_amazon_music'
+		| 'img_bungie_dark'
+		| 'img_bungie_light'
+		| 'img_bungie_white'
+		| 'img_domain_dark'
+		| 'img_domain_light'
+		| 'img_meta_quest'
+		| 'img_meta_quest_light'
+		| 'img_roblox_dark'
+		| 'img_roblox_light'
+		| 'img_roblox_white';
+	webm: 'halloween_loading_dark' | 'halloween_loading_light';
+};
+/** A file type Discord registers assets of. */
+export type DiscordAssetType = keyof DiscordAssetNames;
 /** A function exported by a Discord module, whose signature Discord does not document. */
 export type DiscordFunction<T = any> = (...args: any[]) => T;
+/** The props Discord passes its `*Icon` components, such as `WrenchIcon`, and an imported SVG takes. */
+export type DiscordIconProps = {
+	/** A size on Discord's scale, or points. Defaults to `'md'` (24). */
+	size?: DiscordIconSize | number;
+	/** A theme token or a colour. Defaults to the theme's interactive icon colour. */
+	color?: SemanticColorToken | string;
+};
+/** The sizes of Discord's icons, from 12 points (`xxs`) to 32 (`lg`); `custom` leaves the size to `style`. */
+export type DiscordIconSize = 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'custom' | 'refresh_sm';
+/** A duration's units, smallest first. */
+export type DurationUnit = 'ms' | 's' | 'm' | 'h' | 'd';
 /**
  * Props of `EllipsisCircle` (function). Exports: none.
  * @see design/components/Button/native/ButtonEllipsis.native.tsx
@@ -1338,6 +3028,8 @@ export type EllipsisCircleProps = {
 	size?: unknown;
 	variant?: unknown;
 };
+/** The displays of a `string` setting that pick a Discord entity by its id. */
+export type EntityDisplay = 'user' | 'channel' | 'guild' | 'role';
 /** Discord ships numeric enums as bidirectional maps; this models both directions. */
 export type EnumLike<K extends readonly string[]> = {
 	[P in K[number]]: number;
@@ -1393,14 +3085,8 @@ export type FloatingActionButtonProps = Omit<
 	/** @default 16 */
 	positionRight?: number;
 };
-/** A custom font the native loader has registered, as injected on `window.UNBOUND_FONTS`. */
-export type FontDescriptor = {
-	name: string;
-	file: string;
-	path: string;
-};
-/** A font managed by the Fonts manager: currently identical to its {@link FontDescriptor}. */
-export type FontEntity = FontDescriptor;
+/** A font face managed by the Fonts manager, as `UnboundNative.fonts.list()` returns it. */
+export type FontEntity = UnboundInstalledFont;
 /**
  * Props of `FormLabel` (function). Exports: default.
  * @see design/void/Form/native/FormLabel.tsx
@@ -1592,9 +3278,13 @@ export type HeaderSubmittingIndicatorComponent =
  * @see design/components/Navigator/native/NavigatorHeader.native.tsx
  */
 export type HeaderSubmittingIndicatorProps = {};
+/** An icon a row or toast draws: an asset id, an element such as `<Star />`, or an icon component such as `Star`. */
+export type IconInput = number | React$1.ReactElement | React$1.ComponentType<DiscordIconProps>;
 /** A loaded icon pack: its bundle marker and {@link IconPackManifest}. */
 export type IconPack = {
+	/** The name the pack was loaded under: its manifest `name`, or `Default` for Discord's own icons. */
 	bundle: string;
+	/** The pack's manifest. */
 	manifest: IconPackManifest;
 };
 /** An icon pack's manifest: an {@link AddonManifest} tagged with its source kind. */
@@ -1711,6 +3401,8 @@ export type LayerScopeProps = {
 	children?: React$1.ReactNode;
 	zIndex?: number;
 };
+/** The `objc` namespace the loader publishes, before the client adds `create` and scopes it to a plugin. */
+export type LoaderObjCBridge = Omit<NativeObjCBridge, 'create'> & NativeUIScopeFactory;
 /**
  * Props of `LoadingButtonPill` (function). Exports: LoadingButtonPill.
  * @see design/components/Button/native/ButtonPill.native.tsx
@@ -1729,6 +3421,31 @@ export type LoadingButtonPillProps = {
 	/** @default 'primary' */
 	variant?: PillWrapperProps['variant'];
 };
+/** A generated component that also accepts {@link LooseProps}, keeping its statics such as `TableRow.Icon`. */
+export type LooseComponent<C> =
+	C extends React$1.ComponentType<infer P> ? C & React$1.FunctionComponent<LooseProps<P>> : C;
+/** Each export of a generated module with {@link LooseComponent} applied. */
+export type LooseModule<M> = {
+	[K in keyof M]: LooseComponent<M[K]>;
+};
+/**
+ * The value type a loose prop accepts: a primitive, literal union or callback stays checked; anything else the
+ * generator inferred (`any`, objects, React nodes, wide unions) is {@link UncertainValue}.
+ */
+export type LoosePropValue<T> = 0 extends 1 & T
+	? UncertainValue
+	: [NonNullable<T>] extends [Primitive]
+		? T
+		: [NonNullable<T>] extends [Callback]
+			? T
+			: UncertainValue;
+/**
+ * Generated component props made safe to pass: every known prop is optional and checked only where its type is
+ * concrete, and any other prop is allowed, since the generator can miss props or mark a defaulted one required.
+ */
+export type LooseProps<P> = {
+	[K in keyof P]?: LoosePropValue<P[K]>;
+} & Record<string, unknown>;
 /**
  * Props of `LottieIcon` (function). Exports: LottieIcon.
  * @see design/components/LottieIcon/native/LottieIcon.tsx
@@ -1762,6 +3479,63 @@ export type ManaContextProviderProps = {
 	children?: React$1.ReactNode;
 	value?: unknown;
 };
+/** Parses nested Markdown, as a rule's `parse` receives it. */
+export type MarkdownNestedParse = (source: string, state: MarkdownState) => MarkdownNode[];
+/** One node of a parsed Markdown tree; `type` names the rule that parsed it. */
+export type MarkdownNode = {
+	/** The name of the rule that parsed the node, such as `text` or `strong`. */
+	type: string;
+	/** The node's children, or its text for a leaf rule; absent when a rule stores its data elsewhere. */
+	content?: MarkdownNode[] | string;
+};
+/** Renders a node or a list of nodes, as a rule's `react` receives it. */
+export type MarkdownOutput = (
+	node: MarkdownNode | MarkdownNode[],
+	state: MarkdownState,
+) => React$1.ReactNode;
+/** Discord's Markdown module (`MarkupUtils`), found by `parse`, `parseToAST` and `reactParserFor`. */
+export type MarkdownParserModule = {
+	/** The rules Discord renders messages with. */
+	defaultRules: MarkdownRules;
+	/** Builds a renderer from a rule set, such as `defaultRules` plus your own rules. */
+	reactParserFor(rules: MarkdownRules): MarkdownReactParser;
+	/** Renders Markdown with `defaultRules`, as Discord renders message content. */
+	parse: MarkdownReactParser;
+	/** Parses Markdown with `defaultRules` into nodes without rendering them; `inline` defaults to `true`. */
+	parseToAST(source?: string, inline?: boolean, state?: MarkdownState): MarkdownNode[];
+};
+/** Renders Markdown source to React Native elements; `inline` defaults to `true`. */
+export type MarkdownReactParser = (
+	source?: string,
+	inline?: boolean,
+	state?: MarkdownState,
+) => React$1.ReactNode;
+/** A simple-markdown rule: `match` finds it at the start of the source, `parse` builds its node, `react` renders it. */
+export type MarkdownRule<TNode extends MarkdownNode = MarkdownNode> = {
+	/** Discord 349 ships `highlight`, `guild` and `channel` without one; the parser never calls those. */
+	order?: number;
+	/** Matches the rule at the start of `source`; `previous` is the text already consumed. `null` means no match. */
+	match(source: string, state: MarkdownState, previous: string): RegExpExecArray | null;
+	/** Builds the node from `match`'s capture; call `parse` to parse nested Markdown. */
+	parse(capture: RegExpExecArray, parse: MarkdownNestedParse, state: MarkdownState): TNode;
+	/** Renders the node; call `output` to render its children. */
+	react?(node: TNode, output: MarkdownOutput, state: MarkdownState): React$1.ReactNode;
+};
+/** A rule set by rule name, the shape `reactParserFor` takes. */
+export type MarkdownRules = Record<string, MarkdownRule>;
+/** The parse state Discord's rules read; the `allow*` flags turn links, headings and lists on. */
+export type MarkdownState = {
+	/** The React key the output function sets before calling a rule's `react`. */
+	key?: string | number;
+	/** Whether the parser is inside inline content; inline-only rules such as `strong` match only then. */
+	inline?: boolean;
+	/** Renders links as links instead of plain text. */
+	allowLinks?: boolean;
+	/** Parses `#` headings. */
+	allowHeading?: boolean;
+	/** Parses `-` and `1.` lists. */
+	allowList?: boolean;
+};
 export type MenuComponent = React$1.ComponentType<MenuProps>;
 export type MenuGroupComponent = React$1.ComponentType<MenuGroupProps>;
 /**
@@ -1941,25 +3715,85 @@ export type ModalStepIndicatorProps = {
 };
 /** The outcome of checking an addon's signature against the keys compiled into the loader. */
 export type NativeAddonVerification = {
+	/** `signed` when a trusted key signed the bundle, `unsigned` when there is no signature, `invalid` when it fails. */
 	readonly status: 'signed' | 'unsigned' | 'invalid';
+	/** Who signed the addon; set only when `status` is `signed`. */
 	readonly signer?: string;
+	/** Why verification did not succeed, when the loader can say. */
 	readonly problem?: string;
 };
+/** Where a running install is: `confirming` waits on the system prompt; `failed` carries `error`. */
+export type NativeAndroidInstallPhase =
+	| 'idle'
+	| 'downloading'
+	| 'installing'
+	| 'confirming'
+	| 'failed';
+/** How far the running install is. */
+export type NativeAndroidInstallProgress = {
+	/** What the installer is doing now. */
+	readonly phase: NativeAndroidInstallPhase;
+	/** Gzipped bytes downloaded so far, of `total`. */
+	readonly downloaded: number;
+	/** Gzipped bytes the install downloads in all. */
+	readonly total: number;
+	/** Why the last install failed, or `null`. */
+	readonly error: string | null;
+};
+/** One gzipped split APK of a build to install. */
+export type NativeAndroidInstallSplit = {
+	/** The split's name: `base` or a config split such as `config.arm64_v8a`. */
+	readonly name: string;
+	/** Where the gzipped APK downloads from. */
+	readonly url: string;
+	/** SHA-256 of the APK after it is gunzipped. */
+	readonly sha256: string;
+	/** Size of the APK in bytes. */
+	readonly size: number;
+	/** Size of the gzipped download in bytes. */
+	readonly compressedSize: number;
+};
+/** Whether Discord can install another patched build of itself: not patched with LSPatch, patched before in-app installs, waiting on the "Install unknown apps" permission, or ready. */
+export type NativeAndroidInstallerAvailability =
+	| 'unpatched'
+	| 'unsupported'
+	| 'needs-permission'
+	| 'ready';
+/** The Discord install the installer would replace. */
+export type NativeAndroidInstallerStatus = {
+	/** Whether in-app installs work, or what blocks them. */
+	readonly availability: NativeAndroidInstallerAvailability;
+	/** Discord's version name, such as `352.17 - Stable`. */
+	readonly versionName: string;
+	/** The installed split names, `base` first. */
+	readonly splits: string[];
+};
+/** A key from `objc.createAssociationKey` that names one associated object. */
 export type NativeAssociationKey = NativeHandle;
+/** Refers to an earlier step's result inside `objc.batch`, as a target or an argument. */
 export type NativeBatchReference = {
+	/** The zero-based index of the earlier step whose result to use. */
 	readonly $nativeBatchResult: number;
 };
+/** One Objective-C call in `objc.batch`; a batch takes up to 64 steps. */
 export type NativeBatchStep = {
+	/** The object to call, or an earlier step's result. */
 	target: NativeObjectHandle | NativeBatchReference;
+	/** The selector to send, at most 256 characters. */
 	selector: string;
+	/** The call's arguments, at most 16; each may be an earlier step's result. */
 	args: unknown[];
 };
+/** Options for a synchronous Objective-C call. */
 export type NativeCallOptions = {
+	/** The thread to run on. Defaults to `current`. */
 	thread?: NativeThreadPolicy;
 };
+/** A promise for native work; `cancel` drops it, and stopping the plugin cancels every pending one. */
 export type NativeCancelablePromise<T> = Promise<T> & {
 	cancel(): void;
 };
+/** A handle to an Objective-C class, from `objc.getClass`. */
 export type NativeClassHandle = NativeHandle;
 /** A plugin bundle the loader evaluated from bytecode: it takes the scoped React and returns the plugin module. */
 export type NativeCompiledPlugin = (react: typeof React$1) =>
@@ -1967,45 +3801,85 @@ export type NativeCompiledPlugin = (react: typeof React$1) =>
 	| {
 			default: Plugin$1;
 	  };
+/** What an addon was doing when the loader blamed it: `starting` or `running` for a crash, `frozen` for a freeze. */
 export type NativeCrashPhase = 'starting' | 'running' | 'frozen';
+/** An addon the loader disabled because Discord crashed or froze in it on consecutive launches. */
 export type NativeCrashedAddon = {
+	/** The addon's crash guard key, `<bucket>:<addon id>`. */
 	readonly id: string;
+	/** The addon's display name. */
 	readonly name: string;
-	readonly phase?: NativeCrashPhase;
+	/** What the addon was doing. */
+	readonly phase: NativeCrashPhase;
 };
+/** Debugger support for plugins. */
 export type NativeDebugBridge = {
+	/** Logs an evaluation and adds it to the loader's history; false when the record is malformed. Needs `native.debug.evaluations`. */
 	recordEvaluation(record: NativeDebugEvaluation): boolean;
-	environment(): NativeDebugEnvironment;
+	/** Reads the debug environment, optionally collecting garbage or resetting counters first. Needs `native.debug.environment`. */
+	environment(options?: NativeDebugEnvironmentOptions): NativeDebugEnvironment;
 };
+/** Facts about the device a debugger session needs. */
 export type NativeDebugEnvironment = {
+	/** Whether Discord runs in a simulator, emulator or virtual machine. */
 	isVirtualDevice: boolean;
+	/** The address of the machine hosting the virtual device, or `null` on a physical one. */
 	hostAddress: string | null;
-	resources?: NativeResourceCounts;
-};
+	/** The loader's resource counts. */
+	resources: NativeResourceCounts;
+	/** Present when the read collected garbage first. */
+	garbageCollection?: NativeGarbageCollection;
+};
+/** What reading the debug environment may do first. */
+export type NativeDebugEnvironmentOptions = {
+	/** Collects garbage on the calling runtime and the UI runtime before counting. */
+	collectGarbage?: boolean;
+	/** Zeroes the main-thread counters after reading them. */
+	resetCounters?: boolean;
+};
+/** One debugger evaluation, which the loader logs and keeps in its evaluation history. */
 export type NativeDebugEvaluation = {
 	id: string;
 	code: string;
-	ok: boolean;
-	value?: string;
-	error?: string;
-	logs?: {
-		level: 1 | 2 | 3;
-		message: string;
-	}[];
+	logs?: NativeDebugEvaluationLog[];
+} & (
+	| {
+			ok: true;
+			value?: string;
+	  }
+	| {
+			ok: false;
+			error?: string;
+	  }
+);
+/** One console line an evaluation printed. */
+export type NativeDebugEvaluationLog = {
+	/** 1 for log, 2 for warn, 3 for error. */
+	level: 1 | 2 | 3;
+	/** The printed text. */
+	message: string;
 };
+/** Calls C functions in images Discord already loaded. An unsigned plugin needs the user's consent to use it. */
 export type NativeFFIBridge = {
+	/** Resolves a symbol in a loaded image, or in every loaded image when `image` is omitted; `null` when not found. */
 	symbol(name: string, image?: string): NativePointer | null;
+	/** Calls a symbol from `symbol` with an explicit signature. */
 	call(pointer: NativePointer, signature: NativeFFISignature, ...args: unknown[]): unknown;
 };
+/** A non-variadic C function signature for `ffi.call`. */
 export type NativeFFISignature = {
+	/** The result type; `i64` and `u64` results come back as `BigInt`. */
 	returnType: NativeFFIType;
+	/** The argument types, at most 16 and none `void`. */
 	args: NativeFFIType[];
 };
+/** An FFI type: a scalar or pointer name, or a registered struct by name, such as `{ struct: 'CGRect' }`. */
 export type NativeFFIType =
 	| NativeFFITypeName
 	| {
 			struct: string;
 	  };
+/** A C type in an FFI signature; `object`, `class` and `selector` exist only on iOS. */
 export type NativeFFITypeName =
 	| 'void'
 	| 'bool'
@@ -2024,188 +3898,371 @@ export type NativeFFITypeName =
 	| 'object'
 	| 'class'
 	| 'selector';
+/** 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`. */
 	mount(
 		container: NativeObjectHandle,
 		moduleName: string,
 		properties?: NativeSerializableObject,
+		options?: NativeFabricMountOptions,
 	): NativeFabricSurface;
+	/** Like `mount`, on the main thread. Needs `native.fabric.async`. */
 	mountAsync(
 		container: NativeObjectHandle,
 		moduleName: string,
 		properties?: NativeSerializableObject,
+		options?: NativeFabricMountOptions,
 	): NativeCancelablePromise<NativeFabricSurface>;
+	/** Sends new properties to a surface. */
 	update(surface: NativeFabricSurface, properties: NativeSerializableObject): void;
+	/** Like `update`, on the main thread. */
 	updateAsync(
 		surface: NativeFabricSurface,
 		properties: NativeSerializableObject,
 	): NativeCancelablePromise<void>;
+	/** Sets the smallest and largest size the surface may lay out at. */
 	setSize(
 		surface: NativeFabricSurface,
 		minimumSize: NativeFabricSize,
 		maximumSize: NativeFabricSize,
 	): void;
+	/** Like `setSize`, on the main thread. */
 	setSizeAsync(
 		surface: NativeFabricSurface,
 		minimumSize: NativeFabricSize,
 		maximumSize: NativeFabricSize,
 	): NativeCancelablePromise<void>;
+	/** Positions the surface's view in its container. */
 	setFrame(surface: NativeFabricSurface, frame: NativeFabricFrame): void;
+	/** Like `setFrame`, on the main thread. */
 	setFrameAsync(
 		surface: NativeFabricSurface,
 		frame: NativeFabricFrame,
 	): NativeCancelablePromise<void>;
+	/** Reads a view's frame. */
 	measure(view: NativeObjectHandle): NativeFabricFrame;
+	/** Like `measure`, on the main thread. */
 	measureAsync(view: NativeObjectHandle): NativeCancelablePromise<NativeFabricFrame>;
+	/** Stops a surface and removes its view. */
 	unmount(surface: NativeFabricSurface): void;
+	/** Like `unmount`, on the main thread. */
 	unmountAsync(surface: NativeFabricSurface): NativeCancelablePromise<void>;
+	/** Destroys the idle surfaces this plugin left for reuse. */
+	releaseIdle?(): void;
+	/** Like `releaseIdle`, on the main thread; the plugin scope calls it when the plugin stops. */
+	releaseIdleAsync(): NativeCancelablePromise<void>;
 };
+/** A view's frame in its container, in points on iOS and dp on Android. */
 export type NativeFabricFrame = {
+	/** The left edge, between -100,000 and 100,000. */
 	x: number;
+	/** The top edge, between -100,000 and 100,000. */
 	y: number;
+	/** Width, between 0 and 32,768. */
 	width: number;
+	/** Height, between 0 and 32,768. */
 	height: number;
 };
+/** Options for mounting a Fabric surface. */
+export type NativeFabricMountOptions = {
+	/** Reuses an idle surface of the same component this plugin unmounted, re-hosted in the new container with the new properties, instead of starting one. Only for components whose state follows their properties. */
+	reuse?: boolean;
+};
+/** A Fabric surface size, in points on iOS and dp on Android, between 0 and 32,768. */
 export type NativeFabricSize = {
+	/** Width, in points on iOS and dp on Android. */
 	width: number;
+	/** Height, in points on iOS and dp on Android. */
 	height: number;
 };
+/** A mounted Fabric surface; the plugin scope unmounts it on dispose. */
 export type NativeFabricSurface = NativeHandle;
+/** One font the loader can apply. */
 export type NativeFontEntry = {
+	/** The font's PostScript name, falling back to its full or file name; unique in the list. */
 	readonly name: string;
+	/** The font's full name, or `name` when the file has none. */
 	readonly displayName: string;
+	/** The family name, when the font file declares one. */
 	readonly family?: string;
+	/** The style name, such as `Bold`, when the font file declares one. */
 	readonly style?: string;
+	/** The font file's path; missing for system fonts the loader lists by name only. */
 	readonly path?: string;
+	/** Where the font comes from. */
 	readonly source: NativeFontSource;
 };
+/** Where a font comes from: bundled with Discord, installed on the system, or a font addon. */
 export type NativeFontSource = 'app' | 'system' | 'custom';
+/** Which runtimes a debug garbage collection reached. */
+export type NativeGarbageCollection = {
+	/** Whether garbage was collected on the runtime that made the call. */
+	runtime: boolean;
+	/** Whether garbage was collected on the UI runtime; false when no UI runtime is registered or collection failed. */
+	uiRuntime: boolean;
+};
 /** An opaque reference to a native object. Only the bridge creates handles; plugins pass them back. */
 export type NativeHandle = {
+	/** A type-only brand, absent at runtime, so plain objects cannot pass as handles. */
 	readonly [nativeHandle]: true;
 };
-export type NativeHookContext = {
-	self: NativeObjectHandle;
+/** What an Objective-C hook handler receives for one call of the hooked method. */
+export type NativeHookContext<Receiver extends boolean = true> = {
+	/** The receiver, borrowed until the handler returns. */
+	self: Receiver extends true ? NativeObjectHandle : undefined;
+	/** The hooked selector's name. */
 	selector: string;
+	/** The method's explicit arguments, without `self` and `_cmd`, borrowed until the handler returns. */
 	args: unknown[];
-	original: (...args: unknown[]) => unknown;
+	/** The method argument index each entry of `args` came from, as trimmed by `payload.arguments`. */
+	argumentIndexes: number[];
+	/** Which handler is running. */
+	phase: 'before' | 'after' | 'replace';
+	/** Runs the original implementation; it works only synchronously on the hook's thread. */
+	original: (...args: unknown[]) => NativeObjCResult;
+	/** Swaps the object argument at an index of `args` before the original runs; only during a synchronous handler. */
 	replaceObjectArgument(index: number, value: NativeObjectHandle | null): void;
 };
-export type NativeHookHandlers = {
-	before?: (context: NativeHookContext) => void | Promise<void>;
-	after?: (context: NativeHookContext) => void | Promise<void>;
-	replace?: (context: NativeHookContext) => unknown;
-};
-export type NativeHookOptions = {
+/** The handlers an Objective-C hook runs around each call; it needs at least one, unless `cacheOnly` is set. */
+export type NativeHookHandlers<Receiver extends boolean = true> = {
+	/** Runs before the original implementation. */
+	before?: (context: NativeHookContext<Receiver>) => void | Promise<void>;
+	/** Runs after the original implementation. */
+	after?: (context: NativeHookContext<Receiver>) => void | Promise<void>;
+	/** Runs instead of the original; what it returns becomes the method's result. */
+	replace?: (context: NativeHookContext<Receiver>) => NativeObjCResult;
+};
+/** Options for `objc.hook`. */
+export type NativeHookOptions<Receiver extends boolean = boolean> = {
+	/** Runs no JavaScript and returns values set with `setReturnValue`; needs a scalar or struct return type. */
 	cacheOnly?: boolean;
+	coalesce?: 'receiver';
+	/** Hooks calls on this object only. */
 	instance?: NativeObjectHandle;
+	/** Removes the hook after its first call. */
 	once?: boolean;
+	payload?: NativeHookPayload<Receiver>;
 } & NativeCallOptions;
+/** Trims what a hook sends to JavaScript per call, to cut crossing cost on hot methods. */
+export type NativeHookPayload<Receiver extends boolean = boolean> = {
+	/** Whether handlers receive `self`. Defaults to true. */
+	receiver?: Receiver;
+	/** The zero-based indexes of the arguments to send; every argument when omitted. */
+	arguments?: number[];
+	/** Sends only the `before` or only the `after` call; both when omitted. */
+	phase?: 'before' | 'after';
+};
+/** An installed Objective-C hook; the plugin scope removes it on dispose. */
 export type NativeHookToken = {
+	/** False once the hook is removed. */
 	readonly active: boolean;
-	setReturnValue(self: NativeObjectHandle, args: unknown[], value: unknown): void;
+	/** Sets the result a `cacheOnly` hook returns for calls with this receiver and these arguments. */
+	setReturnValue(self: NativeObjectHandle, args: unknown[], value: NativeObjCResult): void;
+	/** Removes the result set for this receiver and these arguments. */
 	removeReturnValue(self: NativeObjectHandle, args: unknown[]): void;
+	/** Removes every result set on this hook. */
 	clearReturnValues(): void;
+	/** Removes the hook; calling it again does nothing. */
 	remove(): void;
 };
+/** An argument to a Java call: a tagged value or a handle. */
 export type NativeJavaArgument = NativeJavaValue | NativeJavaHandle;
+/** A key from `java.createAssociationKey` that names one associated value. */
 export type NativeJavaAssociationKey = NativeHandle;
+/** One independent operation in a Java `batch` or `batchAsync`. */
 export type NativeJavaBatchOperation = {
+	/** What to do with `handle`. */
 	op: 'invoke' | 'getField' | 'setField' | 'respondsTo';
+	/** The object to act on. */
 	handle: NativeJavaReference;
+	/** The method or field name. */
 	name: string;
+	/** The method's arguments, for `invoke` and `respondsTo`. */
 	args?: NativeJavaArgument[];
+	/** The value to write, for `setField`. */
 	value?: NativeJavaArgument;
 };
+/** The Android bridge to Java through reflection. Sync calls run on the JavaScript thread, so touch views only asynchronously. */
 export type NativeJavaBridge = {
+	/** Looks up a class by fully qualified name and returns a handle the scope holds until released. */
 	getClass(name: string): NativeJavaHandle;
+	/** Lists a class's constructors, methods and fields. */
 	describe(name: string): NativeJavaClassDescription;
+	/** Runs independent operations in one call on the JavaScript thread and returns every result in order. */
 	batch(operations: NativeJavaBatchOperation[]): NativeJavaValue[];
+	/** Runs the operations like `batch`, on the main thread, so views can be read safely. */
+	batchAsync(operations: NativeJavaBatchOperation[]): NativeCancelablePromise<NativeJavaValue[]>;
+	/** Finds the views of a class under or above a view, on the main thread, like `objc.findViews`. */
+	findViews(
+		root: NativeJavaReference,
+		className: string,
+		options?: NativeViewSearchOptions,
+	): NativeCancelablePromise<NativeJavaValue[]>;
+	/** Creates a key for attaching a value to objects with `setAssociatedObject`. */
 	createAssociationKey(): NativeJavaAssociationKey;
+	/** Reads the value attached to an object under a key. */
 	getAssociatedObject(
 		handle: NativeJavaReference,
 		key: NativeJavaAssociationKey,
 	): NativeJavaValue;
+	/** Attaches a value to an object under a key. */
 	setAssociatedObject(
 		handle: NativeJavaReference,
 		key: NativeJavaAssociationKey,
 		value: NativeJavaArgument,
 	): void;
+	/** Reads an object's class name, as a string value. */
 	className(handle: NativeJavaReference): NativeJavaValue;
+	/** Calls the constructor matching `args` and returns a handle the scope holds until released. */
 	construct(name: string, args?: NativeJavaArgument[]): NativeJavaHandle;
+	/** Checks whether the object has a method `name` callable with `args`, as a boolean value. */
 	respondsTo(
 		handle: NativeJavaReference,
 		name: string,
 		args?: NativeJavaArgument[],
 	): NativeJavaValue;
+	/** Calls a method on the JavaScript thread. */
 	invoke(handle: NativeJavaReference, name: string, args?: NativeJavaArgument[]): NativeJavaValue;
+	/** Resolves a method by name and parameter types once, for repeated calls through `invokePrepared`. */
+	prepare(
+		target: NativeJavaReference,
+		name: string,
+		parameterTypes: readonly string[],
+	): NativeJavaCallPlan;
+	/** Calls a prepared method on the JavaScript thread, like `invoke`. */
+	invokePrepared(
+		plan: NativeJavaCallPlan,
+		target: NativeJavaReference,
+		args?: NativeJavaArgument[],
+	): NativeJavaValue;
+	/** Calls a prepared method on the main thread and resolves with its result, like `invokeAsync`. */
+	invokePreparedAsync(
+		plan: NativeJavaCallPlan,
+		target: NativeJavaReference,
+		args?: NativeJavaArgument[],
+	): NativeCancelablePromise<NativeJavaValue>;
+	/** Frees a call plan; using it afterwards throws. */
+	disposePlan(plan: NativeJavaCallPlan): void;
+	/** Calls a method on the main thread and resolves with its result. Needs `native.java.invokeAsync`. */
 	invokeAsync(
 		handle: NativeJavaReference,
 		name: string,
 		args?: NativeJavaArgument[],
 	): NativeCancelablePromise<NativeJavaValue>;
+	/** Reads a field by name. */
 	getField(handle: NativeJavaReference, name: string): NativeJavaValue;
+	/** Writes a field by name. */
 	setField(handle: NativeJavaReference, name: string, value: NativeJavaArgument): void;
+	/** Drops the plugin's hold on a handle so the loader can free the object. */
 	release(handle: NativeJavaReference): void;
 };
+/** A method resolved once by `java.prepare`, for calling many times without the lookup. */
+export type NativeJavaCallPlan = NativeJavaHandle & {
+	readonly [nativeJavaCallPlan]: true;
+};
+/** A Java class's shape, read by reflection with `java.describe`. */
 export type NativeJavaClassDescription = {
+	/** The fully qualified class name. */
 	name: string;
+	/** The superclass name, or `null` when there is none. */
 	superclass: string | null;
+	/** The names of the interfaces the class implements. */
 	interfaces: string[];
+	/** Each constructor's parameter class names. */
 	constructors: string[][];
+	/** The methods the class declares. */
 	methods: NativeJavaMethodDescription[];
+	/** The fields the class declares. */
 	fields: NativeJavaFieldDescription[];
 };
+/** One field a Java class declares, from `java.describe`. */
 export type NativeJavaFieldDescription = {
+	/** The field name. */
 	name: string;
+	/** The field type's class name. */
 	type: string;
+	/** Whether the field is static. */
 	static: boolean;
 };
+/** A handle to a Java object or class; the plugin scope releases it on dispose. */
 export type NativeJavaHandle = NativeHandle;
+/** A Java object reference the bridge returns inside a result. */
 export type NativeJavaHandleValue = {
+	/** Marks the value as an object reference. */
 	type: 'handle';
+	/** The id the loader issued for the object. */
 	value: string;
 };
-export type NativeJavaHookEvent = {
-	self: NativeJavaValue;
+/** What a Java hook listener receives for one call of the hooked method. */
+export type NativeJavaHookEvent<Receiver extends boolean = true> = {
+	/** The object the hooked method was called on. */
+	self: Receiver extends true ? NativeJavaValue : undefined;
+	/** The call's arguments. */
 	args: NativeJavaValue[];
-};
-export type NativeJavaHookOptions = {
+	/** The method argument index each entry of `args` came from, as trimmed by `payload.arguments`. */
+	argumentIndexes: number[];
+	/** Whether the listener heard the call before or after the method ran. */
+	phase: 'before' | 'after';
+};
+/** Options for `hooks.hook`. */
+export type NativeJavaHookOptions<Receiver extends boolean = boolean> = {
+	/** Collapses queued `after` events for the same receiver into one; needs a non-static method and an `after` payload. */
+	coalesce?: 'receiver';
+	/** Returns a value set with `setReturnValue` for a matching call instead of running the method. Defaults to false. */
 	replace?: boolean;
-	notify?: boolean;
+	/** Whether the listener hears calls: before the method by default, `after` once it has run, `false` never. */
+	notify?: boolean | 'after';
+	/** Trims the receiver, arguments and phase each event sends, to cut crossing cost on hot methods. */
+	payload?: NativeHookPayload<Receiver>;
 };
+/** An installed Java hook; the plugin scope removes it on dispose. */
 export type NativeJavaHookToken = {
+	/** The id the loader issued, such as `hook-1`. */
 	readonly id: string;
 };
+/** The Android bridge for hooking Java methods. Needs `native.java.hooks`. */
 export type NativeJavaHooksBridge = {
-	hook(
+	/** Hooks the method whose parameter class names match `parameterTypes`, and sends each call to `listener`. */
+	hook<Receiver extends boolean = true>(
 		className: string,
 		methodName: string,
 		parameterTypes: string[],
-		options?: NativeJavaHookOptions,
-		listener?: (event: NativeJavaHookEvent) => void,
+		options?: NativeJavaHookOptions<Receiver>,
+		listener?: (event: NativeJavaHookEvent<Receiver>) => void,
 	): NativeJavaHookToken;
+	/** Sets the result a `replace` hook returns for calls with this receiver and these arguments. */
 	setReturnValue(
 		token: NativeJavaHookToken,
 		self: NativeJavaValue,
 		args: NativeJavaValue[],
 		value: NativeJavaValue,
 	): void;
+	/** Removes the result set for this receiver and these arguments. */
 	removeReturnValue(
 		token: NativeJavaHookToken,
 		self: NativeJavaValue,
 		args: NativeJavaValue[],
 	): void;
+	/** Removes every result set on a hook. */
 	clearReturnValues(token: NativeJavaHookToken): void;
+	/** Removes a hook. */
 	remove(token: NativeJavaHookToken): void;
 };
+/** One method a Java class declares, from `java.describe`. */
 export type NativeJavaMethodDescription = {
+	/** The method name. */
 	name: string;
+	/** The parameters' class names, in order, as `hooks.hook` takes them. */
 	parameters: string[];
+	/** The return type's class name. */
 	returnType: string;
+	/** Whether the method is static. */
 	static: boolean;
 };
+/** 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. */
 export type NativeJavaValue =
 	| {
 			type: 'null';
@@ -2237,171 +4294,414 @@ export type NativeJavaValue =
 			componentType: string;
 			value: (NativeJavaValue | NativeJavaHandle | string | number | boolean)[];
 	  };
+/** How long main-thread crossings for one addon, kind and call label waited and ran. */
+export type NativeMainWaitCounts = {
+	/** The id of the addon that made the crossings. */
+	addon: string;
+	/** How the caller crossed: blocking (`sync`), fire-and-forget (`posted`) or awaiting a promise (`async`). */
+	kind: 'sync' | 'posted' | 'async' | 'unknown';
+	/** The call label the crossings ran under, `(other)` once the table is full. */
+	label: string;
+	/** Crossings queued for the main thread. */
+	posted: number;
+	/** Crossings that began running on the main thread. */
+	started: number;
+	/** Crossings that finished running on the main thread. */
+	finished: number;
+	/** Crossings that timed out or were refused before they started. */
+	expired: number;
+	/** Total time between posting and starting on the main thread. */
+	queuedMs: number;
+	/** The longest wait between posting and starting. */
+	maxQueuedMs: number;
+	/** Total time spent running on the main thread. */
+	runMs: number;
+	/** The longest single run on the main thread. */
+	maxRunMs: number;
+};
+/** Main-thread drains since launch or the last counter reset. */
+export type NativeMainWorkCounts = {
+	/** Times the loader drained its main-thread queue. */
+	drains: number;
+	/** Work items run across every drain. */
+	items: number;
+	/** Total time spent draining. */
+	drainMs: number;
+	/** The longest single drain. */
+	maxDrainMs: number;
+	/** The most items one drain ran. */
+	maxDrainItems: number;
+};
+/** The iOS bridge to the Objective-C runtime, scoped to the plugin's capabilities. */
 export type NativeObjCBridge = {
+	/** Looks up a class by name, or returns `null` when none is registered. */
 	getClass(name: string): NativeClassHandle | null;
+	/** Allocates an instance and initializes it with `init`, UIKit classes on the main thread; use `create` for any other initializer. */
 	alloc(classOrName: string | NativeClassHandle): NativeObjectHandle;
+	/** Allocates an uninitialized instance, UIKit classes on the main thread unless `options.thread` says otherwise, and returns what `initSelector` initializes; throws when that is nil. */
+	create(
+		classOrName: string | NativeClassHandle,
+		initSelector: string,
+		args?: unknown[],
+		options?: NativeCallOptions,
+	): NativeObjectHandle;
+	/** Returns the class name of the object a handle refers to, or `null`. */
 	className(handle: NativeHandle): string | null;
+	/** Checks whether the object responds to a selector. */
 	respondsTo(handle: NativeHandle, selector: string): boolean;
-	call(handle: NativeHandle, selector: string, ...args: unknown[]): unknown;
+	/** Sends a selector with its arguments on the current runtime thread. */
+	call(handle: NativeHandle, selector: string, ...args: unknown[]): NativeObjCResult;
+	/** Runs the implementation `currentClass`'s superclass provides, like `super` in Objective-C. */
 	callSuper(
 		handle: NativeObjectHandle,
 		currentClass: NativeClassHandle | string,
 		selector: string,
 		...args: unknown[]
-	): unknown;
+	): NativeObjCResult;
+	/** Sends a selector on the thread `options.thread` names; `main` blocks, `main-post` queues `void` methods, so prefer `invokeAsync` or `main-post` for UI work. Ownership follows Cocoa naming: an `alloc`, `new`, `copy`, `mutableCopy` or `init` result is owned by its handle without an extra reference, and the receiver of an `init` selector stays valid. */
 	invoke(
 		handle: NativeObjectHandle,
 		selector: string,
 		args: unknown[],
 		options?: NativeCallOptions,
-	): unknown;
+	): NativeObjCResult;
+	/** Sends a selector on the main thread and resolves with its result. Needs `native.objc.invokeAsync`. */
 	invokeAsync(
 		handle: NativeObjectHandle,
 		selector: string,
 		args: unknown[],
-	): NativeCancelablePromise<unknown>;
-	batch(steps: readonly NativeBatchStep[]): NativeCancelablePromise<unknown[]>;
+	): NativeCancelablePromise<NativeObjCResult>;
+	/** Resolves a selector's method signature on an object once, for repeated calls through `invokePrepared`. */
+	prepare(handle: NativeHandle, selector: string): NativeObjCCallPlan;
+	/** Calls a prepared selector on an object, on the thread `options.thread` names, like `invoke`. */
+	invokePrepared(
+		plan: NativeObjCCallPlan,
+		handle: NativeHandle,
+		args: unknown[],
+		options?: NativeCallOptions,
+	): NativeObjCResult;
+	/** Calls a prepared selector on the main thread and resolves with its result, like `invokeAsync`. */
+	invokePreparedAsync(
+		plan: NativeObjCCallPlan,
+		handle: NativeHandle,
+		args: unknown[],
+	): NativeCancelablePromise<NativeObjCResult>;
+	/** Frees a call plan; using it afterwards throws. */
+	disposePlan(plan: NativeObjCCallPlan): void;
+	/** Runs dependent calls in one main-thread pass; a failed step rejects it without undoing earlier steps. */
+	batch(steps: readonly NativeBatchStep[]): NativeCancelablePromise<NativeObjCResult[]>;
+	/** Reads a `UIView` subtree in one main-thread pass, as a point-in-time list. Needs `native.objc.snapshot`. */
 	snapshot(
 		root: NativeObjectHandle,
 		options?: NativeViewSnapshotOptions,
 	): NativeCancelablePromise<NativeViewSnapshotNode[]>;
+	/** Finds the views of a class under or above a view on the main thread. Needs `native.objc.snapshot`. */
 	findViews(
 		root: NativeObjectHandle,
 		className: string,
 		options?: NativeViewSearchOptions,
 	): NativeCancelablePromise<NativeObjectHandle[]>;
+	/** Like `callSuper` with a thread policy; it cannot cross to the main thread synchronously. */
 	invokeSuper(
 		handle: NativeObjectHandle,
 		currentClass: NativeClassHandle | string,
 		selector: string,
 		args: unknown[],
 		options?: NativeCallOptions,
-	): unknown;
+	): NativeObjCResult;
+	/** Runs the superclass implementation on the main thread and resolves with its result. */
 	invokeSuperAsync(
 		handle: NativeObjectHandle,
 		currentClass: NativeClassHandle | string,
 		selector: string,
 		args: unknown[],
-	): NativeCancelablePromise<unknown>;
-	getIvar(handle: NativeObjectHandle, name: string): unknown;
-	setIvar(handle: NativeObjectHandle, name: string, value: unknown): void;
+	): NativeCancelablePromise<NativeObjCResult>;
+	/** Reads an instance variable by name, such as `_viewModel`. */
+	getIvar(handle: NativeObjectHandle, name: string): NativeObjCResult;
+	/** Writes an instance variable by name. */
+	setIvar(handle: NativeObjectHandle, name: string, value: NativeObjCResult): void;
+	/** Creates a key for attaching a value to objects with `setAssociatedObject`. */
 	createAssociationKey(): NativeAssociationKey;
-	getAssociatedObject(handle: NativeObjectHandle, key: NativeAssociationKey): unknown;
+	/** Reads the value attached to an object under a key. */
+	getAssociatedObject(handle: NativeObjectHandle, key: NativeAssociationKey): NativeObjCResult;
+	/** Attaches a value to an object; `null` clears it. `policy` is `assign`, `retain`, `copy`, `retainNonatomic` or `copyNonatomic`. */
 	setAssociatedObject(
 		handle: NativeObjectHandle,
 		key: NativeAssociationKey,
-		value: unknown,
+		value: NativeObjCResult,
 		policy?: string,
 	): void;
+	/** Builds a registered struct, such as `CGRect` or `UIEdgeInsets`, to pass to native calls. */
 	struct<T extends NativeStructFields = NativeStructFields>(
 		name: string,
 		fields: T,
 	): NativeStruct<T>;
-	array(handle: NativeObjectHandle): unknown[];
+	/** Converts an `NSArray` handle to a JavaScript array. */
+	array(handle: NativeObjectHandle): NativeObjCResult[];
+	/** Copies bytes into a new `NSData` object. */
 	data(value: ArrayBuffer | Uint8Array): NativeObjectHandle;
-	hook(
+	/** Hooks a method by class and selector; handlers run in registration order, and the scope removes the hook on dispose. */
+	hook<Receiver extends boolean = true>(
 		className: string,
 		selector: string,
-		handlers: NativeHookHandlers,
-		options?: NativeHookOptions,
+		handlers: NativeHookHandlers<Receiver>,
+		options?: NativeHookOptions<Receiver>,
 	): NativeHookToken;
 };
+/** A selector and method signature resolved once by `objc.prepare`, for calling many times without the lookup. */
+export type NativeObjCCallPlan = NativeHandle & {
+	readonly [nativeObjCCallPlan]: true;
+};
+/** What an Objective-C call returns: a plain value, a handle to an object, a 64-bit integer, or nothing for `void`. */
+export type NativeObjCResult = NativeSerializable | NativeHandle | bigint | undefined;
+/** A retained handle to an Objective-C object. */
 export type NativeObjectHandle = NativeHandle;
+/** Loader helpers for verifying and loading installed addons. */
 export type NativePlatformAddons = {
 	/** Checks a manifest's `signature` against its bundle. */
 	verify(manifest: string, bundle: string): NativeAddonVerification;
 	/** Evaluates an installed plugin's bundle compiled for this bytecode version, if its digest matches the manifest. */
-	evaluateBytecode?(folder: string, bytecodeVersion: number): NativeCompiledPlugin | undefined;
-};
+	evaluateBytecode(folder: string, bytecodeVersion: number): NativeCompiledPlugin | undefined;
+	/** Reads an installed plugin's source, for one the loader handed over without it, if its signature still holds. */
+	readSource(folder: string): string | undefined;
+};
+/** Android-only helpers; missing on iOS. */
+export type NativePlatformAndroidBridge = {
+	/** Installs patched Discord builds over this one. */
+	readonly installer: NativePlatformAndroidInstaller;
+};
+/** Installs another patched Discord build over this one, upgrade or downgrade, downloading only the splits that differ. */
+export type NativePlatformAndroidInstaller = {
+	/** Reads whether in-app installs work and which Discord is installed. */
+	status(): NativeAndroidInstallerStatus;
+	/** Opens the system's "Install unknown apps" screen for Discord. */
+	requestPermission(): boolean;
+	/** SHA-256 of each installed split APK, `null` where it cannot be read. */
+	installedSplits(): Promise<Record<string, string | null>>;
+	/** Starts installing a build in the background; false when an install is already running. Poll `progress`. */
+	install(splits: readonly NativeAndroidInstallSplit[]): boolean;
+	/** Reads how far the running install is. */
+	progress(): NativeAndroidInstallProgress;
+	/** Stops a running download or abandons the install session. */
+	cancel(): boolean;
+};
+/** Facts about the Discord install the loader runs in. */
 export type NativePlatformApp = {
+	/** Where Discord was installed from, such as `App Store` or `Google Play`. */
 	getAppSource(): string;
-	/** True for the first caller in this process; a reloaded runtime sees false. Missing on older loaders. */
-	claimLaunchURL?(): boolean;
+	/** 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. */
+	isVerifiedBuild(): boolean;
+	/** True for the first caller in this process; a reloaded runtime sees false. */
+	claimLaunchURL(): boolean;
 };
+/** Platform-wide helpers the loader publishes as `globalThis.NativePlatform`, not scoped to a plugin. */
 export type NativePlatformBridge = {
+	/** The host platform. */
 	readonly platform: NativePluginPlatform;
+	/** 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. */
 	readonly device: NativePlatformDevice;
+	/** Facts about the Discord install. */
 	readonly app: NativePlatformApp;
+	/** File removal in the Unbound folder; missing when the loader has no documents directory. */
 	readonly files?: NativePlatformFiles;
+	/** Crash and freeze attribution for addons; missing when the loader has no documents directory. */
 	readonly crashGuard?: NativePlatformCrashGuard;
+	/** The native settings file; missing when the loader does not manage settings. */
 	readonly settings?: NativePlatformSettings;
+	/** The font list; missing when the loader cannot list fonts. */
 	readonly fonts?: NativePlatformFonts;
-	readonly addons?: NativePlatformAddons;
+	/** Addon verification and bytecode loading. */
+	readonly addons: NativePlatformAddons;
+	/** Hermes' sampling profiler. */
+	readonly profiler: NativePlatformProfiler;
+	/** iOS-only helpers; missing on Android. */
 	readonly ios?: NativePlatformIOSBridge;
+	/** Android-only helpers; missing on iOS and on loaders without the in-app installer. */
+	readonly android?: NativePlatformAndroidBridge;
 };
+/** The loader's record of which addon was starting or running when Discord crashed, kept across launches. */
 export type NativePlatformCrashGuard = {
+	/** Marks an addon as starting, by crash guard key and display name, so a crash during its start is blamed on it. */
 	begin(id: string, name: string): boolean;
+	/** Clears the start marker once the addon's start has returned. */
 	end(id: string): boolean;
+	/** Lists the addons the loader disabled after crashes on consecutive launches. */
 	disabled(): NativeCrashedAddon[];
-	register?(id: string, name: string): number;
-	activity?(): ArrayBuffer | undefined;
+	/** Registers an addon for crash attribution and returns its slot, or 0 when the loader cannot attribute crashes. */
+	register(id: string, name: string): number;
+	/** Returns a 4-byte buffer shared with the loader that holds the running addon's slot, or `undefined` when unavailable. */
+	activity(): ArrayBuffer | undefined;
 };
+/** Facts about the device Discord runs on. */
 export type NativePlatformDevice = {
+	/** The host platform. */
 	readonly platform: NativePluginPlatform;
+	/** The device's model name. */
 	getDeviceModel(): string;
+	/** The operating system's version. */
 	getOSVersionString(): string;
+	/** Whether the device is jailbroken on iOS or has an `su` binary on Android. */
 	isRooted(): boolean;
+	/** The active iOS jailbreak's name, such as `Dopamine 2.4`, or an empty string on Android and when none is found; older loaders lack it. */
+	getJailbreak?(): string;
+	/** Whether Discord is installed as a system app. */
 	isSystemApp(): boolean;
+	/** Whether Discord runs in a simulator, emulator or virtual machine. */
 	isVirtualDevice(): boolean;
 };
+/** File operations inside the Unbound folder in Discord's documents directory. */
 export type NativePlatformFiles = {
+	/** Removes a file or folder tree, by path relative to the Unbound folder; returns whether anything was removed. */
 	remove(path: string): boolean;
+	/** Reads a text file, by path relative to the Unbound folder; `undefined` when it is missing. Older loaders lack it. */
+	read?(path: string): string | undefined;
+	/** Replaces a text file atomically, by path relative to the Unbound folder; returns whether it was written. Older loaders lack it. */
+	write?(path: string, text: string): boolean;
 };
+/** The fonts the loader can apply. */
 export type NativePlatformFonts = {
+	/** Lists font addons first, then app and system fonts, without duplicate names. */
 	list(): NativeFontEntry[];
 };
+/** iOS-only facts about Discord's code signature. */
 export type NativePlatformIOSBridge = {
-	isVerifiedBuild(): boolean;
+	/** Discord's code-signing entitlements, as an object. */
 	getEntitlements(): NativeSerializableObject;
+	/** Discord's code-signing entitlements, as plist text. */
 	getEntitlementsAsPlist(): string;
 };
+/** Hermes' sampling profiler, shared with the loader's freeze watchdog. */
+export type NativePlatformProfiler = {
+	/** Starts sampling; `false` when the profiler is missing or already running. */
+	start(): boolean;
+	/** Stops sampling and returns the Chrome trace it recorded, or `undefined` when it was not running. */
+	stop(): string | undefined;
+};
+/** The loader's native settings file, which holds every Bucket. */
 export type NativePlatformSettings = {
+	/** Applies changes and writes the file at once; false when the changes are malformed or the write failed. */
 	apply(changes: readonly NativeSettingsChange[]): boolean;
-};
+	/** Applies changes in memory, to be written by `flush`. */
+	stage(changes: readonly NativeSettingsChange[]): boolean;
+	/** Writes staged changes to the file, if any. */
+	flush(): boolean;
+	/** 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';
-export type NativePluginPlatform = 'ios' | 'android';
+/** 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'
+	'apiVersion' | 'abiVersion' | 'capabilities' | 'ffi' | 'fabric' | 'debug'
 > &
-	Partial<Omit<NativePluginBridge, 'apiVersion' | 'abiVersion' | 'capabilities'>>;
+	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. */
 export type NativeResourceCounts = {
+	/** Installed hooks. */
 	hooks: number;
+	/** Mounted Fabric surfaces. */
 	surfaces: number;
+	/** Hook return values set with `setReturnValue`. */
 	cachedReturns: number;
+	/** Handles still referenced from JavaScript: leases plus the platform's own handle count. */
 	handles: number;
-};
+	/** Handle leases JavaScript still holds. */
+	leases: number;
+	/** Live Objective-C value handles; iOS only, 0 elsewhere. */
+	objcHandles: number;
+	/** Prepared Objective-C call plans; iOS only, 0 elsewhere. */
+	objcPlans: number;
+	/** Objective-C objects the loader retains internally; iOS only, 0 elsewhere. */
+	objcRetains: number;
+	/** Java objects with a live handle; Android only, 0 elsewhere. */
+	javaHandles: number;
+	/** Pooled Fabric surfaces waiting to be reused. */
+	idleSurfaces: number;
+	/** Fabric surfaces created since launch. */
+	createdSurfaces: number;
+	/** Fabric surfaces reused from the pool since launch. */
+	reusedSurfaces: number;
+	/** Batches of main-thread work the loader drained. */
+	mainWork: NativeMainWorkCounts;
+	/** Main-thread crossings per addon, kind and call label, busiest first. */
+	mainWaits: NativeMainWaitCounts[];
+};
+/** Delivers Discord activity to plugins. Needs `native.runtime.events`. */
 export type NativeRuntimeBridge = {
+	/** Calls `listener` with a serializable payload each time the event happens. */
 	subscribe(
 		event: NativeRuntimeEventName,
 		listener: (payload: NativeSerializableObject) => void,
 	): NativeRuntimeEventToken;
 };
+/** A Discord activity a plugin can subscribe to; the client derives each from Flux actions, such as `MESSAGE_CREATE`. */
 export type NativeRuntimeEventName =
 	| 'message.created'
 	| 'message.updated'
@@ -2410,8 +4710,11 @@ export type NativeRuntimeEventName =
 	| 'channel.changed'
 	| 'composer.changed'
 	| 'ui.changed';
+/** A runtime event subscription; the plugin scope removes it on dispose. */
 export type NativeRuntimeEventToken = {
+	/** False once the subscription is removed. */
 	readonly active: boolean;
+	/** Stops the listener receiving events. */
 	remove(): void;
 };
 /** A value the bridge serializes by structure, such as Fabric surface props or a plist. */
@@ -2422,9 +4725,11 @@ export type NativeSerializable =
 	| null
 	| NativeSerializable[]
 	| NativeSerializableObject;
+/** A plain object of serializable values, such as a runtime event payload. */
 export type NativeSerializableObject = {
 	[key: string]: NativeSerializable;
 };
+/** One change to a Bucket: set a key, remove a key, or clear the whole Bucket. Keys are dot paths. */
 export type NativeSettingsChange =
 	| {
 			store: string;
@@ -2440,35 +4745,95 @@ export type NativeSettingsChange =
 			store: string;
 			clear: true;
 	  };
+/** A registered C struct, such as `CGRect`, built by `objc.struct` or returned from a native call. */
 export type NativeStruct<T extends NativeStructFields = NativeStructFields> = {
 	readonly name: string;
 	readonly value?: T;
 } & NativeHandle;
 /** A C struct field: a scalar, a pointer or object, or a nested struct. */
 export type NativeStructField = number | boolean | NativeHandle | NativeStructFields;
+/** A struct's field values by field name. */
 export type NativeStructFields = {
 	[field: string]: NativeStructField;
 };
-export type NativeThreadPolicy = 'current' | 'main';
+/**
+ * Where a native call runs: `current` is the calling thread; `main` blocks until the main thread runs it;
+ * `main-post` queues a `void` method on main and logs its failure, and blocks like `main` otherwise.
+ */
+export type NativeThreadPolicy = 'current' | 'main' | 'main-post';
+/** A value a worklet can take from the JS runtime: a serializable value, a UI scope, which is shared as is, or a callback into the JS thread. */
+export type NativeUIArgument = NativeSerializable | NativeUIScope | NativeUICallback;
+/** Runs plugin worklets on the UI runtime, where native views live, so hooks there act before the next frame. */
+export type NativeUIBridge = {
+	/** Opens a scope with every synchronous method the plugin's capabilities allow; capture it in a worklet. */
+	createScope(): NativeUIScope;
+	/** Runs a worklet on the UI runtime and resolves with what it returns, which must be serializable. */
+	call<A extends NativeUIArgument[], R extends NativeSerializable | void>(
+		worklet: (...args: A) => R,
+		...args: A
+	): NativeCancelablePromise<R>;
+	/** Queues a worklet on the UI runtime. */
+	run<A extends NativeUIArgument[]>(worklet: (...args: A) => void, ...args: A): void;
+	/** Wraps a JS-thread listener so a worklet can call it, for example to wake JS only for the hook events that need it; it stops calling the listener once the plugin stops. */
+	callback<A extends NativeSerializable[]>(listener: (...args: A) => void): NativeUICallback<A>;
+};
+/** A function a worklet calls on the UI runtime to hand serializable values to a listener on the JS thread, made with `callback`. */
+export type NativeUICallback<A extends NativeSerializable[] = NativeSerializable[]> = {
+	call(...args: A): void;
+}['call'];
+/** The bridge methods a plugin may call from the UI runtime, synchronously and on the main thread. */
+export type NativeUIScope = {
+	/** The Objective-C methods the scope allows; present on iOS. */
+	readonly objc?: NativeObjCBridge;
+	/** The Java methods the scope allows; present on Android. */
+	readonly java?: NativeJavaBridge;
+	/** The Java hook methods the scope allows; present on Android. Listeners run inline for calls on the main thread. */
+	readonly hooks?: NativeJavaHooksBridge;
+	/** Removes every hook the scope installed. */
+	dispose(): void;
+};
+/** The loader's way to open UI-runtime scopes, offered on its raw `objc` namespace on iOS and `java` on Android. */
+export type NativeUIScopeFactory = {
+	/** Opens a UI-runtime scope allowed only the listed method paths, such as `objc.invoke`. */
+	createUIScope(paths: readonly string[]): NativeUIScope;
+};
+/** Limits and direction for a breadth-first `findViews` search; larger limits are clamped. */
 export type NativeViewSearchOptions = {
+	/** How many levels to walk from the root. Defaults to 24, at most 128. */
 	maxDepth?: number;
+	/** How many views to visit. Defaults to 512, at most 8,192. */
 	maxVisited?: number;
+	/** How many matches to return. Defaults to 64, at most 256. */
 	maxResults?: number;
+	/** Matches only views attached to a window. */
 	attachedOnly?: boolean;
+	/** Skips the views beneath a match. */
 	stopAtMatch?: boolean;
+	/** `ancestors` walks up the superview chain instead of down. Defaults to `descendants`. */
 	direction?: 'ancestors' | 'descendants';
 };
+/** One view in an `objc.snapshot` result, which lists views in breadth-first order. */
 export type NativeViewSnapshotNode = {
+	/** A retained handle to the view; discard it after cell reuse or a channel change. */
 	view: NativeObjectHandle;
+	/** The index of the parent node in the result, or -1 for the root. */
 	parent: number;
+	/** Levels below the root, which is 0. */
 	depth: number;
+	/** The view's Objective-C class name. */
 	className: string;
+	/** The view's `frame` in its superview's coordinates, in points. */
 	frame: NativeFabricFrame;
+	/** The view's `text` when it has a string one, such as a `UILabel`'s, else `null`. */
 	text: string | null;
+	/** Whether the view is not hidden, has a non-zero alpha and is in a window. */
 	visible: boolean;
 };
+/** Limits for `objc.snapshot`; larger values are clamped and non-integers rejected. */
 export type NativeViewSnapshotOptions = {
+	/** How many levels below the root to read. Defaults to 8, at most 12. */
 	maxDepth?: number;
+	/** How many views to return. Defaults to 100, at most 256. */
 	maxNodes?: number;
 };
 export type NavScrimComponent = React$1.ComponentType<NavScrimProps>;
@@ -2477,12 +4842,19 @@ export type NavScrimComponent = React$1.ComponentType<NavScrimProps>;
  * @see design/components/Navigator/native/NavScrim.ios.tsx
  */
 export type NavScrimProps = {};
+/** A screen's handle on Discord's React Navigation stack, as `useNavigation` returns it. */
 export type Navigation<T = any> = {
+	/** Pushes a new screen for `route` with `params` onto the stack. */
 	push: (route: string, params?: T) => void;
+	/** Removes the top screen from the stack. */
 	pop: () => void;
+	/** Goes to `route`, reusing a screen already on the stack for it. */
 	navigate: (route: string, params?: T) => void;
+	/** Returns to the previous screen. */
 	goBack: () => void;
+	/** Updates the current screen's header options. */
 	setOptions: (options: NavigationOptions) => void;
+	/** Subscribes to a navigation event, such as `focus`; returns a function that unsubscribes. */
 	addListener: (event: string, callback: DiscordFunction) => DiscordFunction<void>;
 };
 /**
@@ -2510,7 +4882,9 @@ export type NavigationContainerInnerProps = Omit<
 };
 /** The screen options accepted by {@link Navigation.setOptions}. */
 export type NavigationOptions = {
+	/** The header title. */
 	title?: string;
+	/** Renders the element shown at the header's right edge. */
 	headerRight?: DiscordFunction<React$1.ReactNode>;
 };
 /**
@@ -2597,6 +4971,16 @@ export type NewInlineNoticeProps = {
 	title?: DesignTextProps['children'];
 	type?: 'info' | 'warning' | (string & {});
 };
+/**
+ * Design components newer than the Discord build the generated types describe, typed by hand from Discord 352's
+ * sources. Regenerating the types from 352 or later makes these generated; then drop them here.
+ */
+export type NewerDesignComponents = {
+	/** Discord's search field: a `TextField` with a search icon, clear button and search return key. */
+	SearchBar: DesignBarrelComponents['TextField'];
+	/** Discord's status label, such as New or Beta, or custom text. */
+	Badge: React$1.ComponentType<BadgeProps>;
+};
 export type NitroGem12LottieComponent = React$1.ComponentType<
 	NitroGem12LottieProps & Record<string, unknown>
 >;
@@ -2687,6 +5071,13 @@ export type NitroGem9LottieComponent = React$1.ComponentType<
 export type NitroGem9LottieProps = Omit<LottieIconProps, 'ref'> & {
 	ref?: LottieIconProps['ref'];
 };
+/** A notice row: it stores nothing, and shows `title` and `subtitle` as a message of its `tone`. */
+export type NoticeSchema = SettingCommon & {
+	kind: 'notice';
+	displayAs: 'notice';
+	/** How the message reads: `info` plain, `warning` cautious, `danger` for something that cannot be undone. */
+	tone: 'info' | 'warning' | 'danger';
+};
 export type NotificationsTabLottieComponent = React$1.ComponentType<
 	NotificationsTabLottieProps & Record<string, unknown>
 >;
@@ -2748,17 +5139,27 @@ export type PlainTextExperimentProviderProps = {
 	children?: React$1.ReactNode;
 	enabled?: boolean;
 };
+/** What the addon manager passes to a plugin's `start`. */
 export type PluginContext = {
+	/** The plugin's manifest. */
 	readonly manifest: AddonManifest;
+	/** The plugin's id, from its manifest. */
 	readonly id: string;
+	/** The host platform, or `undefined` when the loader reports none. */
 	readonly platform?: NativePluginPlatform;
+	/** The capabilities the manifest declares for this platform; `native` allows only these. */
 	readonly capabilities: readonly NativePluginCapability[];
+	/** The native bridge, scoped to the plugin's capabilities. */
 	readonly native: NativePluginBridge;
+	/** Releases the plugin's hooks, surfaces, handles and subscriptions; the addon manager calls it on stop, unload, reload or a failed start. */
 	dispose(): void;
 };
-/** An {@link Addon} whose instance is a {@link Plugin}. */
-export type PluginEntity = Addon & {
-	instance: Plugin$1 | null;
+/** 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;
 };
 /**
  * Props of `PostponeRender` (function). Exports: PostponeRender.
@@ -2812,6 +5213,8 @@ export type PressableOpacityProps = Omit<PressableBaseProps, 'activeOpacity' | '
 	activeOpacity?: PressableBaseProps['activeOpacity'];
 	ref?: PressableBaseProps['innerRef'];
 };
+/** A value that is not an object or a function. */
+export type Primitive = string | number | boolean | bigint | null | undefined;
 export type PromoSheetComponent = React$1.ComponentType<PromoSheetProps & Record<string, unknown>>;
 /**
  * Props of `PromoSheet` (function). Exports: PromoSheet.
@@ -2828,6 +5231,20 @@ export type PromoSheetProps = Omit<
 	illustration?: React$1.ComponentProps<typeof RN.View>['children'];
 	title?: DesignTextProps['children'];
 };
+/**
+ * A manifest pushed by `ubd dev`. The CLI only checks the fields it reads; the device validates the
+ * whole manifest the same way it validates one it loads, so a dev build is never held to the publish rules.
+ */
+export type PushedManifest = {
+	/** The addon's id, as in {@link AuthoredAddonManifest.id}. */
+	id: string;
+	/** The bundle's path relative to the manifest, as in {@link AuthoredAddonManifest.main}. */
+	main: string;
+	/** The SHA-512 of each bytecode build the push carries, by bytecode version; the CLI fills it in. */
+	bytecode?: Record<string, string>;
+	/** The images the build emitted beside the bundle, as in {@link AuthoredAddonManifest.assets}. */
+	assets?: Record<string, AddonAsset>;
+};
 /**
  * Props of `RedesignBottomSheetTitleHeaderBase` (function). Exports: none.
  * @see design/components/Sheet/native/BottomSheetTitleHeader.native.tsx
@@ -2916,8 +5333,11 @@ export type SearchFieldProps = Omit<TextFieldProps, 'ref'> & {
 export type SegmentedControlComponent = React$1.ComponentType<SegmentedControlProps>;
 /** A tab of a segmented control, with the page it shows. */
 export type SegmentedControlItem = {
+	/** A key unique among the control's tabs. */
 	id: string;
+	/** The text shown on the tab. */
 	label: string;
+	/** What `SegmentedControlPages` renders while this tab is selected. */
 	page?: React$1.ReactNode;
 };
 /**
@@ -2979,16 +5399,25 @@ export type SegmentedControlProps = {
 };
 /** The state controller `useSegmentedControlState` returns, which drives a `SegmentedControl`. */
 export type SegmentedControlState = {
+	/** The index of the selected tab in `items`. */
 	activeIndex: number;
+	/** The tabs, in display order. */
 	items: SegmentedControlItem[];
+	/** Selects the tab at `index`. */
 	setActiveIndex: (index: number) => void;
 };
 /** The options `useSegmentedControlState` builds a {@link SegmentedControlState} from. */
 export type SegmentedControlStateOptions = {
+	/** The tabs, in display order. */
 	items: SegmentedControlItem[];
+	/** The width of one page in points; Unbound passes the window width. */
 	pageWidth: number;
+	/** The index of the tab selected first. */
 	defaultIndex?: number;
+	/** Called with the new index when the selected page changes. */
 	onPageChange?: (index: number) => void;
+	/** Called with the index of the tab the user selects. */
+	onSetActiveIndex?: (index: number) => void;
 };
 /** A semantic colour token from `Theme.colors`, which `useToken` resolves to a colour string. */
 export type SemanticColorToken = Readonly<Record<string, string | number | boolean>>;
@@ -3002,24 +5431,120 @@ export type ServerTabLottieComponent = React$1.ComponentType<
 export type ServerTabLottieProps = Omit<LottieIconProps, 'ref'> & {
 	ref?: LottieIconProps['ref'];
 };
+/** One option of a `choice` setting. */
+export type SettingChoice = {
+	/** The value stored when the option is picked. */
+	const: string;
+	/** The message key of the option's label. */
+	title: string;
+	/** The message key of the text under the option; only a radio group shows it. */
+	subtitle?: string;
+};
+/** What every setting and section carries. Labels are message keys of the plugin's `i18n/en-US.json`. */
+export type SettingCommon = {
+	/** The message key of the row's label or the section's title; only a hidden setting may omit it. */
+	title?: string;
+	/** The message key of the row's sub-label. */
+	subtitle?: string;
+	/** Stored and typed, but not drawn in the generated panel. */
+	hidden?: boolean;
+	/** Draws the row only while this holds. */
+	visibleWhen?: SettingCondition;
+	/** Draws the row disabled while this holds. */
+	disabledWhen?: SettingCondition;
+	/** Changing the setting shows a hint to restart Discord. */
+	requiresRestart?: boolean;
+};
+/**
+ * When a row shows or is enabled: a boolean setting's dot-separated key, or a predicate the build lifted
+ * out of settings.ts into the plugin bundle, where the panel finds it by the setting's key.
+ */
+export type SettingCondition =
+	| string
+	| {
+			predicate: true;
+	  };
+/** A value one schema-declared setting holds. */
+export type SettingPrimitive = string | number | boolean;
+/** One schema-declared setting, by the primitive it stores. */
+export type SettingSchema = SettingCommon &
+	(
+		| {
+				kind: 'boolean';
+				displayAs: 'switch' | 'checkbox';
+				default: boolean;
+		  }
+		| {
+				kind: 'number' | 'integer';
+				displayAs: 'input' | 'slider' | 'stepper' | 'duration';
+				/** A `duration` is in milliseconds. */
+				default: number;
+				minimum?: number;
+				maximum?: number;
+				/** The slider's or stepper's step; values must be a multiple of it. */
+				multipleOf?: number;
+				/** `duration`: the units offered. */
+				units?: DurationUnit[];
+		  }
+		| StringSettingSchema
+		| ChoiceSettingSchema
+		| {
+				kind: 'array';
+				displayAs: 'list' | 'checkboxes' | EntityDisplay;
+				default: string[];
+				/** What each item is: a string, or one of a choice's options. */
+				of: Omit<StringSettingSchema, 'default'> | Omit<ChoiceSettingSchema, 'default'>;
+				minItems?: number;
+				maxItems?: number;
+		  }
+	);
+/** A value any schema-declared setting holds. */
+export type SettingValue = SettingPrimitive | string[];
 /** A registered Unbound settings entry, mirroring Discord's `SETTING_RENDERER_CONFIG` route shape. */
 export type SettingsEntry = {
+	/** Always `'route'`: the entry opens its own screen. */
 	type: 'route';
+	/** Unique id of the entry. Registering an existing key replaces that entry and logs a warning. */
 	key: string;
+	/** A hook returning the row and screen title. */
 	useTitle: () => string;
+	/** A hook returning whether Discord shows the row; omitted, it always shows. */
 	usePredicate?: () => boolean;
+	/** The key of the parent entry; `null` for an entry at the top of the settings overview. */
 	parent: string | null;
+	/** The label of the overview section the row belongs to; Unbound's own entries use `'Unbound'`. */
 	section?: string;
+	/** Keeps the route registered but leaves its row out of the settings overview. */
 	excludeFromDisplay?: boolean;
+	/** The icon drawn at the start of the row. */
 	IconComponent?: React$1.ComponentType;
+	/** A hook returning what the row shows at its end, such as a count. */
+	useTrailing?: () => React$1.ReactNode;
+	/** The screen the row opens. */
 	screen: SettingsScreen;
 };
+/** A nested object: its settings, drawn as their own section titled by `title`. */
+export type SettingsGroupSchema = SettingCommon & {
+	kind: 'section';
+	displayAs: 'group' | 'collapsible';
+	properties: Record<string, SettingSchema | StorelessSchema>;
+};
 /** A settings store, or a nested group of settings within one. */
 export type SettingsObject = {
 	[key: string]: SettingsValue;
 };
+/** A plugin's settings schema, the JSON its settings.ts `defineSettings(...)` evaluates to at build time. */
+export type SettingsSchema = {
+	/** Marks the schema's root. */
+	kind: 'settings';
+	/** The message key of the title of the section holding the top-level settings. */
+	title?: string;
+	/** The settings, buttons, notices and sections by key, in the order they are drawn. */
+	properties: Record<string, SettingSchema | StorelessSchema | SettingsGroupSchema>;
+};
 /** The screen descriptor a settings route entry renders. */
 export type SettingsScreen = {
+	/** The navigator route name; Unbound sets it to the entry's `key`. */
 	route: string;
 	/** Discord's navigator renders the screen with its own route props, so any component fits. */
 	getComponent: () => React$1.ComponentType<never>;
@@ -3127,6 +5652,22 @@ export type SimpleActionSheetProps = {
 		map?: unknown;
 	};
 };
+/** The `simple-markdown` library Discord bundles, found by `parserFor`, `outputFor` and `defaultRules`. */
+export type SimpleMarkdownModule = {
+	/** CommonMark-like rules for a whole document, unlike Discord's message rules. */
+	defaultRules: MarkdownRules;
+	/** Builds a parser from a rule set, such as `defaultRules` plus your own; `TNode` names the nodes they parse. */
+	parserFor<TNode extends MarkdownNode = MarkdownNode>(
+		rules: MarkdownRules,
+	): SimpleMarkdownParser<TNode>;
+	/** Wraps a regex into a `match` that only matches inside inline content. */
+	inlineRegex(regex: RegExp): MarkdownRule['match'];
+};
+/** Parses Markdown into nodes; `inline: false` parses blocks such as headings, lists, code and tables. */
+export type SimpleMarkdownParser<TNode extends MarkdownNode = MarkdownNode> = (
+	source: string,
+	state?: MarkdownState,
+) => TNode[];
 export type SliderComponent = React$1.ComponentType<SliderProps & Record<string, unknown>>;
 /**
  * Props of `Slider` (function). Exports: Slider.
@@ -3252,6 +5793,42 @@ export type StickyWrapperProps = {
 	pointerEvents?: React$1.ComponentProps<typeof RN.View>['pointerEvents'];
 	style?: React$1.ComponentProps<typeof RN.View>['style'];
 };
+/** A row that stores nothing: a button or a notice. */
+export type StorelessSchema = ButtonSchema | NoticeSchema;
+/** How a `string` setting displays; each validates the text its own way. */
+export type StringDisplay =
+	| 'input'
+	| 'multiline'
+	| 'secret'
+	| 'url'
+	| 'color'
+	| 'image'
+	| 'font'
+	| 'emoji'
+	| EntityDisplay;
+/** A string setting: the primitive `array` items can be too. */
+export type StringSettingSchema = {
+	/** Marks a text setting. */
+	kind: 'string';
+	/** The row that edits the text, and the validation it applies. */
+	displayAs: StringDisplay;
+	/** The value before the user changes it. */
+	default: string;
+	/** The fewest characters the text may have. */
+	minLength?: number;
+	/** The most characters the text may have. */
+	maxLength?: number;
+	/** The message key of the text shown while the input is empty. */
+	placeholder?: string;
+	/** `color`: also takes an alpha channel, `#RRGGBBAA`. */
+	alpha?: boolean;
+	/** `color`: colors offered first. */
+	presets?: string[];
+	/** `color`: draws `presets` inline instead of a swatch row. */
+	palette?: boolean;
+	/** `image`: the largest file accepted, in bytes. */
+	maxSize?: number;
+};
 /** A stylesheet spec: each key maps to a view, text, or image style. */
 export type StyleSheetSpec = Record<string, ViewStyle | TextStyle | ImageStyle>;
 /** A stylesheet spec, or a function producing one (Discord accepts both forms). */
@@ -3683,9 +6260,13 @@ export type TextVariant = LiteralUnion<
 export type TextWeight = 'normal' | 'medium' | 'semibold' | 'bold';
 /** A theme's semantic and raw colour definitions plus optional background. */
 export type Theme = {
+	/** Overrides for Discord's semantic colours, keyed by name such as `BACKGROUND_BASE_LOWER`; malformed entries are dropped. */
 	semantic: Record<PropertyKey, ThemeSemanticColor>;
+	/** Overrides for Discord's raw palette colours, keyed by raw colour name. */
 	raw: Record<PropertyKey, string>;
-	type: 'midnight' | 'darker' | 'light';
+	/** The Discord base theme the bundle builds on: `light`, `dark` (Ash), `darker` (Dark) or `midnight` (Onyx); parsed as `darker` when absent or unknown. */
+	type: 'light' | 'dark' | 'darker' | 'midnight';
+	/** The chat background the theme recommends: an image `url`, a `blur` radius and an `opacity` from 0 to 1; dropped when `url` is not a string. */
 	background?: {
 		blur?: number;
 		opacity?: number;
@@ -3721,11 +6302,6 @@ export type ThemeContextProviderRootThemeContextProviderProps = {
 	secondaryColor?: unknown;
 	theme?: unknown;
 };
-/** An {@link Addon} whose instance is a {@link Theme}, tracking its registration state. */
-export type ThemeEntity = Addon & {
-	registered: boolean;
-	instance: Theme | null;
-};
 /**
  * Props of `ThemeProvider` (function). Exports: ThemeProvider.
  * @see module 4804 (no source path)
@@ -3736,8 +6312,11 @@ export type ThemeProviderProps = {
 };
 /** A single semantic colour definition in a {@link Theme}. */
 export type ThemeSemanticColor = {
+	/** `color` uses `value` as is; `raw` names a raw colour, looked up in the theme's `raw` and then Discord's. */
 	type: 'color' | 'raw';
+	/** A colour string, or the name of a raw colour when `type` is `raw`. */
 	value: string;
+	/** An alpha from 0 to 1, clamped, that replaces a `#rrggbb` or `#rrggbbaa` colour's alpha; other formats ignore it. */
 	opacity?: number;
 };
 /**
@@ -3747,11 +6326,17 @@ export type ThemeSemanticColor = {
 export type TitleProps = DesignTextProps;
 /** A button rendered inside a toast. */
 export type ToastButton = {
+	/** The Discord button style. Defaults to `'primary'`. */
 	variant?: 'primary' | 'secondary' | 'tertiary';
+	/** The Discord button size. Defaults to `'sm'`. */
 	size?: 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+	/** Which side of the label the icon sits on. Defaults to `'start'`. */
 	iconPosition?: 'start' | 'end';
+	/** The button's label. */
 	content: string;
-	icon?: number;
+	/** An asset id, an element such as `<Star />`, or an icon component such as `Star`, drawn beside the label. */
+	icon?: IconInput;
+	/** Runs when the button is tapped. The toast stays open; call `close` on its handle to dismiss it. */
 	onPress: () => void;
 };
 export type ToastComponent = React$1.ComponentType<ToastProps>;
@@ -3797,18 +6382,28 @@ export type ToastEntityProps = {
 };
 /** A handle returned when showing a toast, used to update or close it. */
 export type ToastHandle = {
+	/** Merges `options` into the shown toast. Does nothing once the toast is gone. */
 	update: (options: Partial<ToastOptions>) => void;
+	/** Plays the toast's exit animation, then removes it. */
 	close: () => void;
 };
 /** Options accepted when showing a toast. */
 export type ToastOptions = {
+	/** The bold first line, or a component rendered in its place. */
 	title?: string | React$1.ComponentType;
+	/** The body text under the title. */
 	content?: string;
+	/** Milliseconds before the toast closes itself; `0` keeps it until dismissed. Omitted, the user's toast duration setting. */
 	duration?: number;
+	/** Declared for callers, but the client does not call it yet. */
 	onTimeout?: () => void;
-	icon?: string | number | ImageSourcePropType;
+	/** An asset name, asset id, image source, element such as `<Star />`, or icon component such as `Star`; a name with no matching asset draws no image. */
+	icon?: string | IconInput | ImageSourcePropType;
+	/** Identifies the toast; showing another toast with the same id replaces it. Omitted, a random id. */
 	id?: string;
+	/** Buttons in a row under the content. */
 	buttons?: ToastButton[];
+	/** Tints an image icon with the theme's icon colour. Defaults to `true`; set `false` for a coloured image. An element or component draws its own colour. */
 	tintedIcon?: boolean;
 };
 /**
@@ -3825,8 +6420,11 @@ export type ToastProps = {
 };
 /** State and actions of the toast store. */
 export type ToastStoreState = {
+	/** Every toast on screen, keyed by toast id, including ones playing their exit animation. */
 	toasts: Record<string, InternalToastOptions>;
+	/** Shows a toast, replacing any with the same id, and stamps `date` when unset. */
 	addToast: (options: InternalToastOptions) => ToastHandle;
+	/** Merges `options` into the toast `id`. Does nothing when no such toast is on screen. */
 	updateToastWithOptions: (id: string, options: Partial<InternalToastOptions>) => void;
 };
 export type ToggleIconButtonComponent = React$1.ComponentType<
@@ -3847,11 +6445,44 @@ export type ToggleIconButtonProps = {
 };
 /** `TransitionStates`: MOUNTED = 0, ENTERED = 1, YEETED = 2. */
 export type TransitionState = 'MOUNTED' | 'ENTERED' | 'YEETED';
-/** A {@link DiscordAsset} extended with Unbound's icon-pack overrides. */
+/** A home screen icon the loader ships, listed in Discord's app icon picker. */
+export type UnboundAppIcon = {
+	/** The icon's native id, which the loader switches to. */
+	id: string;
+	/** The picker row it shows as, when it replaces one of Discord's own icons. */
+	pickerId?: string;
+	/** The name shown under it in the picker. */
+	name: string;
+	/** The URI of its preview image. */
+	image: string;
+};
+/** A {@link DiscordAsset} extended with Unbound's icon-pack overrides and the files of an asset a plugin registered. */
 export type UnboundAsset = DiscordAsset & {
 	iconPackPath?: string;
 	iconPackScale?: number;
+	/** The URI of a registered plugin asset at each scale; set while it is registered. */
+	unboundSources?: Record<number, string>;
+};
+/**
+ * One installed face in the loader's font store.
+ * @internal
+ */
+type UnboundInstalledFont = {
+	/** The store id: the face's PostScript name with only `[A-Za-z0-9._-]`. */
+	id: string;
+	family: string;
+	postScriptName: string;
+	fullName: string;
+	weight: number;
+	style: UnboundFontStyle;
+	/** The file, relative to Unbound's `Fonts` folder. */
+	file: string;
+	/** The file's absolute path; `list()` adds it. */
+	path?: string;
+	source: UnboundFontSource;
 };
+/** A value the generator could not type with confidence, so a loose prop accepts anything for it. */
+export type UncertainValue = any;
 /**
  * Props of `VisualEffectView` (function). Exports: default.
  * @see modules/visual_effect_view/native/VisualEffectView.tsx
@@ -3937,11 +6568,16 @@ export type YouTabLottieComponent = React$1.ComponentType<
 export type YouTabLottieProps = Omit<LottieIconProps, 'ref'> & {
 	ref?: LottieIconProps['ref'];
 };
-/** The lifecycle and settings contract implemented by a plugin. */
+/** The named exports of a plugin's entry module the client reads: its lifecycle and its settings panel. */
 type Plugin$1 = {
-	start?(context?: PluginContext): void;
+	/** Called when the plugin starts, inside its Addon scope, with its native bridge context; a rejected promise is recorded as a start failure. */
+	start?(context?: PluginContext): void | Promise<void>;
+	/** Called when the plugin stops; a returned promise is awaited, and the scope is disposed even if it throws. */
 	stop?(): void | Promise<void>;
-	getSettingsPanel?(): React$1.ReactNode;
+	/** The plugin's settings panel, rendered as `<SettingsPanel />` only while the plugin is running. */
+	SettingsPanel?: React$1.ComponentType;
+	/** Checks, without side effects, that the running plugin works on this device; the device matrix calls it after a restart. */
+	selfTest?(): PluginSelfTestResult | Promise<PluginSelfTestResult>;
 };
 
 export { Plugin$1 as Plugin };