# LockerPad source and packaging

This directory contains the source that WordPress executes. There is no compilation,
minification, obfuscation, dependency download or generated JavaScript build step.
Edit the shipped files directly. Optional formatting does not generate a separate bundle.

- `lockerpad.php`: plugin loading, activation and edition-conflict handling.
- `includes/class-plugin.php`: tables, lock rendering, visitor nonces, rate limits and sessions.
- `includes/class-pages.php`: page selection, password fallback and WordPress output protection.
- `includes/class-targets.php`: page/post search and WordPress URL-path matching.
- `includes/class-admin.php`: page-lock and people forms, capability/nonce checks and saves.
- `includes/class-maintenance.php`: help, recovery notice and ending active sessions.
- `includes/class-crypto.php`: private credential key and previous-password protection only;
  there are no file-encryption/import/delivery methods in this edition.
- `includes/class-policy.php`, `class-access.php`: access format and credential verification.
- `assets/admin.js`: admin interactions, credential generation and page selection.
- `assets/vault.js`: dial and seed-word interaction. It constructs SVG dial marks at runtime;
  this is authored source, not compiled/generated code requiring another repository.
- `assets/vault-math.js`: dial movement math.
- `assets/vault-audio.js`: sounds synthesized with browser Web Audio.
- `assets/strength.js`: possible-combination counts, not an authentication guarantee.
- `assets/page.js`: visible page-session timer and lock/extension actions.
- `assets/*.css`: readable source styles; no CSS preprocessor required.
- `uninstall.php`: page-only removal with conservative legacy-data preservation.

No third-party JS/CSS libraries are bundled. Code and included assets are distributed
under GPL-2.0-or-later. Logos and product names identify ChatRep/LockerPad; no endorsement
or affiliation is conferred by redistribution.

To package: put the contents of this directory in a folder named `lockerpad`, then ZIP
that folder. Exclude OS metadata and test fixtures. The installed path must be
`wp-content/plugins/lockerpad/lockerpad.php`. No npm or other build tool is required.

Release verification records are maintained separately from the distributed plugin.
Never include test-only WordPress endpoints, SQLite adapters or test credentials in a ZIP.

2.1.0 source additions: assets/password-entry.js renders the entered password without disclosing a stored length; assets/dial-cards.js provides numeric entry and cancellable dial animation. Both are readable source, with no compilation step.
