=head1 NAME

PDF::Make - zero-dependency PDF builder / editor / extractor

=head1 SYNOPSIS

    use PDF::Make;
    print PDF::Make::version;   # "0.01"

=head1 STATUS

Alpha. Phase 01 (foundation) only. The full roadmap lives in F<plan/> --
start at F<plan/README.md>. Each phase has its own file with scope, a todo
list, and acceptance criteria.

=head1 DESCRIPTION

C<PDF::Make> is a from-scratch PDF implementation for the Semantic
ecosystem. The engine is a pure-C library (C<libpdfmake>); this module is a
thin Perl + XS binding.

The design target is a single self-contained library that can:

=over 4

=item * build PDFs from scratch (writer, fonts, content streams, images)

=item * open existing PDFs (parser, xref, filters)

=item * extract text with coordinates per glyph / word / line / block

=item * edit existing PDFs (add/remove/reorder pages, annotations,
incremental updates)

=item * read and write encrypted PDFs (RC4, AES)

=back

...with no runtime dependencies. DEFLATE, RC4, AES, JPEG parsing, TrueType
embedding, etc., are all implemented from scratch in C.

=head1 BUILDING

    perl Makefile.PL
    make
    make test
    make install

C<make test> runs the libpdfmake C tests (under F<tests/c/>) and then the
Perl test suite (F<t/>).

=head1 PLATFORMS

Darwin is the primary target. Linux and the BSDs must build. Windows is
best-effort.

=head1 SEE ALSO

L<Object::Proto>, L<Chandra>.

=head1 AUTHOR

LNATION E<lt>email@lnation.orgE<gt>

=head1 LICENSE

This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

=cut
