Skip to main content

Module syntax

Module syntax 

Source
Expand description

Syntax-level types absorbed from Wave D satellite crates. Syntax-level types and utilities absorbed from Wave D satellite crates.

This module contains the internal implementations of AST-adjacent utilities that were previously published as separate satellite crates. They are now internal modules of perl-parser-core.

§Visibility pattern

  • error is an internal submodule exposed via engine::error (and root-level re-exports like ParseError, ParseOutput, error_classifier).
  • edit and heredoc are re-exported at crate root under their own names (syntax::edit, heredoc_collector).
  • path_normalize, path_security, percentile, qualified_name, source_file, and text_line are re-exported directly at crate root so consumers use perl_parser_core::path_normalize etc.
  • quote is only accessed via engine::quote_parser to keep quote-parsing concerns encapsulated behind the engine boundary.

Modules§

edit
Edit tracking for incremental parsing (previously perl-edit). Edit tracking for incremental parsing
error
Error types, classification, and recovery strategies (previously perl-error). Error types for the Perl parser within the Perl parsing workflow pipeline
heredoc
Heredoc collector and processor (previously perl-heredoc). Heredoc collector and processor for Perl.
path_normalize
Secure workspace-relative path normalization (previously perl-path-normalize). Secure workspace-relative path normalization.
path_security
Workspace-bound path validation and traversal prevention (previously perl-path-security). Workspace-bound path validation and traversal prevention.
percentile
Percentile helpers for integer metric samples (previously perl-percentile). Percentile helpers for integer metric samples (previously perl-percentile).
qualified_name
Perl qualified-name parsing, splitting, and validation helpers (previously perl-qualified-name). Focused helpers for Perl qualified-name parsing and validation (previously perl-qualified-name).
quote
Quote operator parsing helpers (previously perl-quote). Uniform quote operator parsing for the Perl parser.
source_file
Perl source-file classification helpers (previously perl-source-file). Shared Perl source-file classification helpers.
text_line
Text-line cursor and boundary helpers (previously perl-text-line). Text-line cursor helpers.