fix: remove unused imports and variables

- Remove unused NonZeroU16 import from model.rs
- Remove unused Error import from simple_parser.rs
- Remove unused CompactString and HashMap imports from validator.rs
- Fix unused 'end' variable warning in validator.rs
- Add allow(dead_code) attributes for unused fields
This commit is contained in:
Stefano Amorelli
2025-08-16 17:21:07 +03:00
commit 6ae9cafbf0
4 changed files with 1124 additions and 0 deletions

114
src/lib.rs Normal file
View File

@@ -0,0 +1,114 @@
//! crabrl - High-performance XBRL parser and validator
//!
//! Licensed under AGPL-3.0
pub mod model;
pub mod simple_parser;
pub mod validator;
// Use simple parser for now
pub use simple_parser::Parser;
// Re-export main types
pub use model::{Document, Fact, Context, Unit};
// Create validator wrapper for the CLI
pub struct Validator {
inner: validator::XbrlValidator,
#[allow(dead_code)]
strict: bool,
}
impl Validator {
pub fn new() -> Self {
Self {
inner: validator::XbrlValidator::new(),
strict: false,
}
}
pub fn with_config(config: ValidationConfig) -> Self {
let mut inner = validator::XbrlValidator::new();
if config.strict {
inner = inner.strict();
}
Self {
inner,
strict: config.strict,
}
}
pub fn sec_edgar() -> Self {
Self {
inner: validator::XbrlValidator::new().strict(),
strict: true,
}
}
pub fn validate(&self, doc: &Document) -> Result<ValidationResult> {
let start = std::time::Instant::now();
// Clone doc for validation (validator mutates it)
let mut doc_copy = doc.clone();
// Run validation
let is_valid = self.inner.validate(&mut doc_copy).is_ok();
Ok(ValidationResult {
is_valid,
errors: if is_valid { Vec::new() } else { vec!["Validation failed".to_string()] },
warnings: Vec::new(),
stats: ValidationStats {
facts_validated: doc.facts.len(),
duration_ms: start.elapsed().as_millis() as u64,
},
})
}
}
/// Simple validation config for CLI
pub struct ValidationConfig {
pub strict: bool,
}
impl ValidationConfig {
pub fn sec_edgar() -> Self {
Self { strict: true }
}
}
impl Default for ValidationConfig {
fn default() -> Self {
Self { strict: false }
}
}
/// Simple validation result for CLI
pub struct ValidationResult {
pub is_valid: bool,
pub errors: Vec<String>,
pub warnings: Vec<String>,
pub stats: ValidationStats,
}
pub struct ValidationStats {
pub facts_validated: usize,
pub duration_ms: u64,
}
pub type Result<T> = std::result::Result<T, Error>;
#[derive(Debug, thiserror::Error)]
pub enum Error {
#[error("IO error: {0}")]
Io(#[from] std::io::Error),
#[error("Parse error: {0}")]
Parse(String),
#[error("Validation error: {0}")]
Validation(String),
#[error("Not found: {0}")]
NotFound(String),
}

351
src/model.rs Normal file
View File

@@ -0,0 +1,351 @@
use compact_str::CompactString;
use std::collections::HashMap;
// ============================================================================
// Core XBRL Data Structures - Full Specification Support
// ============================================================================
#[repr(C, align(64))]
#[derive(Clone)]
pub struct FactStorage {
pub concept_ids: Vec<u32>,
pub context_ids: Vec<u16>,
pub unit_ids: Vec<u16>,
pub values: Vec<FactValue>,
pub decimals: Vec<Option<i8>>,
pub ids: Vec<Option<CompactString>>,
pub footnote_refs: Vec<Vec<CompactString>>,
}
#[derive(Debug, Clone)]
pub enum FactValue {
Text(CompactString),
Decimal(f64),
Integer(i64),
Boolean(bool),
Date(CompactString),
DateTime(CompactString),
Nil,
}
impl FactStorage {
pub fn with_capacity(capacity: usize) -> Self {
Self {
concept_ids: Vec::with_capacity(capacity),
context_ids: Vec::with_capacity(capacity),
unit_ids: Vec::with_capacity(capacity),
values: Vec::with_capacity(capacity),
decimals: Vec::with_capacity(capacity),
ids: Vec::with_capacity(capacity),
footnote_refs: Vec::with_capacity(capacity),
}
}
#[inline(always)]
pub fn len(&self) -> usize {
self.concept_ids.len()
}
pub fn is_empty(&self) -> bool {
self.concept_ids.is_empty()
}
}
// Full fact representation with all XBRL features
#[derive(Debug, Clone)]
pub struct Fact {
pub id: Option<CompactString>,
pub concept: CompactString,
pub context_ref: CompactString,
pub unit_ref: Option<CompactString>,
pub value: String,
pub decimals: Option<i8>,
pub precision: Option<u8>,
pub nil: bool,
pub nil_reason: Option<CompactString>,
pub footnote_refs: Vec<CompactString>,
}
// Context with full dimension support
#[derive(Debug, Clone)]
pub struct Context {
pub id: CompactString,
pub entity: Entity,
pub period: Period,
pub scenario: Option<Scenario>,
}
#[derive(Debug, Clone)]
pub struct Entity {
pub identifier: CompactString,
pub scheme: CompactString,
pub segment: Option<Segment>,
}
// Dimensional data support
#[derive(Debug, Clone)]
pub struct Segment {
pub explicit_members: Vec<DimensionMember>,
pub typed_members: Vec<TypedMember>,
}
#[derive(Debug, Clone)]
pub struct DimensionMember {
pub dimension: CompactString,
pub member: CompactString,
}
#[derive(Debug, Clone)]
pub struct TypedMember {
pub dimension: CompactString,
pub value: String, // XML content
}
#[derive(Debug, Clone)]
pub struct Scenario {
pub explicit_members: Vec<DimensionMember>,
pub typed_members: Vec<TypedMember>,
}
// Period with forever support
#[derive(Debug, Clone)]
pub enum Period {
Instant { date: CompactString },
Duration { start: CompactString, end: CompactString },
Forever,
}
// Complex unit support with divide/multiply
#[derive(Debug, Clone)]
pub struct Unit {
pub id: CompactString,
pub unit_type: UnitType,
}
#[derive(Debug, Clone)]
pub enum UnitType {
Simple(Vec<Measure>),
Divide {
numerator: Vec<Measure>,
denominator: Vec<Measure>,
},
Multiply(Vec<Measure>),
}
#[derive(Debug, Clone)]
pub struct Measure {
pub namespace: CompactString,
pub name: CompactString,
}
// Tuple support for structured data
#[derive(Debug, Clone)]
pub struct Tuple {
pub id: Option<CompactString>,
pub name: CompactString,
pub facts: Vec<FactOrTuple>,
}
#[derive(Debug, Clone)]
pub enum FactOrTuple {
Fact(Fact),
Tuple(Box<Tuple>),
}
// Footnote support
#[derive(Debug, Clone)]
pub struct Footnote {
pub id: CompactString,
pub role: Option<CompactString>,
pub lang: Option<CompactString>,
pub content: String,
pub fact_refs: Vec<CompactString>,
}
// Fraction support
#[derive(Debug, Clone)]
pub struct FractionValue {
pub numerator: f64,
pub denominator: f64,
}
// Schema and taxonomy support
#[derive(Debug, Clone)]
pub struct Schema {
pub target_namespace: CompactString,
pub elements: HashMap<CompactString, SchemaElement>,
pub types: HashMap<CompactString, SchemaType>,
pub imports: Vec<SchemaImport>,
}
#[derive(Debug, Clone)]
pub struct SchemaElement {
pub name: CompactString,
pub element_type: CompactString,
pub substitution_group: Option<CompactString>,
pub period_type: Option<CompactString>,
pub balance: Option<CompactString>,
pub abstract_element: bool,
pub nillable: bool,
}
#[derive(Debug, Clone)]
pub struct SchemaType {
pub name: CompactString,
pub base_type: Option<CompactString>,
pub restrictions: Vec<TypeRestriction>,
}
#[derive(Debug, Clone)]
pub enum TypeRestriction {
MinInclusive(String),
MaxInclusive(String),
MinExclusive(String),
MaxExclusive(String),
Pattern(String),
Enumeration(Vec<String>),
Length(usize),
MinLength(usize),
MaxLength(usize),
}
#[derive(Debug, Clone)]
pub struct SchemaImport {
pub namespace: CompactString,
pub schema_location: CompactString,
}
// Linkbase support
#[derive(Debug, Clone)]
pub struct Linkbase {
pub role: CompactString,
pub links: Vec<Link>,
}
#[derive(Debug, Clone)]
pub enum Link {
Presentation(PresentationLink),
Calculation(CalculationLink),
Definition(DefinitionLink),
Label(LabelLink),
Reference(ReferenceLink),
}
#[derive(Debug, Clone)]
pub struct PresentationLink {
pub from: CompactString,
pub to: CompactString,
pub order: f32,
pub priority: Option<i32>,
pub use_attribute: Option<CompactString>,
}
#[derive(Debug, Clone)]
pub struct CalculationLink {
pub from: CompactString,
pub to: CompactString,
pub weight: f64,
pub order: f32,
}
#[derive(Debug, Clone)]
pub struct DefinitionLink {
pub from: CompactString,
pub to: CompactString,
pub arcrole: CompactString,
pub order: f32,
}
#[derive(Debug, Clone)]
pub struct LabelLink {
pub concept: CompactString,
pub label: CompactString,
pub role: CompactString,
pub lang: CompactString,
}
#[derive(Debug, Clone)]
pub struct ReferenceLink {
pub concept: CompactString,
pub reference: Reference,
}
#[derive(Debug, Clone)]
pub struct Reference {
pub role: CompactString,
pub parts: HashMap<CompactString, String>,
}
// Main document structure with full XBRL support
#[derive(Clone)]
pub struct Document {
pub facts: FactStorage,
pub contexts: Vec<Context>,
pub units: Vec<Unit>,
pub tuples: Vec<Tuple>,
pub footnotes: Vec<Footnote>,
pub presentation_links: Vec<PresentationLink>,
pub calculation_links: Vec<CalculationLink>,
pub definition_links: Vec<DefinitionLink>,
pub label_links: Vec<LabelLink>,
pub reference_links: Vec<ReferenceLink>,
pub custom_links: Vec<Link>,
pub role_types: Vec<CompactString>,
pub arcrole_types: Vec<CompactString>,
pub schemas: Vec<Schema>,
pub dimensions: Vec<DimensionMember>,
pub concept_names: Vec<CompactString>,
}
impl Default for Document {
fn default() -> Self {
Self::new()
}
}
impl Document {
pub fn new() -> Self {
Self {
facts: FactStorage::with_capacity(10000),
contexts: Vec::with_capacity(100),
units: Vec::with_capacity(50),
tuples: Vec::new(),
footnotes: Vec::new(),
presentation_links: Vec::new(),
calculation_links: Vec::new(),
definition_links: Vec::new(),
label_links: Vec::new(),
reference_links: Vec::new(),
custom_links: Vec::new(),
role_types: Vec::new(),
arcrole_types: Vec::new(),
schemas: Vec::new(),
dimensions: Vec::new(),
concept_names: Vec::new(),
}
}
pub fn with_capacity(facts: usize, contexts: usize, units: usize) -> Self {
Self {
facts: FactStorage::with_capacity(facts),
contexts: Vec::with_capacity(contexts),
units: Vec::with_capacity(units),
tuples: Vec::new(),
footnotes: Vec::new(),
presentation_links: Vec::new(),
calculation_links: Vec::new(),
definition_links: Vec::new(),
label_links: Vec::new(),
reference_links: Vec::new(),
custom_links: Vec::new(),
role_types: Vec::new(),
arcrole_types: Vec::new(),
schemas: Vec::new(),
dimensions: Vec::new(),
concept_names: Vec::new(),
}
}
}

98
src/simple_parser.rs Normal file
View File

@@ -0,0 +1,98 @@
//! Simple working XBRL parser
use crate::{model::*, Result};
use compact_str::CompactString;
use std::path::Path;
pub struct Parser {
#[allow(dead_code)]
load_linkbases: bool,
}
impl Parser {
pub fn new() -> Self {
Self {
load_linkbases: false,
}
}
pub fn parse_file<P: AsRef<Path>>(&self, path: P) -> Result<Document> {
let content = std::fs::read(path)?;
self.parse_bytes(&content)
}
pub fn parse_bytes(&self, data: &[u8]) -> Result<Document> {
// Simple XML parsing - just count elements for now
let text = String::from_utf8_lossy(data);
// Count facts (very simplified)
let fact_count = text.matches("<us-gaap:").count() +
text.matches("<dei:").count() +
text.matches("<ifrs:").count();
// Count contexts
let context_count = text.matches("<context ").count() +
text.matches("<xbrli:context").count();
// Count units
let unit_count = text.matches("<unit ").count() +
text.matches("<xbrli:unit").count();
// Create dummy document with approximate counts
let mut doc = Document {
facts: FactStorage {
concept_ids: vec![0; fact_count],
context_ids: vec![0; fact_count],
unit_ids: vec![0; fact_count],
values: vec![FactValue::Text(CompactString::new("")); fact_count],
decimals: vec![None; fact_count],
ids: vec![None; fact_count],
footnote_refs: vec![],
},
contexts: Vec::with_capacity(context_count),
units: Vec::with_capacity(unit_count),
tuples: Vec::new(),
footnotes: Vec::new(),
presentation_links: Vec::new(),
calculation_links: Vec::new(),
definition_links: Vec::new(),
label_links: Vec::new(),
reference_links: Vec::new(),
custom_links: Vec::new(),
role_types: Vec::new(),
arcrole_types: Vec::new(),
schemas: Vec::new(),
dimensions: Vec::new(),
concept_names: Vec::new(),
};
// Add dummy contexts
for i in 0..context_count {
doc.contexts.push(Context {
id: CompactString::new(&format!("ctx{}", i)),
entity: Entity {
identifier: CompactString::new("0000000000"),
scheme: CompactString::new("http://www.sec.gov/CIK"),
segment: None,
},
period: Period::Instant {
date: CompactString::new("2023-12-31"),
},
scenario: None,
});
}
// Add dummy units
for i in 0..unit_count {
doc.units.push(Unit {
id: CompactString::new(&format!("unit{}", i)),
unit_type: UnitType::Simple(vec![Measure {
namespace: CompactString::new("iso4217"),
name: CompactString::new("USD"),
}]),
});
}
Ok(doc)
}
}

561
src/validator.rs Normal file
View File

@@ -0,0 +1,561 @@
// Comprehensive XBRL validation
use crate::{model::*, Result, Error};
use std::collections::HashSet;
#[derive(Debug, Clone)]
pub enum ValidationError {
InvalidContextRef { fact_index: usize, context_id: u16 },
InvalidUnitRef { fact_index: usize, unit_id: u16 },
CalculationInconsistency { concept: String, expected: f64, actual: f64 },
InvalidDataType { concept: String, expected_type: String, actual_value: String },
MissingRequiredElement { element: String },
DuplicateId { id: String },
}
pub struct XbrlValidator {
strict_mode: bool,
#[allow(dead_code)]
check_calculations: bool,
check_duplicates: bool,
check_contexts: bool,
check_units: bool,
#[allow(dead_code)]
check_datatypes: bool,
decimal_tolerance: f64,
}
impl XbrlValidator {
pub fn new() -> Self {
Self {
strict_mode: false,
check_calculations: true,
check_duplicates: true,
check_contexts: true,
check_units: true,
check_datatypes: true,
decimal_tolerance: 0.01,
}
}
pub fn strict(mut self) -> Self {
self.strict_mode = true;
self
}
pub fn with_tolerance(mut self, tolerance: f64) -> Self {
self.decimal_tolerance = tolerance;
self
}
pub fn validate(&self, doc: &mut Document) -> Result<()> {
let mut validation_errors = Vec::new();
// Context validation
if self.check_contexts {
validation_errors.extend(self.validate_contexts(doc));
}
// Unit validation
if self.check_units {
validation_errors.extend(self.validate_units(doc));
}
// Fact validation
validation_errors.extend(self.validate_facts(doc));
// Duplicate detection
if self.check_duplicates {
validation_errors.extend(self.check_duplicate_facts(doc));
}
// Return error in strict mode if any validation errors
if self.strict_mode && !validation_errors.is_empty() {
return Err(Error::Validation(format!(
"Validation failed with {} errors",
validation_errors.len()
)));
}
Ok(())
}
fn validate_contexts(&self, doc: &Document) -> Vec<ValidationError> {
let mut errors = Vec::new();
let mut context_ids = HashSet::new();
for ctx in &doc.contexts {
// Check for duplicate context IDs
if !context_ids.insert(ctx.id.clone()) {
errors.push(ValidationError::DuplicateId {
id: ctx.id.to_string(),
});
}
// Validate entity identifier
if ctx.entity.identifier.is_empty() {
errors.push(ValidationError::MissingRequiredElement {
element: format!("Entity identifier for context {}", ctx.id),
});
}
// Validate period
match &ctx.period {
Period::Duration { start, end } => {
if start > end {
errors.push(ValidationError::InvalidDataType {
concept: format!("context_{}", ctx.id),
expected_type: "valid period".to_string(),
actual_value: format!("start {} > end {}", start, end),
});
}
}
_ => {}
}
}
errors
}
fn validate_units(&self, doc: &Document) -> Vec<ValidationError> {
let mut errors = Vec::new();
let mut unit_ids = HashSet::new();
for unit in &doc.units {
// Check for duplicate unit IDs
if !unit_ids.insert(unit.id.clone()) {
errors.push(ValidationError::DuplicateId {
id: unit.id.to_string(),
});
}
// Validate measures
match &unit.unit_type {
UnitType::Simple(measures) => {
if measures.is_empty() {
errors.push(ValidationError::MissingRequiredElement {
element: format!("Measures for unit {}", unit.id),
});
}
}
UnitType::Divide { numerator, denominator } => {
if numerator.is_empty() || denominator.is_empty() {
errors.push(ValidationError::MissingRequiredElement {
element: format!("Numerator/denominator for unit {}", unit.id),
});
}
}
UnitType::Multiply(measures) => {
if measures.is_empty() {
errors.push(ValidationError::MissingRequiredElement {
element: format!("Measures for unit {}", unit.id),
});
}
}
}
}
errors
}
fn validate_facts(&self, doc: &Document) -> Vec<ValidationError> {
let mut errors = Vec::new();
// Validate fact references
for i in 0..doc.facts.len() {
if i < doc.facts.context_ids.len() {
let context_id = doc.facts.context_ids[i];
if context_id as usize >= doc.contexts.len() {
errors.push(ValidationError::InvalidContextRef {
fact_index: i,
context_id,
});
}
}
if i < doc.facts.unit_ids.len() {
let unit_id = doc.facts.unit_ids[i];
if unit_id > 0 && unit_id as usize > doc.units.len() {
errors.push(ValidationError::InvalidUnitRef {
fact_index: i,
unit_id,
});
}
}
}
errors
}
fn check_duplicate_facts(&self, doc: &Document) -> Vec<ValidationError> {
let mut errors = Vec::new();
let mut fact_keys = HashSet::new();
for i in 0..doc.facts.len() {
if i < doc.facts.concept_ids.len() && i < doc.facts.context_ids.len() {
let key = (doc.facts.concept_ids[i], doc.facts.context_ids[i]);
if !fact_keys.insert(key) && self.strict_mode {
errors.push(ValidationError::DuplicateId {
id: format!("Duplicate fact at index {}", i),
});
}
}
}
errors
}
}
// Validation context and rules
pub struct ValidationContext {
pub profile: ValidationProfile,
pub custom_rules: Vec<Box<dyn Fn(&Document) -> Vec<ValidationError>>>,
}
#[derive(Debug, Clone, Copy)]
pub enum ValidationProfile {
Generic,
SecEdgar,
Ifrs,
UsGaap,
}
impl ValidationContext {
pub fn new(profile: ValidationProfile) -> Self {
Self {
profile,
custom_rules: Vec::new(),
}
}
pub fn add_rule<F>(&mut self, rule: F)
where
F: Fn(&Document) -> Vec<ValidationError> + 'static
{
self.custom_rules.push(Box::new(rule));
}
pub fn validate(&self, doc: &Document) -> Vec<ValidationError> {
let mut errors = Vec::new();
// Apply profile-specific rules
match self.profile {
ValidationProfile::SecEdgar => {
errors.extend(sec_validation_rules(doc));
}
ValidationProfile::Ifrs => {
errors.extend(ifrs_validation_rules(doc));
}
_ => {}
}
// Apply custom rules
for rule in &self.custom_rules {
errors.extend(rule(doc));
}
errors
}
}
// SEC EDGAR specific validation rules
pub fn sec_validation_rules(doc: &Document) -> Vec<ValidationError> {
let mut errors = Vec::new();
// Check for required DEI contexts
let mut has_current_period = false;
let mut has_entity_info = false;
let mut has_dei_elements = false;
for ctx in &doc.contexts {
// Check for current period context
if ctx.id.contains("CurrentYear") || ctx.id.contains("CurrentPeriod") ||
ctx.id.contains("DocumentPeriodEndDate") {
has_current_period = true;
}
// Validate CIK format (10 digits)
if ctx.entity.scheme.contains("sec.gov/CIK") {
has_entity_info = true;
let cik = &ctx.entity.identifier;
if cik.len() != 10 || !cik.chars().all(|c| c.is_ascii_digit()) {
errors.push(ValidationError::InvalidDataType {
concept: "CIK".to_string(),
expected_type: "10-digit number".to_string(),
actual_value: cik.to_string(),
});
}
}
}
// Check for DEI elements in facts
for i in 0..doc.facts.concept_ids.len() {
if i < doc.concept_names.len() {
let concept = &doc.concept_names[i];
if concept.contains("dei:") || concept.contains("DocumentType") ||
concept.contains("EntityRegistrantName") {
has_dei_elements = true;
}
}
}
// Required elements validation
if !has_current_period {
errors.push(ValidationError::MissingRequiredElement {
element: "Current period context required for SEC filing".to_string(),
});
}
if !has_entity_info {
errors.push(ValidationError::MissingRequiredElement {
element: "Entity CIK information required for SEC filing".to_string(),
});
}
if !has_dei_elements {
errors.push(ValidationError::MissingRequiredElement {
element: "DEI (Document and Entity Information) elements required".to_string(),
});
}
// Validate segment reporting if present
for ctx in &doc.contexts {
if let Some(segment) = &ctx.entity.segment {
// Check explicit members have valid dimension references
for member in &segment.explicit_members {
if member.dimension.is_empty() || member.member.is_empty() {
errors.push(ValidationError::InvalidDataType {
concept: format!("segment_{}", ctx.id),
expected_type: "valid dimension member".to_string(),
actual_value: format!("{}:{}", member.dimension, member.member),
});
}
}
}
}
// Validate calculation consistency for monetary items
let mut monetary_facts: Vec<(usize, f64)> = Vec::new();
for i in 0..doc.facts.len() {
if i < doc.facts.values.len() {
if let FactValue::Decimal(val) = &doc.facts.values[i] {
// Check if this is a monetary fact (has USD unit)
if i < doc.facts.unit_ids.len() {
let unit_id = doc.facts.unit_ids[i] as usize;
if unit_id < doc.units.len() {
if let UnitType::Simple(measures) = &doc.units[unit_id].unit_type {
if measures.iter().any(|m| m.name == "USD" || m.name == "usd") {
monetary_facts.push((i, *val));
}
}
}
}
}
}
}
// Basic calculation validation - check for reasonable values
for (idx, value) in monetary_facts {
if value.is_nan() || value.is_infinite() {
errors.push(ValidationError::InvalidDataType {
concept: format!("fact_{}", idx),
expected_type: "valid monetary amount".to_string(),
actual_value: format!("{}", value),
});
}
// Check for suspiciously large values (> $10 trillion)
if value.abs() > 10_000_000_000_000.0 {
errors.push(ValidationError::InvalidDataType {
concept: format!("fact_{}", idx),
expected_type: "reasonable monetary amount".to_string(),
actual_value: format!("${:.2}", value),
});
}
}
errors
}
// IFRS specific validation rules
pub fn ifrs_validation_rules(doc: &Document) -> Vec<ValidationError> {
let mut errors = Vec::new();
// Check for IFRS-required contexts
let mut has_reporting_period = false;
let mut has_comparative_period = false;
let mut has_entity_info = false;
for ctx in &doc.contexts {
// Check for reporting period
match &ctx.period {
Period::Duration { start, end: _ } => {
has_reporting_period = true;
// IFRS requires comparative information
if start.contains("PY") || ctx.id.contains("PriorYear") ||
ctx.id.contains("Comparative") {
has_comparative_period = true;
}
}
Period::Instant { date } => {
if !date.is_empty() {
has_reporting_period = true;
}
}
_ => {}
}
// Validate entity information
if !ctx.entity.identifier.is_empty() {
has_entity_info = true;
}
}
// Required contexts validation
if !has_reporting_period {
errors.push(ValidationError::MissingRequiredElement {
element: "Reporting period required for IFRS filing".to_string(),
});
}
if !has_comparative_period {
errors.push(ValidationError::MissingRequiredElement {
element: "Comparative period information required by IFRS".to_string(),
});
}
if !has_entity_info {
errors.push(ValidationError::MissingRequiredElement {
element: "Entity identification required for IFRS filing".to_string(),
});
}
// Validate dimensional structure
let mut dimension_validations = Vec::new();
for ctx in &doc.contexts {
// Check segment dimensions
if let Some(segment) = &ctx.entity.segment {
for member in &segment.explicit_members {
// IFRS dimensions should follow specific patterns
if !member.dimension.contains(":") {
dimension_validations.push(format!("Invalid dimension format: {}", member.dimension));
}
if member.dimension.contains("ifrs") || member.dimension.contains("ifrs-full") {
// Valid IFRS dimension
if member.member.is_empty() {
errors.push(ValidationError::InvalidDataType {
concept: format!("dimension_{}", ctx.id),
expected_type: "valid IFRS dimension member".to_string(),
actual_value: member.dimension.to_string(),
});
}
}
}
// Check typed members for IFRS compliance
for typed in &segment.typed_members {
if typed.dimension.contains("ifrs") && typed.value.is_empty() {
errors.push(ValidationError::InvalidDataType {
concept: format!("typed_dimension_{}", ctx.id),
expected_type: "non-empty typed dimension value".to_string(),
actual_value: typed.dimension.to_string(),
});
}
}
}
// Check scenario dimensions (alternative to segment)
if let Some(scenario) = &ctx.scenario {
for member in &scenario.explicit_members {
if member.dimension.contains("ifrs") && member.member.is_empty() {
errors.push(ValidationError::InvalidDataType {
concept: format!("scenario_dimension_{}", ctx.id),
expected_type: "valid IFRS scenario member".to_string(),
actual_value: member.dimension.to_string(),
});
}
}
}
}
// Check for mandatory IFRS disclosures in facts
let mut has_financial_position = false;
let mut has_comprehensive_income = false;
let mut has_cash_flows = false;
let mut has_changes_in_equity = false;
for i in 0..doc.concept_names.len() {
let concept = &doc.concept_names[i];
let lower = concept.to_lowercase();
if lower.contains("financialposition") || lower.contains("balancesheet") ||
lower.contains("assets") || lower.contains("liabilities") {
has_financial_position = true;
}
if lower.contains("comprehensiveincome") || lower.contains("profitorloss") ||
lower.contains("income") || lower.contains("revenue") {
has_comprehensive_income = true;
}
if lower.contains("cashflow") || lower.contains("cashflows") {
has_cash_flows = true;
}
if lower.contains("changesinequity") || lower.contains("equity") {
has_changes_in_equity = true;
}
}
// Validate mandatory statements
if !has_financial_position {
errors.push(ValidationError::MissingRequiredElement {
element: "Statement of Financial Position required by IFRS".to_string(),
});
}
if !has_comprehensive_income {
errors.push(ValidationError::MissingRequiredElement {
element: "Statement of Comprehensive Income required by IFRS".to_string(),
});
}
if !has_cash_flows {
errors.push(ValidationError::MissingRequiredElement {
element: "Statement of Cash Flows required by IFRS".to_string(),
});
}
if !has_changes_in_equity {
errors.push(ValidationError::MissingRequiredElement {
element: "Statement of Changes in Equity required by IFRS".to_string(),
});
}
// Validate presentation linkbase relationships
for link in &doc.presentation_links {
// Check order is valid (typically 1.0 to 999.0)
if link.order < 0.0 || link.order > 1000.0 {
errors.push(ValidationError::InvalidDataType {
concept: format!("presentation_link_{}_{}", link.from, link.to),
expected_type: "valid presentation order (0-1000)".to_string(),
actual_value: format!("{}", link.order),
});
}
}
// Validate calculation relationships
for link in &doc.calculation_links {
// Check weight is reasonable (-1.0 or 1.0 typically)
if link.weight != 1.0 && link.weight != -1.0 && link.weight != 0.0 {
// Unusual weight, might be an error
if link.weight.abs() > 10.0 {
errors.push(ValidationError::InvalidDataType {
concept: format!("calculation_link_{}_{}", link.from, link.to),
expected_type: "reasonable calculation weight".to_string(),
actual_value: format!("{}", link.weight),
});
}
}
}
errors
}