gedcomkit 0.1.9__tar.gz → 0.1.11__tar.gz

{gedcomkit-0.1.9 → gedcomkit-0.1.11}/CHANGELOG.md

@@ -5,6 +5,65 @@ format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 the project uses semantic versioning within the usual pre-1.0 compatibility
 rules.
 
+## [0.1.11] - 2026-09-28
+
+### Added
+
+- A `ts` feature (off by default; implies `serde`) that derives
+  `ts_rs::TS` on every type the `serde` feature serializes — the views, the
+  date, encoding, conversion, and validation reports — so a caller that
+  sends them to a TypeScript frontend can generate its types from these
+  definitions rather than keep hand-written copies in step. The definitions
+  follow the JSON exactly: camelCase field names, `null` for an absent
+  value, and unit enums as their variant names. `StructureView::kind`, a
+  `&'static str`, is declared as the five words it can hold
+  (`"record" | "event" | "attribute" | "structure" | "unknown"`). Pulls in
+  `ts-rs` 12 (MIT) and its proc-macro only when enabled.
+
+  Two things a caller should know. ts-rs declares a 64-bit integer as
+  `bigint` by default, while the JSON carries a number: export with
+  `Config::with_large_int("number")` (as `tests/typescript.rs` does) for
+  definitions that match what `serde_json` writes. And a
+  `#[non_exhaustive]` enum becomes a closed TypeScript union, so a variant
+  added in a later patch release — additive in Rust — can break an
+  exhaustive `switch` in TypeScript until the definitions are regenerated.
+
+## [0.1.10] - 2026-09-27
+
+### Added
+
+- `Node::fit_line_limit`, `Document::fit_line_limit` (the same, addressed by
+  a record's cross-reference identifier), and the `MAX_LINE_LENGTH` constant
+  for GEDCOM 5.5.1's 255-byte line, for a caller to fit an edited record to
+  a pre-7.0 document's line limit just before serializing:
+  `set_logical_value` only ever splits a payload across `CONT` at the
+  newlines it is given, so a long edited line was otherwise written over
+  length. Only nodes with no verbatim source line are touched, checked
+  recursively, so a node no caller reached into keeps its exact bytes; a
+  pointer payload is never split either. The line is measured with a
+  2-byte terminator reserve — wider than `wrap_long_lines`' 1 byte — because
+  this is meant for a caller whose own pipeline may keep a source file's
+  `\r\n` terminator rather than always writing `\n`. Bound in both language
+  bindings as `fit_line_limit` (Python) and `fitLineLimit` (WASM), mirroring
+  `wrap_long_lines`/`wrapLongLines`.
+
+### Fixed
+
+- `Document::next_xref` matched its prefix case-sensitively, so in a file
+  using lowercase identifiers (`@i1@`) `next_xref("I")` minted `@I1@` —
+  which `Document::record`'s case-insensitive lookup resolves to the
+  existing `@i1@`, silently colliding with it. The prefix match is now
+  case-insensitive, and the returned identifier is checked against every
+  existing xref case-insensitively and advanced past any collision. Its
+  doc comment claimed "the lowest unused" identifier while returning one
+  past the highest; the comment now says that.
+- The same method minted `highest + 1` with unchecked arithmetic: a hostile
+  or fuzzed file carrying `@I18446744073709551615@` (`u64::MAX`) made it
+  panic in a debug build and wrap around to `@I0@` in release. Arithmetic
+  is now checked throughout, and once the series above the high-water mark
+  is exhausted, `next_xref` falls back to the lowest unused number instead
+  of overflowing.
+
 ## [0.1.9] - 2026-09-27
 
 ### Fixed

{gedcomkit-0.1.9 → gedcomkit-0.1.11}/Cargo.lock

@@ -35,10 +35,11 @@ dependencies = [
 
 [[package]]
 name = "gedcomkit"
-version = "0.1.9"
+version = "0.1.11"
 dependencies = [
  "flate2",
  "serde",
+ "ts-rs",
 ]
 
 [[package]]
@@ -96,7 +97,7 @@ checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 3.0.5",
 ]
 
 [[package]]
@@ -105,6 +106,17 @@ version = "0.3.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "3a219298ac11a56ea9a6d2120044824d6f01aeb034955e7af7bc16858527deea"
 
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
 [[package]]
 name = "syn"
 version = "3.0.5"
@@ -116,8 +128,83 @@ dependencies = [
  "unicode-ident",
 ]
 
+[[package]]
+name = "termcolor"
+version = "1.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "06794f8f6c5c898b3275aebefa6b8a1cb24cd2c6c79397ab15774837a0bc5755"
+dependencies = [
+ "winapi-util",
+]
+
+[[package]]
+name = "thiserror"
+version = "2.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09e52cb86a36cede5cb101bf8908837b3e4c6e5e59fe7fd85c23fb56200d189e"
+dependencies = [
+ "thiserror-impl",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "2.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fe5197923287db20a58125f0bc85c062f7f2c892de97b18c356f9efb14b28524"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.5",
+]
+
+[[package]]
+name = "ts-rs"
+version = "12.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "756050066659291d47a554a9f558125db17428b073c5ffce1daf5dcb0f7231d8"
+dependencies = [
+ "thiserror",
+ "ts-rs-macros",
+]
+
+[[package]]
+name = "ts-rs-macros"
+version = "12.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "38d90eea51bc7988ef9e674bf80a85ba6804739e535e9cab48e4bb34a8b652aa"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+ "termcolor",
+]
+
 [[package]]
 name = "unicode-ident"
 version = "1.0.24"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "winapi-util"
+version = "0.1.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
+dependencies = [
+ "windows-sys",
+]
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "windows-sys"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
+dependencies = [
+ "windows-link",
+]

{gedcomkit-0.1.9 → gedcomkit-0.1.11}/Cargo.toml

@@ -3,7 +3,7 @@
 # was checked on crates.io, npm, and PyPI before the initial release.
 [package]
 name = "gedcomkit"
-version = "0.1.9"
+version = "0.1.11"
 description = "A byte-preserving GEDCOM document model: decoding, parsing, readings, version conversion, plausibility checks, and the GEDZIP container, for GEDCOM 5.5 through 7.x."
 edition = "2024"
 # The true minimum, not the workspace's toolchain: a parser library is a leaf
@@ -42,6 +42,11 @@ gedzip = ["dep:flate2"]
 # Serialization of the read-only views, for callers that send them somewhere —
 # a webview, a JSON API. Off by default: a parser needs no serializer.
 serde = ["dep:serde"]
+# TypeScript definitions of those same serialized shapes (`ts_rs::TS` on every
+# type `serde` serializes), for a caller that generates its frontend's types
+# from them rather than writing them by hand. Off by default, and meant for a
+# build step or a test rather than a shipped binary.
+ts = ["serde", "dep:ts-rs"]
 # Generates a deterministic synthetic tree of any size, for performance and
 # stress fixtures. Off by default: nothing an application ships needs it.
 fixture = []
@@ -50,6 +55,9 @@ fixture = []
 # `rust_backend` keeps deflate in pure Rust, so no system zlib is needed.
 flate2 = { version = "1.1.2", default-features = false, features = ["rust_backend"], optional = true }
 serde = { version = "1", features = ["derive"], optional = true }
+# MIT; its default `serde-compat` reads the serde attributes, so the
+# definitions follow the JSON the `serde` feature writes.
+ts-rs = { version = "12.0.1", optional = true }
 
 [lints.rust]
 unsafe_code = "forbid"

{gedcomkit-0.1.9 → gedcomkit-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gedcomkit
-Version: 0.1.9
+Version: 0.1.11
 Classifier: Development Status :: 3 - Alpha
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython

{gedcomkit-0.1.9 → gedcomkit-0.1.11}/README.md

@@ -198,6 +198,9 @@ than dropped.
   `default-features = false` the parser core has **no dependencies at all**.
 - `serde` — `Serialize` on the views and reports, for callers that send them
   to a webview or over a wire. Off by default.
+- `ts` — TypeScript definitions of those same serialized shapes
+  (`ts_rs::TS`), for a caller that generates its frontend's types from them.
+  Implies `serde`. Off by default.
 - `fixture` — a deterministic, corpus-shaped synthetic tree generator of any
   size, for performance and stress tests. Off by default.
 

{gedcomkit-0.1.9 → gedcomkit-0.1.11}/bindings/gedcomkit-py/Cargo.lock

@@ -35,7 +35,7 @@ dependencies = [
 
 [[package]]
 name = "gedcomkit"
-version = "0.1.9"
+version = "0.1.11"
 dependencies = [
  "flate2",
  "serde",
@@ -43,7 +43,7 @@ dependencies = [
 
 [[package]]
 name = "gedcomkit-py"
-version = "0.1.9"
+version = "0.1.11"
 dependencies = [
  "gedcomkit",
  "pyo3",

{gedcomkit-0.1.9 → gedcomkit-0.1.11}/bindings/gedcomkit-py/Cargo.toml

@@ -2,7 +2,7 @@
 # abi3 keeps it to one wheel per platform across Python versions.
 [package]
 name = "gedcomkit-py"
-version = "0.1.9"
+version = "0.1.11"
 description = "Python bindings for gedcomkit: an archival-grade GEDCOM library — byte-preserving round-trip, encoding detection, GEDCOM 5.5 through 7.x, GEDZIP."
 edition = "2024"
 rust-version = "1.88"

{gedcomkit-0.1.9 → gedcomkit-0.1.11}/bindings/gedcomkit-py/src/lib.rs

@@ -167,6 +167,26 @@ impl Gedcom {
         wrapped.iter().map(|line| to_py(py, line)).collect()
     }
 
+    /// Fits one record inside a 5.5.x document's line limit
+    /// (`max_line_bytes`, terminator included; 255 is GEDCOM 5.5.1's limit)
+    /// by inserting `CONC` lines, addressed by cross-reference identifier.
+    /// Call this on a record just edited with `set_logical_value`, since
+    /// that only ever splits a payload at the newlines it is given. Returns
+    /// whether anything changed; a node still carrying its original,
+    /// unedited line is never touched. Raises `KeyError` when no record
+    /// answers to `xref`.
+    #[pyo3(signature = (xref, max_line_bytes = 255))]
+    fn fit_line_limit(&mut self, xref: &str, max_line_bytes: usize) -> PyResult<bool> {
+        let changed = self
+            .document
+            .fit_line_limit(xref, max_line_bytes)
+            .map_err(|_| PyKeyError::new_err(xref.to_owned()))?;
+        if changed {
+            self.graph = None;
+        }
+        Ok(changed)
+    }
+
     /// What decoding decided, one line — show it before accepting an import.
     #[getter]
     fn encoding(&self) -> String {