Fix Markdown table core round-trip defects and release 0.2.0 (#23)

Five reproducible defects were found by property and fuzz testing of the
public facade and are fixed with regression coverage:

- findTableRanges could return overlapping ranges when a table was followed
  by a line that was itself a valid separator, so whole-document reformatting
  rewrote one row twice and corrupted the document.
- The formatter emitted tables it could not parse back: without outer pipes,
  an empty edge cell produced a row ending (or starting) with a pipe that
  re-parsing consumed as an outer pipe, dropping a column.
- Deleting down to one column in a table without outer pipes left rows with
  no pipe at all, turning the table into plain text.
- A header made only of dashes was mistaken for the separator row, so every
  edit on such a table was rejected.
- EditResult.changed was hardcoded to true instead of reporting whether the
  result differs from the input.

Readability work keeps behaviour unchanged: the duplicated preamble of apply
and applyWrappedToWidth moved into resolveTable, the action switch moved into
applyAction, the two nearly identical wrap routines merged, the three column
width helpers share one accumulator, dead code is gone, and the public Javadoc
now documents the result coordinate system and the non-overlap guarantee.

Testing: new MarkdownTableCoreContractTest adds 105 cases covering alignment,
structural edits, sorting, navigation, wrapping, conversion, Unicode widths,
argument handling, immutability, and a randomised invariant sweep; four golden
fixtures pin the fixed behaviours. Core line coverage is 94%. corePerformance
gains p95 reporting and an end-to-end scenario, and passed three isolated runs.

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>

Author: krotname

README.en.md

@@ -180,8 +180,10 @@ You can change shortcuts in `Settings | Keymap`.
 ## Standalone Core Library
 
 The editor-independent engine is a separate Java 17 module with no runtime dependencies:
-[`name.krot:markdown-table-core`](core/README.md). The plugin consumes that module through the
-same Gradle build, so plugin tests also verify the real library integration.
+[`name.krot:markdown-table-core:0.2.0`](https://central.sonatype.com/artifact/name.krot/markdown-table-core/0.2.0).
+The plugin consumes the artifact published to Maven Central, so plugin tests verify the same
+public library that external consumers get. Core release notes live in
+[core/CHANGELOG.md](core/CHANGELOG.md).
 
 ## Build and Tests
 

README.md

@@ -181,9 +181,10 @@ Marketplace вычисляет конкретные версии продукт
 ## Самостоятельная библиотека ядра
 
 Независимое от редактора ядро выделено в Java 17 модуль без runtime-зависимостей:
-[`name.krot:markdown-table-core:0.1.0`](https://central.sonatype.com/artifact/name.krot/markdown-table-core/0.1.0).
+[`name.krot:markdown-table-core:0.2.0`](https://central.sonatype.com/artifact/name.krot/markdown-table-core/0.2.0).
 Плагин использует опубликованный артефакт из Maven Central, поэтому plugin-тесты проверяют
 интеграцию с той же публичной библиотекой, которую получают внешние потребители.
+История изменений ядра — в [core/CHANGELOG.md](core/CHANGELOG.md).
 
 ## Сборка и тесты
 

core/CHANGELOG.md

@@ -0,0 +1,48 @@
+# Markdown Table Core changelog
+
+All notable changes to `name.krot:markdown-table-core` are recorded here.
+The module follows [semantic versioning](https://semver.org/).
+
+## 0.2.0
+
+Source and binary compatible with `0.1.0`: no public type, method, field, or enum constant was
+removed, added, or changed. Only the observed behaviour of existing methods changed, as listed
+below.
+
+### Fixed
+
+- `findTableRanges` could return overlapping ranges when a table was directly followed by a line
+  that was itself a valid separator. The trailing row of one table was reused as the header of the
+  next one, so a caller that rewrote every range independently corrupted the document. Scanning
+  now resumes past the end of each table.
+- The formatter could emit a table it was unable to parse back. When a table carried no outer
+  pipes and an edge cell was empty - for example right after inserting a column into
+  `a | b` - the padded row ended with a pipe that re-parsing consumed as an outer pipe, dropping a
+  column and breaking header/separator agreement. Rows now keep the outer pipe whenever the first
+  or last column contains an empty cell.
+- Deleting the second column of a table without outer pipes left rows with no pipe at all, turning
+  the table into plain text. A single-column table without a leading pipe now always renders a
+  trailing one.
+- A header made only of dashes, such as `| --- | --- |` above its separator, was mistaken for the
+  separator row, and every edit on that table was rejected with `No Markdown table found`. The
+  separator search now starts below the header.
+- `EditResult.changed` was always `true`. It now reports whether the returned lines actually differ
+  from the table the operation started from, so successful no-ops such as aligning an already
+  aligned table report `false` while `ok` stays `true`.
+
+### Changed
+
+- `findTableRange` stops scanning once the document is past the requested row instead of always
+  mapping the whole document, which speeds up edits in long files.
+
+### Documentation
+
+- The Javadoc of `EditResult` now states that the result carries only the affected table and that
+  `targetRow` indexes into `lines`, not into the document.
+- `findTableRanges` documents the non-overlap guarantee, and `apply` documents that out-of-range
+  coordinates are clamped rather than rejected.
+
+## 0.1.0
+
+- First public release: parsing, formatting, conversion, and editing for GitHub-flavored Markdown
+  pipe tables, with no runtime dependencies on Java 17.

core/README.md

@@ -7,14 +7,16 @@ GitHub-flavored Markdown pipe tables.
 
 ```kotlin
 dependencies {
-    implementation("name.krot:markdown-table-core:0.1.0")
+    implementation("name.krot:markdown-table-core:0.2.0")
 }
 ```
 
-Version `0.1.0` is published on
-[Maven Central](https://central.sonatype.com/artifact/name.krot/markdown-table-core/0.1.0)
+Version `0.2.0` is published on
+[Maven Central](https://central.sonatype.com/artifact/name.krot/markdown-table-core/0.2.0)
 and available from the
-[Central repository](https://repo1.maven.org/maven2/name/krot/markdown-table-core/0.1.0/).
+[Central repository](https://repo1.maven.org/maven2/name/krot/markdown-table-core/0.2.0/).
+
+See [CHANGELOG.md](CHANGELOG.md) for what changed since `0.1.0`.
 
 ## Usage
 

core/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

core/src/main/java/name/krot/markdowntable/core/MarkdownTableCore.java

@@ -55,17 +55,27 @@ public enum Action {
 
 	/**
 	 * Immutable result of a table edit or conversion.
+	 *
+	 * <p>{@link #lines} holds only the affected table, not the whole document, and
+	 * {@link #targetRow} indexes into those lines. Callers that pass a whole document to
+	 * {@link #apply} therefore add {@link TableRange#firstRow} to map the target back onto the
+	 * document.</p>
 	 */
 	public static final class EditResult {
-		/** Whether the returned text differs from the input. */
+		/**
+		 * Whether the returned lines differ from the table the operation started from.
+		 *
+		 * <p>Successful no-ops such as aligning an already aligned table, or moving the first data
+		 * row further up, report {@code false} while {@link #ok} stays {@code true}.</p>
+		 */
 		public final boolean changed;
 		/** Whether the operation completed successfully. */
 		public final boolean ok;
 		/** Human-readable failure or status detail; empty on normal success. */
 		public final String message;
-		/** Immutable formatted or converted lines. */
+		/** Immutable formatted or converted lines; empty when {@link #ok} is {@code false}. */
 		public final List<String> lines;
-		/** Zero-based target row after the operation. */
+		/** Zero-based target row within {@link #lines} after the operation. */
 		public final int targetRow;
 		/** Zero-based target column after the operation. */
 		public final int targetColumn;
@@ -187,7 +197,11 @@ public static TableRange findTableRange(List<String> lines, int row) {
 	}
 
 	/**
-	 * Finds all non-overlapping Markdown table ranges in document order.
+	 * Finds every Markdown table in document order.
+	 *
+	 * <p>The returned ranges are strictly ordered and never overlap, so a caller may rewrite each
+	 * one independently. Scanning resumes past the end of a table even when its last row still
+	 * carries pipes, so a trailing row is never reused as the header of the next table.</p>
 	 *
 	 * @param lines document lines
 	 * @return immutable ranges in document order
@@ -214,11 +228,16 @@ public static boolean isPotentialSeparatorLine(String line) {
 	/**
 	 * Applies an editing action to the table containing {@code row}.
 	 *
+	 * <p>Out-of-range coordinates are clamped into the table rather than rejected. The result
+	 * carries only the rewritten table; see {@link EditResult} for how its coordinates relate to
+	 * the document.</p>
+	 *
 	 * @param lines document lines
 	 * @param row zero-based document row
 	 * @param column zero-based cell index
 	 * @param action operation to apply
-	 * @return immutable operation result
+	 * @return immutable operation result; {@link EditResult#ok} is {@code false} when {@code row}
+	 *         is not inside a Markdown table
 	 */
 	public static EditResult apply(List<String> lines, int row, int column, Action action) {
 		Objects.requireNonNull(action, "action");