breadkit-lint 0.1.0 → 0.2.0

data/lib/guard/breadkit/templates/Guardfile

@@ -0,0 +1,7 @@
+require "guard/breadkit"
+
+guard :breadkit, files: ["circuits"] do
+  watch(%r{^circuits/.*\.bk\.(?:rb|ya?ml|toml|json)$})
+  watch(%r{^parts/.*\.ya?ml$})
+  watch(".bklint.yml")
+end

data/lib/guard/breadkit.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "guard/plugin"
+require "breadkit/lint"
+
+module Guard
+  class Breadkit < Plugin
+    def run_all
+      lint(Array(options.fetch(:files, ["."])))
+    end
+
+    def run_on_changes(paths)
+      return if paths.empty?
+
+      circuits = paths.select { |path| path.match?(/\.bk\.(?:rb|ya?ml|toml|json)\z/) && File.file?(path) }
+      lint(circuits.length == paths.length ? circuits : Array(options.fetch(:files, ["."])))
+    end
+
+    private
+
+    def lint(paths)
+      throw :task_has_failed unless ::Breadkit::Lint::CLI.new.run(Array(options[:args]) + paths).zero?
+      true
+    end
+  end
+end

data/locales/en.yml

@@ -4,25 +4,107 @@ rules:
   Layout/UnknownPart: The part definition is not available.
   Layout/UnknownTransistorModel: The transistor model is unknown and a generic pinout is used.
   Layout/UnknownPin: A component pin reference does not exist.
+  Layout/UnknownSupplySource: The selected source is not a provided power output.
+  Layout/AmbiguousSupplySource: The selected source matches multiple provided power outputs.
   Layout/UnknownOption: A component option is not recognized.
+  Layout/InvalidOption: A component option value is invalid.
+  Layout/InvalidValue: A component value is invalid.
+  Layout/InvalidColor: A component or wire color is invalid.
+  Layout/InvalidRoute: A wire route is invalid.
+  Layout/InvalidWireId: A wire ID conflicts with a board hole.
+  Layout/UnmatchedParts: A part glob matches no files.
+  Layout/PartOverride: A custom part overrides a built-in part.
+  Lint/RedundantDisable: A lint_disable matches no offense.
   Layout/UnplacedPin: A component pin has no board hole.
   Layout/DuplicateRef: A component or wire identifier is repeated.
   Layout/InvalidPlacement: A component footprint does not fit the board.
   Layout/HoleConflict: More than one lead occupies the same hole.
+  Layout/HoleCovered: A module or DIP body covers another lead or wire endpoint.
+  Layout/BodyOverlap: Two component bodies overlap.
   Layout/NoFreeHole: Automatic placement could not find a free hole.
   Layout/SplitNetLabel: A label names disconnected nets.
   Layout/PinsInSameStrip: Two pins of one component share a conductive strip.
   Electrical/ShortCircuit: Power constraints produce inconsistent voltages.
   Electrical/ShortedComponent: A two-pin component is bypassed.
   Electrical/FloatingPin: A component pin has no external connection.
+  Electrical/MissingPullResistor: A supply-switched input has no modeled pull resistor.
   Electrical/DanglingWire: A wire end has no other connection.
   Electrical/SplitRail: A used segment of a split rail has no supply.
   Electrical/MissingSeriesResistor: An LED has an unprotected path across a supply.
+  Electrical/MinimumResistance: A potentiometer can reach zero resistance in an LED current path.
   Electrical/ReversePolarity: A polarized part is connected backwards.
   Electrical/PowerPinUnconnected: An IC power or ground pin is not connected to a supply.
   Electrical/SupplyVoltageRange: An IC supply voltage is outside its rated range.
   Electrical/NoCommonGround: Power supplies do not share a ground.
+  Electrical/VoltageDomainMismatch: A signal exceeds a pin's voltage limit.
+  Electrical/I2CAddressConflict: I2C devices on one bus use the same address.
+  Electrical/I2CPullupMissing: An I2C bus line has no modeled pull-up resistor.
+  Electrical/MissingDecouplingCapacitor: A powered IC has no modeled capacitor across its supply pins.
+  Electrical/MissingBaseResistor: A declared output drives a transistor base without a series resistor.
+  Electrical/MissingFlybackDiode: An explicitly inductive load has no reverse flyback diode.
+  Electrical/SupplyOverload: A modeled load exceeds its supply current limit.
+  Electrical/GpioOvercurrent: A modeled output current exceeds a pin's declared limit.
   Electrical/NetLabelConflict: Different labels name one net.
   Intent/ConnectionMismatch: Wiring differs from declared expectations.
   Intent/UnknownNet: An expectation refers to an unknown net.
+  Intent/MeasurementUnavailable: A requested DC value cannot be calculated.
   Style/WireColor: A wire color differs from the supply color convention.
+guidance:
+  Lint/RedundantDisable: Remove the unused lint_disable or correct its rule and target.
+  Lint/UnknownRuleInDisable: Check the rule ID with bklint --list-rules.
+  Layout/InvalidHole: Use a hole ID present on the selected board.
+  Layout/UnknownBoard: Choose an available board or load a definition with use_boards.
+  Layout/UnknownPart: Check the part ID or load its definition with use_parts.
+  Layout/UnknownTransistorModel: Confirm the physical pinout and define the exact model.
+  Layout/UnknownPin: Use a pin name or number from the part definition.
+  Layout/UnknownSupplySource: Select a pin declared as a power output in the part definition.
+  Layout/AmbiguousSupplySource: Give each power output in the part definition a unique positive pin.
+  Layout/UnknownOption: Use an attribute declared by the part definition.
+  Layout/InvalidOption: Choose a permitted value for the part attribute.
+  Layout/InvalidValue: Check the digits and units of the component value.
+  Layout/InvalidColor: Use a CSS color name, hex color, rgb(), or hsl().
+  Layout/InvalidRoute: Choose a supported wire route.
+  Layout/InvalidWireId: Choose a wire ID that cannot be mistaken for a hole ID.
+  Layout/UnmatchedParts: Check the use_parts path and file pattern.
+  Layout/PartOverride: Verify the pinout and attributes of the overridden part.
+  Layout/UnplacedPin: Place each required pin in a board hole.
+  Layout/DuplicateRef: Give each component, wire, and supply a unique ID.
+  Layout/InvalidPlacement: Check the footprint, board edges, and center gap.
+  Layout/HoleConflict: Place only one lead in each hole.
+  Layout/HoleCovered: Move the lead or wire endpoint to a hole outside the module body.
+  Layout/BodyOverlap: Move the parts so their physical bodies do not overlap.
+  Layout/WireOverIC: Route the wire around the IC body if it must remain visible.
+  Layout/LeadSpan: Move the leads closer or choose a part with sufficient lead length.
+  Layout/NoFreeHole: Use an unoccupied hole on the intended strip or rail.
+  Layout/SplitNetLabel: Connect nets sharing the same label with a wire.
+  Layout/PinsInSameStrip: Place the component pins on different conductive strips.
+  Electrical/ShortCircuit: Inspect the reported path and supply terminals for the short.
+  Electrical/ShortedComponent: Connect the two terminals of the part to separate nets.
+  Electrical/FloatingPin: Connect the pin or mark it unused when intentionally left open.
+  Electrical/FloatingInput: Add a pull resistor or connect the input to a modeled output.
+  Electrical/MissingPullResistor: Add a fixed pull resistor so the input has a defined open-switch state.
+  Electrical/DanglingWire: Connect both wire ends to a component, supply, or another wire.
+  Electrical/SplitRail: Bridge the two reported holes with a wire.
+  Electrical/MissingSeriesResistor: Add a current-limiting resistor in series with the LED.
+  Electrical/MinimumResistance: Add a fixed resistor in series with the LED and potentiometer.
+  Electrical/RailPolarityMismatch: Check the supply terminals against the rail polarity marks.
+  Electrical/ReversePolarity: "Check part polarity and voltage; declare intentional reverse bias with bias: :reverse."
+  Electrical/PowerPinUnconnected: Connect power and ground pins to the appropriate supply nets.
+  Electrical/SupplyVoltageRange: Keep the IC supply voltage within its declared rating.
+  Electrical/NoCommonGround: Share a ground reference where the circuit requires one.
+  Electrical/VoltageDomainMismatch: Use a level shifter or divider to keep the signal within the pin rating.
+  Electrical/ResistorPowerRating: Choose a higher-rated resistor or reduce its dissipation.
+  Electrical/CapacitorVoltageRating: Choose a capacitor rated above the applied voltage.
+  Electrical/LedOvercurrent: Add or increase a series resistor to stay below the LED current limit.
+  Electrical/GpioOvercurrent: Reduce the load to stay below the output pin current limit.
+  Electrical/I2CAddressConflict: Change one device address or use a separate I2C bus.
+  Electrical/I2CPullupMissing: Add fixed pull-up resistors from SDA and SCL to the appropriate supply.
+  Electrical/MissingDecouplingCapacitor: Place a decoupling capacitor across the IC power and ground pins.
+  Electrical/MissingBaseResistor: Add a series resistor between the output and transistor base.
+  Electrical/MissingFlybackDiode: Connect a reverse-biased diode across the inductive load.
+  Electrical/SupplyOverload: Reduce the load or use a supply with sufficient current capacity.
+  Electrical/NetLabelConflict: Resolve the conflicting labels on the same net.
+  Intent/ConnectionMismatch: Align the expect declaration with actual wires and net labels.
+  Intent/UnknownNet: Check the net or pin name used by the expect declaration.
+  Intent/MeasurementUnavailable: Connect a grounded source and supported passive parts, or use a circuit simulator.
+  Style/WireColor: Use red or orange for positive voltage and black or blue for ground, or configure the convention.

data/locales/ja.yml

@@ -4,39 +4,148 @@ rules:
   Layout/UnknownPart: パーツ定義が見つかりません。
   Layout/UnknownTransistorModel: トランジスタの型番が不明なため汎用ピン配置を使用します。
   Layout/UnknownPin: 指定した部品ピンが存在しません。
+  Layout/UnknownSupplySource: 指定した電源元は電源出力として定義されていません。
+  Layout/AmbiguousSupplySource: 指定した電源元に複数の電源出力が一致します。
   Layout/UnknownOption: 指定した部品オプションが存在しません。
+  Layout/InvalidOption: 部品オプションの値が無効です。
+  Layout/InvalidValue: 部品の値が無効です。
+  Layout/InvalidColor: 部品またはワイヤの色が無効です。
+  Layout/InvalidRoute: ワイヤの経路指定が無効です。
+  Layout/InvalidWireId: ワイヤ ID が穴の名前と衝突しています。
+  Layout/UnmatchedParts: 部品定義の指定に一致するファイルがありません。
+  Layout/PartOverride: カスタム部品が組み込み部品を上書きしました。
+  Lint/RedundantDisable: lint_disable が指摘を抑制していません。
+  Lint/UnknownRuleInDisable: lint_disable に不明なルール名があります。
   Layout/UnplacedPin: 部品ピンがボードの穴に配置されていません。
   Layout/DuplicateRef: 部品記号またはワイヤ ID が重複しています。
   Layout/InvalidPlacement: 部品の配置がボードに収まりません。
   Layout/HoleConflict: 同じ穴に複数のリードが挿されています。
+  Layout/HoleCovered: モジュールやDIP本体の下に別の端子やワイヤがあります。
+  Layout/BodyOverlap: 部品の本体同士が重なっています。
+  Layout/WireOverIC: 直線のジャンパー線が DIP IC の本体上を通っています。
+  Layout/LeadSpan: 配置した穴の間隔が部品のリード長の上限を超えています。
   Layout/NoFreeHole: 自動配置できる空き穴がありません。
   Layout/SplitNetLabel: 同じラベルが接続されていない複数のネットに付いています。
   Layout/PinsInSameStrip: 同じ部品の複数ピンが同一ストリップに接続しています。
   Electrical/ShortCircuit: 電源間の電位に矛盾があります。
   Electrical/ShortedComponent: 2端子部品が迂回されています。
   Electrical/FloatingPin: 部品ピンが外部に接続されていません。
+  Electrical/FloatingInput: 入力ネットに駆動源やプル抵抗が定義されていません。
+  Electrical/MissingPullResistor: 電源へ切り替える入力にプル抵抗がありません。
   Electrical/DanglingWire: ワイヤの端が他の要素に接続されていません。
   Electrical/SplitRail: 分断された電源レールの一部に電源がありません。
   Electrical/MissingSeriesResistor: LED に電流制限抵抗がありません。
+  Electrical/MinimumResistance: LED の電流制限に使う可変抵抗が 0 Ω になり得ます。
+  Electrical/RailPolarityMismatch: 電源の正負端子がレールの極性表示と逆に接続されています。
   Electrical/ReversePolarity: 有極性部品が逆向きに接続されています。
   Electrical/PowerPinUnconnected: IC の電源ピンまたは GND ピンが電源につながっていません。
   Electrical/SupplyVoltageRange: IC の電源電圧が定格範囲外です。
   Electrical/NoCommonGround: 複数の電源で GND が共通化されていません。
+  Electrical/VoltageDomainMismatch: 信号の電圧がピンの許容範囲を超えています。
+  Electrical/ResistorPowerRating: 抵抗の推定消費電力が指定された定格を超えています。
+  Electrical/CapacitorVoltageRating: 電解コンデンサの推定電圧が指定された定格を超えています。
+  Electrical/LedOvercurrent: LED の推定電流が指定された上限を超えています。
+  Electrical/GpioOvercurrent: 出力ピンの推定電流が指定された上限を超えています。
+  Electrical/I2CAddressConflict: 同じ I2C バス上でアドレスが重複しています。
+  Electrical/I2CPullupMissing: I2C バスの信号線にプルアップ抵抗がありません。
+  Electrical/MissingDecouplingCapacitor: IC の電源ピン間にデカップリングコンデンサがありません。
+  Electrical/MissingBaseResistor: 出力ピンとトランジスタのベース間に直列抵抗がありません。
+  Electrical/MissingFlybackDiode: 誘導負荷の両端に逆向きのフライバックダイオードがありません。
+  Electrical/SupplyOverload: 電源の供給電流が指定した上限を超えています。
   Electrical/NetLabelConflict: 同じネットに異なる名前が付いています。
   Intent/ConnectionMismatch: 宣言した接続と実際の配線が異なります。
   Intent/UnknownNet: 宣言で参照したネットが見つかりません。
+  Intent/MeasurementUnavailable: 指定した直流電圧または電流を計算できません。
   Style/WireColor: 電源レールの慣例とワイヤ色が異なります。
+guidance:
+  Lint/RedundantDisable: lint_disable の対象とルール名を確認し、使われていない指定を削除してください。
+  Lint/UnknownRuleInDisable: bklint --list-rules でルール名を確認してください。不明な名前では指摘を抑制できません。
+  Layout/InvalidHole: 指定したボードに存在する穴 ID を使用してください。
+  Layout/UnknownBoard: board で使用可能なボード名を指定するか、use_boards で定義を読み込んでください。
+  Layout/UnknownPart: 部品名を確認するか、use_parts で定義を読み込んでください。
+  Layout/UnknownTransistorModel: 型番別のピン配置を定義するか、実物のピン配置を確認してください。
+  Layout/UnknownPin: 部品定義にあるピン名または番号を指定してください。
+  Layout/UnknownSupplySource: 部品定義の電源出力ピンを指定してください。
+  Layout/AmbiguousSupplySource: 部品定義の各電源出力に一意の正極ピンを指定してください。
+  Layout/UnknownOption: 部品定義にある属性名を指定してください。
+  Layout/InvalidOption: 属性に許可された値を指定してください。
+  Layout/InvalidValue: 抵抗やコンデンサの値を有効な単位表記で指定してください。
+  Layout/InvalidColor: CSS の色名、16進色、rgb()、hsl() のいずれかを指定してください。
+  Layout/InvalidRoute: 対応しているワイヤ経路を指定してください。
+  Layout/InvalidWireId: 穴 ID と紛らわしくないワイヤ ID を指定してください。
+  Layout/UnmatchedParts: use_parts のパスとファイル名を確認してください。
+  Layout/PartOverride: 上書きした部品のピン配置と属性を確認してください。
+  Layout/UnplacedPin: 必要なピンをボードの穴に配置してください。
+  Layout/DuplicateRef: 部品、ワイヤ、電源に固有の ID を指定してください。
+  Layout/InvalidPlacement: 部品のフットプリントと中央の溝を確認してください。
+  Layout/HoleConflict: 1つの穴に挿すリードを1本にしてください。
+  Layout/HoleCovered: モジュールの外側にある穴へ端子やワイヤを移してください。
+  Layout/BodyOverlap: 部品本体が重ならないように配置を変えてください。
+  Layout/WireOverIC: 本体上を通さない場合は、ジャンパー線の経路を IC の外側に変更してください。
+  Layout/LeadSpan: ピン間の穴を近づけるか、十分なリード長の部品を選んでください。
+  Layout/NoFreeHole: 同じストリップまたはレールの空き穴を使用してください。
+  Layout/SplitNetLabel: 同じラベルを付けたネットをワイヤで接続してください。
+  Layout/PinsInSameStrip: 同じ部品のピンを別の導通ストリップに配置してください。
+  Electrical/ShortCircuit: 短絡経路に示されたワイヤと電源端子を確認してください。
+  Electrical/ShortedComponent: 部品の両端が別々のネットにつながるように配置してください。
+  Electrical/FloatingPin: 使用するピンを接続し、未使用なら unused で明示してください。
+  Electrical/FloatingInput: 必要に応じてプルアップ、プルダウン、または出力ピンに接続してください。
+  Electrical/MissingPullResistor: スイッチを開いたときに入力が浮かないよう、電源端子へ固定抵抗で接続してください。
+  Electrical/DanglingWire: ワイヤの両端を部品、電源、または別のワイヤにつないでください。
+  Electrical/SplitRail: 表示された2つの穴をワイヤで橋渡ししてください。
+  Electrical/MissingSeriesResistor: LED と電源または GPIO の間に電流制限抵抗を直列に入れてください。
+  Electrical/MinimumResistance: LED と可変抵抗をつなぐ経路に固定抵抗を直列に入れてください。
+  Electrical/RailPolarityMismatch: 電源の正負端子とレールの極性表示を確認してください。
+  Electrical/ReversePolarity: "部品の極性と電位を確認してください。意図的な逆バイアスは bias: :reverse と明示できます。"
+  Electrical/PowerPinUnconnected: 電源ピンと GND ピンを対応する電源ネットに接続してください。
+  Electrical/SupplyVoltageRange: IC の電源電圧を部品定義の定格範囲内にしてください。
+  Electrical/NoCommonGround: 電源の基準が必要な回路では GND を共有してください。
+  Electrical/VoltageDomainMismatch: ピンの最大許容電圧を確認し、レベルシフタや分圧で信号を下げてください。
+  Electrical/ResistorPowerRating: 定格電力の高い抵抗を選ぶか、抵抗値を上げてください。
+  Electrical/CapacitorVoltageRating: 回路でかかる電圧より高い定格のコンデンサを選んでください。
+  Electrical/LedOvercurrent: LED の電流上限を確認し、適切な直列抵抗を追加してください。
+  Electrical/GpioOvercurrent: 出力ピンの電流上限を確認し、負荷を減らしてください。
+  Electrical/I2CAddressConflict: 一方のモジュールの ADR 設定を変更するか、別の I2C バスにつないでください。
+  Electrical/I2CPullupMissing: SDA と SCL をそれぞれ適切な電源レールへ固定抵抗でプルアップしてください。
+  Electrical/MissingDecouplingCapacitor: IC の電源ピンと GND ピンの間にデカップリングコンデンサを配置してください。
+  Electrical/MissingBaseResistor: 出力ピンとトランジスタのベースの間に直列抵抗を追加してください。
+  Electrical/MissingFlybackDiode: 誘導負荷の両端に逆向きのダイオードを接続してください。
+  Electrical/SupplyOverload: 電源の許容電流を確認し、負荷を減らすか適切な電源を使用してください。
+  Electrical/NetLabelConflict: 同じネットに付いた異なるラベルを確認してください。
+  Intent/ConnectionMismatch: expect の接続宣言と実際のワイヤ、ネットラベルを一致させてください。
+  Intent/UnknownNet: expect で参照したネット名またはピン名を確認してください。
+  Intent/MeasurementUnavailable: 接地した電源と対応する受動部品を接続するか、回路シミュレータで確認してください。
+  Style/WireColor: 正極には赤や橙、GND には黒や青など慣例に合う色を指定してください。
 messages:
   diagnostic_invalid_hole: "無効な穴または接続先です: %{target}"
-  diagnostic_unknown_board: "ボード定義が見つかりません。"
+  diagnostic_unknown_board: "ボード定義が見つかりません: %{target}"
   diagnostic_unknown_part: "部品定義が見つかりません: %{target}"
   diagnostic_unknown_transistor_model: "トランジスタの型番が不明なため汎用 EBC ピン配置を使用します: %{target}"
   diagnostic_unknown_pin: "ピンが見つかりません: %{target}"
+  diagnostic_unknown_supply_source: "電源出力として定義されていない電源元です: %{target}"
+  diagnostic_ambiguous_supply_source: "複数の電源出力に一致する電源元です: %{target}"
   diagnostic_unknown_option: "部品オプションが見つかりません: %{option}"
+  diagnostic_invalid_option: "部品オプションの値が無効です: %{target}（%{reason}）"
+  diagnostic_invalid_value: "部品の値が無効です: %{target}（%{reason}）"
+  diagnostic_invalid_color: "色が無効です: %{target}（%{reason}）"
+  diagnostic_invalid_route: "ワイヤの経路指定が無効です: %{target}（%{reason}）"
+  diagnostic_invalid_wire_id: "ワイヤ ID が穴の名前と衝突しています: %{target}"
+  diagnostic_unmatched_parts: "部品定義に一致するファイルがありません: %{reason}"
+  diagnostic_part_override: "カスタム部品が組み込み部品を上書きしました: %{reason}"
   diagnostic_unplaced_pin: "部品ピンが穴に配置されていません: %{target}"
   diagnostic_duplicate_ref: "識別子が重複しています: %{target}"
-  diagnostic_invalid_placement: "部品の配置が無効です: %{target}"
+  diagnostic_invalid_placement: "部品の配置が無効です: %{target}（%{reason}）"
+  placement_straddle: "中央の溝をまたぐ必要があります"
+  placement_bounds_or_gap: "フットプリントが盤外または中央の溝にはみ出します"
+  placement_bounds: "フットプリントが盤外にはみ出します"
+  placement_footprint: "ピン位置がフットプリントと一致しません"
+  placement_anchor: "端子穴を基準点に指定してください"
   diagnostic_hole_conflict: "同じ穴に複数の端子があります: %{target}"
+  hole_covered_lead: "%{pin} は %{module} の本体下にある %{hole} に挿されています"
+  hole_covered_wire: "%{wire} の端が %{module} の本体下にある %{hole} に挿されています"
+  body_overlap: "%{first} と %{second} の本体が重なっています"
+  wire_over_ic: "%{wire} が %{ic} の本体上を通っています"
+  lead_span: "%{ref} の端子間は %{actual} mm で、上限 %{limit} mm を超えています"
   diagnostic_no_free_hole: "空き穴がありません: %{target}"
   diagnostic_split_net_label: "同じラベルが切断されたネットにあります: %{target}"
   diagnostic_unknown_net: "ネットが見つかりません: %{target}"
@@ -46,20 +155,37 @@ messages:
   shorted_component: "%{ref} の両端が同じネットに接続されています"
   unplaced_pin: "%{pin} がボードの穴に配置されていません"
   floating_pin: "%{pin} が外部に接続されていません"
+  floating_input: "%{pin} にモデル化された駆動源またはプル抵抗がありません"
+  missing_pull_resistor: "%{switch} を開くと %{pin} が浮く可能性があります。プル抵抗を追加してください"
   dangling_wire: "%{wire} の端が接続されていません"
-  split_rail: "%{rail} の使用中の区間に電源がありません"
+  split_rail: "%{rail} の使用中の区間に電源がありません。%{bridge} を橋渡ししてください"
   missing_series_resistor: "%{ref} に直列の電流制限抵抗がありません"
+  series_resistor_recommendation: "E12 系列の %{resistance} 以上の抵抗を直列に追加してください。電源上限 %{voltage} V、宣言された順方向電圧 %{forward_voltage} V、最大電流 %{current} mA からの概算です。公差を確認してください。"
+  minimum_resistance: "%{led} は可変抵抗 %{pot} だけで電流を制限しています。ワイパーが端に達すると 0 Ω になり得ます"
+  rail_polarity_mismatch: "%{source} の正極が %{positive_rail}、負極が %{negative_rail} に接続され、レールの極性表示と逆です"
   reverse_polarity: "%{ref} の正極の電位が負極より低くなっています"
   power_pin: "%{pin} が有効な電源に接続されていません"
   supply_range: "%{ref} の %{power}/%{ground} 間は %{voltage} V です（定格 %{minimum}〜%{maximum} V）"
   common_ground: "複数の電源で GND が共通化されていません"
+  voltage_domain: "%{pin} に %{voltage} V がかかっています（最大 %{maximum} V）"
+  i2c_address: "%{refs} が同じ I2C バスでアドレス %{address} を使用しています"
+  i2c_pullup_missing: "%{refs} の I2C %{line} 信号線にプルアップ抵抗がありません"
+  missing_decoupling_capacitor: "%{ref} の %{power} と %{ground} の間にコンデンサがありません"
+  missing_base_resistor: "%{driver} が %{base} を直列抵抗なしで駆動しています"
+  missing_flyback_diode: "%{ref} の %{positive} と %{negative} の間に逆向きのフライバックダイオードがありません"
+  supply_overload: "%{supply} の供給電流は %{current} mA です（上限 %{limit} mA）"
+  gpio_overcurrent: "%{pin} に %{current} mA が流れています（上限 %{limit} mA）"
   wire_color: "%{wire} の色 %{color} は想定色 %{expected} と異なります"
   label_conflict: "同じネットに異なるラベルがあります: %{labels}"
   unknown_expectation: "接続宣言に不明な参照があります: %{refs}"
+  unknown_state: "不明な回路状態です: %{state}"
+  measurement_unavailable: "%{ref} の%{kind}を検証できません: %{reason}"
+  measurement_mismatch: "%{ref} の%{kind}は %{range} %{unit} を期待しましたが、%{value} %{unit} です"
   expected_connected: "%{refs} は接続されている必要があります"
   expected_isolated: "%{refs} は分離されている必要があります"
   undeclared_pins: "宣言したネットに未宣言のピンがあります: %{pins}"
-  expected_net_name: "ネット名は %{expected} のはずですが %{actual} です"
+  expected_net_name: "ネット名は %{expected} のはずですが %{actual} です。net :%{expected}, at: ... でラベルを付けてください"
   expected_one_net: "%{refs} は同じネットにある必要があります"
   unknown_disable: "lint_disable に不明なルールがあります: %{rule}"
   disable_reason: "%{rule} の lint_disable には理由が必要です"
+  redundant_disable: "%{rule} の lint_disable は指摘を抑制していません"

data/locales/ko.yml

@@ -0,0 +1,191 @@
+rules:
+  Layout/InvalidHole: 선택한 브레드보드에 없는 구멍입니다.
+  Layout/UnknownBoard: 선택한 브레드보드 정의를 찾을 수 없습니다.
+  Layout/UnknownPart: 부품 정의를 찾을 수 없습니다.
+  Layout/UnknownTransistorModel: 트랜지스터 모델을 알 수 없어 일반 핀 배열을 사용합니다.
+  Layout/UnknownPin: 지정한 부품 핀이 없습니다.
+  Layout/UnknownSupplySource: 선택한 핀이 전원 출력으로 정의되지 않았습니다.
+  Layout/AmbiguousSupplySource: 선택한 전원 소스가 여러 출력과 일치합니다.
+  Layout/UnknownOption: 알 수 없는 부품 옵션입니다.
+  Layout/InvalidOption: 부품 옵션 값이 잘못되었습니다.
+  Layout/InvalidValue: 부품 값이 잘못되었습니다.
+  Layout/InvalidColor: 부품 또는 전선 색상이 잘못되었습니다.
+  Layout/InvalidRoute: 전선 경로가 잘못되었습니다.
+  Layout/InvalidWireId: 전선 ID가 구멍 ID와 충돌합니다.
+  Layout/UnmatchedParts: 부품 정의 파일 패턴에 일치하는 파일이 없습니다.
+  Layout/PartOverride: 사용자 정의 부품이 내장 부품을 덮어썼습니다.
+  Lint/RedundantDisable: lint_disable이 어떤 진단도 숨기지 않습니다.
+  Lint/UnknownRuleInDisable: lint_disable에 알 수 없는 규칙이 있습니다.
+  Layout/UnplacedPin: 부품 핀이 브레드보드 구멍에 배치되지 않았습니다.
+  Layout/DuplicateRef: 부품 또는 전선 식별자가 중복됩니다.
+  Layout/InvalidPlacement: 부품을 지정한 위치에 배치할 수 없습니다.
+  Layout/HoleConflict: 같은 구멍에 여러 리드가 꽂혀 있습니다.
+  Layout/HoleCovered: 모듈 또는 DIP 본체가 다른 리드나 전선 끝을 가립니다.
+  Layout/BodyOverlap: 두 부품의 본체가 겹칩니다.
+  Layout/WireOverIC: 직선 점퍼선이 DIP IC 본체 위를 지납니다.
+  Layout/LeadSpan: 핀 구멍 사이 거리가 부품 리드의 최대 길이를 초과합니다.
+  Layout/NoFreeHole: 자동 배치에 쓸 빈 구멍이 없습니다.
+  Layout/SplitNetLabel: 연결되지 않은 네트에 같은 라벨이 붙었습니다.
+  Layout/PinsInSameStrip: 같은 부품의 핀 여러 개가 같은 도전 스트립에 연결됩니다.
+  Electrical/ShortCircuit: 전원 전위 제약이 서로 충돌합니다.
+  Electrical/ShortedComponent: 두 단자 부품이 우회 연결되었습니다.
+  Electrical/FloatingPin: 부품 핀이 외부에 연결되지 않았습니다.
+  Electrical/FloatingInput: 입력 네트에 모델링된 구동원이나 풀 저항이 없습니다.
+  Electrical/MissingPullResistor: 전원으로 전환되는 입력에 풀 저항이 없습니다.
+  Electrical/DanglingWire: 전선 끝이 다른 요소에 연결되지 않았습니다.
+  Electrical/SplitRail: 분할된 전원 레일의 한 구간에 전원이 없습니다.
+  Electrical/MissingSeriesResistor: LED에 전류 제한 저항이 없습니다.
+  Electrical/MinimumResistance: LED 전류 제한에 쓰는 가변 저항이 0 Ω이 될 수 있습니다.
+  Electrical/RailPolarityMismatch: 전원 단자가 레일의 극성 표시와 반대로 연결되었습니다.
+  Electrical/ReversePolarity: 극성이 있는 부품이 반대로 연결되었습니다.
+  Electrical/PowerPinUnconnected: IC 전원 또는 접지 핀이 전원에 연결되지 않았습니다.
+  Electrical/SupplyVoltageRange: IC 전원 전압이 정격 범위를 벗어납니다.
+  Electrical/NoCommonGround: 여러 전원이 공통 접지를 사용하지 않습니다.
+  Electrical/VoltageDomainMismatch: 신호 전압이 핀 허용 범위를 초과합니다.
+  Electrical/ResistorPowerRating: 저항의 예상 소비 전력이 정격을 초과합니다.
+  Electrical/CapacitorVoltageRating: 전해 콘덴서의 예상 전압이 정격을 초과합니다.
+  Electrical/LedOvercurrent: LED의 예상 전류가 정격을 초과합니다.
+  Electrical/GpioOvercurrent: 출력 핀의 예상 전류가 정격을 초과합니다.
+  Electrical/I2CAddressConflict: 같은 I2C 버스에 중복 주소가 있습니다.
+  Electrical/I2CPullupMissing: I2C 신호선에 풀업 저항이 없습니다.
+  Electrical/MissingDecouplingCapacitor: IC 전원 핀 사이에 디커플링 콘덴서가 없습니다.
+  Electrical/MissingBaseResistor: 출력 핀과 트랜지스터 베이스 사이에 직렬 저항이 없습니다.
+  Electrical/MissingFlybackDiode: 유도성 부하 양단에 역방향 플라이백 다이오드가 없습니다.
+  Electrical/SupplyOverload: 전원 공급 전류가 지정된 한도를 초과합니다.
+  Electrical/NetLabelConflict: 같은 네트에 다른 라벨이 붙었습니다.
+  Intent/ConnectionMismatch: 실제 배선이 선언한 연결 의도와 다릅니다.
+  Intent/UnknownNet: 연결 선언이 알 수 없는 네트를 참조합니다.
+  Intent/MeasurementUnavailable: 지정한 직류 전압 또는 전류를 계산할 수 없습니다.
+  Style/WireColor: 전선 색상이 전원 레일의 색상 관례와 다릅니다.
+guidance:
+  Lint/RedundantDisable: 사용하지 않는 lint_disable을 삭제하거나 규칙과 대상을 수정하세요.
+  Lint/UnknownRuleInDisable: bklint --list-rules로 규칙 ID를 확인하세요.
+  Layout/InvalidHole: 선택한 브레드보드에 실제로 있는 구멍 ID를 사용하세요.
+  Layout/UnknownBoard: 기존 보드를 선택하거나 use_boards로 정의를 불러오세요.
+  Layout/UnknownPart: 부품 ID를 확인하거나 use_parts로 정의를 불러오세요.
+  Layout/UnknownTransistorModel: 실제 핀 배열을 확인하고 정확한 모델을 정의하세요.
+  Layout/UnknownPin: 부품 정의에 있는 핀 이름이나 번호를 사용하세요.
+  Layout/UnknownSupplySource: 부품 정의에서 전원 출력으로 선언한 핀을 선택하세요.
+  Layout/AmbiguousSupplySource: 각 전원 출력에 고유한 양극 핀을 지정하세요.
+  Layout/UnknownOption: 부품 정의에 선언된 속성을 사용하세요.
+  Layout/InvalidOption: 부품 속성에 허용된 값을 선택하세요.
+  Layout/InvalidValue: 부품 값의 숫자와 단위를 확인하세요.
+  Layout/InvalidColor: CSS 색상 이름, 16진 색상, rgb() 또는 hsl()을 사용하세요.
+  Layout/InvalidRoute: 지원되는 전선 경로를 선택하세요.
+  Layout/InvalidWireId: 구멍 ID와 혼동되지 않는 전선 ID를 사용하세요.
+  Layout/UnmatchedParts: use_parts 경로와 파일 패턴을 확인하세요.
+  Layout/PartOverride: 덮어쓴 부품의 핀 배열과 속성을 확인하세요.
+  Layout/UnplacedPin: 필요한 핀을 모두 브레드보드 구멍에 배치하세요.
+  Layout/DuplicateRef: 부품, 전선, 전원에 각각 고유한 ID를 지정하세요.
+  Layout/InvalidPlacement: 풋프린트, 보드 가장자리, 중앙 홈을 확인하세요.
+  Layout/HoleConflict: 한 구멍에는 리드 하나만 꽂으세요.
+  Layout/HoleCovered: 리드나 전선 끝을 모듈 본체 바깥 구멍으로 옮기세요.
+  Layout/BodyOverlap: 부품 본체가 겹치지 않도록 위치를 바꾸세요.
+  Layout/WireOverIC: 전선을 보이게 해야 한다면 IC 본체 바깥으로 우회하세요.
+  Layout/LeadSpan: 핀 간격을 줄이거나 리드가 충분히 긴 부품을 선택하세요.
+  Layout/NoFreeHole: 대상 스트립 또는 레일의 빈 구멍을 사용하세요.
+  Layout/SplitNetLabel: 같은 라벨을 가진 네트를 전선으로 연결하세요.
+  Layout/PinsInSameStrip: 부품 핀을 서로 다른 도전 스트립에 배치하세요.
+  Electrical/ShortCircuit: 보고된 단락 경로와 전원 단자를 확인하세요.
+  Electrical/ShortedComponent: 부품의 두 단자를 서로 다른 네트에 연결하세요.
+  Electrical/FloatingPin: 핀을 연결하거나 의도적으로 비워 둔 경우 unused로 표시하세요.
+  Electrical/FloatingInput: 풀 저항을 추가하거나 입력을 모델링된 출력에 연결하세요.
+  Electrical/MissingPullResistor: 스위치가 열려 있을 때 입력 전위가 정해지도록 고정 풀 저항을 추가하세요.
+  Electrical/DanglingWire: 전선 양끝을 부품, 전원 또는 다른 전선에 연결하세요.
+  Electrical/SplitRail: 보고된 두 구멍을 전선으로 이어 주세요.
+  Electrical/MissingSeriesResistor: LED 경로에 전류 제한 저항을 직렬로 넣으세요.
+  Electrical/MinimumResistance: LED와 가변 저항의 경로에 고정 저항을 직렬로 넣으세요.
+  Electrical/RailPolarityMismatch: 레일의 극성 표시와 전원 단자를 비교하세요.
+  Electrical/ReversePolarity: "부품 극성과 전압을 확인하세요. 의도적인 역바이어스는 bias: :reverse로 선언하세요."
+  Electrical/PowerPinUnconnected: 전원 핀과 접지 핀을 알맞은 전원 네트에 연결하세요.
+  Electrical/SupplyVoltageRange: IC 전원 전압을 지정된 정격 범위 안에 유지하세요.
+  Electrical/NoCommonGround: 공통 기준이 필요한 회로에서는 전원 접지를 연결하세요.
+  Electrical/VoltageDomainMismatch: 레벨 시프터나 분압기로 신호 전압을 낮추세요.
+  Electrical/ResistorPowerRating: 더 높은 정격의 저항을 사용하거나 소비 전력을 줄이세요.
+  Electrical/CapacitorVoltageRating: 실제 전압보다 정격 전압이 높은 콘덴서를 사용하세요.
+  Electrical/LedOvercurrent: 직렬 저항을 추가하거나 저항값을 높여 LED 전류를 제한하세요.
+  Electrical/GpioOvercurrent: 부하를 줄여 출력 핀 전류를 허용 범위 안에 유지하세요.
+  Electrical/I2CAddressConflict: 한 장치의 주소를 바꾸거나 별도의 I2C 버스를 사용하세요.
+  Electrical/I2CPullupMissing: SDA와 SCL을 각각 적절한 전원에 고정 풀업 저항으로 연결하세요.
+  Electrical/MissingDecouplingCapacitor: IC 전원 핀과 접지 핀 사이에 디커플링 콘덴서를 놓으세요.
+  Electrical/MissingBaseResistor: 출력 핀과 트랜지스터 베이스 사이에 저항을 직렬로 넣으세요.
+  Electrical/MissingFlybackDiode: 유도성 부하 양단에 역방향 다이오드를 연결하세요.
+  Electrical/SupplyOverload: 부하를 줄이거나 충분한 전류를 공급하는 전원을 사용하세요.
+  Electrical/NetLabelConflict: 같은 네트에 붙은 라벨의 충돌을 해결하세요.
+  Intent/ConnectionMismatch: expect 선언을 실제 전선과 네트 라벨에 맞추세요.
+  Intent/UnknownNet: expect 선언에 사용한 네트 또는 핀 이름을 확인하세요.
+  Intent/MeasurementUnavailable: 접지 기준이 있는 전원과 지원되는 수동 부품을 연결하거나 회로 시뮬레이터를 사용하세요.
+  Style/WireColor: 양전압에는 빨강이나 주황, 접지에는 검정이나 파랑을 사용하거나 색상 관례를 설정하세요.
+messages:
+  diagnostic_invalid_hole: "잘못된 구멍 또는 끝점: %{target}"
+  diagnostic_unknown_board: "브레드보드 정의를 찾을 수 없음: %{target}"
+  diagnostic_unknown_part: "부품 정의를 찾을 수 없음: %{target}"
+  diagnostic_unknown_transistor_model: "트랜지스터 모델을 알 수 없어 일반 EBC 핀 배열 사용: %{target}"
+  diagnostic_unknown_pin: "핀을 찾을 수 없음: %{target}"
+  diagnostic_unknown_supply_source: "전원 출력으로 선언되지 않은 끝점: %{target}"
+  diagnostic_ambiguous_supply_source: "여러 전원 출력과 일치하는 소스: %{target}"
+  diagnostic_unknown_option: "알 수 없는 부품 옵션: %{option}"
+  diagnostic_invalid_option: "잘못된 부품 옵션 값: %{target} (%{reason})"
+  diagnostic_invalid_value: "잘못된 부품 값: %{target} (%{reason})"
+  diagnostic_invalid_color: "잘못된 색상: %{target} (%{reason})"
+  diagnostic_invalid_route: "잘못된 전선 경로: %{target} (%{reason})"
+  diagnostic_invalid_wire_id: "전선 ID가 구멍 ID와 충돌: %{target}"
+  diagnostic_unmatched_parts: "일치하는 부품 정의 파일이 없음: %{reason}"
+  diagnostic_part_override: "사용자 정의 부품이 내장 부품을 덮어씀: %{reason}"
+  diagnostic_unplaced_pin: "부품 핀이 구멍에 배치되지 않음: %{target}"
+  diagnostic_duplicate_ref: "중복된 식별자: %{target}"
+  diagnostic_invalid_placement: "잘못된 부품 위치: %{target} (%{reason})"
+  placement_straddle: "중앙 홈을 가로질러야 합니다"
+  placement_bounds_or_gap: "풋프린트가 보드 밖이나 중앙 홈으로 넘어갑니다"
+  placement_bounds: "풋프린트가 보드 밖으로 넘어갑니다"
+  placement_footprint: "핀 위치가 풋프린트와 일치하지 않습니다"
+  placement_anchor: "단자 구멍을 기준점으로 지정하세요"
+  diagnostic_hole_conflict: "같은 구멍에 여러 단자가 있음: %{target}"
+  hole_covered_lead: "%{pin}이(가) %{module} 본체 아래의 %{hole}에 꽂혀 있습니다"
+  hole_covered_wire: "%{wire} 끝이 %{module} 본체 아래의 %{hole}에 꽂혀 있습니다"
+  body_overlap: "%{first}와(과) %{second}의 본체가 겹칩니다"
+  wire_over_ic: "%{wire}이(가) %{ic} 본체 위를 지납니다"
+  lead_span: "%{ref}의 리드 간격은 %{actual} mm이며 한도 %{limit} mm를 넘습니다"
+  diagnostic_no_free_hole: "빈 구멍이 없음: %{target}"
+  diagnostic_split_net_label: "연결되지 않은 네트에 같은 라벨이 있음: %{target}"
+  diagnostic_unknown_net: "네트를 찾을 수 없음: %{target}"
+  rule_error: "%{rule} 검사 중 오류: %{error}"
+  same_strip: "%{ref}의 핀 %{left}와(과) %{right}이(가) 같은 스트립 %{strip}에 있습니다"
+  short_circuit: "%{first} (%{first_voltage} V)와(과) %{second} (%{second_voltage} V)의 전위가 네트 %{net}에서 충돌합니다 (경로: %{path})"
+  shorted_component: "%{ref}의 두 단자가 같은 네트에 연결되었습니다"
+  unplaced_pin: "%{pin}이(가) 브레드보드 구멍에 배치되지 않았습니다"
+  floating_pin: "%{pin}에 외부 연결이 없습니다"
+  floating_input: "%{pin}에 모델링된 구동원이나 풀 저항이 없습니다"
+  missing_pull_resistor: "스위치 %{switch}이(가) 열리면 %{pin}이(가) 부유할 수 있습니다. 풀 저항을 추가하세요"
+  dangling_wire: "%{wire} 끝이 연결되지 않았습니다"
+  split_rail: "%{rail}의 사용 구간에 전원이 없습니다. %{bridge}를 이어 주세요"
+  missing_series_resistor: "%{ref}에 직렬 전류 제한 저항이 없습니다"
+  series_resistor_recommendation: "E12 계열 %{resistance} 이상의 저항을 직렬로 추가하세요. 전원 최대 %{voltage} V, 선언된 순방향 전압 %{forward_voltage} V, 최대 전류 %{current} mA를 바탕으로 한 추정치입니다. 허용 오차를 확인하세요."
+  minimum_resistance: "%{led}은(는) 가변 저항 %{pot}만으로 전류를 제한합니다. 와이퍼가 끝에 닿으면 0 Ω이 될 수 있습니다"
+  rail_polarity_mismatch: "%{source}의 양극은 %{positive_rail}, 음극은 %{negative_rail}에 연결되어 레일 표시와 반대입니다"
+  reverse_polarity: "%{ref}의 양극 전위가 음극보다 낮습니다"
+  power_pin: "%{pin}이(가) 유효한 전원에 연결되지 않았습니다"
+  supply_range: "%{ref}의 %{power}/%{ground} 전압은 %{voltage} V입니다 (정격 %{minimum}–%{maximum} V)"
+  common_ground: "여러 전원이 공통 접지를 사용하지 않습니다"
+  voltage_domain: "%{pin}에 %{voltage} V가 걸립니다 (최대 %{maximum} V)"
+  i2c_address: "%{refs}이(가) 같은 I2C 버스에서 주소 %{address}를 사용합니다"
+  i2c_pullup_missing: "%{refs}의 I2C %{line} 신호선에 풀업 저항이 없습니다"
+  missing_decoupling_capacitor: "%{ref}의 %{power}와(과) %{ground} 사이에 콘덴서가 없습니다"
+  missing_base_resistor: "%{driver}이(가) 직렬 저항 없이 %{base}을(를) 구동합니다"
+  missing_flyback_diode: "%{ref}의 %{positive}와(과) %{negative} 사이에 역방향 플라이백 다이오드가 없습니다"
+  supply_overload: "%{supply}의 공급 전류는 %{current} mA입니다 (한도 %{limit} mA)"
+  gpio_overcurrent: "%{pin}에 %{current} mA가 흐릅니다 (한도 %{limit} mA)"
+  wire_color: "%{wire}의 색상 %{color}이(가) 예상 색상 %{expected}와(과) 다릅니다"
+  label_conflict: "같은 네트에 다른 라벨이 있음: %{labels}"
+  unknown_expectation: "연결 선언에 알 수 없는 참조가 있음: %{refs}"
+  unknown_state: "알 수 없는 회로 상태: %{state}"
+  measurement_unavailable: "%{ref}의 %{kind}을(를) 확인할 수 없음: %{reason}"
+  measurement_mismatch: "%{ref}의 %{kind}은(는) %{range} %{unit}이어야 하지만 %{value} %{unit}입니다"
+  expected_connected: "%{refs}은(는) 연결되어야 합니다"
+  expected_isolated: "%{refs}은(는) 서로 분리되어야 합니다"
+  undeclared_pins: "선언한 네트에 선언되지 않은 핀이 있음: %{pins}"
+  expected_net_name: "네트 이름은 %{expected}이어야 하지만 %{actual}입니다. net :%{expected}, at: ...로 라벨을 추가하세요"
+  expected_one_net: "%{refs}은(는) 같은 네트에 있어야 합니다"
+  unknown_disable: "lint_disable에 알 수 없는 규칙이 있음: %{rule}"
+  disable_reason: "%{rule}의 lint_disable에는 이유가 필요합니다"
+  redundant_disable: "%{rule}의 lint_disable은(는) 어떤 진단도 숨기지 않습니다"