carve-lang 0.1.10-aarch64-linux → 0.1.12-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b214f8dbf9f5c494a35507e7636deb76e57e9731ea0e41576a4ed5fa15e32a82
-  data.tar.gz: b93ce900782e080a60f87bcc370490465d7746b3cdd1fb3898ff0d188159c0d0
+  metadata.gz: 53e586d63a6d53682f45955244c0d3c9c7631a879b8aa91e7df3327d4204af56
+  data.tar.gz: 6ed30946fc41d2f2f2baed993415cdce3ab6727c339fbf35ca4434ea4ed229a6
 SHA512:
-  metadata.gz: 4fd189dfc7372fef16f44d2c5d15cac5e88b78062d0e6ef7e4f620b2b4faa5b6b363fc0590d154c38972241c522e089f7cc731eed3275ce404f570825cc5191f
-  data.tar.gz: 9242e5b9e6dc0f76f06846f84e8df95163550d7d97a1a19bb737eaae1e87db840bf5b6981d20d404807c4fb332b90e8e24a10b993f4f79224631066787e4acf2
+  metadata.gz: 53a9c3fbe4f5abd6c6ae897c40914ee4521c5122e191ae80dda6c7199a4d72e51d53eeef9c8db3d926e6e8d273be2f10eb4ea604d1bf698e8822116bb9eb2c23
+  data.tar.gz: ba818e73929cb3907c07eb786c86d59cf1cd1ce3996248a4abb2a7e37eb1a677b89075389a266493bbbf1f861dd1ec2fef97949554b91bf296da5957588f92c8

data/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.12] - 2026-10-24
+
+### Improvements
+
+- Update to the published carve-rs 0.1.12 engine. Table spans, wrapped attributes, and continuation markers follow the latest spec rules. Markdown output reports four new loss codes: `markdown-container-flattened`, `markdown-caption-flattened`, `markdown-attributes-dropped`, and `raw-html-escaped` (#228).
+
+## [0.1.11] - 2026-10-23
+
+### Improvements
+
+- `Carve.lint(source, extensions:)` exposes the engine's linter: findings carry
+  the rule id, message, 1-based line and column, and character offsets. With
+  `root:` and `source_path:` it lints included files and reports each finding's
+  file and `includedBy` chain (#223).
+
 ## [0.1.10] - 2026-10-23
 
 ### Breaking
@@ -527,7 +542,9 @@ are not listed, because no release ever shipped them.
   Arrays (every AST node type is covered), enabling custom renderers such as
   [carve-hexapdf](https://github.com/markup-carve/carve-hexapdf).
 
-[Unreleased]: https://github.com/markup-carve/carve-rb/compare/v0.1.10...HEAD
+[Unreleased]: https://github.com/markup-carve/carve-rb/compare/v0.1.12...HEAD
+[0.1.12]: https://github.com/markup-carve/carve-rb/compare/v0.1.11...v0.1.12
+[0.1.11]: https://github.com/markup-carve/carve-rb/compare/v0.1.10...v0.1.11
 [0.1.10]: https://github.com/markup-carve/carve-rb/compare/v0.1.9...v0.1.10
 [0.1.9]: https://github.com/markup-carve/carve-rb/compare/v0.1.8...v0.1.9
 [0.1.8]: https://github.com/markup-carve/carve-rb/compare/v0.1.7...v0.1.8

data/README.md

@@ -140,6 +140,21 @@ Other render methods leave directives literal. See the
 [include reference](docs/reference.md#file-includes) for budgets, AST expansion,
 targets, and containment behavior.
 
+## Lint
+
+`Carve.lint(source)` reports constructs that render but lose what the author
+wrote, such as an unattached attribute or a link to a missing id:
+
+```ruby
+Carve.lint("é [x](#nope)\n").map { |f| [f[:rule], f[:line], f[:column]] }
+# => [["broken-fragment-link", 1, 3]]
+```
+
+Columns and the `:start`/`:end` offsets count characters, not bytes. Pass
+`root:` and `source_path:` to lint included files too; each such finding names
+its file and the `:includedBy` chain. See the
+[lint reference](docs/reference.md#linting).
+
 ## Security
 
 Use `safe: true` and a restrictive profile for untrusted documents. Custom

data/lib/carve/version.rb

@@ -8,5 +8,5 @@ module Carve
   # compares it against ext/carve/Cargo.toml and against the newest cut
   # CHANGELOG section on every run, and .github/workflows/release.yml refuses to
   # publish a gem whose version is not the tag being released.
-  VERSION = "0.1.10"
+  VERSION = "0.1.12"
 end

data/lib/carve.rb

@@ -150,6 +150,55 @@ module Carve
       )
     end
 
+    # Report constructs that parse and render, but not the way the author
+    # meant: an attribute that attaches to nothing, an unclosed fence, a
+    # fragment link with no target.
+    #
+    #   Carve.lint("Text.\n\n{#gone}\n")
+    #   # => [{rule: "unattached-block-attribute", message: "...", line: 3,
+    #   #      column: 1, start: 7, end: 14, file: nil, includedBy: []}]
+    #
+    # Returns an Array of Hashes, empty for a clean document:
+    #
+    # * +:rule+ - the engine's stable rule id, the same in every Carve engine.
+    # * +:message+ - what degrades, in prose.
+    # * +:line+, +:column+ - 1-based; the column counts characters, not bytes.
+    # * +:start+, +:end+ - 0-based character offsets into +source+, end
+    #   exclusive, so <tt>source[f[:start]...f[:end]]</tt> is the offending text.
+    #   +nil+ on a finding the include pass adds (below), whose offsets would
+    #   index another text.
+    # * +:file+, +:includedBy+ - see below; +nil+ and +[]+ without includes.
+    #
+    # The engine reports no severity: every finding is a warning.
+    #
+    # Pass the same +extensions:+ you render with, since they change which
+    # constructs are elements and which rules apply.
+    #
+    # ==== Following includes
+    #
+    # With +root:+ and +source_path:+ (absolute, as for .to_html_with_includes)
+    # the pass also lints every included Carve file and reports include
+    # directives that stay literal (a missing target, a cycle, a budget). Such a
+    # finding names its +:file+ relative to the root and its +:includedBy+ chain,
+    # top-level first, as +{file:, line:, column:}+. The budgets
+    # (+max_depth:+ and the rest) mean what they mean for rendering.
+    def lint(source, extensions: nil, root: nil, source_path: nil, max_depth: nil,
+             max_bytes: nil, max_resolver_calls: nil, max_warnings: nil)
+      JSON.parse(
+        _lint_json(
+          source.to_s,
+          Array(extensions).map(&:to_s),
+          root&.to_s,
+          source_path&.to_s,
+          max_depth,
+          max_bytes,
+          max_resolver_calls,
+          max_warnings,
+        ),
+        symbolize_names: true,
+      )
+    end
+
     # Format +source+ into canonical Carve. A writer refusal returns the source
     # as authored. +align_tables:+ pads table cells into aligned columns.
     def to_carve(source, align_tables: false)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: carve-lang
 version: !ruby/object:Gem::Version
-  version: 0.1.10
+  version: 0.1.12
 platform: aarch64-linux
 authors:
 - markup-carve
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-10-23 00:00:00.000000000 Z
+date: 2026-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake