fix: add scoped error logging for lexer/parser errors

- Add std.log.scoped(.pugz) to template.zig and view_engine.zig
- Log detailed error info (code, line, column, message) when parsing fails
- Log template path context in ViewEngine on parse errors
- Remove debug print from lexer, use proper scoped logging instead
- Move benchmarks, docs, examples, playground, tests out of src/ to project root
- Update build.zig and documentation paths accordingly
- Bump version to 0.3.1

examples/demo/views/pages/about.pug

@@ -0,0 +1,53 @@
+extends layouts/base.pug
+
+block title
+  title #{title} | Pugz Store
+
+block content
+  section.page-header
+    .container
+      h1 About Pugz
+      p A Pug template engine written in Zig
+
+  section.section
+    .container
+      .about-grid
+        .about-main
+          h2 What is Pugz?
+          p Pugz is a high-performance Pug template engine implemented in Zig. It provides both runtime interpretation and build-time compilation for maximum flexibility.
+
+          h3 Key Features
+          ul.feature-list
+            li Template inheritance with extends and blocks
+            li Partial includes for modular templates
+            li Mixins for reusable components
+            li Conditionals (if/else/unless)
+            li Iteration with each loops
+            li Variable interpolation
+            li Pretty-printed output
+            li LRU caching with TTL
+
+          h3 Performance
+          p Compiled templates run approximately 3x faster than Pug.js, with zero runtime parsing overhead.
+
+        .about-sidebar
+          .info-card
+            h3 This Demo Shows
+            ul
+              li Template inheritance (extends)
+              li Named blocks
+              li Conditional rendering
+              li Variable interpolation
+              li Simple iteration
+
+          .info-card
+            h3 Links
+            ul
+              li
+                a(href="https://github.com/ankitpatial/pugz") GitHub Repository
+              li
+                a(href="/products") View Products
+              li
+                a(href="/include-demo") Include Demo
+              li
+                a(href="/") Back to Home