1.2.0-alpha.3
Templar 1.2.0-alpha.3
Section titled “Templar 1.2.0-alpha.3”1.2.0-alpha.3 is the packaged validation candidate for Templar’s persistence, recovery, and custom-CSS safety remediation. It keeps the production note and template format at version 1 while making supported migrations in memory and protecting data that this plugin version cannot safely interpret.
What changed
Section titled “What changed”- Blocks custom CSS that can escape the virtual page subtree or make essentially every note descendant unreadable through broad transparency, typography, clipping, or zero-geometry rules.
- Makes automatic Style Rule writes compare-and-swap safe. If a note changes after the rule observed it as unstyled, the automatic write is skipped rather than replacing newer data.
- Restores explicit Batch Apply behavior: valid current styles can be intentionally replaced while page options can be preserved per note. Future, malformed, and other protected data remain skipped.
- Adds recovery-backed destructive handling for protected outer note data, protected nested source snapshots, malformed/future settings, and quarantined saved templates.
- Runs supported schema migrations in memory through runtime note loading and template/pack imports without silently persisting a read-time upgrade.
- Adds recovery confirmations, truthful post-write warnings, atomic multi-template removal, template-literal interpolation scanning in the runtime policy checker, and renderer lifecycle/performance coverage.
Automated verification
Section titled “Automated verification”The exact alpha.3 candidate was verified before tagging with:
- ESLint and all runtime, test, and tooling TypeScript checks.
- 47 Vitest files / 259 tests, including 8 integration files / 19 integration tests.
- V8 coverage: 54.46% statements and lines, 79.23% branches, and 78.33% functions.
- Production build, mobile-bundle guard, runtime privacy-policy guard, release metadata verifier, BRAT contract verifier, dependency audits (zero vulnerabilities), and the full benchmark matrix including PageRenderer workloads.
The tagged release workflow independently rebuilds with Node 20, verifies the asset checksums and BRAT contract, and publishes only main.js, manifest.json, styles.css, and SHA256SUMS.txt.
Validation still required before beta
Section titled “Validation still required before beta”This alpha release is intentionally the package under test for the beta promotion matrix. The following are not claimed by this release note and must be recorded against its downloaded artifacts before beta promotion:
- BRAT clean-vault install, frozen-tag, update, deep-link, and reinstall behavior.
- Upgrade from the previous alpha with styled notes, templates, rules, settings, and source snapshots.
- Desktop Reading View, Live Preview, multiple-leaf, popout, page-mode, content, and print checks.
- Manual recovery, automatic-rule race, Batch Apply, and adversarial CSS sanity checks.
- Interactive mobile/emulation coverage and any physical-device results.
Installation and feedback
Section titled “Installation and feedback”Install through BRAT with K0g1/Templar, or download the three plugin files from this release into <vault>/.obsidian/plugins/templar/. Back up important notes before testing prerelease software. When reporting a compatibility problem, include the Templar version, Obsidian version, operating system/device, view mode, exact steps, and whether the note contains existing templar frontmatter.
Known limitations
Section titled “Known limitations”Templar remains a prerelease plugin. Its package-level beta validation matrix is still in progress at this alpha tag; physical iOS and Android results are not yet represented by this release note. Custom CSS intentionally supports only the documented virtual page selectors and may reject broad rules even when a host browser would accept them.