zig/pugz

Files

Ankit Patial dd2191829d fix: flush static buffer in conditionals and correct helpers import path

- Flush static buffer at end of each conditional branch (if/else/else-if)
  to ensure content is rendered inside the correct blocks
- Add helpers_path parameter to zig_codegen.generate() for correct
  relative imports in nested directories (e.g., '../helpers.zig')
- Fix build.zig to use correct CLI path (src/tpl_compiler/main.zig)
- Export zig_codegen from root.zig for CLI module usage

Bump version to 0.3.11

2026-01-30 22:59:47 +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: flush static buffer in conditionals and correct helpers import path

2026-01-30 22:59:47 +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!