ravenous_typst/setup/analysis/around_target_audit.typ

424 lines
14 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// Audit every wording that places an effect "around" a central target so the
// inclusion or exclusion of that target can be reviewed directly.
#import "../generation/radar_graphs.typ": school-sources
#import "origin_metrics.typ": origin-sources
#import "report_style.typ": report-theme
#import "../theme/tables.typ" as tables
#let normalized(text) = lower(text).replace("’", "'")
#let alteration-names = {
let names = ()
for entry in yaml("/data/src/glossaries/alterations.yaml") {
if type(entry.short) == str { names.push(lower(entry.short)) }
}
names
}
#let aoe-wording(text) = {
let value = normalized(text)
// This audit is deliberately narrower than the general AoE audit: it only
// concerns areas explicitly described in relation to something at their
// centre. A mere range ("dans un rayon de 15 m") is not an AoE wording.
(
value.find(regex("autours?(?: de| du| des| d')")) != none
and value.find(regex("zone|rayon|toutes? les cibles|aire d'effet")) != none
)
}
#let has-central-target(text) = {
normalized(text).find(regex("autours? de (?:la|cette|votre|sa) cible")) != none
}
#let explicitly-excludes-center(text) = {
normalized(text).find(regex(
"(?:à l'exception de|excepté|excepte|hormis) (?:la|cette|votre|sa) cible|(?:toutes? les )?autres cibles",
)) != none
}
#let explicitly-includes-center(text) = {
let value = normalized(text)
value.find(regex("(?:incluant|y compris) (?:cette dernière|la cible|celle-ci)")) != none
}
#let explicit-test-characteristic(text) = {
let value = normalized(text)
value.find(regex(
"#cr\\.[a-z]+|@ca_torque|test (?:de |d[' ])(?:force|agilité|agilite|perception|psyché|psyche|intelligence|volonté|volonte|chance|charisme|torque)",
)) != none
}
#let glossary-backed-test(text) = {
let value = normalized(text)
if value.find(regex(
"@al_[a-z_]+|#gls\\(|#marques?\\(|altérations?[^.;]{0,100}liée?s? à[^.;]{0,50}(?:éléments?|dégâts)",
)) != none {
return true
}
for name in alteration-names {
if name in value and ("test de " + name) not in value {
return true
}
}
false
}
#let non-test-difficulty(text) = {
let value = normalized(text)
value.find(regex(
"résistance|resistance|plus difficile de [^.;]{0,15}\\(#ddlvl|(?:bonus|malus|gagne|gagnent|augmentez?|augmenté(?:e|es|s)?|diminué(?:e|es|s)?|difficultée?) (?:de |à |aux? )?[^.;]{0,45}\\(#ddlvl|\\(#ddlvl[^.;]{0,55}(?:(?:à|au|aux) (?:toutes? )?(?:tests?|altérations?|seuils?)|supplémentaires?|maximum)|(?:niveau|rareté|rarete|supérieure?|inférieure?|camouflé|camoufle|ne pouvez gagner que)[^.;]{0,45}\\(#ddlvl",
)) != none
}
// Return each bare difficulty with the local clause that gives it meaning.
#let naked-test-signals(text) = {
let signals = ()
for found in text.matches(regex("\\(#ddlvl\\([^)]*\\)\\)")) {
let prefix = text.slice(0, found.start)
let clause = prefix.split(regex(";|\\.\\s")) .last().trim()
let suffix = text.slice(found.end).split(regex(";|\\.\\s")).first()
let local = clause + " " + found.text + suffix
if (
not explicit-test-characteristic(local)
and not glossary-backed-test(local)
and not non-test-difficulty(local)
) {
signals.push(clause + " " + found.text)
}
}
signals
}
#let radius-includes-center(text) = {
let value = normalized(text)
value.find(regex("dans un rayon[^.;]{0,80}autours?(?: de| du| des| d')")) != none
}
#let lists-targets-in-area(text) = {
normalized(text).find(regex(
"toutes? les (?:cibles|personnes|créatures|creatures|chasseurs)|tout chasseur",
)) != none
}
#let excluded-radius-wording(text) = {
(
explicitly-excludes-center(text)
or (
lists-targets-in-area(text)
and not explicitly-includes-center(text)
and not radius-includes-center(text)
)
)
}
#let unclear-area-targets(text) = {
let value = normalized(text)
(
not lists-targets-in-area(text)
and not explicitly-includes-center(text)
and not radius-includes-center(text)
and value.find(regex("inflig(?:e|ez|ent|é|és|ée|ées)[^.;]{0,160}(?:dans|sur) une zone")) != none
)
}
// Only flag imperative "choisissez … parmi(s)" clauses. Other occurrences of
// "choisir", "choix" or "parmi" are intentionally outside this audit.
#let mandatory-choice-signals(text) = {
let signals = ()
for found in text.matches(regex(
"(?i)(?:choisissez|choissisez|choissicez)[^.;—]{0,120}(?:parmi|parmis)",
)) {
let prefix = text.slice(0, found.start).split(regex("[.;—]")) .last()
if normalized(prefix).find(regex("vous pouvez[^.;]{0,80}$")) == none {
signals.push(found.text)
}
}
signals
}
#let school-records() = {
let records = ()
for (school, source) in school-sources {
let rows = csv(source, delimiter: "\t")
let header-index = rows.position(row => "Technique" in row)
if header-index == none { continue }
let header = rows.at(header-index)
let name-index = header.position(value => value.trim() == "Technique")
let effect-index = header.position(value => value.trim() == "Effet")
for row in rows.slice(header-index + 1) {
if name-index >= row.len() or effect-index >= row.len() { continue }
let name = row.at(name-index).trim()
let effect = row.at(effect-index).trim()
if name != "" and aoe-wording(effect) {
records.push((source: "École · " + school, name: name, text: effect))
}
}
}
records
}
#let origin-records() = {
let records = ()
for origin in origin-sources {
let data = yaml(origin.source)
for stage in data.stades {
for ability in stage.abilities {
let effect = ability.at("description", default: "")
if aoe-wording(effect) {
records.push((
source: "Origine · " + origin.family,
name: ability.at("name", default: "Capacité sans nom"),
text: effect,
))
}
}
}
}
records
}
#let glossary-records() = {
let records = ()
for source in (
"/data/src/glossaries/alterations.yaml",
"/data/src/glossaries/creature.yaml",
) {
for entry in yaml(source) {
let effect = entry.at("description", default: "")
if aoe-wording(effect) {
records.push((
source: if "alterations" in source { "Altération" } else { "Effet de créature" },
name: entry.short,
text: effect,
))
}
}
}
records
}
#let school-naked-test-records() = {
let records = ()
for (school, source) in school-sources {
let rows = csv(source, delimiter: "\t")
let header-index = rows.position(row => "Technique" in row)
if header-index == none { continue }
let header = rows.at(header-index)
let name-index = header.position(value => value.trim() == "Technique")
let effect-index = header.position(value => value.trim() == "Effet")
for row in rows.slice(header-index + 1) {
if name-index >= row.len() or effect-index >= row.len() { continue }
let name = row.at(name-index).trim()
let effect = row.at(effect-index).trim()
if name == "" { continue }
for signal in naked-test-signals(effect) {
records.push((source: "École · " + school, name: name, text: signal))
}
}
}
records
}
#let origin-naked-test-records() = {
let records = ()
for origin in origin-sources {
let data = yaml(origin.source)
for stage in data.stades {
for ability in stage.abilities {
let effect = ability.at("description", default: "")
for signal in naked-test-signals(effect) {
records.push((
source: "Origine · " + origin.family,
name: ability.at("name", default: "Capacité sans nom"),
text: signal,
))
}
}
}
}
records
}
#let glossary-naked-test-records() = {
let records = ()
for source in (
"/data/src/glossaries/creature.yaml",
) {
for entry in yaml(source) {
let effect = entry.at("description", default: "")
for signal in naked-test-signals(effect) {
records.push((source: "Effet de créature", name: entry.short, text: signal))
}
}
}
records
}
#let mandatory-choice-records() = {
let records = ()
for (school, source) in school-sources {
let rows = csv(source, delimiter: "\t")
let header-index = rows.position(row => "Technique" in row)
if header-index == none { continue }
let header = rows.at(header-index)
let name-index = header.position(value => value.trim() == "Technique")
let effect-index = header.position(value => value.trim() == "Effet")
for row in rows.slice(header-index + 1) {
if name-index >= row.len() or effect-index >= row.len() { continue }
let name = row.at(name-index).trim()
let effect = row.at(effect-index).trim()
if name == "" { continue }
for signal in mandatory-choice-signals(effect) {
records.push((source: "École · " + school, name: name, text: signal))
}
}
}
for origin in origin-sources {
let data = yaml(origin.source)
for stage in data.stades {
for ability in stage.abilities {
for signal in mandatory-choice-signals(ability.at("description", default: "")) {
records.push((
source: "Origine · " + origin.family,
name: ability.at("name", default: "Capacité sans nom"),
text: signal,
))
}
}
}
}
for source in (
"/data/src/glossaries/alterations.yaml",
"/data/src/glossaries/character.yaml",
"/data/src/glossaries/classes.yaml",
"/data/src/glossaries/creature.yaml",
"/data/src/glossaries/elements.yaml",
"/data/src/glossaries/folklore.yaml",
"/data/src/glossaries/rules.yaml",
) {
for entry in yaml(source) {
for signal in mandatory-choice-signals(entry.at("description", default: "")) {
records.push((
source: "Glossaire · " + source.split("/").last().replace(".yaml", ""),
name: entry.at("short", default: entry.at("key", default: "Entrée sans nom")),
text: signal,
))
}
}
}
for signal in mandatory-choice-signals(read("/chapters/craft/restauration.typ")) {
records.push((source: "Règle · artisanat", name: "Assaisonnement", text: signal))
}
records
}
#let around-target-audit() = {
pagebreak()
heading(level: 1)[Audit rédactionnel]
heading(level: 2)[Cibles « autour » d’une cible centrale]
[Ce tableau recense uniquement les aires d’effet explicitement décrites
« autour » de quelque chose. Les portées visant une cible unique et les
zones qui ne sont pas formulées autour d’un centre sont exclues.
L’expression « dans un rayon autour de la cible » inclut la cible centrale.
La formulation plus rare « toutes les cibles autour de la cible » l’exclut,
sauf mention explicite telle que « incluant cette dernière ». Les
formulations qui déterminent clairement le traitement des cibles sont
signalées comme conformes.]
let records = school-records() + origin-records() + glossary-records()
if records.len() == 0 {
text(fill: report-theme.muted-ink)[
Aucune aire d’effet n’a été détectée.
]
} else {
let rows = records.map(record => (
record.source,
record.name,
if excluded-radius-wording(record.text) {
[Exclue (rayon)]
} else if explicitly-includes-center(record.text) {
[Incluse explicitement]
} else if radius-includes-center(record.text) {
[Incluse (rayon)]
} else if has-central-target(record.text) {
[Exclue (rayon)]
} else {
[Sans cible centrale]
},
if lists-targets-in-area(record.text) {
[Conforme]
} else if unclear-area-targets(record.text) {
[À vérifier]
} else {
[—]
},
record.text,
))
tables.set-table-style(
table(
columns: (0.7fr, 1fr, 0.72fr, 0.48fr, 2.1fr),
table.header([Source], [Effet], [Cible centrale], [Signal], [Texte détecté]),
..rows.flatten(),
),
table-theme: "steingrund",
text-size: 6.8pt,
)
}
heading(level: 2)[Tests sans caractéristique de résistance]
[Cet audit recherche les difficultés écrites sous la forme `(#ddlvl(X))`
sans caractéristique de test explicite. Les altérations et termes liés à une
entrée de glossaire sont exclus, de même que les formulations telles que
`(#cr.X — #ddlvl(X))` et les modificateurs numériques manifestes. Les
résultats restants signalent principalement des effets uniques dont la
méthode de résistance doit être précisée.]
let naked = school-naked-test-records() + origin-naked-test-records() + glossary-naked-test-records()
if naked.len() == 0 {
text(fill: report-theme.muted-ink)[
Aucun test dépourvu de caractéristique n’a été détecté.
]
} else {
let rows = naked.map(record => (
record.source,
record.name,
record.text,
))
tables.set-table-style(
table(
columns: (0.9fr, 1.2fr, 2.8fr),
table.header([Source], [Effet], [Test détecté]),
..rows.flatten(),
),
table-theme: "steingrund",
text-size: 6.8pt,
)
}
heading(level: 2)[Choix formulés comme obligatoires]
[Cet audit signale uniquement les formulations « choisissez … parmi(s) »
qui ne sont pas précédées de « vous pouvez ». Les autres mentions de choix
ne sont pas affichées.]
let choices = mandatory-choice-records()
if choices.len() == 0 {
text(fill: report-theme.muted-ink)[
Aucune formulation « choisissez … parmi(s) » non optionnelle n’a été détectée.
]
} else {
let rows = choices.map(record => (record.source, record.name, record.text))
tables.set-table-style(
table(
columns: (0.9fr, 1.2fr, 2.8fr),
table.header([Source], [Effet ou règle], [Formulation détectée]),
..rows.flatten(),
),
table-theme: "steingrund",
text-size: 6.8pt,
)
}
}