feat: Implement sequence processing improvements for SHACL Node Expressions (Issue #484)

[simonstey]

This pull request implements comprehensive changes to address Issue #484 regarding sequence processing naming inconsistencies in SHACL Node Expressions. The changes align the vocabulary and documentation with the sequence-based nature of node expression processing while maintaining backward compatibility through deprecation notices.

Problem Statement

SHACL Node Expressions are fundamentally sequence-based but were using set-style operation names, creating confusion:

• Operations like union and minus suggested set semantics despite working on ordered sequences
• The generic path property conflicted conceptually with constraint sh:path
• Missing advanced sequence operations limited processing capabilities

Solution

1. Vocabulary Renaming for Sequence Semantics

Renamed Operations:

• shnex:union → shnex:join - Emphasizes sequence concatenation with order preservation
• shnex:minus → shnex:remove - Clearer operation name for sequence subtraction
• shnex:path → shnex:pathValues - Distinguishes from constraint sh:path (needs to align with Rename shnex:path to shnex:pathValues and change its shnex:nodes to shnex:focusNode #514 )

Deprecation Strategy:

• Updated shacl.ttl with deprecation notices for sh:union and sh:minus
• Maintained backward compatibility while guiding migration to new terms

2. Advanced Sequence Operations

New Operations Added:

• shnex:flatMap - Applies expression to each input node and flattens results
• shnex:findFirst - Returns first node conforming to a given shape
• shnex:matchAll - Returns true if all nodes conform to a given shape

Files Modified

Vocabulary Files

• shacl12-vocabularies/shnex.ttl

  • Added complete RDF definitions for FlatMap, FindFirst, and MatchAll expressions
  • Updated existing definitions with sequence-appropriate naming
  • Enhanced property comments for clarity

• shacl12-vocabularies/shacl.ttl

  • Added deprecation notices for sh:union and sh:minus
  • Clear migration guidance to new sequence-based terms

Documentation

• shacl12-node-expr/index.html
  • Renamed sections: UnionExpression → JoinExpression, MinusExpression → RemoveExpression

New Advanced Operations:

# Find first senior employee
sh:values [
    shnex:findFirst [
        shnex:nodes [ shnex:pathValues ex:employee ] ;
        shnex:findFirst ex:SeniorEmployeeShape ;
    ] ;
] .

# Check if all employees are active
sh:values [
    shnex:matchAll [
        shnex:nodes [ shnex:pathValues ex:employee ] ;
        shnex:matchAll ex:ActiveEmployeeShape ;
    ] ;
] .

---

Closes #484

• See this document rendered online here

[simonstey]

@TallTed @HolgerKnublauch I now rebased this PR onto gh-pages (and hopefully haven't broken anything in the process of doing so)

@TallTed I've applied your 3 suggestions, thx!

[HolgerKnublauch]

Thanks @simonstey! The branch seems to be on the wrong base though - it displays 115 changed files and 147 commits. Maybe the easiest way forward is to create a new branch that only overwrites the node-expr doc?

[simonstey]

yep, I guess that's the better approach

[simonstey]

I'll close this PR in favor of #636