# pytermgui file_loaders reference — YAML/JSON style files

## Metadata

| Field | Value |
|---|---|
| Institute | Molodetz Institute — Research & Retrieval Division |
| Subject | tui-framework-design |
| Document type | Source Dossier |
| Tier | 1 |
| Source title | pytermgui file_loaders reference — config, markup, and widget files |
| Source URL | https://ptg.bczsalba.com/reference/pytermgui/file_loaders/ |
| Source publisher / author | bczsalba (pytermgui project) |
| Source type | vendor docs |
| Source date (published) | Unknown — not stated |
| Date researched | 2026-10-11 |
| Researched by | tai (agent), model: Muse Spark, on behalf of retoor |
| Research method | direct page fetch |
| Confidence | Medium |
| Status | Active |

## Summary

A thin source with one finding: pytermgui loads YAML/JSON config, markup, and widget files through its `file_loaders` module, runnable via `ptg -f`. It exists here as the file-based-override precedent tai explicitly defers.

## Key findings

- YAML/JSON files define config, markup styles, and widget trees, loaded via the `file_loaders` module and runnable with `ptg -f`.

## Pros / strengths

- Shows file-based style overrides composing with a palette system with no registry changes.

## Cons / limitations / caveats

- Thin source: the merge semantics between file styles and the active palette were not part of the inspected evidence.

## Relevance to tai

- Precedent behind the palette-role conclusion's deferred file-override design (a partial role dict from TOML/JSON merged over a named theme, if ever added).

## Changelog

| Date | Change |
|---|---|
| 2026-10-11 | Initial dossier created from 2026-10-11 research-pass evidence (body opened via web_fetch by researching agent). |