LengthRatioRule class

Warn when a translation is suspiciously much shorter or longer than the source. Out-of-band lengths are a strong signal of a truncated translation, a swap-bug (wrong locale's text), or an AI that hallucinated extra prose.

Per-locale min, max multipliers are read from dialect.yaml:

length_ratio:
  ja: [0.4, 1.5]   # Japanese is consistently shorter
  de: [0.5, 2.8]   # German is consistently longer

Default for unlisted locales: [0.3, 2.5]. Very short source strings (< 8 columns) skip the check entirely — "OK" → "はい" is a 1x ratio that's meaningless to police.

Both sides are measured in display columns (displayColumns), the same unit width_budget uses: a Hangul or hanzi character takes two columns, so a faithful Korean translation of a long English label is not "too short" merely because it needs fewer characters.

Severity is warning. --strict-length (separate from --strict) promotes it to an error for CI gating.

Inheritance

• Object
• Rule
• LengthRatioRule

Constructors

LengthRatioRule()

const

Properties

defaultSeverity → IssueSeverity

Default severity. May be overridden per-issue.

no setter, override

hashCode → int

The hash code for this object.

no setter, inherited

name → String

Stable rule identifier (snake_case). Used by the report formatter to group findings and by users to silence/ack via state file (post-v1.0).

no setter, override

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

run(DialectProject project) → List<Issue>

Inspect project and return findings. May return an empty list. Should NOT throw — turn unexpected conditions into Issues so the report surfaces them rather than crashing.

override

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited

Constants

defaultRange → const List<double>

Default multiplier band when no per-locale override is set in dialect.yaml.

minSourceLength → const int

Source strings narrower than this (in display columns) skip the check — short strings' ratios are too noisy to be a useful signal.