moxml 0.1.16 → 0.1.18

data/TODO.remaining/8-xpath-predicate-gaps.md

@@ -1,68 +0,0 @@
-# TODO 8: XPath Engine Predicate Gaps (5 xit Tests)
-
-## Problem
-
-The pure-Ruby XPath engine (used by HeadedOx) does not fully support
-`position()`, `last()`, and `id()` inside predicates. Five tests are marked
-`xit` pending predicate support.
-
-These gaps affect the XPath engine in `lib/moxml/xpath/` — they are not
-adapter-specific.
-
-## Failing Tests
-
-### `position()` in Predicates (2 tests)
-
-`spec/moxml/xpath/functions/position_functions_spec.rb`
-
-```ruby
-xit "returns current position in predicate" do
-  # /root/item[position() = 2]
-end
-
-xit "works with position comparison" do
-  # /root/item[position() > 1]
-end
-```
-
-### `last()` in Predicates (2 tests)
-
-`spec/moxml/xpath/functions/position_functions_spec.rb`
-
-```ruby
-xit "returns size of context in predicate" do
-  # /root/item[position() = last()]
-end
-
-xit "works with last() - 1" do
-  # /root/item[position() = last() - 1]
-end
-```
-
-### `id()` with Nodeset Argument (1 test)
-
-`spec/moxml/xpath/functions/special_functions_spec.rb:69`
-
-```ruby
-xit "accepts nodeset argument containing IDs" do
-  # id(nodeset) where nodeset is path-evaluated
-end
-```
-
-## Investigation Needed
-
-- The XPath compiler likely needs to pass predicate context (position, size)
-  into the evaluation environment when compiling predicate expressions.
-- `position()` and `last()` are defined but raise `InvalidContextError` when
-  used inside predicates — the predicate evaluation path doesn't set up the
-  context they need.
-- `id()` with a nodeset argument requires evaluating the argument as an XPath
-  path first, then extracting ID values from the resulting nodes.
-
-## Files
-
-- `lib/moxml/xpath/compiler.rb` — predicate compilation
-- `lib/moxml/xpath/engine.rb` — runtime evaluation context
-- `lib/moxml/xpath/context.rb` — context setup for position/last
-- `spec/moxml/xpath/functions/position_functions_spec.rb`
-- `spec/moxml/xpath/functions/special_functions_spec.rb`

data/TODO.remaining/9-cleanup-hygiene.md

@@ -1,42 +0,0 @@
-# TODO 9: Cleanup and Hygiene
-
-Small items that don't affect functionality but should be addressed.
-
-## 9a. Stale Doc Links in Skip Messages
-
-15+ test skip messages reference `docs/HEADED_OX_LIMITATIONS.md` but the
-actual file is at `docs/_pages/headed-ox-limitations.adoc`. The referenced
-path does not exist.
-
-**Fix:** Update all skip messages to reference
-`docs/_pages/headed-ox-limitations.adoc` instead.
-
-**Affected files:**
-- `spec/integration/headed_ox_integration_spec.rb`
-- `spec/integration/shared_examples/integration_workflows.rb`
-- `spec/integration/shared_examples/node_wrappers/node_behavior.rb`
-- `spec/integration/shared_examples/node_wrappers/cdata_behavior.rb`
-- `spec/integration/shared_examples/edge_cases.rb`
-- `spec/moxml/xpath/axes_spec.rb`
-- `spec/moxml/xpath/compiler_spec.rb`
-- `spec/moxml/adapter/headed_ox_spec.rb`
-
-## 9b. Untracked `scripts/` Directory
-
-`scripts/format_xml.rb` and `scripts/pretty_format_xml.rb` exist as untracked
-files. Decide whether to commit (and add to `.gitignore` pattern or document)
-or remove.
-
-## 9c. Superseded Root TODO Files
-
-The following root-level files are marked as superseded in
-`TODO.remaining/README.md` but still exist:
-
-- `TODO.entities-work.md`
-- `TODO.entity-handling.md`
-- `TODO.entity-support.md`
-- `TODO.full-entity-support.md`
-- `TODO.full-entity.md`
-- `TODO.mn-bilingual-round-trip.md`
-
-Once all work is confirmed tracked in `TODO.remaining/`, these can be deleted.

data/TODO.remaining/README.md

@@ -1,54 +0,0 @@
-# TODO.remaining — Consolidated Action Items
-
-Consolidated from: TODO.entities-work.md, TODO.entity-support.md,
-TODO.full-entity.md, TODO.full-entity-support.md, TODO.entity-handling.md,
-TODO.mn-bilingual-round-trip.md, plus code audit (2026-04-22).
-
-Those root files are superseded and can be removed.
-
-## Dependency Order
-
-```
-TODO 1 (Adapter Support)
-   |
-   v
-TODO 2 (Model-Driven Restoration) ---> TODO 4 (Lenient Entities Mode)
-   |
-   v
-TODO 3 (Test Coverage)
-
-TODO 5 (Fixture Integrity) — independent
-TODO 6 (Ox Element Ordering) — independent
-TODO 7 (HeadedOx Limitations) — independent
-TODO 8 (XPath Predicate Gaps) — independent
-TODO 9 (Cleanup Hygiene) — independent
-```
-
-## Summary
-
-| # | File | Description | Status |
-|---|------|-------------|--------|
-| 1 | `1-entity-reference-adapter-support.md` | EntityReference in Ox, Oga, REXML, LibXML, HeadedOx | Not started |
-| 2 | `2-entity-restoration-model-driven.md` | Use EntityRegistry as source of truth for restoration | Not started |
-| 3 | `3-entity-reference-test-coverage.md` | Tests for EntityReference nodes and round-trips | Not started |
-| 4 | `4-lenient-entities-mode.md` | Strict vs lenient entity restoration mode | Not started |
-| 5 | `5-fixture-integrity.md` | Bilingual fixture verification + CI validation | Not started |
-| 6 | `6-ox-element-ordering-bug.md` | Ox adapter reorders elements in certain fixtures | Not started |
-| 7 | `7-headed-ox-limitations.md` | 15 skipped tests across 7 HeadedOx limitation areas | Not started |
-| 8 | `8-xpath-predicate-gaps.md` | position()/last()/id() not working in XPath predicates | Not started |
-| 9 | `9-cleanup-hygiene.md` | Stale doc links, untracked scripts, superseded files | Not started |
-
-## What's Already Done
-
-- EntityReference node class (`lib/moxml/entity_reference.rb`)
-- EntityRegistry with 2125 W3C entities (`lib/moxml/entity_registry.rb`)
-- Node type registry includes `:entity_reference`
-- Base adapter template: `create_entity_reference`, `validate_entity_reference_name`
-- Nokogiri adapter: full native EntityReference support
-- Document factory: `create_entity_reference(name)`
-- DocumentBuilder: `visit_entity_reference` + partial `restore_entities_in_text`
-- Builder DSL: `entity_reference(name)`
-- Config: `restore_entities`, `entity_load_mode`, `entity_provider`, `preload_entity_sets`
-- Context: entity registry integration
-- EntityRegistry tests (24 examples passing)
-- HeadedOx limitations documented in `docs/_pages/headed-ox-limitations.adoc`