.gitattributes

# Line endings are normalised to LF in the repository, on every platform.
#
# This file exists rather than relying on a global config setting, because the
# rule has to travel with the repository. A machine with different settings
# still produces the right commits.
#
# Verify with the command below. The INDEX column is the half that decides what
# a commit contains, and every tracked text file should read i/lf:
#
#   git ls-files --eol
#
# The working-tree column is not uniform and does not need to be. A file written
# by an editor that did not read this file will disagree until it is next
# checked out, and produces no git diff because the index is LF on both sides.

* text=auto eol=lf

*.md            text eol=lf
*.txt           text eol=lf
*.json          text eol=lf
*.jsonc         text eol=lf
*.yml           text eol=lf
*.yaml          text eol=lf
*.toml          text eol=lf
*.xml           text eol=lf
*.html          text eol=lf
*.css           text eol=lf
*.sql           text eol=lf
*.sh            text eol=lf
*.mjs           text eol=lf
*.js            text eol=lf
*.ts            text eol=lf
.gitignore      text eol=lf
.gitattributes  text eol=lf
.editorconfig   text eol=lf
.githooks/*     text eol=lf

# PowerShell is the one exception, and it is not a preference. Windows
# PowerShell 5.1 mis-parses a here-string whose terminator arrives with a bare
# LF, so these keep CRLF in the working tree.
#
# A second 5.1 requirement lives in the FILE rather than here: a .ps1 with any
# non-ASCII byte needs a UTF-8 BOM, because 5.1 decodes a BOM-less file as the
# system ANSI code page. `text` does not touch a BOM, so the two rules coexist.
# docs/conventions/shell.md section 8.
*.ps1           text eol=crlf
*.psm1          text eol=crlf
*.psd1          text eol=crlf

# Batch files are read by cmd.exe, which wants CRLF.
*.bat           text eol=crlf
*.cmd           text eol=crlf

# Anything whose exact bytes are the content. Changing one byte changes what
# the file IS, so no translation may be applied. The names tiles, the dumps and
# the packed indexes this project handles are binary by construction.
*.png           binary
*.jpg           binary
*.jpeg          binary
*.gif           binary
*.webp          binary
*.ico           binary
*.pdf           binary
*.zip           binary
*.gz            binary
*.bz2           binary
*.xz            binary
*.zst           binary
*.7z            binary
*.tar           binary
*.parquet       binary
*.avro          binary
*.snappy        binary
*.bin           binary
*.wasm          binary
*.woff          binary
*.woff2         binary

# The packs the verifier's tests commit (packages/pack/test/verify): DPK1 parts
# and indexes, whose names (clean.part.000, clean.idx) carry no extension above.
# verify.test.ts holds them to the records of synthetic.ts, the SHA-256 of their
# raw blocks and their byte length, so a translated byte fails it.
packages/pack/test/verify/*.idx     binary
packages/pack/test/verify/*.part.*  binary

# Generated and noisy in a diff. Collapsed in review, still tracked.
package-lock.json   linguist-generated=true