rolldown_error 1.0.0

rolldown_error
Documentation
use std::{any::Any, fmt::Debug};

use arcstr::ArcStr;
use oxc::span::Span;

use crate::{
  build_diagnostic::diagnostic::Diagnostic,
  types::{diagnostic_options::DiagnosticOptions, event_kind::EventKind},
};

#[cfg(feature = "napi")]
pub mod napi_error;

pub mod already_closed;
pub mod ambiguous_external_namespace;
pub mod assign_to_import;
pub mod bundler_initialize_error;
pub mod cannot_call_namespace;
pub mod circular_dependency;
pub mod circular_reexport;
pub mod commonjs_variable_in_esm;
pub mod configuration_field_conflict;
pub mod could_not_clean_directory;
pub mod duplicate_shebang;
pub mod empty_import_meta;
pub mod eval;
pub mod external_entry;
pub mod filename_conflict;
pub mod filename_outside_output_directory;
pub mod forbid_const_assign;
pub mod illegal_identifier_as_name;
pub mod import_is_undefined;
pub mod ineffective_dynamic_import;
pub mod invalid_annotation;
pub mod invalid_define_config;
pub mod invalid_export_option;
pub mod invalid_option;
pub mod json_parse;
pub mod large_barrel_modules;
pub mod missing_export;
pub mod missing_global_name;
pub mod missing_name_option_for_iife_export;
pub mod mixed_exports;
pub mod oxc_error;
pub mod plugin_error;
pub mod plugin_timings;
pub mod prefer_builtin_feature;
pub mod require_tla;
pub mod resolve_error;
pub mod runtime_module_symbol_not_found;
pub mod tsconfig_error;
pub mod unhandleable_error;
pub mod unloadable_dependency;
pub mod unresolved_entry;
pub mod unsupported_feature;
pub mod unsupported_tsconfig_option;
pub mod untranspiled_syntax;

pub trait BuildEvent: Debug + Sync + Send + AsAny + AsAnyMut {
  fn kind(&self) -> EventKind;

  fn message(&self, opts: &DiagnosticOptions) -> String;

  fn on_diagnostic(&self, _diagnostic: &mut Diagnostic, _opts: &DiagnosticOptions) {}

  // extra properties to match RollupLog interface
  // https://rollupjs.org/configuration-options/#onlog
  fn id(&self) -> Option<String> {
    None
  }

  fn exporter(&self) -> Option<String> {
    None
  }

  fn ids(&self) -> Option<Vec<String>> {
    None
  }

  #[cfg(feature = "napi")]
  fn as_napi_error(&self) -> Option<&napi::Error> {
    None
  }
}

impl<T: BuildEvent + 'static> From<T> for Box<dyn BuildEvent>
where
  Self: Sized,
{
  fn from(e: T) -> Self {
    Box::new(e)
  }
}

pub trait AsAny {
  fn as_any(&self) -> &dyn Any;
}

impl<T: 'static + BuildEvent> AsAny for T {
  fn as_any(&self) -> &dyn Any {
    self
  }
}

pub trait AsAnyMut {
  fn as_any_mut(&mut self) -> &mut dyn Any;
}

impl<T: 'static + BuildEvent> AsAnyMut for T {
  fn as_any_mut(&mut self) -> &mut dyn Any {
    self
  }
}

/// A Hybrid string type used for diagnostic, e.g.
/// for `UnresolvedError`, a specifier could be either a slice from raw source, or
/// created during ast transformation. When the specifier came from raw source, we could
/// use the `Span` information to give user better DX, otherwise, we could just use the string to
/// create a fallback message.
/// ## Panic
/// they type is only used for store information, user should check the span could be referenced
/// the raw source, or the user side may panic.
#[derive(Debug)]
pub enum DiagnosableArcstr {
  String(ArcStr),
  Span(Span),
}

// --- end