neu-mods 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4271827888541fa8ae2c61c52a6d3d73b79c7ee3ae3ae114ba391e3aae5e16a5
-  data.tar.gz: a59905f08b0092b40ade775cf95d846941d210b922aca213b5f1ee7b70ad864d
+  metadata.gz: fb4c30744c189d3e0b4bfc0f84bb75175685bcb142dd6dc35dc55cfbcbdaf0a2
+  data.tar.gz: a5cd73f764edf2da97e05787788124bed168c9dba8caf997307fc53591f05661
 SHA512:
-  metadata.gz: 25775e1c92de8bbc6f730980b1cbf78a5f0c78668ab901fb3c84f62e6ab15986bab6270ef37f511dfac367caa275d901b0cde87490a5b7d6f3338fd75d99415a
-  data.tar.gz: 61726ef704b127856f0fc1f2febe3b35681ffe48b7822a7cbbe1d30a4c8b094071bd681c57a1b3639c09f0ad1f085d4d3d543608fe86a7d2c558fa84ec913dc2
+  metadata.gz: 785e3c7485886be0fd7946b61463e2e2b66319cf4c4f30980b6e4b2b0b8ed2ae4348be41a48caa9fbad536901a89e9c73d4d4fd005283bc2cc0dc9c9102d6ff6
+  data.tar.gz: 7a331ed220702dbab23bd6d16637f33a3da2f431a17939647ee7d1fd21898b9cf76a4594b26300eb01f8c9ad1b50d0cabcd298cdbff9c363a01a7f7bba6229a7

data/.version

@@ -1 +1 @@
-0.1.1
+0.2.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

@@ -84,6 +84,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 +206,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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: neu-mods
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - David Cliff
@@ -14,42 +14,42 @@ dependencies:
   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.