AtlatestRepositorysigil-doc
1
#!/usr/bin/env bash2
set -euo pipefail4
repo_dir="$(cd "$(dirname "$0")/.." && pwd)"5
cd "$repo_dir"6
sigil="${SIGIL_D1_COMPILER:-$repo_dir/../task-sigil-language-readers/build/dev/bin/sigil}"7
redirects="${SIGIL_D1_REDIRECTS:-$repo_dir/dev-redirects.sgl}"8
sigil_sxml_root="${SIGIL_SXML_ROOT:-$repo_dir/../sigil-sxml}"9
typst_bin="${TYPST_BIN:-typst}"10
pdfinfo_bin="${PDFINFO_BIN:-pdfinfo}"11
pdftotext_bin="${PDFTOTEXT_BIN:-pdftotext}"12
pdftoppm_bin="${PDFTOPPM_BIN:-pdftoppm}"13
qpdf_bin="${QPDF_BIN:-qpdf}"14
convert_bin="${CONVERT_BIN:-convert}"15
sha256sum_bin="${SHA256SUM_BIN:-sha256sum}"16
mkdir -p "$repo_dir/build"17
gate_dir="$(mktemp -d "$repo_dir/build/d6-gate.XXXXXX")"18
export XDG_CACHE_HOME="$gate_dir/cache"19
export SIGIL_REDIRECTS="$redirects"20
export SIGIL_D1_COMPILER="$sigil"21
export SIGIL_BYTECODE_BASE="${SIGIL_BYTECODE_BASE:-$(test/build-d3-bytecode-base.sh)}"22
export SOURCE_DATE_EPOCH=024
for tool in "$typst_bin" "$pdfinfo_bin" "$pdftotext_bin" "$pdftoppm_bin" \25
"$qpdf_bin" "$convert_bin" "$sha256sum_bin"; do26
command -v "$tool" >/dev/null27
done28
"$typst_bin" --version | tee "$gate_dir/toolchain.txt"29
"$pdfinfo_bin" -v 2>&1 | head -1 | tee -a "$gate_dir/toolchain.txt"30
"$qpdf_bin" --version | head -1 | tee -a "$gate_dir/toolchain.txt"31
echo D6_GATE_01_PINNED_EXISTING_TOOLCHAIN33
"$sigil" -L "$sigil_sxml_root/src" -L src test test/test-print.sgl --report \34
| tee "$gate_dir/print-tests.txt"35
rg -q '5 passed' "$gate_dir/print-tests.txt"36
echo D6_GATE_02_NEUTRAL_ADAPTER_PASSIVITY_HIGHLIGHTING_5_538
generate_book() {39
local stem="$1"40
"$sigil" -L src -L book tools/build-practical-sigil-print.sgl "$gate_dir/$stem.typ"41
"$typst_bin" compile --root "$repo_dir" --creation-timestamp 0 --pdf-standard a-2b \42
--jobs 1 "$gate_dir/$stem.typ" "$gate_dir/$stem.pdf"43
}44
generate_book practical-a45
generate_book practical-b46
cmp "$gate_dir/practical-a.typ" "$gate_dir/practical-b.typ"47
cmp "$gate_dir/practical-a.pdf" "$gate_dir/practical-b.pdf"48
"$sha256sum_bin" "$gate_dir/practical-a.typ" "$gate_dir/practical-b.typ" \49
"$gate_dir/practical-a.pdf" "$gate_dir/practical-b.pdf" | tee "$gate_dir/reproducible-hashes.txt"50
echo D6_GATE_03_REPRODUCIBLE_SOURCE_AND_PDF_BYTES52
"$sigil" -L src test/build-d6-change-control.sgl "$gate_dir/changed.typ"53
"$typst_bin" compile --root "$repo_dir" --creation-timestamp 0 --pdf-standard a-2b \54
--jobs 1 "$gate_dir/changed.typ" "$gate_dir/changed.pdf"55
# Change-control assertions must be `if cmp; then fail`, never a bare `! cmp`56
# -- bash exempts `!`-inverted commands from `set -e`, so the bare form could57
# never fail: a build that IGNORED its input would have passed (inert 2026-08-24).58
if cmp -s "$gate_dir/practical-a.typ" "$gate_dir/changed.typ"; then59
echo 'D6 change control: changed input produced an IDENTICAL .typ' >&260
exit 161
fi62
if cmp -s "$gate_dir/practical-a.pdf" "$gate_dir/changed.pdf"; then63
echo 'D6 change control: changed input produced an IDENTICAL .pdf' >&264
exit 165
fi66
"$pdftotext_bin" "$gate_dir/changed.pdf" "$gate_dir/changed.txt"67
rg -q 'D6 changed-content witness 7391' "$gate_dir/changed.txt"68
echo D6_GATE_03B_CONTENT_CHANGE_INVALIDATES_SOURCE_AND_PDF70
"$pdfinfo_bin" "$gate_dir/practical-a.pdf" >"$gate_dir/pdfinfo.txt"71
"$qpdf_bin" --check "$gate_dir/practical-a.pdf" >"$gate_dir/qpdf-check.txt" 2>&172
"$qpdf_bin" --json-key=outlines --json "$gate_dir/practical-a.pdf" >"$gate_dir/outlines.json"73
"$pdftotext_bin" -layout "$gate_dir/practical-a.pdf" "$gate_dir/practical.txt"74
rg -q '^Title:[[:space:]]+Practical Sigil$' "$gate_dir/pdfinfo.txt"75
rg -q '^Author:[[:space:]]+David Wilson$' "$gate_dir/pdfinfo.txt"76
rg -q '^Tagged:[[:space:]]+yes$' "$gate_dir/pdfinfo.txt"77
rg -q '^JavaScript:[[:space:]]+no$' "$gate_dir/pdfinfo.txt"78
rg -q 'A Useful First Script' "$gate_dir/outlines.json"79
rg -q 'Change the Question' "$gate_dir/outlines.json"80
rg -q 'Begin with a Question' "$gate_dir/outlines.json"81
rg -q 'A Useful First Script \(page 3\)' "$gate_dir/practical.txt"82
rg -q '\(string-starts-with\? line' "$gate_dir/practical.txt"83
rg -q 'Exercise: Craft a helpful failure' "$gate_dir/practical.txt"84
rg -q '^[[:space:]]*4[[:space:]]*$' "$gate_dir/practical.txt"85
echo D6_GATE_04_METADATA_BOOKMARKS_XREFS_PAGES_SEARCHABLE_TEXT87
error_xdg="$gate_dir/error-cache"88
for id in stdout expected-error; do89
XDG_CACHE_HOME="$error_xdg" SIGIL_BIN="$sigil" \90
"$sigil" -L src -L test tools/sigil-doc-verify.sgl test/fixtures/d3-examples.sgd \91
--example "$id" | tee "$gate_dir/$id-verification.txt"92
done93
rg -q 'stdout: verified' "$gate_dir/stdout-verification.txt"94
rg -q 'expected-error: verified' "$gate_dir/expected-error-verification.txt"95
D6_VERIFY_CACHE="$error_xdg/sigil-doc/verify-v1" \96
"$sigil" -L src -L test test/build-d6-pressure.sgl "$gate_dir/pressure.typ"97
test -s "$gate_dir/pressure.typ"98
"$typst_bin" compile --root "$repo_dir" --creation-timestamp 0 --pdf-standard a-2b \99
--jobs 1 "$gate_dir/pressure.typ" "$gate_dir/pressure.pdf"100
"$pdftotext_bin" -layout "$gate_dir/pressure.pdf" "$gate_dir/pressure.txt"101
rg -q 'Example: stdout' "$gate_dir/pressure.txt"102
rg -q '^Verified$' "$gate_dir/pressure.txt"103
rg -q 'Clean project verified: d3-project' "$gate_dir/pressure.txt"104
rg -q 'project-ok' "$gate_dir/pressure.txt"105
rg -q 'error: expected boom' "$gate_dir/pressure.txt"106
echo D6_GATE_05_EXACT_SPEC_TRUSTED_RESULTS_AND_AUTHENTICATED_ERROR108
"$sigil" -L src test/build-d6-passivity.sgl "$gate_dir/passivity.typ"109
"$typst_bin" compile --root "$repo_dir" --creation-timestamp 0 --pdf-standard a-2b \110
--jobs 1 "$gate_dir/passivity.typ" "$gate_dir/passivity.pdf"111
test ! -e "$repo_dir/build/d6/owned"112
"$pdftotext_bin" "$gate_dir/passivity.pdf" "$gate_dir/passivity.txt"113
rg -q '#import "https://example.invalid/evil.typ"' "$gate_dir/passivity.txt"114
rg -q '#read\("/etc/passwd"\)' "$gate_dir/passivity.txt"115
rg -q '#write\("build/d6/owned"' "$gate_dir/passivity.txt"116
echo D6_GATE_06_NO_NETWORK_SCRIPT_OR_SUBJECT_EXECUTION118
"$sigil" -L src test/build-d6-longline.sgl "$gate_dir/longline.typ"119
"$typst_bin" compile --root "$repo_dir" --creation-timestamp 0 --pdf-standard a-2b \120
--jobs 1 "$gate_dir/longline.typ" "$gate_dir/longline.pdf"121
"$pdftotext_bin" -layout "$gate_dir/longline.pdf" "$gate_dir/longline.txt"122
"$pdftotext_bin" -bbox "$gate_dir/longline.pdf" "$gate_dir/longline-bbox.html"123
rg -q "$(printf 'x%.0s' {1..88})" "$gate_dir/longline.txt"124
awk '/<word / {125
line=$0; sub(/^.*xMin="/, "", line); split(line,a,"\""); xmin=a[1]+0126
line=$0; sub(/^.*xMax="/, "", line); split(line,a,"\""); xmax=a[1]+0127
line=$0; sub(/^.*yMin="/, "", line); split(line,a,"\""); ymin=a[1]+0128
line=$0; sub(/^.*yMax="/, "", line); split(line,a,"\""); ymax=a[1]+0129
if (xmin < 0 || xmax > 612 || ymin < 0 || ymax > 792) bad=1130
} END { exit bad }' "$gate_dir/longline-bbox.html"131
"$pdftoppm_bin" -f 3 -l 3 -singlefile -png -r 120 "$gate_dir/longline.pdf" "$gate_dir/longline-code-page"132
"$pdftoppm_bin" -png -r 100 "$gate_dir/practical-a.pdf" "$gate_dir/practical-page"133
test -s "$gate_dir/longline-code-page.png"134
test -s "$gate_dir/practical-page-3.png"135
test -s "$gate_dir/practical-page-4.png"136
echo D6_GATE_07_OVERLONG_CODE_WRAPPED_BBOX_AND_RASTERS138
"$sigil" -L src test/build-d6-highlight.sgl "$gate_dir/highlight.typ"139
"$typst_bin" compile --root "$repo_dir" --creation-timestamp 0 --pdf-standard a-2b \140
--jobs 1 "$gate_dir/highlight.typ" "$gate_dir/highlight.pdf"141
"$pdftotext_bin" -layout "$gate_dir/highlight.pdf" "$gate_dir/highlight.txt"142
rg -q '; comment color witness' "$gate_dir/highlight.txt"143
rg -q 'define message "string color witness"' "$gate_dir/highlight.txt"144
rg -q 'if #t 7391 0' "$gate_dir/highlight.txt"145
"$pdftoppm_bin" -f 3 -l 3 -singlefile -png -r 160 "$gate_dir/highlight.pdf" "$gate_dir/highlight-page"146
"$convert_bin" "$gate_dir/highlight-page.png" -format %c histogram:info:- >"$gate_dir/highlight-histogram.txt"147
rg -qi '#6A737D' "$gate_dir/highlight-histogram.txt"148
rg -qi '#9C442E' "$gate_dir/highlight-histogram.txt"149
rg -qi '#6F42C1' "$gate_dir/highlight-histogram.txt"150
rg -qi '#1F6F8B' "$gate_dir/highlight-histogram.txt"151
echo D6_GATE_07B_OFFLINE_HIGHLIGHT_COPYABLE_AND_RASTER_COLORS153
# The print adapter owns neither Press routing nor any typesetter implementation.154
# Subject-existence pins: to `if rg`, a missing file (exit 2) reads as clean.155
test -f src/sigil/doc/print.sgl156
test -f src/sigil/doc/render/typst.sgl157
if rg -n -i 'press|site-nav|sitemap|robots\.txt|<html|write-pdf|line-break|font-shap|paginate' \158
src/sigil/doc/print.sgl src/sigil/doc/render/typst.sgl; then159
echo 'D6 boundary violation' >&2160
exit 1161
fi162
echo D6_GATE_08_PRESS_AND_TYPESETTING_BOUNDARY164
bash test/gate-d0.sh >"$gate_dir/d0.txt"165
bash test/gate-d1.sh >"$gate_dir/d1.txt"166
bash test/gate-d2.sh >"$gate_dir/d2.txt"167
bash test/gate-d3.sh >"$gate_dir/d3.txt"168
bash test/gate-d4a.sh >"$gate_dir/d4a.txt"169
rg -q D0_GATE_GREEN "$gate_dir/d0.txt"170
rg -q D1_GATE_GREEN "$gate_dir/d1.txt"171
rg -q D2_REAL_LANGUAGE_GREEN "$gate_dir/d2.txt"172
rg -q D3_GATE_GREEN "$gate_dir/d3.txt"173
rg -q D4A_GATE_GREEN "$gate_dir/d4a.txt"174
echo D6_GATE_09_D0_D4_REGRESSIONS_GREEN176
printf 'D6_GATE_GREEN artifacts=%s\n' "$gate_dir"