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/mixins/alerts.pug

@@ -0,0 +1,12 @@
+//- Alert/notification mixins
+
+mixin alert(message, type)
+  - var alertClass = type ? "alert alert-" + type : "alert alert-info"
+  .alert(class=alertClass)
+    p= message
+
+mixin alert-dismissible(message, type)
+  - var alertClass = type ? "alert alert-" + type : "alert alert-info"
+  .alert.alert-dismissible(class=alertClass)
+    p= message
+    button.alert-close(type="button" aria-label="Close") x

examples/demo/views/mixins/buttons.pug

@@ -0,0 +1,15 @@
+//- Button mixins with various styles
+
+mixin btn(text, type)
+  - var btnClass = type ? "btn btn-" + type : "btn btn-primary"
+  button(class=btnClass)= text
+
+mixin btn-link(href, text, type)
+  - var btnClass = type ? "btn btn-" + type : "btn btn-primary"
+  a(href=href class=btnClass)= text
+
+mixin btn-icon(icon, text, type)
+  - var btnClass = type ? "btn btn-" + type : "btn btn-primary"
+  button(class=btnClass)
+    span.icon= icon
+    span= text

examples/demo/views/mixins/cart-item.pug

@@ -0,0 +1,17 @@
+//- Cart item display
+
+mixin cart-item(item)
+  .cart-item
+    .cart-item-image
+      img(src=item.image alt=item.name)
+    .cart-item-details
+      h4.cart-item-name #{item.name}
+      p.cart-item-variant #{item.variant}
+      span.cart-item-price $#{item.price}
+    .cart-item-quantity
+      button.qty-btn.qty-minus -
+      input.qty-input(type="number" value=item.quantity min="1")
+      button.qty-btn.qty-plus +
+    .cart-item-total
+      span $#{item.total}
+    button.cart-item-remove(aria-label="Remove item") x

examples/demo/views/mixins/forms.pug

@@ -0,0 +1,25 @@
+//- Form input mixins
+
+mixin input(name, label, type, placeholder)
+  .form-group
+    label(for=name)= label
+    input.form-control(type=type id=name name=name placeholder=placeholder)
+
+mixin input-required(name, label, type, placeholder)
+  .form-group
+    label(for=name)
+      = label
+      span.required *
+    input.form-control(type=type id=name name=name placeholder=placeholder required)
+
+mixin select(name, label, options)
+  .form-group
+    label(for=name)= label
+    select.form-control(id=name name=name)
+      each opt in options
+        option(value=opt.value)= opt.label
+
+mixin textarea(name, label, placeholder, rows)
+  .form-group
+    label(for=name)= label
+    textarea.form-control(id=name name=name placeholder=placeholder rows=rows)

examples/demo/views/mixins/product-card.pug

@@ -0,0 +1,38 @@
+//- Product card mixin - displays a product in grid/list view
+//- Parameters:
+//-   product: { id, name, price, image, rating, category }
+
+mixin product-card(product)
+  article.product-card
+    a.product-image(href="/products/" + product.id)
+      img(src=product.image alt=product.name)
+      if product.sale
+        span.badge.badge-sale Sale
+    .product-info
+      span.product-category #{product.category}
+      h3.product-name
+        a(href="/products/" + product.id) #{product.name}
+      .product-rating
+        +rating(product.rating)
+      .product-footer
+        span.product-price $#{product.price}
+        button.btn.btn-primary.btn-sm(data-product=product.id) Add to Cart
+
+//- Featured product card with larger display
+mixin product-featured(product)
+  article.product-card.product-featured
+    .product-image-large
+      img(src=product.image alt=product.name)
+      if product.sale
+        span.badge.badge-sale Sale
+    .product-details
+      span.product-category #{product.category}
+      h2.product-name #{product.name}
+      p.product-description #{product.description}
+      .product-rating
+        +rating(product.rating)
+        span.review-count (#{product.reviewCount} reviews)
+      .product-price-large $#{product.price}
+      .product-actions
+        button.btn.btn-primary.btn-lg Add to Cart
+        button.btn.btn-outline Wishlist

examples/demo/views/mixins/rating.pug

@@ -0,0 +1,13 @@
+//- Star rating display
+//- Parameters:
+//-   stars: number of stars (1-5)
+
+mixin rating(stars)
+  .stars
+    - var i = 1
+    while i <= 5
+      if i <= stars
+        span.star.star-filled
+      else
+        span.star.star-empty
+      - i = i + 1