Use when a Pkl file imports hyphenated filenames - an `as` alias is required; the pklr (Rust) evaluator lacks import/spread support so use the pkl binary with `HK_PKL_BACKEND=pkl`.
When splitting pkl config into shared modules, filenames with hyphens (e.g., hk-common.pkl) MUST use an as alias in the import statement. Pkl treats hyphens in identifiers as syntax errors. Additionally, the pklr (Rust) pkl evaluator does NOT support import or spread (...) syntax at all — you must use the pkl binary.
The hk.pkl split (PR #42) created hk-common.pkl for shared checks. Initial attempts to import "hk-common.pkl" without an alias, or using pklr as the backend, produced cryptic evaluation failures with no clear error message pointing to the import.
HK_PKL_BACKEND=pklr and import/spread syntaxas aliasimport "hk-common.pkl" as commonHK_PKL_BACKEND=pkl (not pklr) when using import/spreadhk validate after any pkl config changesHK_PKL_BACKEND=pkl in mise.toml, ci.yml, mise-system.toml, AND chezmoi templates// WRONG — hyphen in implicit identifier
import "hk-common.pkl"
// WRONG — pklr doesn't support import
// HK_PKL_BACKEND=pklr
// RIGHT
import "hk-common.pkl" as common
// HK_PKL_BACKEND=pkl
hooks { ["pre-commit"] { steps { ...common.hygiene } } }