import type { ResourceCtx } from '../../../core/extend-resource.js';
import type { DescribedAddOn, ResolveAddonOptions } from './types.js';
/**
 * Resolve, describe, and decorate an add-on for display.
 *
 * - Resolves the add-on by identity (optionally scoped to an app).
 * - Loads the add-on's attachments.
 * - Returns a copy with `plan.price` set from `billed_price` (so the
 *   value reflects any grandfathered/contract pricing).
 *
 * Requests the `version=3.sdk` accept variant with `addon_service,plan`
 * expansion so the resolved add-on includes the full `Plan` shape
 * (`price.unit`, etc.) needed to render pricing.
 */
export declare function describeAddon(ctx: Pick<ResourceCtx, 'platform'>, addonIdentity: string, options?: ResolveAddonOptions): Promise<DescribedAddOn>;