sts 0.5.2 → 0.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb09142275cd6246d7a63fe3b45489a11cf83f5e659151010ad50c84b4722f1c
-  data.tar.gz: 232e2b93e82a446e863f5d5d4c0a18151445ed25fe82be4c7c4ef6b5eef4dba3
+  metadata.gz: 443e55e67ecb2e042fc9e4e54041c5c9e1af49e0c14356015ea7183b7f340539
+  data.tar.gz: cf38e564d3c8086b129debf1e8b173d7ed9a3d96291dbe70781627172d3e6df2
 SHA512:
-  metadata.gz: c802673caa1e2cd33c596e16fbf53239b9be90cb7a0330ea5ae2b13d4bf93acdfad5a67aa6baac0bc618ad56ddcb33babfe70d3229364bb48dfb1a6449a60971
-  data.tar.gz: 4c4185da827c98a9f469f29ae3604d28ae7f48d82adaf390e4d9a02d6026693210aaaa6f26e5ac01dadc8c69fdcb531fa05f88a6bd49b2e876785638a0075ad8
+  metadata.gz: fbeecaa968c2d3a0df65e6f1ad2ced97e523d92dc1816db3c0820d7de9653457db049ef780e27b82f550716b8622c3d12dde8f83aae15ada4c64a1d76a3948d9
+  data.tar.gz: 5a1e0c1c065bd160b28ccb27f91b4002c6e43c2377a1455ae12d4c1cbb82c8879d7b499322ee9d6f0856b6085cf5089de0fd31e19249ffb63acef93f4e1161ed

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "spec/fixtures/mn-samples-iso-private"]
+	path = spec/fixtures/mn-samples-iso-private
+	url = git@github.com:metanorma/mn-samples-iso-private.git

data/.rubocop.yml

@@ -5,6 +5,9 @@ inherit_from:
 # local repo-specific modifications
 # ...
 
+Metrics/BlockLength:
+  Max: 35
+
 AllCops:
   TargetRubyVersion: 2.6
   NewCops: enable

data/.rubocop_todo.yml

@@ -1,20 +1,34 @@
 # This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2026-04-03 22:12:14 UTC using RuboCop version 1.86.0.
+# `rubocop --auto-gen-config --auto-gen-only-exclude --exclude-limit 50`
+# on 2026-05-06 01:14:05 UTC using RuboCop version 1.86.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 8
+# Offense count: 18
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Exclude:
+    - 'lib/sts/iso_sts/content_groups/highlight_elements.rb'
+    - 'lib/sts/niso_sts/content_groups/body_elements.rb'
+    - 'lib/sts/niso_sts/content_groups/emphasized_text.rb'
+    - 'lib/sts/niso_sts/content_groups/highlight_elements.rb'
+    - 'lib/sts/niso_sts/content_groups/inside_cell.rb'
+    - 'lib/sts/niso_sts/content_groups/styled_content_elements.rb'
+    - 'lib/sts/niso_sts/content_groups/table_group_attributes.rb'
     - 'lib/sts/niso_sts/mml_content/containers.rb'
     - 'lib/sts/niso_sts/mml_content/linear_algebra.rb'
     - 'lib/sts/niso_sts/term.rb'
     - 'lib/sts/tbx_iso_tml/lang_set.rb'
     - 'lib/sts/tbx_iso_tml/term_type.rb'
+    - 'spec/round_trip/reference_docs_spec.rb'
     - 'spec/spec_helper.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
+Metrics/AbcSize:
+  Exclude:
+    - 'lib/sts/iso_sts/mathml2/math.rb'

data/CLAUDE.md

@@ -0,0 +1,72 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build and Test Commands
+
+```bash
+# Run tests
+bundle exec rspec
+
+# Run tests with specific file
+bundle exec rspec spec/sts_spec.rb
+
+# Run RuboCop linting
+bundle exec rubocop
+
+# Run both (default task)
+bundle exec rake
+```
+
+## Architecture
+
+This is a Ruby gem for parsing NISO STS (National Information Standards Organization - Science and Technical Standards) XML documents. It uses `lutaml-model` for XML serialization/deserialization.
+
+### Namespace Structure
+
+```
+Sts
+├── NisoSts        # NISO STS elements (lib/sts/niso_sts/)
+│   ├── MmlContent # MathML content elements (autoloaded)
+│   └── Xi, Ali   # Module elements
+├── TbxIsoTml     # TBX ISO TML elements (lib/sts/tbx_iso_tml/)
+├── Mathml        # MathML namespace wrapper
+└── Namespaces    # XML namespace definitions
+```
+
+### Key Implementation Patterns
+
+**Element Classes** (in `lib/sts/niso_sts/`):
+- Inherit from `Lutaml::Model::Serializable`
+- Define attributes and XML mapping in `xml do ... end` block
+- Use `map_element` to map child elements, `map_content` for text content
+- Use `mixed_content` for elements that contain both text and child elements
+
+**Example element structure:**
+```ruby
+module Sts
+  module NisoSts
+    class SomeElement < Lutaml::Model::Serializable
+      attribute :id, :string
+      attribute :content, :string
+      attribute :child, ::Sts::NisoSts::ChildElement
+
+      xml do
+        element "some-element"
+        map_attribute "id", to: :id
+        map_content to: :content
+        map_element "child", to: :child
+      end
+    end
+  end
+end
+```
+
+**Autoload Pattern**: Elements are autoloaded via `lib/sts/niso_sts.rb`. When adding new elements, add autoloads in alphabetical order.
+
+**Bold/Italic Elements**: These use `::Sts::TbxIsoTml::Bold` and `::Sts::TbxIsoTml::Italic` types (not `:string`), enabling proper round-tripping of nested markup.
+
+### Reference Data
+
+- XSD schema: `reference-docs/NISO-STS-extended-1-MathML3-XSD/`
+- Test fixtures: `spec/fixtures/`

data/GAPS.guidelines.iso-sts-ed2.1/01-maintenance.md

@@ -0,0 +1,19 @@
+# Sections 1-2: Maintenance & Legal Terms
+
+## Overview
+Sections 1 and 2 are non-technical: Section 1 describes the maintenance process for the guidelines document, and Section 2 provides legal terms and disclaimer language. No XML elements or attributes are defined.
+
+## Element Coverage
+
+| Element | Guidelines Usage | sts-ruby Model | Status | Notes |
+|---------|-----------------|---------------|--------|-------|
+| N/A | N/A | N/A | N/A | No XML elements defined in these sections |
+
+## Attribute Gaps
+
+| Attribute | Parent Element | Guidelines Usage | Modeled | Status |
+|-----------|---------------|-----------------|---------|--------|
+| N/A | N/A | N/A | N/A | No attributes defined in these sections |
+
+## Key Gaps
+None - these sections contain no XML coding instructions.

data/GAPS.guidelines.iso-sts-ed2.1/03-general.md

@@ -0,0 +1,75 @@
+# Section 3: General
+
+## Overview
+Section 3 covers general coding guidance, Online Standards Development (OSD), elements containing IDs, editorial notes, and formatting conventions. It introduces key structural patterns and lists elements that should carry `@id` attributes.
+
+## Element Coverage
+
+| Element | Guidelines Usage | sts-ruby Model | Status | Notes |
+|---------|-----------------|---------------|--------|-------|
+| `<standard>` | Root element for standards documents | `NisoSts::Standard` | Partial | Missing `@xmlns:xi`, `@xmlns:xsi` attributes; missing `<processing-meta>` child |
+| `<processing-meta>` | New in Ed 2.1 - metadata about the XML file (tagset, MathML version, table model, TBX model) | Missing | Missing | **Critical gap** - new element introduced in Ed 2.1 |
+| `<front>` | Front matter container | `NisoSts::Front` | Supported | |
+| `<body>` | Body container | `NisoSts::Body` | Supported | |
+| `<back>` | Back matter container | `NisoSts::Back` | Supported | |
+
+## Attribute Gaps
+
+| Attribute | Parent Element | Guidelines Usage | Modeled | Status |
+|-----------|---------------|-----------------|---------|--------|
+| `@base-tagset` | `<processing-meta>` | "interchange" | N/A | Missing (parent element missing) |
+| `@mathml-version` | `<processing-meta>` | "3.0" | N/A | Missing (parent element missing) |
+| `@table-model` | `<processing-meta>` | "xhtml" | N/A | Missing (parent element missing) |
+| `@terminology-model` | `<processing-meta>` | "tbx" | N/A | Missing (parent element missing) |
+| `@math-representation` | `<processing-meta>` | "mathml" | N/A | Missing (parent element missing) |
+| `@tagset-family` | `<processing-meta>` | "sts" | N/A | Missing (parent element missing) |
+| `@xmlns:xi` | `<standard>` | XInclude namespace declaration | No | Missing attribute |
+| `@xmlns:xsi` | `<standard>` | XML Schema Instance namespace | No | Missing attribute |
+| `@mml` | `<standard>` | MathML namespace (modeled as attribute) | Partial | Modeled as `:string`, not as namespace declaration |
+| `@tbx` | `<standard>` | TBX namespace (modeled as attribute) | Partial | Modeled as `:string`, not as namespace declaration |
+
+## ID-Bearing Elements (Sec 3.4 Checklist)
+
+The guidelines list 31 elements that should carry `@id`. Checking whether sts-ruby models support `@id`:
+
+| Element | Has `@id` attribute | Notes |
+|---------|-------------------|-------|
+| `<app-group>` | Yes | |
+| `<app>` | Yes | |
+| `<code>` | N/A | Element not modeled |
+| `<def-item>` | No | Missing `@id` on `DefItem` |
+| `<def-list>` | Yes | |
+| `<disp-formula>` | Yes | |
+| `<fig>` | Yes | |
+| `<fig-group>` | Yes | |
+| `<graphic>` | No | Missing `@id` on `Graphic` |
+| `<inline-code>` | N/A | Element not modeled |
+| `<inline-formula>` | Yes | |
+| `<inline-graphic>` | Yes | |
+| `<legend>` | N/A | Element not modeled |
+| `<list-item>` | No | Missing `@id` on `ListItem` |
+| `<mml:math>` | Yes | |
+| `<mixed-citation>` | No | Missing `@id` |
+| `<p>` | Yes | |
+| `<ref>` | Yes | |
+| `<ref-list>` | Yes | |
+| `<sec>` | Yes | |
+| `<std>` | No | Missing `@id` on `ReferenceStandard` |
+| `<table-wrap>` | Yes | |
+| `<table-wrap-foot>` | No | Missing `@id` on `TableWrapFoot` |
+| `<tbx:example>` | Yes | |
+| `<tbx:note>` | Yes | |
+| `<tbx:termEntry>` | Yes | |
+| `<tbx:tig>` | Yes | |
+| `<term-sec>` | Yes | |
+| `<xref>` | No | Missing `@id` on `Xref` |
+
+## Key Gaps
+- [ ] **CRITICAL**: `<processing-meta>` element not modeled -- new in Ed 2.1 with attributes `@base-tagset`, `@mathml-version`, `@table-model`, `@terminology-model`, `@math-representation`, `@tagset-family`, and child `<custom-meta-group>`
+- [ ] **CRITICAL**: `<code>` element not modeled -- guidelines specify it for code blocks (replaces legacy `<preformat>`)
+- [ ] **CRITICAL**: `<inline-code>` element not modeled -- inline code equivalent of `<code>`
+- [ ] Missing `@id` on `<def-item>`, `<graphic>`, `<list-item>`, `<mixed-citation>`, `<std>`, `<table-wrap-foot>`, `<xref>` -- all listed in Sec 3.4 as needing IDs
+- [ ] `<legend>` element not modeled -- used for formula keys and figure keys (Sec 7.3, 8.3)
+- [ ] `NisoSts::Standard` does not map `<processing-meta>` as a child element
+- [ ] `NisoSts::Permissions` does not model `<license>` as a child element
+- [ ] `NisoSts::Permissions` maps `copyright-statement` as `:string` but guidelines show it can contain `<inline-graphic>` (IEC copyright)

data/GAPS.guidelines.iso-sts-ed2.1/04-structure.md

@@ -0,0 +1,75 @@
+# Section 4: Structure
+
+## Overview
+Section 4 defines the document structure: front matter, body, and back matter. It covers metadata, foreword, introduction, clauses/subclauses, normative references, terms and definitions, annexes, and bibliography.
+
+## Element Coverage
+
+| Element | Guidelines Usage | sts-ruby Model | Status | Notes |
+|---------|-----------------|---------------|--------|-------|
+| `<standard>` | Root element | `NisoSts::Standard` | Partial | Missing `<processing-meta>` child |
+| `<front>` | Front matter container | `NisoSts::Front` | Partial | Missing `<std-doc-meta>` child; missing `<adoption-front>` |
+| `<body>` | Body container | `NisoSts::Body` | Supported | |
+| `<back>` | Back matter container | `NisoSts::Back` | Partial | Missing `<index>` child |
+| `<std-meta>` | Standards metadata | `NisoSts::MetadataStd` | Partial | Missing `<abstract>`, multiple `<permissions>`, `<license>` inside permissions, `<isbn>`, `<std-id-group>` inside `<std-ident>`, `<counts>`, `<suppl-type>`, `<suppl-number>`, `<suppl-version>` |
+| `<iso-meta>` | ISO-specific legacy metadata | `NisoSts::MetadataIso` | Partial | Deprecated per guidelines but still needed for legacy |
+| `<std-doc-meta>` | Document-level metadata | `NisoSts::StdDocMeta` | Partial | Not mapped in `NisoSts::Front` |
+| `<sec>` | Clauses and subclauses | `NisoSts::Section` | Supported | `@sec-type` mapped as `:type` |
+| `<label>` | Clause/formula/figure numbers | `NisoSts::Label` | Supported | |
+| `<title>` | Section/figure/table titles | `NisoSts::Title` | Supported | |
+| `<p>` | Paragraphs | `NisoSts::Paragraph` | Supported | |
+| `<ref-list>` | Normative refs and bibliography | `NisoSts::ReferenceList` | Supported | Has `@content-type` |
+| `<ref>` | Individual reference | `NisoSts::Reference` | Partial | Missing `<non-normative-note>` child, missing `@specific-use` |
+| `<std>` | Standard reference | `NisoSts::ReferenceStandard` | Partial | Missing `@content-type`, `@std-id` vs `@std-id-link-type`, `<std-id>` children not mapped |
+| `<std-id>` | Standard identifier (URN, etc.) | `NisoSts::StdId` | Supported | |
+| `<std-ref>` | Standard reference text | `NisoSts::StandardRef` | Supported | |
+| `<mixed-citation>` | Non-standard references | `NisoSts::MixedCitation` | Partial | Missing `@id`, `<uri>`, `<break>` children |
+| `<title-wrap>` | Title grouping with `@xml:lang` | `NisoSts::TitleWrap` | Supported | |
+| `<proj-id>` | Project ID | `NisoSts::ProjId` | Supported | |
+| `<std-ident>` | Standard identification block | `NisoSts::StandardIdentification` | Partial | Missing `<isbn>`, `<std-id-group>`, `<suppl-type/number/version>` |
+| `<app-group>` | Annex group container | `NisoSts::AppGroup` | Supported | |
+| `<app>` | Individual annex | `NisoSts::App` | Supported | Has `@content-type`, `<annex-type>` |
+| `<annex-type>` | Annex type text (informative/normative) | Mapped as `:string` | Supported | |
+| `<content-language>` | Document language | `NisoSts::ContentLanguage` | Supported | |
+| `<permissions>` | Copyright info | `NisoSts::Permissions` | Partial | Missing `<license>` child; `copyright-statement` should allow markup not just string |
+| `<license>` | License within permissions | `NisoSts::License` | Supported | Not mapped as child of Permissions |
+| `<license-p>` | License paragraph | `NisoSts::LicenseP` | Supported | |
+| `<custom-meta-group>` | Custom metadata group | `NisoSts::CustomMetaGroup` | Supported | |
+| `<custom-meta>` | Custom metadata entry | `NisoSts::CustomMeta` | Supported | |
+| `<meta-name>` | Custom metadata name | `NisoSts::CustomMeta` (attr) | Supported | |
+| `<meta-value>` | Custom metadata value | `NisoSts::CustomMeta` (attr) | Supported | |
+| `<index>` | Back matter index | Missing | Missing | Not modeled -- legacy but still referenced |
+| `<self-uri>` | Self-reference URI | `NisoSts::SelfUri` | Supported | |
+
+## Attribute Gaps
+
+| Attribute | Parent Element | Guidelines Usage | Modeled | Status |
+|-----------|---------------|-----------------|---------|--------|
+| `@sec-type` | `<sec>` | "foreword", "intro", "scope", "norm-refs", "terms", "numbered-paragraph" | Yes (as `:type`) | Supported |
+| `@content-type` | `<app>` | "informative" / "normative" | Yes | Supported |
+| `@content-type` | `<ref-list>` | "norm-refs", "bibl" | Yes | Supported |
+| `@xml:lang` | `<title-wrap>` | Language code | Yes (via TitleWrap) | Supported |
+| `@type` | `<std-ref>` | "dated" / "undated" | Yes | Supported |
+| `@std-id-link-type` | `<std-id>` | "urn" | Yes | Supported |
+| `@std-id-type` | `<std-id>` | "dated" / "undated" | Yes | Supported |
+| `@orientation` | `<table-wrap>` | "landscape" / "portrait" | Yes | Supported |
+| `@specific-use` | `<ref>` | "delete" (IEC amendments) | No | Missing |
+
+## Key Gaps
+- [ ] **CRITICAL**: `<processing-meta>` not modeled as child of `<standard>` -- introduced in Ed 2.1
+- [ ] **CRITICAL**: `NisoSts::Front` does not map `<std-doc-meta>` as a child element
+- [ ] `NisoSts::Front` does not support `<adoption-front>` as child (it's on `Adoption` but not `Front`)
+- [ ] `NisoSts::Permissions` does not contain `<license>` as a child element -- guidelines show `<license>` inside `<permissions>` (IEC example)
+- [ ] `NisoSts::Permissions` maps `copyright-statement` as `:string` but guidelines show it can contain `<inline-graphic>` and mixed content (IEC example)
+- [ ] `NisoSts::Permissions` does not support multiple `<copyright-holder>` elements (needed for B.4.2)
+- [ ] `NisoSts::Reference` missing `<non-normative-note>` as a child (B.2.4)
+- [ ] `NisoSts::Reference` missing `@specific-use` attribute (for IEC amendments "delete")
+- [ ] `NisoSts::ReferenceStandard` missing `@content-type` attribute (used for "uri")
+- [ ] `NisoSts::MixedCitation` missing `@id` attribute
+- [ ] `<index>` element not modeled at all (legacy but still used in traditional production chain)
+- [ ] `NisoSts::MetadataStd` missing `<abstract>` as a child (shown in IEC metadata C.2)
+- [ ] `NisoSts::MetadataStd` missing `<isbn>` as a child (shown in IEC metadata C.2)
+- [ ] `NisoSts::MetadataStd` missing `<suppl-type>`, `<suppl-number>`, `<suppl-version>` (shown in IEC metadata)
+- [ ] `NisoSts::MetadataStd` missing `<counts>` child (shown in IEC metadata)
+- [ ] `NisoSts::MetadataStd` missing `<license_ref>` child (shown in IEC metadata example, under `<license>`)
+- [ ] `NisoSts::MetadataStd` only allows single `<permissions>` but IEC uses multiple (B.2.1)

data/GAPS.guidelines.iso-sts-ed2.1/05-content.md

@@ -0,0 +1,63 @@
+# Section 5: Content
+
+## Overview
+Section 5 covers content elements: text formatting, labels/titles, paragraphs, symbols, notes, examples, warnings, lists, text alignment arrays, quotations, graphics, and code.
+
+## Element Coverage
+
+| Element | Guidelines Usage | sts-ruby Model | Status | Notes |
+|---------|-----------------|---------------|--------|-------|
+| `<p>` | General body text | `NisoSts::Paragraph` | Supported | Has `@id`, `@style-type`, `@specific-use`; mixed content |
+| `<label>` | Numbering labels | `NisoSts::Label` | Supported | Mixed content with `<sup>` |
+| `<title>` | Designation titles | `NisoSts::Title` | Supported | |
+| `<bold>` | Bold formatting | `TbxIsoTml::Bold` | Supported | |
+| `<italic>` | Italic formatting | `TbxIsoTml::Italic` | Supported | |
+| `<underline>` | Underline formatting | `NisoSts::Underline` | Supported | |
+| `<strike>` | Strikethrough | `NisoSts::Strike` | Supported | |
+| `<monospace>` | Monospace font | `NisoSts::Monospace` | Supported | |
+| `<sub>` | Subscript | `NisoSts::Sub` | Supported | |
+| `<sup>` | Superscript | `NisoSts::Sup` | Supported | In `TbxIsoTml` namespace |
+| `<sc>` | Small caps | `NisoSts::Sc` | Supported | |
+| `<named-content>` | Variable quantities with `@content-type="variable"` | `NisoSts::NamedContent` | Partial | Missing `<sup>`, `<sub>`, `<italic>` children needed for variable symbols |
+| `<non-normative-note>` | Notes in body text | `NisoSts::NonNormativeNote` | Supported | Has `@id`, `@content-type`, `<label>`, `<p>` |
+| `<non-normative-example>` | Examples in body text | `NisoSts::NonNormativeExample` | Supported | Has `@id`, `<label>`, `<p>` |
+| `<list>` | Ordered and unordered lists | `NisoSts::List` | Supported | Has `@list-type`, `@id`, `@content-type` |
+| `<list-item>` | Items in lists | `NisoSts::ListItem` | Partial | Missing `@id` attribute |
+| `<array>` | Text alignment tables | `NisoSts::SectionArray` | Partial | Only contains `<table>`, not colgroup or other structures |
+| `<disp-quote>` | Block quotations | `NisoSts::DispQuote` | Partial | Missing `<permissions>` child; uses `<attribution>` instead of `<attrib>` with `@specific-use="source"` |
+| `<graphic>` | Block graphics | `NisoSts::Graphic` | Partial | Missing `@id`, `@specific-use` attributes; missing `<label>`, `<caption>` children (ISO sub-figures B.2.16) |
+| `<inline-graphic>` | Inline graphics | `NisoSts::InlineGraphic` | Supported | Has `@specific-use`, `@href`, etc. |
+| `<code>` | Code blocks (new) | Missing | Missing | **Critical gap** -- replaces `<preformat>` for code; planned `@language`, `@language-version` attributes |
+| `<inline-code>` | Inline code (new) | Missing | Missing | **Critical gap** -- inline equivalent of `<code>` |
+| `<preformat>` | Preformatted text (legacy) | `NisoSts::Preformat` | Supported | Legacy, being replaced by `<code>` |
+| `<styled-content>` | Styled text with semantic meaning | `NisoSts::StyledContent` | Supported | Has `@style`, `@style-type`, `@specific-use` |
+| `<break>` | Line breaks | `NisoSts::Break` | Supported | |
+
+## Attribute Gaps
+
+| Attribute | Parent Element | Guidelines Usage | Modeled | Status |
+|-----------|---------------|-----------------|---------|--------|
+| `@content-type` | `<p>` | "dimension" for unit statements, "warning" for warnings | No | Missing on `Paragraph` |
+| `@list-type` | `<list>` | "alpha-lower", "arabic", "roman-lower", "dash", "bullet", "simple", "order", "roman-upper", "alpha-upper", "symbol", "other" | Yes | Supported |
+| `@style-type` | `<p>` | Alignment: "align-left", "align-right", "align-center", etc. (legacy) | Yes | Supported |
+| `@xlink:href` | `<graphic>` | Reference to graphic file | Yes | Supported (via `:xlink_href`) |
+| `@specific-use` | `<graphic>` | Size indicator: "size:T", "size:S", "size:M", "size:L" | No | Missing on `Graphic` |
+| `@id` | `<graphic>` | Element identifier | No | Missing on `Graphic` |
+| `@id` | `<list-item>` | Element identifier (Sec 3.4) | No | Missing on `ListItem` |
+| `@content-type` | `<non-normative-note>` | "warning" for warnings | Yes | Supported |
+| `@language` | `<code>` | Code language (planned) | N/A | Element missing |
+| `@language-version` | `<code>` | Code language version (planned) | N/A | Element missing |
+
+## Key Gaps
+- [ ] **CRITICAL**: `<code>` element not modeled -- the primary element for code blocks in new content (replacing `<preformat>`)
+- [ ] **CRITICAL**: `<inline-code>` element not modeled -- inline code equivalent
+- [ ] `NisoSts::Paragraph` missing `@content-type` attribute -- guidelines use `<p content-type="dimension">` for unit statements in figures and tables
+- [ ] `NisoSts::Graphic` missing `@id` attribute -- listed in Sec 3.4 as needing ID
+- [ ] `NisoSts::Graphic` missing `@specific-use` attribute -- guidelines define size indicators (size:T, size:S, size:M, size:L)
+- [ ] `NisoSts::Graphic` missing `<label>` and `<caption>` children -- ISO uses these for sub-figure captions (B.2.16)
+- [ ] `NisoSts::ListItem` missing `@id` attribute -- listed in Sec 3.4 as needing ID
+- [ ] `NisoSts::NamedContent` missing child elements (`<sup>`, `<sub>`, `<italic>`) -- needed for variable quantity symbols (Sec 5.5)
+- [ ] `NisoSts::DispQuote` uses `<attribution>` but guidelines show `<attrib specific-use="source">` (Sec 5.9)
+- [ ] `NisoSts::DispQuote` missing `<permissions>` child -- guidelines mention permissions within disp-quote
+- [ ] `NisoSts::NonNormativeNote` missing `<xref>` child -- needed for references within notes
+- [ ] `NisoSts::NonNormativeNote` missing `<non-normative-note>` child (nested notes in legacy B.2.10)

data/GAPS.guidelines.iso-sts-ed2.1/06-tables.md

@@ -0,0 +1,53 @@
+# Section 6: Tables
+
+## Overview
+Section 6 covers formal and informal tables, table cell styling (alignment, borders, background color), merged cells, line breaks and lists within tables, and landscape tables.
+
+## Element Coverage
+
+| Element | Guidelines Usage | sts-ruby Model | Status | Notes |
+|---------|-----------------|---------------|--------|-------|
+| `<table-wrap>` | Formal table container | `TbxIsoTml::TableWrap` | Partial | Missing `@width` attribute; label mapped as `:string` not as `Label` type |
+| `<table>` | XHTML table | `TbxIsoTml::Table` | Supported | Has `@border`, `@frame`, `@rules`, `@width`, `@style`, `@cellspacing`, `@cellpadding` |
+| `<col>` | Column specification | `TbxIsoTml::Col` | Supported | Has `@width`, `@align`, `@valign`, `@span` |
+| `<colgroup>` | Column group | `TbxIsoTml::Colgroup` | Supported | |
+| `<thead>` | Table header | `TbxIsoTml::Thead` | Supported | Has `@align`, `@valign`, `@style` |
+| `<tbody>` | Table body | `TbxIsoTml::Tbody` | Supported | |
+| `<tfoot>` | Table footer (legacy) | `TbxIsoTml::Tfoot` | Supported | |
+| `<tr>` | Table row | `TbxIsoTml::Tr` | Supported | |
+| `<th>` | Table header cell | `TbxIsoTml::Th` | Supported | Has `@align`, `@valign`, `@colspan`, `@rowspan`, `@style`, children including `<p>`, `<bold>`, `<break>` |
+| `<td>` | Table data cell | `TbxIsoTml::Td` | Supported | Has `@align`, `@valign`, `@colspan`, `@rowspan`, `@style`; children include `<p>`, `<list>`, `<xref>`, `<non-normative-note>` |
+| `<caption>` | Table caption | `NisoSts::Caption` | Supported | Contains `<title>`, `<p>` |
+| `<label>` | Table label | `NisoSts::Label` | Supported | |
+| `<table-wrap-foot>` | Table footer wrapper | `TbxIsoTml::TableWrapFoot` | Partial | Missing `@id`; missing `<p content-type="dimension">`; multiple `<fn>` elements not supported |
+| `<fn>` | Footnotes in tables | `NisoSts::Fn` / `TbxIsoTml::Fn` | Supported | |
+| `<break>` | Line breaks in cells | `NisoSts::Break` / `TbxIsoTml::TableBreak` | Supported | |
+| `<array>` | Informal table container | `NisoSts::SectionArray` | Partial | Only supports `<table>`, not colgroup |
+
+## Attribute Gaps
+
+| Attribute | Parent Element | Guidelines Usage | Modeled | Status |
+|-----------|---------------|-----------------|---------|--------|
+| `@orientation` | `<table-wrap>` | "landscape" / "portrait" | Yes | Supported |
+| `@content-type` | `<table-wrap>` | "fig-index" (ISO figure keys), "dimension" | Yes | Supported |
+| `@width` | `<table>` | Table width in px or % | Yes | Supported |
+| `@width` | `<table-wrap>` | Table wrapper width | No | Missing |
+| `@border` | `<table>` | Border width | Yes | Supported |
+| `@frame` | `<table>` | Frame type ("box", etc.) | Yes | Supported |
+| `@rules` | `<table>` | Rules ("all", "groups", etc.) | Yes | Supported |
+| `@style` | `<td>`, `<th>` | Cell styling (borders, background-color) | Yes | Supported |
+| `@align` | `<td>`, `<th>`, `<col>`, `<thead>`, `<tbody>` | Horizontal alignment | Yes | Supported |
+| `@valign` | `<td>`, `<th>`, `<col>`, `<thead>`, `<tbody>` | Vertical alignment | Yes | Supported |
+| `@colspan` | `<td>`, `<th>` | Column spanning | Yes | Supported |
+| `@rowspan` | `<td>`, `<th>` | Row spanning | Yes | Supported |
+| `@scope` | `<td>`, `<th>` | Scope for accessibility | Yes | Supported |
+| `@content-type` | `<p>` (inside `<table-wrap-foot>`) | "dimension" for unit statements | No | `@content-type` missing on `Paragraph` |
+| `@id` | `<table-wrap-foot>` | Element identifier | No | Missing on `TableWrapFoot` |
+
+## Key Gaps
+- [ ] `TbxIsoTml::TableWrap` maps `<label>` as `:string` instead of `NisoSts::Label` type -- label can contain `<sup>` markup for footnote markers
+- [ ] `TbxIsoTml::TableWrapFoot` missing `@id` attribute
+- [ ] `TbxIsoTml::TableWrapFoot` only supports single `<fn>` -- guidelines show multiple `<fn>` elements in table footers
+- [ ] `TbxIsoTml::TableWrapFoot` missing multiple `<p>` children -- guidelines show `<p content-type="dimension">` for unit statements
+- [ ] `TbxIsoTml::TableWrapFoot` missing `<tr>` as child -- legacy IEC coding has `<tr>` inside `<table-wrap-foot>` (B.2.14)
+- [ ] `NisoSts::Paragraph` missing `@content-type` attribute -- needed for `<p content-type="dimension">` in table footers

data/GAPS.guidelines.iso-sts-ed2.1/07-formulae.md

@@ -0,0 +1,41 @@
+# Section 7: Formulae and Equations
+
+## Overview
+Section 7 covers display formulae, inline formulae, formula numbering, notes to formulae, formula keys (using `<legend>`), and MathML.
+
+## Element Coverage
+
+| Element | Guidelines Usage | sts-ruby Model | Status | Notes |
+|---------|-----------------|---------------|--------|-------|
+| `<disp-formula>` | Block formulae | `NisoSts::DisplayFormula` | Partial | Missing `<legend>`, `<non-normative-note>`, `<def-list>` children |
+| `<inline-formula>` | Inline formulae | `NisoSts::InlineFormula` | Supported | Has `@id`, `<math>`, `<alternatives>` |
+| `<mml:math>` | MathML expression | `TbxIsoTml::Math` | Partial | Limited MathML element support |
+| `<label>` | Formula number e.g. "(1)" | `NisoSts::Label` | Supported | |
+| `<legend>` | Formula key container (new) | Missing | Missing | **Critical gap** -- introduced for formula keys in Ed 2.1 OSD |
+| `<def-list>` | Formula key definition list | `NisoSts::DefList` | Supported | Has `@list-content` (note: model has `@list-type` not `@list-content`) |
+| `<def-item>` | Key term/definition pair | `NisoSts::DefItem` | Partial | Missing `@id` attribute |
+| `<term>` | Key variable symbol | `NisoSts::Term` | Supported | |
+| `<def>` | Key variable definition | `NisoSts::Def` | Supported | |
+| `<non-normative-note>` | Notes to formulae | `NisoSts::NonNormativeNote` | Supported | Not mapped as child of `DisplayFormula` |
+| `<tex-math>` | TeX math representation | `NisoSts::TexMath` | Supported | |
+| `<graphic>` | Formula graphic | `NisoSts::Graphic` | Supported | |
+
+## Attribute Gaps
+
+| Attribute | Parent Element | Guidelines Usage | Modeled | Status |
+|-----------|---------------|-----------------|---------|--------|
+| `@id` | `<disp-formula>` | Formula identifier | Yes | Supported |
+| `@content-type` | `<disp-formula>` | Formula content type | Yes | Supported |
+| `@display` | `<mml:math>` | "block" for display formulae | Yes | Supported |
+| `@id` | `<mml:math>` | Math element ID (e.g. "mml_m5") | Yes | Supported |
+| `@list-content` | `<def-list>` | "formula" for formula keys | No | Model has `@list-type` not `@list-content`; guidelines use `@list-content` |
+| `@id` | `<def-item>` | Item identifier | No | Missing |
+
+## Key Gaps
+- [ ] **CRITICAL**: `<legend>` element not modeled -- used for formula keys and figure keys (Sec 7.3, 8.3). Contains `<title>` and `<def-list>`
+- [ ] **CRITICAL**: `NisoSts::DisplayFormula` missing `<legend>` as a child element -- primary container for formula keys in OSD
+- [ ] **CRITICAL**: `NisoSts::DisplayFormula` missing `<non-normative-note>` as a child element -- Sec 7.2 explicitly allows notes after `<mml:math>`
+- [ ] **CRITICAL**: `NisoSts::DisplayFormula` missing `<def-list>` as a child element -- needed when legend is not used
+- [ ] `NisoSts::DefList` has `@list-type` but guidelines use `@list-content` (value "formula", "figure", "abbreviation") -- possible attribute name mismatch
+- [ ] `NisoSts::DefItem` missing `@id` attribute -- all def-items in examples carry IDs
+- [ ] `TbxIsoTml::Math` has limited MathML child elements -- missing `<mover>`, `<munder>`, `<mtable>`, `<mtr>`, `<mtd>`, `<mpadded>`, `<maction>`, `<mphantom>`, etc.

data/GAPS.guidelines.iso-sts-ed2.1/08-figures.md

@@ -0,0 +1,45 @@
+# Section 8: Figures
+
+## Overview
+Section 8 covers figure elements, sub-figures and figure groups, figure keys, and unit statements in figures.
+
+## Element Coverage
+
+| Element | Guidelines Usage | sts-ruby Model | Status | Notes |
+|---------|-----------------|---------------|--------|-------|
+| `<fig>` | Figure element | `NisoSts::Figure` | Partial | Missing `<legend>`, `<def-list>` (for IEC keys) should be collection, missing `<inline-graphic>`, missing `<supplementary-material>` |
+| `<fig-group>` | Sub-figure group | `NisoSts::FigGroup` | Partial | Missing `<legend>`, `<non-normative-note>` children |
+| `<label>` | Figure number | `NisoSts::Label` | Supported | |
+| `<caption>` | Figure caption | `NisoSts::Caption` | Supported | Contains `<title>`, `<p>` |
+| `<graphic>` | Figure graphic | `NisoSts::Graphic` | Partial | Missing `<label>`, `<caption>` children for sub-figure captions (ISO) |
+| `<inline-graphic>` | Inline graphic in figure keys | `NisoSts::InlineGraphic` | Supported | |
+| `<legend>` | Figure key container (new) | Missing | Missing | **Critical gap** -- introduced in Ed 2.1 for figure keys |
+| `<def-list>` | Figure key items | `NisoSts::DefList` | Supported | Mapped in `Figure` but as singular (should be collection for multiple keys) |
+| `<def-item>` | Key item pair | `NisoSts::DefItem` | Supported | |
+| `<term>` | Key symbol/number | `NisoSts::Term` | Supported | |
+| `<def>` | Key description | `NisoSts::Def` | Supported | |
+| `<non-normative-note>` | Figure notes | `NisoSts::NonNormativeNote` | Supported | Mapped in `Figure` |
+| `<table-wrap>` | ISO figure key table | `TbxIsoTml::TableWrap` | Supported | ISO uses `<table-wrap content-type="fig-index">` for figure keys |
+| `<p>` | Unit statements, caption content | `NisoSts::Paragraph` | Partial | Missing `@content-type` for dimension statements |
+
+## Attribute Gaps
+
+| Attribute | Parent Element | Guidelines Usage | Modeled | Status |
+|-----------|---------------|-----------------|---------|--------|
+| `@id` | `<fig>` | Figure identifier | Yes | Supported |
+| `@orientation` | `<fig>` | "landscape" / "portrait" | Yes | Supported |
+| `@fig-type` | `<fig>` | Usually "figure" (ISO) | Yes | Supported |
+| `@content-type` | `<p>` (in `<caption>`) | "dimension" for unit statements | No | Missing on `Paragraph` |
+| `@list-content` | `<def-list>` | "figure" for figure keys | No | Model has `@list-type` not `@list-content` |
+| `@id` | `<fig-group>` | Figure group identifier | Yes | Supported |
+| `@orientation` | `<fig-group>` | "landscape" / "portrait" | Yes | Supported |
+
+## Key Gaps
+- [ ] **CRITICAL**: `<legend>` element not modeled -- the primary container for figure keys in OSD (Sec 8.3). Contains `<title>` ("Key") and `<def-list>`
+- [ ] `NisoSts::Figure` missing `<legend>` as a child element
+- [ ] `NisoSts::FigGroup` missing `<legend>` as a child element -- "only one `<legend>` for each `<fig-group>`" (Sec 8.2)
+- [ ] `NisoSts::FigGroup` missing `<non-normative-note>` and `<non-normative-example>` children -- guidelines say these go in the last `<fig>` but the group should support them
+- [ ] `NisoSts::Figure` maps `<def-list>` as singular but guidelines show figure can contain both `<def-list>` (IEC keys) and `<legend>` (new OSD keys)
+- [ ] `NisoSts::Graphic` missing `<label>` and `<caption>` children -- ISO sub-figures use `<graphic>` with `<label>` and `<caption>` (Sec B.2.16)
+- [ ] `NisoSts::Paragraph` missing `@content-type` attribute -- needed for `<p content-type="dimension">` in figure captions (Sec 8.4)
+- [ ] `NisoSts::DefList` has `@list-type` but guidelines use `@list-content="figure"` -- possible attribute name mismatch

data/GAPS.guidelines.iso-sts-ed2.1/09-terms.md

@@ -0,0 +1,56 @@
+# Section 9: Terms and Definitions
+
+## Overview
+Section 9 covers terminological entries using TBX (Term Base eXchange), including term entries, definitions, term information groups, examples, notes, cross-references, sources, and subject fields.
+
+## Element Coverage
+
+| Element | Guidelines Usage | sts-ruby Model | Status | Notes |
+|---------|-----------------|---------------|--------|-------|
+| `<term-sec>` | Terminological entry container | `NisoSts::TermSection` | Supported | Has `@id`, `@sec-type`, `<label>`, `<termEntry>`, `<term-display>` |
+| `<tbx:termEntry>` | TBX term entry | `TbxIsoTml::TermEntry` | Supported | Has `@id`, `<langSet>` |
+| `<tbx:langSet>` | Language set | `TbxIsoTml::LangSet` | Supported | Has `@xml:lang`, `<definition>`, `<note>`, `<example>`, `<tig>`, `<source>`, `<subjectField>`, `<see>` |
+| `<tbx:definition>` | Term definition | `TbxIsoTml::Definition` | Supported | Mixed content with `<entailedTerm>`, `<italic>`, `<sub>`, `<sup>`, `<list>`, `<std>` |
+| `<tbx:tig>` | Term information group | `TbxIsoTml::TermInformationGroup` | Supported | Has `<term>`, `<partOfSpeech>`, `<normativeAuthorization>`, `<termType>`, `<grammaticalNumber>` |
+| `<tbx:term>` | Term text | `TbxIsoTml::Term` | Supported | Has `@id`, mixed content with `<italic>`, `<bold>`, `<sub>`, `<sup>` |
+| `<tbx:partOfSpeech>` | Part of speech | `TbxIsoTml::PartOfSpeech` | Supported | `@value`: noun, verb, adj, adv |
+| `<tbx:normativeAuthorization>` | Term status | `TbxIsoTml::NormativeAuthorization` | Supported | `@value`: preferredTerm, admittedTerm, deprecatedTerm |
+| `<tbx:termType>` | Term type | `TbxIsoTml::TermType` | Supported | `@value`: fullForm, abbreviation, symbol, formula, etc. |
+| `<tbx:grammaticalNumber>` | Singular/plural | `TbxIsoTml::GrammaticalNumber` | Supported | `@value`: singular, plural |
+| `<tbx:grammaticalGender>` | Gender | `TbxIsoTml::GrammaticalGender` | Supported | `@value`: masculine, feminine, neuter |
+| `<tbx:geographicalUsage>` | Geographic usage | `TbxIsoTml::GeographicalUsage` | Supported | Content-based |
+| `<tbx:pronunciation>` | Pronunciation | `TbxIsoTml::Pronunciation` | Supported | Content-based |
+| `<tbx:note>` | Notes in terminology | `TbxIsoTml::Note` | Supported | Has `@id`, `<entailedTerm>`, `<xref>`, `<list>` |
+| `<tbx:example>` | Examples in terminology | `TbxIsoTml::Example` | Supported | Has `@id`, `<entailedTerm>`, `<italic>` |
+| `<tbx:entailedTerm>` | Cross-ref to other terms | `TbxIsoTml::EntailedTerm` | Supported | Has `@target`, content text |
+| `<tbx:source>` | Source of term | `TbxIsoTml::Source` | Partial | Missing `<std>` child -- IEC codes `<std>` references inside source (Sec B.2.17) |
+| `<tbx:subjectField>` | Subject field | `TbxIsoTml::SubjectField` | Supported | Content-based |
+| `<tbx:see>` | Cross-reference from terms | `TbxIsoTml::See` | Supported | Has `@script`, content |
+| `<term-display>` | Display-oriented terms (IEC) | `NisoSts::TermDisplay` | Partial | Missing `<term>` child, `<def>` child, `<list>` child -- guidelines show full display entries (Sec B.3.3) |
+| `<label>` | Entry number | `NisoSts::Label` | Supported | |
+| `<xref>` | Cross-references to terms | `TbxIsoTml::Xref` | Partial | Missing `@custom-type` attribute |
+
+## Attribute Gaps
+
+| Attribute | Parent Element | Guidelines Usage | Modeled | Status |
+|-----------|---------------|-----------------|---------|--------|
+| `@xml:lang` | `<tbx:langSet>` | Language of the term entry | Yes | Supported |
+| `@id` | `<tbx:termEntry>` | Term entry ID | Yes | Supported |
+| `@id` | `<tbx:term>` | Term ID | Yes | Supported |
+| `@value` | `<tbx:partOfSpeech>` | "noun", "verb", "adj", "adv" | Yes | Supported |
+| `@value` | `<tbx:normativeAuthorization>` | "preferredTerm", "admittedTerm", "deprecatedTerm" | Yes | Supported |
+| `@value` | `<tbx:termType>` | "fullForm", "abbreviation", "symbol", "formula" | Yes | Supported |
+| `@target` | `<tbx:entailedTerm>` | ID of referenced entry | Yes | Supported |
+| `@target` | `<tbx:see>` | ID of referenced element (legacy) | No | Missing `@target` on `See` |
+| `@ref-type` | `<xref>` | "custom" for term cross-refs | Yes | Supported |
+| `@custom-type` | `<xref>` | "term-entry" for cross-refs to terms | No | Missing on `Xref` |
+| `@rid` | `<xref>` | Target element ID | Yes | Supported |
+
+## Key Gaps
+- [ ] `TbxIsoTml::Source` missing `<std>` child element -- IEC codes standards references inside `<tbx:source>` (Sec B.2.17, Sec 9.2.8)
+- [ ] `NisoSts::TermDisplay` is incomplete -- missing `<term>`, `<def>`, `<list>` children needed for IEC legacy term display (Sec B.3.3)
+- [ ] `TbxIsoTml::See` missing `@target` attribute -- legacy `<tbx:see>` uses `@target` for cross-references (Sec B.2.18)
+- [ ] `TbxIsoTml::Xref` missing `@custom-type` attribute -- guidelines specify `@custom-type="term-entry"` for cross-refs to terms from outside the terminology section (Sec 9.2.6)
+- [ ] `TbxIsoTml::LangSet` missing `<xref>` child -- Sec 9.2.7 says `<xref>` is used for references from terms to other document sections (replaces `<tbx:see>`)
+- [ ] `TbxIsoTml::Note` missing text content mapping -- TBX notes contain text directly, but model maps children only
+- [ ] `TbxIsoTml::Example` missing `<break>` child -- may need line breaks in examples