export interface CommandFlag {
    readonly flag: string;
    readonly description: string;
}
export interface CommandHelp {
    readonly summary: string;
    readonly usage: string;
    readonly flags: readonly CommandFlag[];
}
export declare const commandHelpTable: {
    readonly permissions: {
        readonly summary: "Check Screeny grants or request missing permissions.";
        readonly usage: "screeny permissions [--request]";
        readonly flags: readonly [{
            readonly flag: "--request";
            readonly description: "Request the Screeny system permissions.";
        }];
    };
    readonly record: {
        readonly summary: "Run a TypeScript recording module and write a take.";
        readonly usage: "screeny record <file.screeny.ts> --out <dir>";
        readonly flags: readonly [{
            readonly flag: "--out <dir>";
            readonly description: "Write the recorded take artifacts to this directory.";
        }];
    };
    readonly start: {
        readonly summary: "Open a live take against a specific app or window.";
        readonly usage: "screeny start --out <dir> (--app <bundle-id> | --window-id <id>) [--capture display:<uuid> | region:<uuid>:<x>,<y>,<w>,<h>]";
        readonly flags: readonly [{
            readonly flag: "--out <dir>";
            readonly description: "Write the live take artifacts to this directory.";
        }, {
            readonly flag: "--app <bundle-id>";
            readonly description: "Bind the take to a running app by bundle identifier.";
        }, {
            readonly flag: "--window-id <id>";
            readonly description: "Bind the take to a specific window id.";
        }, {
            readonly flag: "--capture display:<uuid>";
            readonly description: "Capture a full display instead of the target window.";
        }, {
            readonly flag: "--capture region:<uuid>:<x>,<y>,<w>,<h>";
            readonly description: "Capture a display-local region instead of the target window.";
        }];
    };
    readonly see: {
        readonly summary: "Catalog the bound window's elements as a snapshot for --on actions.";
        readonly usage: "screeny see [--app <bundle-id>]";
        readonly flags: readonly [{
            readonly flag: "--app <bundle-id>";
            readonly description: "Catalog a running app when no take is live.";
        }];
    };
    readonly query: {
        readonly summary: "Read a snapshot element's current value from the bound app.";
        readonly usage: "screeny query --on <elem> --snapshot <id>";
        readonly flags: readonly [{
            readonly flag: "--on <elem>";
            readonly description: "Target the element id from a snapshot.";
        }, {
            readonly flag: "--snapshot <id>";
            readonly description: "Use the snapshot that contains the target element.";
        }];
    };
    readonly mark: {
        readonly summary: "Name the next live interaction for cut anchors.";
        readonly usage: "screeny mark <id>";
        readonly flags: readonly [];
    };
    readonly unmark: {
        readonly summary: "Discard the armed live-interaction mark.";
        readonly usage: "screeny unmark";
        readonly flags: readonly [];
    };
    readonly move: {
        readonly summary: "Move the real cursor to an element or coordinate.";
        readonly usage: "screeny move (--on <elem> --snapshot <id> | --coords <x>,<y>) [--profile human|linear] [--duration <ms>] [--steps <n>]";
        readonly flags: readonly [{
            readonly flag: "--on <elem>";
            readonly description: "Move to the element id from a snapshot.";
        }, {
            readonly flag: "--snapshot <id>";
            readonly description: "Use the snapshot that contains the target element.";
        }, {
            readonly flag: "--coords <x>,<y>";
            readonly description: "Move to screen coordinates in points.";
        }, {
            readonly flag: "--profile human|linear";
            readonly description: "Choose the cursor movement profile.";
        }, {
            readonly flag: "--duration <ms>";
            readonly description: "Set the cursor movement duration.";
        }, {
            readonly flag: "--steps <n>";
            readonly description: "Set the number of generated cursor samples.";
        }];
    };
    readonly click: {
        readonly summary: "Click an element or coordinate in the live take.";
        readonly usage: "screeny click (--on <elem> --snapshot <id> | --coords <x>,<y>)";
        readonly flags: readonly [{
            readonly flag: "--on <elem>";
            readonly description: "Click the element id from a snapshot.";
        }, {
            readonly flag: "--snapshot <id>";
            readonly description: "Use the snapshot that contains the target element.";
        }, {
            readonly flag: "--coords <x>,<y>";
            readonly description: "Click screen coordinates in points.";
        }];
    };
    readonly type: {
        readonly summary: "Type text into the focused field or a snapshot element.";
        readonly usage: "screeny type <text> [--on <elem> --snapshot <id>] [--wpm <n>]";
        readonly flags: readonly [{
            readonly flag: "--on <elem>";
            readonly description: "Type into the element id from a snapshot.";
        }, {
            readonly flag: "--snapshot <id>";
            readonly description: "Use the snapshot that contains the target element.";
        }, {
            readonly flag: "--wpm <n>";
            readonly description: "Set the typing speed in words per minute.";
        }];
    };
    readonly press: {
        readonly summary: "Press a keyboard key, optionally with modifiers.";
        readonly usage: "screeny press <key> [--mods cmd,shift,...]";
        readonly flags: readonly [{
            readonly flag: "--mods cmd,shift,...";
            readonly description: "Hold comma-separated modifiers while pressing the key.";
        }];
    };
    readonly scroll: {
        readonly summary: "Scroll the focused target or a snapshot element.";
        readonly usage: "screeny scroll [--on <elem> --snapshot <id>] [--dx <px>] [--dy <px>]";
        readonly flags: readonly [{
            readonly flag: "--on <elem>";
            readonly description: "Scroll the element id from a snapshot.";
        }, {
            readonly flag: "--snapshot <id>";
            readonly description: "Use the snapshot that contains the target element.";
        }, {
            readonly flag: "--dx <px>";
            readonly description: "Set the horizontal scroll delta.";
        }, {
            readonly flag: "--dy <px>";
            readonly description: "Set the vertical scroll delta.";
        }];
    };
    readonly drag: {
        readonly summary: "Drag between two elements or coordinates.";
        readonly usage: "screeny drag (--from <elem> --to <elem> --snapshot <id> | --from-coords <x>,<y> --to-coords <x>,<y>)";
        readonly flags: readonly [{
            readonly flag: "--from <elem>";
            readonly description: "Start from the element id in a snapshot.";
        }, {
            readonly flag: "--to <elem>";
            readonly description: "End on the element id in a snapshot.";
        }, {
            readonly flag: "--snapshot <id>";
            readonly description: "Use the snapshot that contains both target elements.";
        }, {
            readonly flag: "--from-coords <x>,<y>";
            readonly description: "Start from screen coordinates in points.";
        }, {
            readonly flag: "--to-coords <x>,<y>";
            readonly description: "End on screen coordinates in points.";
        }];
    };
    readonly displays: {
        readonly summary: "List capture display UUIDs and geometry.";
        readonly usage: "screeny displays";
        readonly flags: readonly [];
    };
    readonly status: {
        readonly summary: "Show whether a live take is running.";
        readonly usage: "screeny status";
        readonly flags: readonly [];
    };
    readonly stop: {
        readonly summary: "Finalize the live take and write its artifacts.";
        readonly usage: "screeny stop";
        readonly flags: readonly [];
    };
    readonly abort: {
        readonly summary: "End the live take early, preserving captured evidence when present.";
        readonly usage: "screeny abort";
        readonly flags: readonly [];
    };
    readonly moments: {
        readonly summary: "List moment ids from a moments artifact.";
        readonly usage: "screeny moments <moments.json>";
        readonly flags: readonly [];
    };
    readonly "derive-moments": {
        readonly summary: "Derive moments from a completed take's artifacts.";
        readonly usage: "screeny derive-moments --execution <execution.json> --events <events.json> --cursor <cursor.json> --recording <recording.json> --frame-timeline <frame-timeline.json> --out <moments.json>";
        readonly flags: readonly [{
            readonly flag: "--execution <execution.json>";
            readonly description: "Read the execution artifact.";
        }, {
            readonly flag: "--events <events.json>";
            readonly description: "Read the event log artifact.";
        }, {
            readonly flag: "--cursor <cursor.json>";
            readonly description: "Read the cursor track artifact.";
        }, {
            readonly flag: "--recording <recording.json>";
            readonly description: "Read the recording artifact.";
        }, {
            readonly flag: "--frame-timeline <frame-timeline.json>";
            readonly description: "Read the frame timeline artifact.";
        }, {
            readonly flag: "--out <moments.json>";
            readonly description: "Write the derived moments artifact.";
        }];
    };
    readonly "compile-cut": {
        readonly summary: "Compile a .screenycut file into a cut plan.";
        readonly usage: "screeny compile-cut <file.screenycut> [--out <cut.json>]";
        readonly flags: readonly [{
            readonly flag: "--out <cut.json>";
            readonly description: "Write the compiled cut instead of printing it.";
        }];
    };
    readonly resolve: {
        readonly summary: "Resolve a compiled cut against immutable take artifacts.";
        readonly usage: "screeny resolve --cut <cut.json> --take <id>=<dir> ... --out <resolved.json> [--export]";
        readonly flags: readonly [{
            readonly flag: "--cut <cut.json>";
            readonly description: "Read the compiled cut artifact.";
        }, {
            readonly flag: "--take <id>=<dir>";
            readonly description: "Bind a take id to its artifact directory.";
        }, {
            readonly flag: "--out <resolved.json>";
            readonly description: "Write the resolved render plan.";
        }, {
            readonly flag: "--export";
            readonly description: "Refuse unresolved export gaps instead of previewing them.";
        }];
    };
    readonly trace: {
        readonly summary: "Inspect camera movement for a single resolved take.";
        readonly usage: "screeny trace --resolved <resolved.json> --cursor <cursor.json> --recording <recording.json> --frame-timeline <frame-timeline.json> [--out <file>]";
        readonly flags: readonly [{
            readonly flag: "--resolved <resolved.json>";
            readonly description: "Read the resolved render plan.";
        }, {
            readonly flag: "--cursor <cursor.json>";
            readonly description: "Read the cursor track artifact.";
        }, {
            readonly flag: "--recording <recording.json>";
            readonly description: "Read the recording artifact.";
        }, {
            readonly flag: "--frame-timeline <frame-timeline.json>";
            readonly description: "Read the frame timeline artifact.";
        }, {
            readonly flag: "--out <file>";
            readonly description: "Write the trace artifact instead of only printing it.";
        }];
    };
    readonly render: {
        readonly summary: "Render a resolved cut to a movie file.";
        readonly usage: "screeny render --resolved <resolved.json> --take <id>=<dir> ... --out <demo.mp4|demo.mov> [--preview]";
        readonly flags: readonly [{
            readonly flag: "--resolved <resolved.json>";
            readonly description: "Read the resolved render plan.";
        }, {
            readonly flag: "--take <id>=<dir>";
            readonly description: "Bind a take id to its artifact directory.";
        }, {
            readonly flag: "--out <demo.mp4|demo.mov>";
            readonly description: "Write the rendered movie: .mp4 for the H.264 export, .mov for the ProRes export.";
        }, {
            readonly flag: "--preview";
            readonly description: "Allow preview rendering through unresolved gaps.";
        }];
    };
    readonly activate: {
        readonly summary: "Activate a Screeny Pro license key.";
        readonly usage: "screeny activate --key <license-key>";
        readonly flags: readonly [{
            readonly flag: "--key <license-key>";
            readonly description: "Use this license key for activation.";
        }];
    };
    readonly license: {
        readonly summary: "Show the current Screeny license tier.";
        readonly usage: "screeny license";
        readonly flags: readonly [];
    };
    readonly version: {
        readonly summary: "Print the Screeny command service version.";
        readonly usage: "screeny version";
        readonly flags: readonly [];
    };
    readonly "selftest-render": {
        readonly summary: "Run the renderer self-test.";
        readonly usage: "screeny selftest-render [--out <dir>]";
        readonly flags: readonly [{
            readonly flag: "--out <dir>";
            readonly description: "Write self-test artifacts to this directory.";
        }];
    };
    readonly "selftest-contracts": {
        readonly summary: "Write command contract fixtures.";
        readonly usage: "screeny selftest-contracts [--out <dir>]";
        readonly flags: readonly [{
            readonly flag: "--out <dir>";
            readonly description: "Write contract fixtures to this directory.";
        }];
    };
};
export declare const documentedCommands: readonly ["permissions", "record", "start", "see", "query", "mark", "unmark", "move", "click", "type", "press", "scroll", "drag", "displays", "status", "stop", "abort", "moments", "derive-moments", "compile-cut", "resolve", "trace", "render", "activate", "license", "version"];
export type CommandName = keyof typeof commandHelpTable;
export declare const commandNames: string[];
export declare function isKnownCommand(name: string): name is CommandName;
export declare function topLevelHelp(): string;
export declare function commandHelp(name: string): string | undefined;
export declare function usageLine(name: string): string | undefined;
export declare function argumentError(command: string, argv: readonly string[]): string | undefined;
//# sourceMappingURL=help.d.ts.map