sts 0.5.6 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6978d54e78a3b856fabb8c79a810c03b1b7ac57326453dc695b212405ef5bb50
-  data.tar.gz: 3f9e168d8fe68849e4002c1c1b912e11fc0d2d83b0f9920487e3983f455b63dc
+  metadata.gz: 13e2f7f08de69885f2e625b3e46d6d459116fe58692c735a5a003113e7a80a77
+  data.tar.gz: eb1de3ce704b4d955a89bce414ceea801ebd6d8c51ecb3c3bc73ec44b88eb6f2
 SHA512:
-  metadata.gz: 0cb8492ca499c979631a349444635829b128cecffaf81a8805ac0ea6e4b0608d798d0b260af40470708497f680ae7b0a1eea8d90024e0180bf5a3810b51d98d4
-  data.tar.gz: 2b1838bdbde38dfc2cef5ea6218e4c48b6e04e99fd169d45c9d6bfe34929239d07b9b62df3bc834921605fa2103a90c29da281225b6e2a52d4c58f7cc45be113
+  metadata.gz: 530f4e261194c92e8543cf8eb242e851be5aede2d365ff8ef7bef98f21d0f9a25e4d464632ae108b61bdbaa43d5bb77c583c8c1ec7e14bc355f78016690cc01f
+  data.tar.gz: 231aebbc44901782184e018394071dbfc98db1245960b5161158a301b32ab6640a6c1190b1f23a133059848e7dc0e977ac625a47e1ad6198520aa88caff7441b

data/.github/workflows/rake.yml

@@ -8,6 +8,9 @@ on:
     tags: [ v* ]
   pull_request:
 
+permissions:
+  contents: write
+
 jobs:
   rake:
     uses: metanorma/ci/.github/workflows/generic-rake.yml@main

data/.github/workflows/release.yml

@@ -2,11 +2,6 @@
 # See https://github.com/metanorma/cimas
 name: release
 
-permissions:
-  contents: write
-  packages: write
-  id-token: write
-
 on:
   workflow_dispatch:
     inputs:
@@ -24,6 +19,17 @@ jobs:
     uses: metanorma/ci/.github/workflows/rubygems-release.yml@main
     with:
       next_version: ${{ github.event.inputs.next_version }}
+      # Explicit release_command needed since metanorma/ci#314 deprecated
+      # `bundler_cache` (hardcoded to false) — the reusable's release job no
+      # longer runs `bundle install` implicitly via ruby/setup-ruby, so the
+      # default `bundle exec rake release` fires against uninstalled gems.
+      # Surfaced by kwkwan on metanorma-plugin-lutaml#285. Deeper fix
+      # (bundle install inside rubygems-release.yml's release job) tracked
+      # separately.
+      release_command: |
+        bundle install
+        bundle exec rake release
     secrets:
       rubygems-api-key: ${{ secrets.METANORMA_CI_RUBYGEMS_API_KEY }}
       pat_token: ${{ secrets.METANORMA_CI_PAT_TOKEN }}
+

data/.rubocop.yml

@@ -1,16 +1,31 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
 inherit_from:
+  - https://raw.githubusercontent.com/riboseinc/oss-guides/main/ci/rubocop.yml
+  # .rubocop_todo.yml MUST be the last entry. inherit_from is last-wins:
+  # if listed before oss-guides, the shared config's stricter Metrics/
+  # (MethodLength, BlockLength, etc.) rules override the todo's per-file
+  # grandfathering, and the todo becomes inert on those cops. Empirically
+  # verified on suma 2026-07-06: with todo listed first, 34 Metrics/* offenses
+  # remained; moved last, cleared. Every gem in the metanorma-org fleet
+  # already ships a `.rubocop_todo.yml` on its live tree (audited 2026-07-06,
+  # 54/54 have it), so this reference is safe to emit unconditionally.
   - .rubocop_todo.yml
-  - https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml
+
+# Rubocop plugins enabled centrally so every metanorma-org gem picks them up
+# on cimas sync — best practice belongs at the shared-template layer, not
+# per-repo. Per ronaldtse feedback on metanorma/ci#332.
+plugins:
+  - rubocop-rspec
+  - rubocop-performance
+  - rubocop-rake
 
 # local repo-specific modifications
 # ...
 
-Metrics/BlockLength:
-  Max: 35
-
 AllCops:
-  TargetRubyVersion: 2.6
-  NewCops: enable
-  Exclude:
-    - 'lib/sts/mapper.rb'
-    - 'vendor/**/*'
+  # 3.3 matches the org-wide minimum being pushed via #274 (Raise minimum
+  # Ruby version to 3.3 due to EOL of 3.2 on 2026-03-31). Was 3.4 before
+  # this commit — 3.4 was above the org's stated minimum and would have
+  # applied Rubocop rules that fail-close on gems still targeting 3.3.
+  TargetRubyVersion: 3.3

data/.rubocop_todo.yml

@@ -1,11 +1,17 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-05-12 03:56:52 UTC using RuboCop version 1.86.1.
+# on 2026-07-15 03:29:27 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: 4
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLines:
+  Exclude:
+    - 'spec/sts_spec.rb'
+
 # Offense count: 14
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
@@ -21,16 +27,98 @@ Layout/LineLength:
     - 'spec/round_trip/reference_docs_spec.rb'
     - 'spec/spec_helper.rb'
 
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+Lint/RedundantDirGlobSort:
+  Exclude:
+    - 'spec/spec_helper.rb'
+
 # Offense count: 1
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Exclude:
     - 'lib/sts/iso_sts/mathml2/math.rb'
 
+# Offense count: 10
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 35
+
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
-# SupportedStyles: single_quotes, double_quotes
-Style/StringLiterals:
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: be, be_nil
+RSpec/BeNil:
   Exclude:
+    - 'spec/sts_spec.rb'
+
+# Offense count: 9
+# Configuration parameters: IgnoredMetadata.
+RSpec/DescribeClass:
+  Exclude:
+    - '**/spec/features/**/*'
+    - '**/spec/requests/**/*'
+    - '**/spec/routing/**/*'
+    - '**/spec/system/**/*'
+    - '**/spec/views/**/*'
+    - 'spec/anti_patterns_spec.rb'
+    - 'spec/elements/expanded_models_spec.rb'
+    - 'spec/elements/index_toc_spec.rb'
+    - 'spec/elements/missing_attributes_spec.rb'
+    - 'spec/elements/modified_elements_spec.rb'
     - 'spec/elements/new_elements_spec.rb'
+    - 'spec/elements/reference_models_spec.rb'
+    - 'spec/elements/structural_models_spec.rb'
+    - 'spec/round_trip/reference_docs_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+RSpec/EmptyLineAfterFinalLet:
+  Exclude:
+    - 'spec/sts_spec.rb'
+
+# Offense count: 62
+# Configuration parameters: CountAsOne.
+RSpec/ExampleLength:
+  Max: 40
+
+# Offense count: 5
+RSpec/LeakyLocalVariable:
+  Exclude:
+    - 'spec/anti_patterns_spec.rb'
+    - 'spec/round_trip/reference_docs_spec.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+RSpec/LetBeforeExamples:
+  Exclude:
+    - 'spec/sts_spec.rb'
+
+# Offense count: 1
+RSpec/MultipleDescribes:
+  Exclude:
+    - 'spec/profiles/iso_iec_validator_spec.rb'
+
+# Offense count: 67
+RSpec/MultipleExpectations:
+  Max: 14
+
+# Offense count: 4
+# Configuration parameters: AllowedPatterns.
+# AllowedPatterns: ^expect_, ^assert_
+RSpec/NoExpectationExample:
+  Exclude:
+    - 'spec/iso_sts/iso_sts_spec.rb'
+    - 'spec/sts_spec.rb'
+
+# Offense count: 2
+# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
+# SupportedInflectors: default, active_support
+RSpec/SpecFilePathFormat:
+  Exclude:
+    - '**/spec/routing/**/*'
+    - 'spec/sts_element_spec.rb'
+    - 'spec/sts_table_spec.rb'
+    - 'spec/iso_sts/iso_sts_spec.rb'
+    - 'spec/iso_sts/iso_sts_element_spec.rb'

data/TODO.sts-refactor/00-overview.md

@@ -19,7 +19,7 @@
 |---|------|----------|----------|--------------|
 | 01 | `01-mathml-delegation.md` | Anti-Pattern Fix | DONE | — |
 | 02 | `02-type-resolution.md` | Anti-Pattern Fix | DONE | — |
-| 03 | `03-namespace-coupling.md` | Architecture | IN PROGRESS | 01, 02 |
+| 03 | `03-namespace-coupling.md` | Architecture | IN PROGRESS (63→20 refs) | 01, 02 |
 | 04 | `04-register-versioning.md` | Architecture | HIGH | 01, 02 |
 | 05 | `05-missing-elements.md` | Feature Gap | MOSTLY DONE | 04 |
 | 06 | `06-missing-attributes.md` | Feature Gap | DONE | 04 |
@@ -140,7 +140,9 @@ grep -r "method_missing|respond_to_missing|Object.const_get|\.send" lib/
 ```
 
 ### IsoSts Namespace Independence (2026-05-07)
-- ARCHITECTURE DECISION: IsoSts and NisoSts must remain fully independent
+- ARCHITECTURE DECISION: IsoSts must be independent **of NisoSts**. This is not
+  independence in general — `lib/sts/iso_sts/` still references `TbxIsoTml` and
+  MathML types directly, and those shared namespaces are outside this ADR.
 - ISOSTS is frozen legacy; NISO STS evolves — combining them violates OCP
 - Created 11 new IsoSts-specific types: Monospace, Sc, Strike, Underline, Uri,
   NamedContent, StandardRef, MetaDate, ContentLanguage (with autoloads)
@@ -164,9 +166,27 @@ grep -r "method_missing|respond_to_missing|Object.const_get|\.send" lib/
 - ~~Expand StringName usage (in contrib, element-citation, related-article — NISO STS 1.2)~~ → DONE: added to name-alternatives; already in person-group and mixed-citation
 
 ### Architectural Items (High Effort)
-- `03-namespace-coupling.md` — IN PROGRESS: 157→63 IsoSts→NisoSts cross-references remaining
+- `03-namespace-coupling.md` — IN PROGRESS: 63→20 IsoSts→NisoSts references
+  remaining (issue #40). Source of truth is `ISOSTS.xsd`, NOT the NisoSts
+  models — they disagree on nearly every element.
 - `04-register-versioning.md` — Version the models via lutaml-model Registers
 - `11-duplicate-models.md` — 44 overlapping element resolution (depends on 03)
 
+### Known bugs — schema conformance (separate from 03)
+The 2026-05-07 "@id added to all models (XSD-verified)" pass verified against
+the **NISO** XSD and applied the result to IsoSts. ISOSTS disagrees:
+- **16 IsoSts models silently drop ISOSTS attributes that exist** — real data
+  loss. `sub`/`sup` lose `arrange`+`specific-use`; `ext-link` loses 5 xlink
+  attrs; `mixed-citation` loses 6; `graphic`, `copyright-*`, `edition`,
+  `title`, `label`, `uri`, `named-content`, `underline`, `meta-date`, `body`
+  lose others.
+- **25 IsoSts models carry an `@id` ISOSTS does not define** — harmless (never
+  populated on parse, never emitted on serialise), but dead surface.
+
 ## Next Action
-Proceed with `03-namespace-coupling.md` — audit and resolve 157+ IsoSts→NisoSts cross-references.
+Two independent tracks:
+1. Finish `03` — the 20 remaining refs split into 11 deep-root refs (each
+   reaching a ~152-class recursive core) and 9 child-bearing refs whose closure
+   is unmeasured. Both need sizing before planning.
+2. File and fix the 16 lossy models above — real data loss, unrelated to
+   decoupling.

data/TODO.sts-refactor/03-namespace-coupling.md

@@ -3,156 +3,117 @@
 **Priority**: HIGH
 **Category**: Architecture
 **Estimated Effort**: High
-**Files Affected**: `lib/sts/iso_sts/content_groups/highlight_elements.rb` (194+ references)
+**Status**: Partially done — 63 → 20 references (GitHub issue #40)
 
 ## Problem
 
-`lib/sts/iso_sts/content_groups/highlight_elements.rb` contains 194+ references to `Sts::NisoSts::*` types:
-
-```ruby
-# Examples from highlight_elements.rb
-[:sub, "Sts::NisoSts::Sub", "sub"]
-[:sup, "Sts::NisoSts::Sup", "sup"]
-[:italic, "Sts::NisoSts::Italic", "italic"]
-[:bold, "Sts::NisoSts::Bold", "bold"]
-# ... 190 more
-```
-
-### Why This Is Wrong
-
-1. **Violation of namespace isolation**: IsoSts should not depend on NisoSts implementation
-2. **Shared-namespace ambiguity**: These elements appear in both ISOSTS and NISO STS but with different attribute sets
-3. **Tight coupling**: Changes to NisoSts can break IsoSts
-4. **Schema divergence ignored**: `<p>` in ISOSTS has different attributes than `<p>` in NISO STS Extended
-
-### Root Cause
-
-The schemas ARE different:
-- ISOSTS `<p>`: `@content-type, @id, @specific-use, @xml:lang`
-- NISO STS Extended `<p>`: `@content-type, @id, @originator, @specific-use, @style-type, @xml:base, @xml:lang`
-
-## Solution: Three-Tier Architecture
-
-### Tier 1: Shared Base Types
-
-Create shared types in `Sts::Base` that both namespaces inherit:
-
-```ruby
-# lib/sts/base/text/emphasis.rb
-module Sts
-  module Base
-    module Text
-      class Emphasis < Lutaml::Model::Serializable
-        # Shared attributes/methods
-        attribute :id, :string
-        attribute :base_fontsize, :string
-        attribute :baseline_shift, :string
-        attribute :color, :string
-
-        xml do
-          map_attribute :id, to: :id
-          # ...
-        end
-      end
-
-      class Bold < Emphasis
-        xml { element "bold" }
-      end
-
-      class Italic < Emphasis
-        xml { element "italic" }
-      end
-
-      class Sub < Emphasis
-        xml { element "sub" }
-      end
-
-      class Sup < Emphasis
-        xml { element "sup" }
-      end
-    end
-  end
-end
-```
-
-### Tier 2: IsoSts-Specific Extensions
-
-```ruby
-# lib/sts/iso_sts/text/emphasis.rb
-module Sts
-  module IsoSts
-    module Text
-      class Bold < ::Sts::Base::Text::Bold
-        # Add IsoSts-specific attributes
-        attribute :content_type, :string
-
-        xml do
-          # Override/add IsoSts-specific mapping
-          map_attribute "content-type", to: :content_type
-        end
-      end
-    end
-  end
-end
-```
-
-### Tier 3: NisoSts-Specific Extensions
-
-```ruby
-# lib/sts/niso_sts/text/emphasis.rb
-module Sts
-  module NisoSts
-    module Text
-      class Bold < ::Sts::Base::Text::Bold
-        # Add NisoSts-specific attributes
-        attribute :originator, :string
-        attribute :style_type, :string
-
-        xml do
-          map_attribute "originator", to: :originator
-          map_attribute "style-type", to: :style_type
-        end
-      end
-    end
-  end
-end
-```
-
-## Implementation Strategy
-
-1. **Phase 1**: Identify all shared element types (bold, italic, sub, sup, p, etc.)
-2. **Phase 2**: Create base types with MINIMAL shared attributes
-3. **Phase 3**: Refactor IsoSts to extend bases
-4. **Phase 4**: Refactor NisoSts to extend bases
-5. **Phase 5**: Delete `Sts::NisoSts::*` references from IsoSts content groups
-
-## Files to Refactor
-
-Primary targets:
-- `lib/sts/iso_sts/content_groups/highlight_elements.rb`
-- `lib/sts/iso_sts/content_groups/emphasis_elements.rb` (if exists)
-- `lib/sts/niso_sts/content_groups/highlight_elements.rb`
+`lib/sts/iso_sts/` references `Sts::NisoSts::*` types directly. IsoSts must be
+independent of NisoSts (ADR 2026-05-07): ISOSTS is frozen legacy, NISO STS
+evolves, so coupling them violates OCP.
+
+PR #31 reduced this from 157 to 63 references. Issue #40 reduced it further,
+from 63 to 20.
+
+## Source of truth: ISOSTS.xsd, NOT the NisoSts models
+
+The obvious approach — duplicate each NisoSts class into IsoSts — produces
+**schema-incorrect models**. The NisoSts models disagree with
+`reference-docs/isosts-v1/xsd/ISOSTS.xsd` on nearly every element:
+
+| Element | ISOSTS says | NisoSts model |
+|---|---|---|
+| `year` (:948) | `content-type`, `specific-use`, `xml:lang` — no `@id` | `@id` only |
+| `doc-type` (:6378) | `type="xs:string"` — no attributes at all | `@id` + content |
+| `ics` (:6373) | `type="xs:string"` | `@id` + `ics-desc` child |
+| `fpage` | `content-type`, `seq`, `specific-use`, `xml:lang`; no children | `@id` + bold/italic |
+| `license` (:51) | `license-type`, `specific-use`, `xml:lang` | `@id`, `xlink:href` |
+| `ruby` | **not an ISOSTS element** | exists (NISO only) |
+
+`feature_doc.xml` declares `<!DOCTYPE standard SYSTEM ".../ISOSTS.dtd">`, and
+the ISOSTS DTD agrees with ISOSTS.xsd (both derive `bold`, `sub` etc. from the
+JATS 0.4 modules). ISOSTS.xsd is a faithful conversion and is the authority.
+
+**Round-tripping does not prove correctness.** A model that invents or drops an
+attribute still parses and serialises symmetrically, so the suite stays green
+while the model is wrong. Assert the exact attribute set per element instead.
+
+Attribute lists must be **generated** from the XSD, never hand-read: `version`
+on `tex-math` and `specific-use` on `pub-id` sit after long `xs:enumeration`
+blocks and are invisible to a truncated read.
+
+## Done in issue #40 — 43 refs removed, 27 classes added
+
+- **14 `xs:string` elements** (`originator`, `doc-type`, `doc-number`,
+  `part-number`, `version`, `suppl-type`, `suppl-number`, `suppl-version`,
+  `urn`, `sdo`, `proj-id`, `release-version`, `ics`, `secretariat`) — modelled
+  as content-only IsoSts classes with no attributes. 23 refs.
+- **3 `permissions` refs** repointed to the existing `IsoSts::Permissions`.
+- **`ruby` deleted** from `StyledContent` — ISOSTS defines no such element.
+  Behaviour change: `<ruby>` in `<styled-content>` no longer round-trips.
+- **13 element classes** modelled from ISOSTS.xsd: `Year`, `PubDate`,
+  `ReleaseVersionId`, `IsProof`, `AltText`, `LongDesc`, `TexMath`, `PubId`,
+  `Volume`, `Issue`, `Fpage`, `Lpage`, `PageRange`. 16 refs.
+- **`WiNumber` added** — ISOSTS gives `wi-number` an `@id`; it was typed as a
+  plain string, silently discarding that `@id`.
+
+### Why classes and not plain `:string`
+
+`xs:string` elements look like they need no class. They do: an empty element
+(`<sdo/>`, which `feature_doc.xml` contains) does not survive a `:string`
+round-trip. For a scalar, `render_empty: :empty` recovers it; for a collection
+(`secretariat`, `ics` — both `maxOccurs="unbounded"`) an empty element parses
+to `[]`, destroying the information at parse time before any render option
+applies. Content-only classes round-trip every case.
+
+## Remaining — 20 refs
+
+**11 refs to 9 deep roots**: `MetadataStd`, `ElementCitation`, `PersonGroup`,
+`Collab`, `Source`, `DispQuote`, `EditingInstruction`, `TermDisplay`,
+`BoxedText`. Each reaches the same ~152-class mutually-recursive core
+(`Section` → `Paragraph` → `DispQuote` → `Paragraph`). `DispQuote` has 3 direct
+children but pulls all 152. No incremental path — needs its own decision.
+
+**9 refs whose ISOSTS content models have real children**, closure not measured:
+`attrib` (:1082), `term-head` (:4308), `article-title`, `license` → `license-p`
+(:51), `publisher` → `publisher-loc`, `custom-meta-group` → `custom-meta`.
+`attrib` and `term-head` are **not** trivial leaves in ISOSTS despite what the
+NisoSts models suggest; `license-p` reaches `array`/`alternatives`, so these may
+not be cheap. Measure before planning.
+
+## Rejected: three-tier `Sts::Base` hierarchy
+
+An earlier draft of this document proposed shared base types in `Sts::Base` that
+both namespaces inherit. This contradicts the 2026-05-07 ADR, and the schemas
+genuinely diverge — `IsoSts::Fig` has `title`/`alternatives` that
+`NisoSts::Figure` lacks; `IsoSts::Ref` has `nlm-citation`/`citation-alternatives`
+that `NisoSts::Reference` lacks. A shared base would fight the schemas.
+
+That draft also targeted `lib/sts/iso_sts/content_groups/highlight_elements.rb`
+and "194+ references" to emphasis types. That file was deleted as dead code; the
+real work was metadata types, not highlight elements.
+
+## Naming trap (for the deferred work)
+
+A mechanical `s/NisoSts::/IsoSts::/` is wrong. Nine elements already have
+different class names per namespace, so a blind rename creates `IsoSts::Section`
+alongside the existing `IsoSts::Sec` — two classes for one `sec` element:
+
+`Section`/`Sec`, `Figure`/`Fig`, `Reference`/`Ref`, `ReferenceList`/`RefList`,
+`SectionArray`/`Array`, `StdCrossReference`/`StandardCrossReference`,
+`DisplayFormula`/`DispFormula`, `TermSection`/`TermSec`,
+`ReferenceStandard`/`Std`.
+
+Remap child references by **XML element name**, not class name.
+
+## Scope boundary
+
+Independence from NisoSts is not independence in general: `lib/sts/iso_sts/`
+still references 6 `TbxIsoTml` types directly, and much of the deferred closure
+reaches `TbxIsoTml`/MathML. Those are shared namespaces, outside this ADR.
 
 ## Verification
 
-1. No `Sts::NisoSts` references in `lib/sts/iso_sts/`
-2. All round-trip tests pass
-3. Schema validation against both ISOSTS DTD and NISO STS XSD passes
-
-## Dependencies
-
-- `01-mathml-delegation.md` — uses similar patterns
-- `02-type-resolution.md` — must be clean first
-
-## TODO Checklist
-
-- [ ] Audit all IsoSts → NisoSts references
-- [ ] Categorize by shared vs. truly namespace-specific
-- [ ] Design base type hierarchy
-- [ ] Create `lib/sts/base/` directory structure
-- [ ] Implement base types for shared elements
-- [ ] Refactor IsoSts to use base types
-- [ ] Refactor NisoSts to use base types
-- [ ] Remove cross-namespace references
-- [ ] Verify no circular dependencies
-- [ ] Run full test suite
+1. `grep -rho "Sts::NisoSts::" lib/sts/iso_sts/ | wc -l` → `20`
+2. Every attribute on an IsoSts model traces to a line in `ISOSTS.xsd`
+3. Autoload registry 1:1 with the directory (112/112)
+4. `bundle exec rspec` green; `bundle exec rubocop` clean

data/lib/sts/iso_sts/alt_text.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Sts
+  module IsoSts
+    class AltText < Lutaml::Model::Serializable
+      attribute :content, :string
+      attribute :id, :string
+      attribute :content_type, :string
+      attribute :specific_use, :string
+      attribute :xml_lang, :string
+
+      xml do
+        element "alt-text"
+
+        map_content to: :content
+        map_attribute "id", to: :id
+        map_attribute "content-type", to: :content_type
+        map_attribute "specific-use", to: :specific_use
+        map_attribute "xml:lang", to: :xml_lang
+      end
+    end
+  end
+end

data/lib/sts/iso_sts/app.rb

@@ -15,7 +15,7 @@ module Sts
       attribute :term_sec, ::Sts::IsoSts::TermSec, collection: true
       attribute :fn_group, ::Sts::IsoSts::FnGroup, collection: true
       attribute :ref_list, ::Sts::IsoSts::RefList, collection: true
-      attribute :permissions, ::Sts::NisoSts::Permissions
+      attribute :permissions, ::Sts::IsoSts::Permissions
       attribute :non_normative_note, ::Sts::IsoSts::NonNormativeNote,
                 collection: true
       attribute :non_normative_example, ::Sts::IsoSts::NonNormativeExample,

data/lib/sts/iso_sts/array.rb

@@ -12,7 +12,7 @@ module Sts
       attribute :label, ::Sts::IsoSts::Label
       attribute :table, ::Sts::IsoSts::Table
       attribute :attrib, ::Sts::NisoSts::Attrib, collection: true
-      attribute :permissions, ::Sts::NisoSts::Permissions, collection: true
+      attribute :permissions, ::Sts::IsoSts::Permissions, collection: true
 
       xml do
         element "array"

data/lib/sts/iso_sts/disp_formula.rb

@@ -17,7 +17,7 @@ module Sts
       attribute :styled_content, ::Sts::IsoSts::StyledContent
       attribute :preformat, ::Sts::IsoSts::Preformat
       attribute :graphic, ::Sts::IsoSts::Graphic, collection: true
-      attribute :tex_math, ::Sts::NisoSts::TexMath
+      attribute :tex_math, ::Sts::IsoSts::TexMath
 
       xml do
         element "disp-formula"

data/lib/sts/iso_sts/doc_number.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Sts
+  module IsoSts
+    # ISOSTS declares <doc-number> as type="xs:string" -- no attributes.
+    class DocNumber < Lutaml::Model::Serializable
+      attribute :content, :string
+
+      xml do
+        element "doc-number"
+
+        map_content to: :content
+      end
+    end
+  end
+end

data/lib/sts/iso_sts/doc_type.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Sts
+  module IsoSts
+    # ISOSTS declares <doc-type> as type="xs:string" -- no attributes.
+    class DocType < Lutaml::Model::Serializable
+      attribute :content, :string
+
+      xml do
+        element "doc-type"
+
+        map_content to: :content
+      end
+    end
+  end
+end

data/lib/sts/iso_sts/document_identification.rb

@@ -4,11 +4,11 @@ module Sts
   module IsoSts
     class DocumentIdentification < Lutaml::Model::Serializable
       attribute :id, :string
-      attribute :sdo, ::Sts::NisoSts::Sdo
-      attribute :proj_id, ::Sts::NisoSts::ProjId
+      attribute :sdo, ::Sts::IsoSts::Sdo
+      attribute :proj_id, ::Sts::IsoSts::ProjId
       attribute :language, ::Sts::IsoSts::Language
-      attribute :release_version, ::Sts::NisoSts::ReleaseVersion
-      attribute :urn, ::Sts::NisoSts::Urn
+      attribute :release_version, ::Sts::IsoSts::ReleaseVersion
+      attribute :urn, ::Sts::IsoSts::Urn
 
       xml do
         element "doc-ident"