lutaml-model 0.8.10 → 0.8.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1dea5a70c106b45dafcf2950dda9a8a1c2d8f2d37a4d32ec9a610e461b97a91
-  data.tar.gz: ca6332ea17ae83c4473a5143d454f155006ad369759dab98c48a1ba825aa6d74
+  metadata.gz: 86f1ceda6e01c3d47e303f092a24062a0e051faaf8a859bb47d2723670088d61
+  data.tar.gz: 92b43d69b6d49244c4187859e497fdbbce11d913f11425e8dfdfed1493f97e5a
 SHA512:
-  metadata.gz: 01c6623cc80b904875abe68601be5f4b76f441a0b6d0a599325db9454152072c4548985b29e12656b79cffeb28a965ddbf2d3191c6dc617503d914324cee3d35
-  data.tar.gz: 38c58ea41a62c035f56ba5a6ae758ed45e861417d7b41dba4003418600f36a88b6ab1a6ab753bd3ff54c3c45a2ed25ac13a68c774c9f488e9785d3d5c44894c6
+  metadata.gz: 33612bb8b97cc3667b88a5638288155319281de507ca4b8ca6386ea6b9e3a79b747d3b0441d92b4083441310a7962449c511e1445eb3779c2bf872b1d2ebdca1
+  data.tar.gz: f51445ae0f41d649c89e21c43f8cb1738a146457a35fac1fb5f927f6829d7360e3d115b55d7ea24549c33b03074c381028b89fc10e4ef87e703cd7f51bd36bf6

data/.github/workflows/dependent-repos.json

@@ -29,6 +29,7 @@
     "relaton/loc_mods",
     "relaton/w3c_api",
     "ukiryu/ukiryu",
+    "unitsml/unitsdb-ruby",
     "unitsml/unitsml-ruby"
   ]
 }

data/.github/workflows/opal.yml

@@ -0,0 +1,31 @@
+name: opal
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: "recursive"
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "18"
+
+      - name: Run Opal tests
+        # TODO: Remove continue-on-error once REXML adapter is verified
+        # under actual Opal runtime (REXML compiles to JS via Opal's stdlib)
+        run: bundle exec rake spec:opal
+        continue-on-error: true

data/.rspec-opal

@@ -0,0 +1,5 @@
+--default-path=spec
+--pattern='spec/lutaml/model/opal_smoke_spec.rb,spec/lutaml/xml/opal_xml_spec.rb'
+-I lib
+--require=spec_helper
+--require=support/opal

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-05-18 04:34:59 UTC using RuboCop version 1.86.0.
+# on 2026-05-27 05:02:01 UTC using RuboCop version 1.86.0.
 # 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
@@ -11,13 +11,60 @@ Gemspec/RequiredRubyVersion:
   Exclude:
     - 'lutaml-model.gemspec'
 
-# Offense count: 3012
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
+  Exclude:
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/ClosingParenthesisIndentation:
+  Exclude:
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: consistent, consistent_relative_to_receiver, special_for_inner_method_call, special_for_inner_method_call_in_parentheses
+Layout/FirstArgumentIndentation:
+  Exclude:
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowMultipleStyles, EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle.
+# SupportedHashRocketStyles: key, separator, table
+# SupportedColonStyles: key, separator, table
+# SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
+Layout/HashAlignment:
+  Exclude:
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
+
+# Offense count: 3022
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: symmetrical, new_line, same_line
+Layout/MultilineMethodCallBraceLayout:
+  Exclude:
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
+  Exclude:
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
+
 # Offense count: 21
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: enums
@@ -109,6 +156,12 @@ Lint/UnusedMethodArgument:
     - 'lib/lutaml/xml/unqualified_inheritance_strategy.rb'
     - 'spec/support/xml/xsd/code_example_validator.rb'
 
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Lint/UselessAssignment:
+  Exclude:
+    - 'spec/lutaml/xml/opal_xml_spec.rb'
+
 # Offense count: 1
 Lint/UselessConstantScoping:
   Exclude:
@@ -130,12 +183,12 @@ Metrics/BlockLength:
 Metrics/BlockNesting:
   Max: 6
 
-# Offense count: 310
+# Offense count: 308
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 554
+# Offense count: 553
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 514
@@ -238,7 +291,7 @@ RSpec/BeforeAfterAll:
 RSpec/ContextWording:
   Enabled: false
 
-# Offense count: 96
+# Offense count: 98
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
   Enabled: false
@@ -249,7 +302,7 @@ RSpec/DescribeMethod:
     - 'spec/lutaml/xml/schema/xsd/schema_helper_methods_spec.rb'
     - 'spec/lutaml/xml/serializable_namespace_spec.rb'
 
-# Offense count: 1257
+# Offense count: 1301
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 68
@@ -324,7 +377,7 @@ RSpec/MultipleDescribes:
     - 'spec/lutaml/xml/namespace_resolution_strategy_spec.rb'
     - 'spec/lutaml/xml/xml_space_type_spec.rb'
 
-# Offense count: 1490
+# Offense count: 1515
 RSpec/MultipleExpectations:
   Max: 21
 
@@ -490,3 +543,11 @@ Style/StringConcatenation:
     - 'lib/lutaml/model/schema/xml_compiler/complex_type.rb'
     - 'lib/lutaml/model/schema/xml_compiler/simple_type.rb'
     - 'lib/lutaml/model/schema/xml_compiler/xml_namespace_class.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInArguments:
+  Exclude:
+    - 'spec/lutaml/model/opal_smoke_spec.rb'

data/README.adoc

@@ -5507,6 +5507,49 @@ vocab.to_turtle
 vocab.to_jsonld
 ----
 
+==== Multiple RDF types
+
+`type` accepts a single compact IRI or an array:
+
+[source,ruby]
+----
+type "skos:Concept"
+# or multiple types:
+type ["skos:Concept", "dcterms:Agent"]
+----
+
+In Turtle, each type produces a separate `a` triple. In JSON-LD, a single type
+produces `"@type": "skos:Concept"` while multiple types produce an array.
+
+==== URI reference predicates
+
+Predicates declared with `uri_reference: true` serialize values as URI objects
+rather than string literals. In Turtle, values are emitted without quotes. In
+JSON-LD, values are wrapped in `{"@id": ...}` and the context term includes
+`"@type": "@id"`.
+
+[source,ruby]
+----
+predicate :related, namespace: SkosNamespace, to: :related, uri_reference: true
+----
+
+Round-trip fidelity is preserved: compact IRI forms (e.g. `"skos:other"`) are
+maintained through serialization and deserialization.
+
+==== Linked member predicates
+
+`members` accepts `predicate_name:` and `namespace:` to generate linking triples
+from the container to each member:
+
+[source,ruby]
+----
+members :children, predicate_name: :member, namespace: SkosNamespace
+----
+
+In Turtle, this produces `skos:member <child-uri>` triples on the container
+subject. In JSON-LD, the context includes a `member` term with `"@type": "@id"`
+and the container resource contains `{"@id": "..."}` references.
+
 See link:docs/_guides/rdf-serialization.adoc[Unified RDF Serialization] for the
 complete guide including language-tagged values, graph serialization, and
 architecture details.
@@ -16152,11 +16195,20 @@ Lutaml::Model supports running under https://opalrb.com[Opal] (Ruby compiled to
 JavaScript). The runtime is detected automatically and adapter selection is
 adjusted accordingly.
 
-* *XML*: Only the `:oga` adapter is available (auto-selected).
+* *XML*: Only the `:rexml` adapter is available (auto-selected). Opal
+  reimplements `strscan` and `stringio` in its stdlib, enabling REXML (pure
+  Ruby) to compile cleanly to JavaScript.
 * *JSON*: Only the `:standard` adapter is available.
+* *YAML*: Only the `:standard` adapter is available.
 * *TOML*: Not available on Opal.
 * *Schema generation*: `to_xsd`, `to_relaxng`, and `from_xml` (XML schema
   compilation) raise `NotImplementedError` on Opal.
+* *Liquid templating*: Not available on Opal (Phase 1 — skipped).
+* *XPath*: Not available on Opal (REXML XPath requires features not yet
+  supported by Opal's stdlib).
+
+See the link:docs/_guides/opal.adoc[Opal Usage Guide] for setup instructions
+and limitations.
 
 
 === Error handling

data/docs/_guides/index.adoc

@@ -46,6 +46,10 @@ See link:../references/rdf-namespaces[RDF Namespaces] for namespace classes,
 * link:../consolidation-mapping[Consolidation Mapping] - Group sibling elements into structured models
 * link:../document-validation[Document Validation] - Document-level validation with rules, profiles, and remediation
 
+== Runtime environments
+
+* link:../opal[Opal Usage Guide] - Run Lutaml::Model in the browser via Opal (Ruby to JavaScript)
+
 == By task
 
 === I want to serialize to XML

data/docs/_guides/jsonld-serialization.adoc

@@ -160,7 +160,9 @@ end
 ----
 
 See link:../_guides/rdf-serialization.adoc[Unified RDF Serialization] for the
-complete guide including graph-level serialization with `members`.
+complete guide including graph-level serialization with `members`, URI reference
+predicates (`uri_reference: true`), multiple RDF types, and linking predicates
+on member collections.
 
 == Multi-format models
 

data/docs/_guides/opal.adoc

@@ -0,0 +1,221 @@
+---
+title: Opal Usage Guide
+parent: Guides
+nav_order: 99
+---
+
+= Opal Usage Guide
+
+:toc:
+:toclevels: 3
+
+== Overview
+
+https://opalrb.com[Opal] is a Ruby-to-JavaScript compiler that allows Ruby code to run in the browser. Lutaml::Model supports running under Opal, enabling XML/JSON/YAML serialization in client-side applications.
+
+The XML parsing layer is provided by the https://github.com/lutaml/moxml[moxml] gem (v0.2+), which detects the Opal runtime and uses the REXML adapter automatically.
+
+== How it works
+
+Opal compiles Ruby source code to JavaScript. Under Opal:
+
+. `RUBY_ENGINE` equals `"opal"`
+. `Lutaml::Model::RuntimeCompatibility.opal?` returns `true`
+. Adapter selection is adjusted automatically
+. Gems with C extensions (Nokogiri, Ox, Oj, tomlib) are not available
+. REXML is used for XML because Opal reimplements `strscan` and `stringio` in its stdlib, enabling REXML (pure Ruby) to compile cleanly to JavaScript
+
+No configuration is needed -- the runtime is detected and adapters are selected automatically.
+
+== Supported features
+
+=== Fully supported
+
+* Model definition with `attribute`, types, collections, defaults
+* XML serialization/deserialization (via REXML adapter)
+** Element and attribute mapping
+** Nested elements and collections
+** Mixed content
+** Namespaces (parsing and serialization)
+** CDATA sections
+** Processing instructions
+** Comments
+** Entity references
+** XML declarations and doctypes
+* JSON serialization/deserialization (via standard adapter)
+* YAML serialization/deserialization (via standard adapter)
+* Hash transformation
+* Custom types
+* Model import (`import_model`)
+* Value transformations
+
+=== Not available
+
+[cols="1,3",options="header"]
+|===
+| Feature | Reason
+| XSD schema generation | Requires Nokogiri
+| RELAX NG generation | Requires Nokogiri
+| XML schema compilation | Requires Nokogiri + native parsing
+| TOML serialization | Both tomlib and toml-rb require native extensions
+| Oj / MultiJson adapters | Require native extensions
+| Ox / Nokogiri / Oga adapters | Require native extensions or C extensions
+| XPath queries | REXML XPath requires features not yet in Opal's stdlib
+| Liquid templating | Uses file-system-based template loading (Phase 1: skipped)
+| Canon XML equivalence | Uses Nokogiri for XML parsing
+|===
+
+== Setup
+
+=== Gemfile
+
+Add Opal gems to your Gemfile:
+
+[source,ruby]
+----
+gem "lutaml-model"
+
+group :opal do
+  gem "opal", "~> 1.8"
+  gem "opal-rspec", "~> 1.0"
+  gem "opal-sprockets"
+end
+----
+
+=== Rake task
+
+Add an Opal RSpec task to your Rakefile:
+
+[source,ruby]
+----
+begin
+  require "opal/rspec/rake_task"
+rescue LoadError
+  # Opal not available
+end
+
+namespace :spec do
+  if defined?(Opal::RSpec::RakeTask)
+    desc "Run Opal (JavaScript) tests"
+    Opal::RSpec::RakeTask.new(:opal) do |server, runner|
+      server.append_path "lib"
+      runner.default_path = "spec"
+      runner.pattern = "spec/**/*_spec.{rb,opal}"
+    end
+  end
+end
+----
+
+=== Test configuration
+
+Create `spec/support/opal.rb` for Opal-specific test patches:
+
+[source,ruby]
+----
+# frozen_string_literal: true
+
+if RUBY_ENGINE == "opal"
+  Lutaml::Model::Config.xml_adapter_type = :rexml
+end
+----
+
+Create `.rspec-opal`:
+
+----
+--default-path=spec
+--pattern='spec/**/*_spec.{rb,opal}'
+-I lib
+--opal-opt=-g,lutaml-model
+-I spec
+--require=spec_helper
+--require=support/opal
+----
+
+=== CI workflow
+
+Add `.github/workflows/opal.yml`:
+
+[source,yaml]
+----
+name: opal
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: "recursive"
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "18"
+      - name: Run Opal tests
+        run: bundle exec rake spec:opal
+----
+
+== Example: XML round-trip in the browser
+
+[source,ruby]
+----
+class Person
+  include Lutaml::Model::Serialize
+
+  attribute :name, :string
+  attribute :age, :integer
+
+  xml do
+    root "person"
+    map_element "name", to: :name
+    map_element "age", to: :age
+  end
+end
+
+# Parse XML
+person = Person.from_xml('<person><name>Alice</name><age>30</age></person>')
+person.name  # => "Alice"
+person.age   # => 30
+
+# Serialize to XML
+person.to_xml  # => "<person><name>Alice</name><age>30</age></person>"
+
+# JSON and YAML also work
+person.to_json  # => '{"name":"Alice","age":30}'
+person.to_yaml  # => "---\nname: Alice\nage: 30\n"
+----
+
+== Architecture
+
+Under Opal, the library uses a JRuby-like pattern for dependency management:
+
+. *Dependencies stay in the gemspec.* Gems like Nokogiri, Ox, and Oga remain listed as dependencies -- they are simply not loadable under Opal.
+. *Requires are guarded with `RUBY_ENGINE`.* Code that depends on native gems uses `RUBY_ENGINE == "opal"` checks instead of silent `rescue LoadError`.
+. *No gem splitting.* The same gem works on both MRI and Opal.
+
+Key components:
+* `Lutaml::Model::RuntimeCompatibility` -- detects the runtime (opal, windows, native)
+* `Lutaml::Model::AdapterResolver` -- selects adapters based on runtime capabilities
+* `Moxml::Config::OPAL_DEFAULT_ADAPTER` -- set to `:rexml`
+* `Moxml::Adapter::OPAL_AVAILABLE_ADAPTERS` -- set to `%i[rexml]`
+
+== Dependencies
+
+The following gems in the lutaml ecosystem support Opal:
+
+* **lutaml-model** -- Core model library (this gem)
+* **moxml** (v0.2+) -- XML parsing abstraction with REXML adapter for Opal
+* **canon** -- XML comparison (uses moxml under Opal; comparison features work but Nokogiri-specific features do not)
+
+== Limitations
+
+* **No XPath** -- REXML's XPath module has dependencies not yet reimplemented in Opal's stdlib.
+* **No schema generation** -- XSD, RELAX NG generation, and schema compilation require Nokogiri.
+* **No TOML** -- Both TOML adapters (tomlib, toml-rb) require native extensions.
+* **No Liquid** -- Template rendering via Liquid is skipped in Opal (file-system dependency). May be addressed in a future phase using liquidjs via Opal's JavaScript bridge.

data/docs/_guides/rdf-serialization.adoc

@@ -94,15 +94,22 @@ subject { |m| "http://example.org/concept/#{m.code}" }
 
 ==== type
 
-Sets the RDF type (`rdf:type`). Compact IRIs are resolved via declared
-namespaces:
+Sets the RDF type (`rdf:type`). Accepts a single compact IRI or an array of
+compact IRIs. Compact IRIs are resolved via declared namespaces:
 
 [source,ruby]
 ----
 type "skos:Concept"
 # resolves to <http://www.w3.org/2004/02/skos/core#Concept>
+
+# multiple types:
+type ["skos:Concept", "dcterms:Agent"]
 ----
 
+In Turtle, each type produces a separate `a` triple. In JSON-LD, a single type
+produces `"@type": "skos:Concept"` while multiple types produce an array
+`"@type": ["skos:Concept", "dcterms:Agent"]`.
+
 ==== predicate
 
 Each `predicate` creates a mapping between an RDF predicate and a model
@@ -119,13 +126,38 @@ Parameters:
 * `namespace:` — the `Lutaml::Rdf::Namespace` subclass (required)
 * `to:` — the model attribute to read (required)
 * `lang_tagged:` (default: `false`) — if true, values are serialized with
-  language tags (see <<language-tagged-values>>)
+  language tags (see <<language-tagged-values>>). Mutually exclusive with
+  `uri_reference`.
+* `uri_reference:` (default: `false`) — if true, values are serialized as URI
+  references rather than string literals (see <<uri-reference-predicates>>).
+  Mutually exclusive with `lang_tagged`.
 
 ==== members
 
 Declares that a container model contains member resources that should be
 serialized as separate subjects in the output graph (see <<graph-serialization>>).
 
+Optional linking predicate parameters generate relationship triples from the
+container to each member:
+
+[source,ruby]
+----
+members :concepts, predicate_name: :member, namespace: SkosNamespace
+----
+
+When `predicate_name` and `namespace` are provided:
+
+* **Turtle**: produces `skos:member <child-uri>` triples on the container subject
+* **JSON-LD**: adds a `member` term to `@context` with `"@type": "@id"` and
+  `{"@id": "..."}` references in the container resource
+
+Parameters:
+
+* `attr_name` — the model attribute holding the member collection (required)
+* `predicate_name:` — the local name for the linking predicate (optional)
+* `namespace:` — the `Lutaml::Rdf::Namespace` subclass for the linking predicate
+  (required when `predicate_name` is given)
+
 == Serialization
 
 === Turtle
@@ -207,6 +239,48 @@ class LocalizedLiteral < Lutaml::Model::Serializable
 end
 ----
 
+== [[uri-reference-predicates]]URI Reference Predicates
+
+Predicates declared with `uri_reference: true` serialize attribute values as
+URI references rather than string literals:
+
+[source,ruby]
+----
+predicate :related, namespace: SkosNamespace, to: :related, uri_reference: true
+----
+
+**Turtle:**
+
+Values are emitted as URI objects without quotes. Compact IRIs (e.g.
+`"skos:other"`) are resolved to full URIs using the declared namespaces. Full
+URIs (e.g. `"http://example.org/foo"`) are used as-is.
+
+[source,turtle]
+----
+<http://example.org/concept/1> skos:related skos:other .
+----
+
+**JSON-LD:**
+
+Values are wrapped in `{"@id": ...}` objects. The auto-generated `@context`
+includes a term definition with `"@type": "@id"`:
+
+[source,json]
+----
+{
+  "@context": {
+    "related": { "@id": "http://www.w3.org/2004/02/skos/core#related", "@type": "@id" }
+  },
+  "related": [ { "@id": "skos:other" } ]
+}
+----
+
+Round-trip fidelity: compact IRI forms are preserved through serialization and
+deserialization. Values round-trip as `Concept.from_turtle(concept.to_turtle)`
+preserving the original `"skos:other"` compact form.
+
+The `uri_reference` option is mutually exclusive with `lang_tagged`.
+
 == [[graph-serialization]]Graph Serialization
 
 When a container model holds a collection of member resources, use `members` to
@@ -227,11 +301,16 @@ class Vocabulary < Lutaml::Model::Serializable
     type "skos:ConceptScheme"
     predicate :prefLabel, namespace: SkosNamespace, to: :id
 
-    members :concepts
+    members :concepts,
+            predicate_name: :member,
+            namespace: SkosNamespace
   end
 end
 ----
 
+The `predicate_name` and `namespace` parameters on `members` generate linking
+triples from the container to each member.
+
 === Turtle Output with Members
 
 [source,ruby]
@@ -247,7 +326,9 @@ Produces a single Turtle document with the container and all member triples:
 @prefix skos: <http://www.w3.org/2004/02/skos/core#> .
 
 <http://example.org/vocab/iso1087> a skos:ConceptScheme;
-  skos:prefLabel "iso1087" .
+  skos:prefLabel "iso1087";
+  skos:member <http://example.org/concept/2119>;
+  skos:member <http://example.org/concept/2120> .
 
 <http://example.org/concept/2119> a skos:Concept;
   skos:notation "2119";
@@ -272,14 +353,19 @@ Produces a JSON-LD document with `@graph` containing all resources:
 {
   "@context": {
     "skos": "http://www.w3.org/2004/02/skos/core#",
-    "prefLabel": "skos:prefLabel",
-    "notation": "skos:notation"
+    "prefLabel": { "@id": "skos:prefLabel" },
+    "notation": { "@id": "skos:notation" },
+    "member": { "@id": "http://www.w3.org/2004/02/skos/core#member", "@type": "@id" }
   },
   "@graph": [
     {
       "@id": "http://example.org/vocab/iso1087",
       "@type": "skos:ConceptScheme",
-      "prefLabel": "iso1087"
+      "prefLabel": "iso1087",
+      "member": [
+        { "@id": "http://example.org/concept/2119" },
+        { "@id": "http://example.org/concept/2120" }
+      ]
     },
     {
       "@id": "http://example.org/concept/2119",