Luigit
repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by admin

pi/agent/skills/optional/qml/README.md

Raw
Rendered preview

qml

A concise workflow for correct QML and Qt Quick state, geometry, interaction, accessibility, and validation. It is toolkit-neutral beyond Qt's standard modules.

Contents

  • SKILL.md: workflow and invariants
  • references/: focused guidance by concern
  • examples/: seven standard-library QML entry points

Validation

From this directory:

for file in examples/*/*.qml; do qmllint "$file"; done
for file in examples/*/*.qml; do
    QT_QPA_PLATFORM=offscreen timeout 3s qml6 "$file"
done

qmllint performs static analysis. A clean offscreen startup followed by timeout status 124 confirms that a window entry point imported and instantiated without a reported runtime failure. It does not verify rendered appearance or interaction.

The examples have not undergone pointer, keyboard, focus-traversal, accessibility-tree, animation, or visual-regression testing unless a separate test report says so.

Use the repository's Qt version, import paths, and runner when they differ from these standalone examples.

# qml

A concise workflow for correct QML and Qt Quick state, geometry, interaction, accessibility, and validation.
It is toolkit-neutral beyond Qt's standard modules.

## Contents

- `SKILL.md`: workflow and invariants
- `references/`: focused guidance by concern
- `examples/`: seven standard-library QML entry points

## Validation

From this directory:

```sh
for file in examples/*/*.qml; do qmllint "$file"; done
for file in examples/*/*.qml; do
    QT_QPA_PLATFORM=offscreen timeout 3s qml6 "$file"
done
```

`qmllint` performs static analysis.
A clean offscreen startup followed by timeout status `124` confirms that a window entry point imported and instantiated without a reported runtime failure.
It does not verify rendered appearance or interaction.

The examples have not undergone pointer, keyboard, focus-traversal, accessibility-tree, animation, or visual-regression testing unless a separate test report says so.

Use the repository's Qt version, import paths, and runner when they differ from these standalone examples.