neu-mods 0.1.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4271827888541fa8ae2c61c52a6d3d73b79c7ee3ae3ae114ba391e3aae5e16a5
-  data.tar.gz: a59905f08b0092b40ade775cf95d846941d210b922aca213b5f1ee7b70ad864d
+  metadata.gz: ebf2bf82cd0b9c0e5593307ecc9a986cefcb16f4035a5004f233bdd7f9d4d8ea
+  data.tar.gz: 7087e35df1b2f34430a53acfa49e9c97be12dd9b8bdc36b3ffa69d05e98189e0
 SHA512:
-  metadata.gz: 25775e1c92de8bbc6f730980b1cbf78a5f0c78668ab901fb3c84f62e6ab15986bab6270ef37f511dfac367caa275d901b0cde87490a5b7d6f3338fd75d99415a
-  data.tar.gz: 61726ef704b127856f0fc1f2febe3b35681ffe48b7822a7cbbe1d30a4c8b094071bd681c57a1b3639c09f0ad1f085d4d3d543608fe86a7d2c558fa84ec913dc2
+  metadata.gz: 63b83e54cdf64af06856fe1de2cb3763cc36a1f1f0a73403fb7836fac9e910dcd2f0ebd0a4fd5fb928b7714ddec20ad281ac1cc42b47a18fcda21cbc8ad8589f
+  data.tar.gz: 3d6ecb5f48c1c4cff669add4adc7bfa2a90bf29045b17bb1b1047a58f02820c85fbe303ec0c0e7665f7045e27d03531fe32759f6bc023d91032038baf4466c65

data/.version

@@ -1 +1 @@
-0.1.1
+0.3.0

data/README.md

@@ -44,8 +44,23 @@ NEU::MODS.compose_title(non_sort: "", title: "What's New",
 node = doc.primary_title_info.at_xpath("mods:title", NEU::MODS::NAMESPACE)
 node.content = "New Title" unless NEU::MODS.whitespace_equivalent?(node.text, "New Title")
 doc.to_xml
+
+# Editable creators (for an "advanced metadata" form): structured read,
+# node selection (for replace-on-save), and structure-aware build.
+doc.editable_personal_creators   # => [{ given:, family: }]  (plain, Creator role)
+doc.editable_corporate_creators  # => [{ name: }]
+doc.preserved_names              # => [{ name:, role: }]  (authority-bearing / non-Creator — read-only)
+doc.editable_creator_nodes("personal")            # => live <name> nodes to replace
+doc.build_personal_name(given: "Jenny", family: "Smith")      # => a plain personal <name> node
+doc.build_corporate_name(name: "Northeastern University")     # => a plain corporate <name> node
 ```
 
+The "editable creator" set is plain names — **no `@authority`/`@authorityURI`/
+`@valueURI`** — with a **Creator** role; everything else (authority-controlled or
+other-role names) is `preserved_names`, shown read-only. This mirrors the
+keyword-subject curated-vs-editable split. `build_*_name`'s `role:` defaults to
+`"Creator"` but is parameterised, so a later role-selectable form is non-breaking.
+
 ## Two normalizers, two jobs
 
 - `NEU::MODS.whitespace_equivalent?` / `.canonical_ws` — the **no-op guard**: did an

data/lib/neu/mods/projection.rb

@@ -45,7 +45,32 @@ module NEU
 
         optional = { ": " => parts[:subtitle], " - " => parts[:part_name], ", " => parts[:part_number] }
         suffix = optional.filter_map { |sep, val| "#{sep}#{val}" unless val.to_s.strip.empty? }.join
-        "#{parts[:non_sort]}#{parts[:title]}#{suffix}"
+        "#{join_non_sort(parts[:non_sort], parts[:title])}#{suffix}"
+      end
+
+      # Characters that bind a nonSort to the word after it. An elided article
+      # takes no space -- "L'Etranger", not "L' Etranger" -- and the same holds
+      # for a hyphenated prefix. U+2019 is the curly apostrophe, escaped rather
+      # than literal to keep lib/ pure ASCII (see the source-purity spec).
+      NON_SORT_BINDING = ["'", "\u2019", "-"].freeze
+
+      # MODS says a nonSort carries whatever separator it needs, so the historical
+      # composition simply concatenated. That only holds while the authored
+      # trailing space survives, and it does not: #child_text canonicalizes
+      # whitespace on read, so `<nonSort>The </nonSort>` arrives here as "The" and
+      # the title came out as "TheHobbit". Composing the separator instead makes
+      # the output right whether or not the source kept one -- which matters,
+      # because an invisible trailing space is not something a curator, a
+      # hand-edit or a third-party producer can be relied on to preserve.
+      #
+      # Callers that DO pass the space (Atlas's access-copy model) are unaffected:
+      # a nonSort already ending in whitespace is joined as-is.
+      def self.join_non_sort(non_sort, title)
+        prefix = non_sort.to_s
+        return title.to_s if prefix.empty?
+        return "#{prefix}#{title}" if prefix.end_with?(" ") || prefix.end_with?(*NON_SORT_BINDING)
+
+        "#{prefix} #{title}"
       end
 
       # --- Abstract / access ---------------------------------------------------
@@ -84,6 +109,28 @@ module NEU
         end
       end
 
+      # Editable (depositor-managed) creators: the plain names (no authority
+      # markers) with a Creator role, as STRUCTURED parts for form pre-fill --
+      # distinct from #names, which composes display strings for the access copy.
+      def editable_personal_creators
+        editable_creator_nodes("personal").map do |node|
+          { given: clean_part(joined_parts(node, "given")), family: clean_part(joined_parts(node, "family")) }
+        end
+      end
+
+      def editable_corporate_creators
+        editable_creator_nodes("corporate").map { |node| { name: clean_part(non_date_parts_joined(node)) } }
+      end
+
+      # Names the editable form does NOT manage (authority-bearing or non-Creator)
+      # -- for read-only display ("these exist; edit via the XML tab"). Composed
+      # display string + role, like #names but filtered to the preserved set.
+      def preserved_names
+        doc.xpath("/mods:mods/mods:name", NAMESPACE)
+           .reject { |node| editable_creator_name?(node) }
+           .map { |node| { name: name_display_value_w_date(node), role: name_role(node) } }
+      end
+
       # --- Scalars / simple arrays --------------------------------------------
 
       def languages
@@ -184,6 +231,12 @@ module NEU
         v.empty? ? nil : v
       end
 
+      # canonical_ws keeping "" for blank -- for structured form-field values
+      # (an empty given/family/org renders as an empty input, not a dropped key).
+      def clean_part(str)
+        NEU::MODS.canonical_ws(str)
+      end
+
       def join_paragraphs(nodes)
         nodes.map { |n| NEU::MODS.normalize_paragraphs(n.text) }.reject(&:empty?).join("\n\n")
       end

data/lib/neu/mods/selectors.rb

@@ -39,6 +39,39 @@ module NEU
         node
       end
 
+      # The "editable creator" <name> nodes of a given @type ("personal" /
+      # "corporate") that the Advanced form manages: plain names (no authority
+      # markers) with a Creator role. The write-path counterpart to the
+      # editable_*_creators projections; everything else (authority-bearing or
+      # non-Creator) is curated and left untouched. Mirrors keyword_subjects.
+      def editable_creator_nodes(type)
+        doc.xpath("/mods:mods/mods:name[@type='#{type}']", NAMESPACE)
+           .select { |n| editable_creator_name?(n) }
+      end
+
+      # Build a plain personal-creator <name> node: namePart[@type=given]/[family]
+      # + a text roleTerm. No authority/valueURI (the editable set). `role` is
+      # parameterised (default "Creator") so a later role-selectable form is a
+      # non-breaking change.
+      def build_personal_name(given:, family:, role: "Creator")
+        name = build_node("name")
+        name["type"] = "personal"
+        name.add_child(name_part(given, "given")) unless given.to_s.strip.empty?
+        name.add_child(name_part(family, "family")) unless family.to_s.strip.empty?
+        name.add_child(role_node(role))
+        name
+      end
+
+      # Build a plain corporate-creator <name> node: a single namePart + a text
+      # roleTerm. No authority/valueURI.
+      def build_corporate_name(name:, role: "Creator")
+        node = build_node("name")
+        node["type"] = "corporate"
+        node.add_child(name_part(name)) unless name.to_s.strip.empty?
+        node.add_child(role_node(role))
+        node
+      end
+
       private
 
       def keyword_subject?(subject)
@@ -47,6 +80,28 @@ module NEU
         topics = subject.element_children
         topics.any? && topics.all? { |c| c.name == "topic" }
       end
+
+      # A name is "editable" (depositor-managed) when it carries no authority
+      # markers and resolves to a Creator role. Shared by editable_creator_nodes
+      # (write/select) and the editable_*_creators projections (read).
+      def editable_creator_name?(node)
+        %w[authority authorityURI valueURI].none? { |attr| node[attr] } &&
+          name_role(node) == "Creator"
+      end
+
+      def name_part(text, type = nil)
+        np = build_node("namePart", text.to_s.strip)
+        np["type"] = type if type
+        np
+      end
+
+      def role_node(role)
+        role_el = build_node("role")
+        term = build_node("roleTerm", role)
+        term["type"] = "text"
+        role_el.add_child(term)
+        role_el
+      end
     end
   end
 end

metadata

@@ -1,55 +1,55 @@
 --- !ruby/object:Gem::Specification
 name: neu-mods
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.3.0
 platform: ruby
 authors:
 - David Cliff
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-09 00:00:00.000000000 Z
+date: 2026-08-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.13'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.13'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.12'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.12'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.60'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.60'
 description: 'Nokogiri-native, dependency-light reading/projection contract over MODS
@@ -62,7 +62,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .version
+- ".version"
 - Gemfile
 - README.md
 - Rakefile
@@ -83,16 +83,16 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.9
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: Northeastern-flavored MODS XML projection + selection for the DRS.