import { ModuleFederationOptions } from '@module-federation/rsbuild-plugin';

/** Builds, assembles, verifies, then atomically replaces the configured output. */
export declare function buildTapMiniapp(options?: TapMiniappLifecycleOptions): Promise<TapMiniappBuildResult>;

/** Runs the same compiler/build/verification path without replacing output. */
export declare function checkTapMiniapp(options?: TapMiniappLifecycleOptions): Promise<TapMiniappCheckResult>;

/** Creates the canonical command-backed target-builder adapter. */
export declare function commandTargetBuilder(options: CommandTargetBuilderOptions): TargetBuilder;

export declare type CommandTargetBuilderOptions = Readonly<{
    id?: string;
    command: string;
    args?: readonly string[];
    env?: Readonly<Record<string, string>>;
}>;

declare type Config = {
    manifest?: string;
    entryName?: string;
    output?: string;
    federation?: ModuleFederationOptions;
    /** Descriptor target updated by this build, such as desktop or mobile. */
    packageTarget?: 'desktop' | 'mobile' | 'quickjs' | 'worker' | 'node' | 'workflow-host';
    /** Filesystem root for this independently compiled target graph. */
    packageOutputRoot?: string;
};

declare type ExactSourceManifestV2 = Readonly<{
    rawBytes: Uint8Array<ArrayBuffer>;
    parsedManifest: SourceManifestV2;
    sha256: string;
    byteLength: number;
}>;

/** Verifies one assembled package and invokes exactly one explicit publisher. */
export declare function publishTapMiniapp(options?: PublishTapMiniappOptions): Promise<TapMiniappPublishResult>;

export declare type PublishTapMiniappOptions = TapMiniappLifecycleOptions & Readonly<{
    from?: string;
}>;

declare type ResolvedTapMiniappTargetDefinition = Readonly<{
    remoteName: string;
    exposes: Readonly<Record<string, ResolvedTapMiniappTargetExpose>>;
}>;

declare type ResolvedTapMiniappTargetExpose = Readonly<{
    runtime: TapMiniappTargetExpose['runtime'];
    source: string;
}>;

declare const SOURCE_MANIFEST_SCHEMA_VERSION = 2;

declare type SourceManifestArtifactV2 = Readonly<{
    path: string;
    digest: string;
    length: number;
}>;

declare type SourceManifestLocalDisplayV2 = Readonly<{
    name?: string;
    slug?: string;
}>;

declare type SourceManifestRuntimeEffectV2 = Readonly<{
    kind: string;
    resources: readonly string[];
}>;

declare type SourceManifestTargetV2 = Readonly<{
    target: string;
    path: string;
    digest: string;
    length: number;
}>;

declare type SourceManifestV2 = Readonly<{
    schemaVersion: typeof SOURCE_MANIFEST_SCHEMA_VERSION;
    versionLabel: string;
    localDisplay?: SourceManifestLocalDisplayV2;
    targets: readonly SourceManifestTargetV2[];
    artifacts: readonly SourceManifestArtifactV2[];
    permissions: readonly string[];
    runtimeEffects: readonly SourceManifestRuntimeEffectV2[];
}>;

declare type TapMiniappBuildContext = Readonly<{
    buildSchemaVersion: 2;
    sdkVersion: string;
    versionLabel: string;
    localDisplay: Required<SourceManifestLocalDisplayV2>;
    projectRoot: string;
    stagingRoot: string;
    outputRoot: string;
    buildManifestPath: string;
    targets: readonly TapPackageTarget[];
}>;

export declare type TapMiniappBuildResult = Readonly<{
    command: 'build';
    build: TapMiniappBuildContext;
    sourceManifest: ExactSourceManifestV2;
    packageRoot: string;
}>;

export declare type TapMiniappCheckResult = Readonly<{
    command: 'check';
    build: TapMiniappBuildContext;
    sourceManifest: ExactSourceManifestV2;
    verified: true;
}>;

export declare type TapMiniappLifecycleOptions = Readonly<{
    root?: string;
    output?: string;
    configPath?: string;
}>;

declare type TapMiniappMaybePromise<T> = T | Promise<T>;

export declare type TapMiniappPublishResult<TResult = unknown> = Readonly<{
    command: 'publish';
    build: TapMiniappBuildContext;
    sourceManifest: ExactSourceManifestV2;
    packageRoot: string;
    publisherId: string;
    result: TResult;
}>;

declare type TapMiniappTargetExpose = Readonly<{
    runtime: 'webview' | 'quickjs' | 'worker' | 'node' | 'workflow-host';
    source: string | Readonly<{
        generated: string;
    }>;
}>;

declare type TapPackageTarget = NonNullable<Config['packageTarget']>;

/** Compiles one application target into the SDK-owned target output root. */
declare type TargetBuilder = Readonly<{
    id: string;
    build(context: TargetBuilderContext): TapMiniappMaybePromise<void>;
}>;

declare type TargetBuilderContext = Readonly<{
    target: TapPackageTarget;
    build: TapMiniappBuildContext;
    buildManifestPath: string;
    stagingRoot: string;
    outputRoot: string;
    targetDefinition: ResolvedTapMiniappTargetDefinition;
}>;

export { }