chop-logic-core/lib/propositional/hilbert-calculus/classes/hilbert-proof-builder.d.ts

Core classes, methods and functions for calculating logical formulas and constructing proofs within the Chop Logic project.

import type { HilbertAxiomPayload, HilbertDerivedPayload, PropAtom, PropFormula } from "../../../models";
import { HilbertProof } from "./hilbert-proof";
/**
 * A builder class for constructing Hilbert-style proofs.
 * Provides a chainable API for adding proof steps.
 *
 * @example
 * ```typescript
 * const proof = new HilbertProofBuilder(implicationAB)
 *	.addPremise(A, "First premise")
 *	.addPremise(B, "Second premise")
 *	.build();
 * ```
 *
 * @category Hilbert Calculus
 */
export declare class HilbertProofBuilder {
    private readonly proof;
    /**
     * Creates a new proof builder with a goal formula.
     * @param goal - The target formula to prove
     */
    constructor(goal: PropFormula);
    /**
     * Adds a premise (given assumption) to the proof.
     * @param formula - The premise formula
     * @param comment - Optional explanation for the premise
     * @returns This builder instance for chaining
     */
    addPremise(formula: PropFormula, comment?: string): this;
    /**
     * Adds an axiom step to the proof.
     * @param payload - The axiom payload containing formulas and schema
     * @param comment - Optional explanation for the axiom
     * @returns This builder instance for chaining
     */
    addAxiom(payload: HilbertAxiomPayload, comment?: string): this;
    /**
     * Adds a derived step to the proof using a Hilbert calculus rule.
     * @param payload - The derived step payload containing formulas, schema, and step references
     * @param comment - Optional explanation for the derivation
     * @returns This builder instance for chaining
     */
    addDerivedStep(payload: HilbertDerivedPayload, comment?: string): this;
    /**
     * Reiterates (repeats) a previously proved step.
     * Allows referring to a formula from an earlier step in the proof.
     * @param fromIndex - The index of the step to reiterate (1-based)
     * @param comment - Optional explanation for the reiteration
     * @returns This builder instance for chaining
     */
    reiterateStep(fromIndex: number, comment?: string): this;
    /**
     * Replaces all occurrences of an atom with a formula or atom in all proof steps.
     * The goal formula is not modified.
     *
     * @param atom - The atomic proposition to replace
     * @param substitute - The formula or atom to substitute
     * @returns This builder instance for chaining
     */
    replace(atom: PropAtom, substitute: PropFormula | PropAtom): this;
    /**
     * Constructs the proof and returns it.
     * @returns The completed HilbertProof instance
     */
    build(): HilbertProof;
    /**
     * Adds multiple steps in sequence using a callback function.
     * Useful for building complex proofs programmatically.
     *
     * @param stepsFn - A callback that receives the current builder and adds steps
     * @returns This builder instance for chaining
     *
     * @example
     * ```typescript
     * proof.buildSteps((builder) => {
     *   builder.addPremise(p);
     *   builder.addAxiom(axiom1);
     *   builder.addDerivedStep(derived1);
     * });
     * ```
     */
    buildSteps(stepsFn: (builder: this) => void): this;
    /**
     * Gets the current state of the proof without building.
     * Useful for inspection during construction.
     * @returns The current HilbertProof instance
     */
    preview(): HilbertProof;
}