mdld-parse 0.2.9 → 0.3.0

package/LICENCE

@@ -1,6 +1,6 @@
 # MDLD / MD-LD Community License
 
-Version 0.2 — 2025
+Version 0.3 — 2025
 
 Copyright © 2025–present  
 **Denis Starov**  

package/README.md

@@ -1,4 +1,4 @@
-# MD-LD Parse v0.2
+# MD-LD Parse v0.3
 
 **Markdown-Linked Data (MD-LD)** — a deterministic, streaming-friendly RDF authoring format that extends Markdown with explicit `{...}` annotations.
 
@@ -14,10 +14,10 @@ MD-LD allows you to author RDF graphs directly in Markdown using explicit `{...}
 # Apollo 11 {=ex:apollo11 .SpaceMission}
 
 Launch: [1969-07-16] {startDate ^^xsd:date}
-Crew: [Neil Armstrong] {=?ex:armstrong ?crewMember fullName}
+Crew: [Neil Armstrong] {+ex:armstrong ?crewMember name}
 Description: [First crewed Moon landing] {description}
 
-[Section] {=?#overview ?hasPart}
+[Section] {+#overview ?hasPart}
 Overview: [Mission summary] {description}
 ```
 
@@ -29,14 +29,14 @@ ex:apollo11 a schema:SpaceMission ;
   schema:crewMember ex:armstrong ;
   schema:description "First crewed Moon landing" .
 
-ex:armstrong schema:fullName "Neil Armstrong" .
+ex:armstrong schema:name "Neil Armstrong" .
 ```
 
 ## Core Features
 
 - **Subject declarations**: `{=IRI}` and `{=#fragment}` for context setting
-- **Object IRIs**: `{=?IRI}` and `{=?#fragment}` for temporary object declarations  
-- **Four predicate forms**: `p` (S→L), `?p` (S→O), `^p` (L→S), `^?p` (O→S)
+- **Object IRIs**: `{+IRI}` and `{+#fragment}` for temporary object declarations  
+- **Four predicate forms**: `p` (S→L), `?p` (S→O), `^p` (L→S), `!p` (O→S)
 - **Type declarations**: `.Class` for rdf:type triples
 - **Datatypes & language**: `^^xsd:date` and `@en` support
 - **Lists**: Explicit subject declarations for structured data
@@ -93,7 +93,7 @@ Each predicate form determines the graph edge:
 | `p`   | S → L   | `[Alice] {name}`             | literal property |
 | `?p`  | S → O   | `[NASA](ex:nasa) {?org}`     | object property  |
 | `^p`  | *(none)*| *(literals can't be subjects)* | reverse literal  |
-| `^?p` | O → S   | `[Parent](ex:p) {^?hasPart}` | reverse object   |
+| `!p` | O → S   | `[Parent](ex:p) {!hasPart}` | reverse object   |
 
 ## Syntax Reference
 
@@ -237,7 +237,7 @@ Reverse the relationship direction:
 ```markdown
 # Part {=ex:part}
 
-Part of: {^?hasPart}
+Part of: {!hasPart}
 
 - Book {=ex:book}
 ```
@@ -417,7 +417,7 @@ Each predicate is partitioned by **direction** and **node kind**:
 | `p`            | `S ─p→ L`      |
 | `?p`           | `S ─p→ O`      |
 | `^p`           | `L ─p→ S`      |
-| `^?p`          | `O ─p→ S`      |
+| `!p`          | `O ─p→ S`      |
 
 This spans all **2 × 2** combinations of:
 
@@ -480,7 +480,7 @@ npm test
 
 Tests validate:
 - Subject declaration and context
-- All predicate forms (p, ?p, ^p, ^?p)
+- All predicate forms (p, ?p, ^p, !p)
 - Datatypes and language tags
 - List processing
 - Code blocks and blockquotes

package/index.js

@@ -75,15 +75,15 @@ export function parseSemanticBlock(raw) {
                 continue;
             }
 
-            if (token.startsWith('=?#')) {
-                const fragment = token.substring(3);
+            if (token.startsWith('+#')) {
+                const fragment = token.substring(2);
                 result.object = `#${fragment}`;
                 result.entries.push({ kind: 'softFragment', fragment, relRange: { start: relStart, end: relEnd }, raw: token });
                 continue;
             }
 
-            if (token.startsWith('=?')) {
-                const iri = token.substring(2);
+            if (token.startsWith('+')) {
+                const iri = token.substring(1);
                 result.object = iri;
                 result.entries.push({ kind: 'object', iri, relRange: { start: relStart, end: relEnd }, raw: token });
                 continue;
@@ -118,10 +118,10 @@ export function parseSemanticBlock(raw) {
                 continue;
             }
 
-            if (token.startsWith('^?')) {
-                const iri = token.substring(2);
-                result.predicates.push({ iri, form: '^?', entryIndex });
-                result.entries.push({ kind: 'property', iri, form: '^?', relRange: { start: relStart, end: relEnd }, raw: token });
+            if (token.startsWith('!')) {
+                const iri = token.substring(1);
+                result.predicates.push({ iri, form: '!', entryIndex });
+                result.entries.push({ kind: 'property', iri, form: '!', relRange: { start: relStart, end: relEnd }, raw: token });
                 continue;
             }
 
@@ -593,7 +593,7 @@ function processAnnotation(carrier, sem, state) {
             // L —p→ S (use soft IRI object as subject if available, otherwise current subject)
             const subjectIRI = localObject || S;
             emitQuad(state.quads, state.origin.quadIndex, block.id, L, P, subjectIRI, state.df, { kind: 'pred', token, form: pred.form, expandedPredicate: P.value, entryIndex: pred.entryIndex });
-        } else if (pred.form === '^?') {
+        } else if (pred.form === '!') {
             // O —p→ S (use previous subject as object, newSubject as subject)
             const objectIRI = newSubject ? previousSubject : S;
             const subjectIRI = localObject || newSubject || carrierO;
@@ -660,11 +660,17 @@ function processListContext(contextSem, listTokens, state, contextSubject = null
 
         contextSem.predicates.forEach(pred => {
             const P = state.df.namedNode(expandIRI(pred.iri, state.ctx));
-            if (pred.form === '^' || pred.form === '^?') {
+
+            // According to MD-LD spec: list predicates that connect to item subjects MUST use object predicate forms (?p or !p)
+            // Literal predicate forms (p, ^p) in list scope emit no quads
+            if (pred.form === '!') {
+                // Reverse object property: O —p→ S
                 emitQuad(state.quads, state.origin.quadIndex, 'list-context', itemSubject, P, contextSubject, state.df);
-            } else {
+            } else if (pred.form === '?') {
+                // Object property: S —p→ O
                 emitQuad(state.quads, state.origin.quadIndex, 'list-context', contextSubject, P, itemSubject, state.df);
             }
+            // Note: pred.form === '' and pred.form === '^' are intentionally ignored (literal predicate forms)
         });
 
         const prevSubject = state.currentSubject;
@@ -791,22 +797,22 @@ function removeOneToken(tokens, matchFn) {
 }
 
 function addObjectToken(tokens, iri) {
-    const objectToken = `=?${iri}`;
+    const objectToken = `+${iri}`;
     return tokens.includes(objectToken) ? tokens : [...tokens, objectToken];
 }
 
 function removeObjectToken(tokens, iri) {
-    const objectToken = `=?${iri}`;
+    const objectToken = `+${iri}`;
     return removeOneToken(tokens, t => t === objectToken);
 }
 
 function addSoftFragmentToken(tokens, fragment) {
-    const fragmentToken = `=?#${fragment}`;
+    const fragmentToken = `+#${fragment}`;
     return tokens.includes(fragmentToken) ? tokens : [...tokens, fragmentToken];
 }
 
 function removeSoftFragmentToken(tokens, fragment) {
-    const fragmentToken = `=?#${fragment}`;
+    const fragmentToken = `+#${fragment}`;
     return removeOneToken(tokens, t => t === fragmentToken);
 }
 
@@ -1197,7 +1203,7 @@ export function serialize({ text, diff, origin, options = {} }) {
                         const full = quad.object.value;
                         const label = shortenIRI(full, ctx);
                         const objectShort = shortenIRI(full, ctx);
-                        edits.push({ start: result.length, end: result.length, text: `\n[${label}] {=?${objectShort} ?${predShort}}` });
+                        edits.push({ start: result.length, end: result.length, text: `\n[${label}] {+${objectShort} ?${predShort}}` });
                     }
                     return;
                 }
@@ -1240,9 +1246,9 @@ export function serialize({ text, diff, origin, options = {} }) {
                         // Create new annotation with object token
                         if (isSoftFragment) {
                             const fragment = full.split('#')[1];
-                            edits.push({ start: result.length, end: result.length, text: `\n[${objectShort}] {=?#${fragment} ?${predShort}}` });
+                            edits.push({ start: result.length, end: result.length, text: `\n[${objectShort}] {+#${fragment} ?${predShort}}` });
                         } else {
-                            edits.push({ start: result.length, end: result.length, text: `\n[${objectShort}] {=?${objectShort} ?${predShort}}` });
+                            edits.push({ start: result.length, end: result.length, text: `\n[${objectShort}] {+${objectShort} ?${predShort}}` });
                         }
                     }
                     return;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mdld-parse",
-	"version": "0.2.9",
+	"version": "0.3.0",
 	"description": "A standards-compliant parser for **MD-LD (Markdown-Linked Data)** — a human-friendly RDF authoring format that extends Markdown with semantic annotations.",
 	"type": "module",
 	"main": "index.js",