zig/pugz

Files

Ankit Patial 5ce319b335 Fix mixin expansion in conditionals and include resolution in extends

- mixin.zig: expandNode and expandNodeWithArgs now recurse into
  node.consequent and node.alternate for Conditional nodes
- view_engine.zig: process includes and collect mixins from child
  template before extracting blocks in processExtends

This fixes mixin calls inside if/else blocks not being rendered
in compiled templates.

2026-01-30 22:24:27 +05:30

public/css

fix: add scoped error logging for lexer/parser errors

2026-01-25 17:10:02 +05:30

src

feat: add @TypeOf type hints for compiled templates

2026-01-28 22:31:24 +05:30

views

Fix mixin expansion in conditionals and include resolution in extends

2026-01-30 22:24:27 +05:30

build.zig

- demo build fix.

2026-01-28 19:38:59 +05:30

build.zig.zon

fix: add scoped error logging for lexer/parser errors

2026-01-25 17:10:02 +05:30

README.md

Genearte .zig verions of templates to use in production.

2026-01-28 17:01:28 +05:30

README.md

Pugz Demo App

A comprehensive e-commerce demo showcasing Pugz template engine capabilities.

Features

Template inheritance (extends/block)
Partial includes (header, footer)
Mixins with parameters (product-card, rating, forms)
Conditionals and loops
Data binding
Pretty printing

Running the Demo

Option 1: Runtime Templates (Default)

cd examples/demo
zig build run

Then visit http://localhost:5882 in your browser.

Option 2: Compiled Templates (Experimental)

Compiled templates offer maximum performance by pre-compiling templates to Zig functions at build time.

Note: Compiled templates currently have some code generation issues and are disabled by default.

To try compiled templates:

Compile templates:

# From demo directory
./compile_templates.sh

# Or manually from project root
cd ../..
zig build demo-compile-templates

This generates compiled templates in generated/root.zig

Enable in code:
- Open src/main.zig
- Set USE_COMPILED_TEMPLATES = true
Build and run:
```
zig build run
```

The build.zig automatically detects if generated/ exists and includes the templates module.

Template Structure

views/
├── layouts/          # Layout templates
│   └── base.pug
├── pages/            # Page templates
│   ├── home.pug
│   ├── products.pug
│   ├── cart.pug
│   └── ...
├── partials/         # Reusable partials
│   ├── header.pug
│   ├── footer.pug
│   └── head.pug
├── mixins/           # Reusable components
│   ├── product-card.pug
│   ├── buttons.pug
│   ├── forms.pug
│   └── ...
└── includes/         # Other includes
    └── ...

Known Issues with Compiled Templates

The template code generation (src/tpl_compiler/zig_codegen.zig) has some bugs:

helpers.zig import paths need to be relative
Double quotes being escaped incorrectly in string literals
Field names with dots causing syntax errors
Some undefined variables in generated code

These will be fixed in a future update. For now, runtime templates work perfectly!