import { type EncryptionRef, type Token } from "../core.js";
import { type FolderRef } from "../refs.js";
import type { FolderHandle } from "./folder.js";
export type AppSpec = {
    /** Path to the app's code directory (uploaded + built on deploy). */
    path: string;
    name?: string;
    description?: string;
    folder?: FolderHandle | FolderRef;
    /** Env vars baked into the build (`VITE_`-prefixed). Use `secret("NAME")` for secret values. */
    env?: Record<string, string | EncryptionRef>;
};
export type AppHandle = {
    readonly slug: string;
    readonly uuid: Token;
    /** The live app URL (deferred — known after deploy). */
    readonly url: Token;
};
export declare function defineApp(slug: string, spec: AppSpec): AppHandle;
//# sourceMappingURL=app.d.ts.map