/**
 * Export manifest — types for export artifact manifests and validation.
 *
 * Defines the schema for export manifests — structural metadata files
 * that describe what was exported (artifacts), when, and by which tool,
 * and enable subsequent validation of completeness and integrity.
 *
 * @module
 */
/**
 * Supported export artifact types.
 *
 * Maps to the file format enum used by EasyEDA Pro export tools and
 * the golden fixture's `exportManifest.expectedFormats`.
 */
export declare enum ArtifactType {
    /** Gerber RS-274X (fabrication layers). */
    Gerber = "gerber",
    /** NC drill file (Excellon). */
    Drill = "drill",
    /** Bill of materials (CSV). */
    Bom = "bom",
    /** Pick-and-place / centroid file (CSV). */
    Pnp = "pnp",
    /** PDF export (schematic, board, or both). */
    Pdf = "pdf",
    /** Netlist (PADS / Allegro / Altium format). */
    Netlist = "netlist",
    /** Electrical rules check report. */
    ErcReport = "erc-report",
    /** Design rules check report. */
    DrcReport = "drc-report",
    /** Markdown or JSON documentation artifact. */
    Documentation = "documentation"
}
/**
 * Manufacturing handoff role for an export artifact.
 *
 * File extensions alone are often ambiguous. Roles let the validator check
 * that a fabrication package has the required copper, mask, drill, outline,
 * assembly, and documentation artifacts.
 */
export declare enum ExportArtifactRole {
    TopCopper = "top-copper",
    BottomCopper = "bottom-copper",
    InnerCopper = "inner-copper",
    TopSolderMask = "top-solder-mask",
    BottomSolderMask = "bottom-solder-mask",
    TopSilkscreen = "top-silkscreen",
    BottomSilkscreen = "bottom-silkscreen",
    BoardOutline = "board-outline",
    DrillPlated = "drill-plated",
    DrillNonPlated = "drill-nonplated",
    Bom = "bom",
    PickPlace = "pick-place",
    SchematicPdf = "schematic-pdf",
    BoardPdf = "board-pdf",
    Netlist = "netlist",
    DrcReport = "drc-report",
    ErcReport = "erc-report",
    TestpointChecklist = "testpoint-checklist",
    AssemblyNotes = "assembly-notes",
    BringupPlan = "bringup-plan",
    ProductionQaChecklist = "production-qa-checklist",
    QaManifest = "qa-manifest"
}
/**
 * A single artifact entry in an export manifest.
 *
 * Each entry describes one file produced by an export operation, including
 * its origin, integrity metadata, and required/optional classification.
 */
export interface ExportManifestEntry {
    /** File name (e.g. "ESP32-S3-Board-F.Cu.gbr"). */
    filename: string;
    /** Relative path from the export root directory. */
    relativePath?: string;
    /** The type of exported file. */
    fileType: ArtifactType;
    /** Human-readable purpose (e.g. "Top copper layer"). */
    purpose: string;
    /** Manufacturing role used for package completeness checks. */
    role?: ExportArtifactRole;
    /** Source project identifier. */
    sourceProject?: string;
    /** Tool that generated this artifact (e.g. "easyeda-export-gerbers"). */
    generatedByTool?: string;
    /** ISO-8601 timestamp when this artifact was generated. */
    timestamp?: string;
    /** Hex-encoded checksum, preferably SHA-256. */
    checksum?: string;
    /** Algorithm used to compute checksum. */
    checksumAlgorithm?: 'sha256' | 'sha512' | 'md5';
    /** File size in bytes. */
    fileSize?: number;
    /** Whether this artifact is required for the export to be valid. */
    required: boolean;
    /** Whether this artifact is stale (outdated relative to source design). */
    stale: boolean;
}
/**
 * Expected artifact descriptor used to validate actual export output.
 *
 * Mirrors the golden fixture's `exportManifest.files[]` structure.
 */
export interface ExpectedArtifact {
    /** Expected file name pattern. */
    filename: string;
    /** Expected file type. */
    fileType: ArtifactType;
    /** Expected manufacturing role. */
    role?: ExportArtifactRole;
    /** Minimum acceptable file size in bytes. */
    minSizeBytes?: number;
    /** Whether this artifact is required (missing = validation error). */
    required?: boolean;
}
/** Project metadata captured at export time. */
export interface ExportProjectMetadata {
    /** EasyEDA project id or repository-specific project id. */
    projectId: string;
    /** Human-readable project name. */
    projectName?: string;
    /** EasyEDA editor/runtime version when available. */
    easyedaVersion?: string;
    /** EasyEDA bridge extension version when available. */
    bridgeVersion?: string;
    /** Source document or board id when available. */
    documentId?: string;
    /** Board revision or release identifier. */
    revision?: string;
}
/** Assembly cross-check metadata for BOM and pick-and-place consistency. */
export interface AssemblyConsistencyMetadata {
    /** BOM designators extracted from the exported BOM. */
    bomDesignators?: string[];
    /** Pick-and-place designators extracted from the centroid file. */
    pnpDesignators?: string[];
    /** Expected BOM row/designator count. */
    expectedBomDesignatorCount?: number;
    /** Expected pick-and-place row/designator count. */
    expectedPnpDesignatorCount?: number;
}
/** Manufacturing package validation policy. */
export interface ManufacturingExportPolicy {
    /** Required artifact roles for this export profile. */
    requiredRoles?: ExportArtifactRole[];
    /** Require each required artifact to include checksum metadata. */
    requireChecksums?: boolean;
    /** Require each required artifact to include non-zero fileSize. */
    requireFileSizes?: boolean;
    /** Require each required artifact to include generatedByTool and timestamp. */
    requireGenerationMetadata?: boolean;
    /** Require manifest-level EasyEDA and project metadata. */
    requireProjectMetadata?: boolean;
    /** Require BOM and pick-and-place designator consistency checks. */
    requireBomPnpConsistency?: boolean;
}
/**
 * Complete input to export manifest validation.
 *
 * Carries both the actual exported artifacts and an optional set of
 * expectations to compare against.
 */
export interface ExportManifestInput {
    /** Manifest schema version (semver, e.g. "1.0.0"). */
    version: string;
    /** Source project identifier (EasyEDA project UUID). */
    sourceProjectId: string;
    /** Human-readable source project name. */
    sourceProjectName?: string;
    /** ISO-8601 timestamp of manifest generation. */
    generatedAt: string;
    /** Server / tool version that produced this manifest. */
    serverVersion?: string;
    /** EasyEDA / bridge metadata if available. */
    bridgeMetadata?: Record<string, unknown>;
    /** Structured project metadata captured at export time. */
    projectMetadata?: ExportProjectMetadata;
    /** Manufacturing package policy for strict handoff checks. */
    manufacturingPolicy?: ManufacturingExportPolicy;
    /** Optional assembly data used to compare BOM and pick-and-place outputs. */
    assemblyConsistency?: AssemblyConsistencyMetadata;
    /** Artifacts produced by the export. */
    artifacts: ExportManifestEntry[];
    /** Expected artifacts for comparison-based validation. */
    expectedArtifacts?: ExpectedArtifact[];
}
/**
 * A single export manifest validation issue (error or warning).
 *
 * Mirrors the pattern from `net-validation/errors.ts` for consistency
 * across validation modules.
 */
export interface ExportManifestIssue {
    /** Machine-readable error code. */
    code: string;
    /** Human-readable description of what is wrong. */
    message: string;
    /** Whether this issue blocks validation or is advisory. */
    severity: 'error' | 'warning';
    /** Dot-notation path to the offending field (e.g. "artifacts[2]"). */
    path?: string;
    /** Related artifact path for file-level issues. */
    artifactPath?: string;
    /** Related artifact type for type-specific issues. */
    artifactType?: string;
    /** Related purpose field for purpose-related issues. */
    purpose?: string;
    /** Actionable hint for the user. */
    remediationHint: string;
    /** Additional machine-readable context. */
    details?: Record<string, unknown>;
}
/**
 * Validation summary breakdown.
 */
export interface ExportManifestSummary {
    /** Total artifact count in the manifest. */
    totalFiles: number;
    /** Number of error-severity issues. */
    errors: number;
    /** Number of warning-severity issues. */
    warnings: number;
    /** Count of missing required files. */
    missingRequired: number;
    /** Count of empty files. */
    emptyFiles: number;
    /** Count of stale files. */
    staleFiles: number;
    /** Count of checksum mismatches. */
    checksumMismatches: number;
    /** Count of unexpected files (present but not expected). */
    unexpectedFiles: number;
    /** Count of wrong file type assignments. */
    wrongFileTypes: number;
    /** Count of artifacts missing a purpose description. */
    missingPurposes: number;
    /** Count of artifacts missing a generation timestamp. */
    missingTimestamps: number;
    /** Count of artifacts missing a source project reference. */
    missingSourceProjects: number;
    /** Count of artifacts missing checksum metadata. */
    missingChecksums: number;
    /** Count of artifacts missing file size metadata. */
    missingFileSizes: number;
    /** Count of missing manufacturing roles. */
    missingRequiredRoles: number;
    /** Count of board outline package errors. */
    missingBoardOutlines: number;
    /** Count of drill package errors. */
    missingDrillFiles: number;
    /** Count of BOM / pick-and-place consistency errors. */
    bomPnpMismatches: number;
    /** Count of manifest/project metadata errors. */
    missingProjectMetadata: number;
}
/**
 * Complete export manifest validation report.
 */
export interface ExportManifestReport {
    /** True when there are zero errors (warnings are allowed). */
    valid: boolean;
    /** The manifest that was validated (as provided). */
    manifest: ExportManifestInput;
    /** All issues found during validation. */
    issues: ExportManifestIssue[];
    /** Aggregated summary counts. */
    summary: ExportManifestSummary;
}