s3dgraphy 1.6.0.dev41__tar.gz → 1.6.0.dev42__tar.gz

{s3dgraphy-1.6.0.dev41/src/s3dgraphy.egg-info → s3dgraphy-1.6.0.dev42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: s3dgraphy
-Version: 1.6.0.dev41
+Version: 1.6.0.dev42
 Summary: 3D Stratigraphic Graph Management Library for archaeological and heritage applications
 Author-email: Emanuel Demetrescu <emanuel.demetrescu@cnr.it>
 Maintainer-email: Emanuel Demetrescu <emanuel.demetrescu@cnr.it>

{s3dgraphy-1.6.0.dev41 → s3dgraphy-1.6.0.dev42}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "s3dgraphy"
-version = "1.6.0.dev41"
+version = "1.6.0.dev42"
 description = "3D Stratigraphic Graph Management Library for archaeological and heritage applications"
 readme = "README.md"
 requires-python = ">=3.9"

{s3dgraphy-1.6.0.dev41 → s3dgraphy-1.6.0.dev42}/src/s3dgraphy/JSON_config/datamodel_translations.json

@@ -1,6 +1,6 @@
 {
  "schema": "s3Dgraphy_datamodel_translations",
- "version": "1.8",
+ "version": "1.9",
  "languages": [
   "en",
   "it",
@@ -2243,43 +2243,43 @@
   "absolute_time_end": {
    "label": {
     "en": "Absolute Time — End",
-    "validated_it": false,
+    "validated_it": true,
     "validated_el": false,
     "validated_he": false,
     "validated_es": false,
     "validated_pl": false,
     "validated_ro": false,
     "validated_fr": false,
-    "validated_de": false,
-    "it": "Tempo assoluto — fine",
+    "validated_de": true,
+    "it": "Data di fine",
     "el": "Απόλυτος χρόνος — Τέλος",
     "he": "זמן מוחלט — סיום",
     "es": "Tiempo absoluto — Fin",
     "pl": "Czas bezwzględny — koniec",
     "ro": "Timp absolut — sfârșit",
     "fr": "Temps absolu — fin",
-    "de": "Absolute Zeit — Ende"
+    "de": "Enddatum"
    }
   },
   "absolute_time_start": {
    "label": {
     "en": "Absolute Time — Start",
-    "validated_it": false,
+    "validated_it": true,
     "validated_el": false,
     "validated_he": false,
     "validated_es": false,
     "validated_pl": false,
     "validated_ro": false,
     "validated_fr": false,
-    "validated_de": false,
-    "it": "Tempo assoluto — inizio",
+    "validated_de": true,
+    "it": "Data di inizio",
     "el": "Απόλυτος χρόνος — Αρχή",
     "he": "זמן מוחלט — התחלה",
     "es": "Tiempo absoluto — Inicio",
     "pl": "Czas bezwzględny — początek",
     "ro": "Timp absolut — început",
     "fr": "Temps absolu — début",
-    "de": "Absolute Zeit — Beginn"
+    "de": "Anfangsdatum"
    }
   },
   "access_conditions": {
@@ -8661,5 +8661,49 @@
     "fr": "Propriétaires non déclarés"
    }
   }
+ },
+ "property_names": {
+  "definition": {
+   "label": {
+    "en": "Definition",
+    "validated_it": true,
+    "validated_el": false,
+    "validated_he": false,
+    "validated_es": false,
+    "validated_pl": false,
+    "validated_ro": false,
+    "validated_fr": false,
+    "validated_de": true,
+    "it": "Definizione",
+    "de": "Definition",
+    "el": "Ορισμός",
+    "he": "הגדרה",
+    "es": "Definición",
+    "pl": "Definicja",
+    "ro": "Definiție",
+    "fr": "Définition"
+   }
+  },
+  "material": {
+   "label": {
+    "en": "Material",
+    "validated_it": true,
+    "validated_el": false,
+    "validated_he": false,
+    "validated_es": false,
+    "validated_pl": false,
+    "validated_ro": false,
+    "validated_fr": false,
+    "validated_de": true,
+    "it": "Materiale",
+    "de": "Material",
+    "el": "Υλικό",
+    "he": "חומר",
+    "es": "Material",
+    "pl": "Materiał",
+    "ro": "Material",
+    "fr": "Matériau"
+   }
+  }
  }
 }

{s3dgraphy-1.6.0.dev41 → s3dgraphy-1.6.0.dev42}/src/s3dgraphy/JSON_config/em_qualia_types.json

@@ -1,11 +1,23 @@
 {
     "metadata": {
-      "version": "1.6.7",
-      "last_updated": "2026-10-05",
+      "version": "1.6.8",
+      "last_updated": "2026-10-09",
       "maintainers": ["Emanuel Demetrescu"],
       "license": "CC-BY-SA-4.0",
       "license_note": "Share-alike per allinearsi agli strumenti terminologici da cui questo datamodel prende gli ancoraggi (ICCD CC BY-SA 3.0 IT) e perche' una derivazione resti aperta. Gli identificatori AAT/CIDOC citati nei `mappings` sono RIFERIMENTI, non contenuto incorporato: lo share-alike non si propaga ai vocabolari altrui, che mantengono i propri termini.",
-      "changelog": "v1.6.7 (MICRO le decisioni della sera, 2026-10-05, asked by E.D. 2026-10-04): contextual.administrative gains `alternative_label` — another label of the element in a source (a numbering of another excavation, of a thesis), analogous to skos:altLabel, projected as crm:P1_is_identified_by → E41_Appellation. The first quale declared `repeatable: true`: one PropertyNode per label, never a list in one value, and the merger keys it with its value (two labels are two claims). Its source is the ordinary paradata chain (property has_data_provenance → extractor extracted_from → document); an optional data.scheme names the numbering. The element's own label (area.settore.tipoNumero) is unchanged. s3dgraphy.labels writes and reads them. v1.6.6 (dev27, 2026-10-31, decided by E.D. 2026-10-01): cultural_interpretive.semantic.attribution gains an optional `note` in its schema and `natural_language_fields: [\"note\"]` — the object is not text, its note is, and only the note carries a language tag (rdf_exporter._Datamodel.natural_language_fields). v1.6.5 (MICRO le traduzioni, 2026-10-29, decided by E.D. 2026-10-01, domanda 3): the doubtful qualia, MEASURED. contextual.administrative.intervention_history is prose (a history of conservation interventions) and gains `natural_language: true`. provenance_history, exhibition_history, publication_history and contextual.ownership.ownership_chain are `object_chain` WITHOUT a schema: no field of theirs is declared and no code reads a structure, so what a PropertyNode stores is ONE string (the chain as written) — the whole string is marked. cultural_interpretive.semantic.attribution is an `object` WITH separate fields (attributed_to: an E39 Actor reference, attribution_type: a closed list, confidence: a float): none of them is a note, so nothing is marked — the rule is to mark only the note, and this object has none. Its value today travels as one string (\"attributed to Phidias\") and leaves untagged; marking it would need a `note` field in its schema, which is E.D.'s to add. inventory_number stays a code. v1.6.4 (MICRO la lingua dei dati, 2026-10-27, decided by E.D. 2026-09-28): cultural_interpretive.iconographic.narrative_content gains `natural_language: true` — its value is prose and leaves in RDF with its language tag (crm:P90_has_value \"la guerra di Troia\"@it), the language coming from the property node's data.lang, else the study's working language. data_type alone does not say it: inventory_number is a string too, and it is a CODE, so it is not marked and never tagged. No other quale marked: the ones whose value may be prose (intervention_history, attribution, the *_history and ownership_chain object chains) are waiting for E.D. v1.6.3 (MICRO em.ttl nel datamodel, 2026-10-26, decided by E.D. 2026-10-01 — every em: term of em.ttl is cited by a datamodel): epistemic.confidence.confidence_level.mappings gains specialised_alternative 'em:confidenceLevel', the em.ttl literal form of the same scalar, declared and NOT emitted (the exporter keeps crminf:I6_Belief_Value via J5). Mapping text only, no quale changed. v1.6.2: added two descriptive qualia of the stratigraphic unit asked for by the DAI record (iDAI.field Layer, D7/D8) — proposte da Cowork per E.D., 28 set 2026, dalla scheda DAI: `feature_shape` (spatial; the shape in plan or section named with a term, AAT 300056273, E55_Type) and `boundary_distinctness` (material; how sharp the limits are: abrupt / clear / gradual / diffuse, E55_Type, no AAT evident). Both controlled vocabularies with indicative seed values; templates declare their own. v1.6.1: added the spatial qualia `geometry` — the PROXY as a quale. The geometry-without-material of a unit becomes a PropertyNode whose payload is a SemanticShapeNode (has_semantic_shape), so the proxy inherits the paradata chain a lone node could not have, and one proxy can be synthesised from several sources. CIDOC default crmgeo:SP5_Geometric_Place_Expression, flagged `confirm_with: Felicetti` (E36 is the alternative, to be decided together with em:AnnotationRegion). v1.6.0: version realigned to the EM language version (EM 1.6) — supersedes the standalone 4.x line (last was 4.2), so all EM JSON config files now share the 1.6.x scheme. Added optional `rationale` + `example` fields to qualia entries (a plain-language why + a concrete case), shown by the EMStudio vocabulary picker when creating a PropertyNode. Seeded for the temporal qualia (absolute_time_start / absolute_time_end / dating_method); to be filled in for the rest incrementally. Prior (4.x) history: v4.2 added rationale/example scaffolding; v4.1: expanded spatial elevation qualia for pyArchInit us_table quote (all E54_Dimension): elevation_relative, elevation_min_absolute, elevation_max_absolute, elevation_min_relative, elevation_max_relative, elevation_min_usm, elevation_max_usm (the generic 'elevation' = absolute MASL, used by quota_abs). Each pyArchInit quota column maps to its own qualia id so they don't collide on the single-PropertyNode-per-property_name rule. v4.0: verified all v3.0 CIDOC-CRM mappings (correct). Expanded with: volume, area, circumference in dimensional; color, texture, finish, patina, hardness, porosity in material; damage_type, fragility, completeness in state; tool_marks, joining_technique in technical; bounding_box, footprint_area in spatial; duration, terminus_post_quem, terminus_ante_quem, relative_chronology in temporal; ceremonial_function, ritual_function, defensive_function, domestic_function, symbolic_function in telic; school, workshop, period_attribution in stylistic. NEW subcategories: iconographic + semantic under cultural_interpretive (iconographic_subject, narrative_content, iconographic_program, aesthetic_value, religious_significance, monumental_status, attribution). Added provenance_history, exhibition_history, publication_history under administrative; NEW ownership subcategory (current_custodian, ownership_chain). NEW CATEGORY epistemic — meta-qualia central to EM paradata model (confidence_level, certainty_level, uncertainty_factors, methodology_used, validation_method, source_quality, primary_contributor, review_status, last_modified)."
+      "changelog": "v1.6.8 (MICRO badge PD e cronologia, part 5, 2026-10-09): a top-level `property_names` block — the EM property NAMES in use that are not a quale, each with its English `name` (the source of its label in datamodel_translations.json, section `property_names`) and a `description`: `definition` (the property of the EM GraphML templates that says what the unit is, 75 PropertyNodes in the files at hand, measured) and `material` (the same fact as the quale `material_type`, under the name of the yEd tradition: `quale` says so; 26 PropertyNodes as `material` / `Material`). They give a client the readable label of a property by its name; they are NOT qualia: no mapping, no class, nothing exported to RDF changes (the exporter reads `qualia_categories` only). Keys starting with `_` are notes. v1.6.7 (MICRO le decisioni della sera, 2026-10-05, asked by E.D. 2026-10-04): contextual.administrative gains `alternative_label` — another label of the element in a source (a numbering of another excavation, of a thesis), analogous to skos:altLabel, projected as crm:P1_is_identified_by → E41_Appellation. The first quale declared `repeatable: true`: one PropertyNode per label, never a list in one value, and the merger keys it with its value (two labels are two claims). Its source is the ordinary paradata chain (property has_data_provenance → extractor extracted_from → document); an optional data.scheme names the numbering. The element's own label (area.settore.tipoNumero) is unchanged. s3dgraphy.labels writes and reads them. v1.6.6 (dev27, 2026-10-31, decided by E.D. 2026-10-01): cultural_interpretive.semantic.attribution gains an optional `note` in its schema and `natural_language_fields: [\"note\"]` — the object is not text, its note is, and only the note carries a language tag (rdf_exporter._Datamodel.natural_language_fields). v1.6.5 (MICRO le traduzioni, 2026-10-29, decided by E.D. 2026-10-01, domanda 3): the doubtful qualia, MEASURED. contextual.administrative.intervention_history is prose (a history of conservation interventions) and gains `natural_language: true`. provenance_history, exhibition_history, publication_history and contextual.ownership.ownership_chain are `object_chain` WITHOUT a schema: no field of theirs is declared and no code reads a structure, so what a PropertyNode stores is ONE string (the chain as written) — the whole string is marked. cultural_interpretive.semantic.attribution is an `object` WITH separate fields (attributed_to: an E39 Actor reference, attribution_type: a closed list, confidence: a float): none of them is a note, so nothing is marked — the rule is to mark only the note, and this object has none. Its value today travels as one string (\"attributed to Phidias\") and leaves untagged; marking it would need a `note` field in its schema, which is E.D.'s to add. inventory_number stays a code. v1.6.4 (MICRO la lingua dei dati, 2026-10-27, decided by E.D. 2026-09-28): cultural_interpretive.iconographic.narrative_content gains `natural_language: true` — its value is prose and leaves in RDF with its language tag (crm:P90_has_value \"la guerra di Troia\"@it), the language coming from the property node's data.lang, else the study's working language. data_type alone does not say it: inventory_number is a string too, and it is a CODE, so it is not marked and never tagged. No other quale marked: the ones whose value may be prose (intervention_history, attribution, the *_history and ownership_chain object chains) are waiting for E.D. v1.6.3 (MICRO em.ttl nel datamodel, 2026-10-26, decided by E.D. 2026-10-01 — every em: term of em.ttl is cited by a datamodel): epistemic.confidence.confidence_level.mappings gains specialised_alternative 'em:confidenceLevel', the em.ttl literal form of the same scalar, declared and NOT emitted (the exporter keeps crminf:I6_Belief_Value via J5). Mapping text only, no quale changed. v1.6.2: added two descriptive qualia of the stratigraphic unit asked for by the DAI record (iDAI.field Layer, D7/D8) — proposte da Cowork per E.D., 28 set 2026, dalla scheda DAI: `feature_shape` (spatial; the shape in plan or section named with a term, AAT 300056273, E55_Type) and `boundary_distinctness` (material; how sharp the limits are: abrupt / clear / gradual / diffuse, E55_Type, no AAT evident). Both controlled vocabularies with indicative seed values; templates declare their own. v1.6.1: added the spatial qualia `geometry` — the PROXY as a quale. The geometry-without-material of a unit becomes a PropertyNode whose payload is a SemanticShapeNode (has_semantic_shape), so the proxy inherits the paradata chain a lone node could not have, and one proxy can be synthesised from several sources. CIDOC default crmgeo:SP5_Geometric_Place_Expression, flagged `confirm_with: Felicetti` (E36 is the alternative, to be decided together with em:AnnotationRegion). v1.6.0: version realigned to the EM language version (EM 1.6) — supersedes the standalone 4.x line (last was 4.2), so all EM JSON config files now share the 1.6.x scheme. Added optional `rationale` + `example` fields to qualia entries (a plain-language why + a concrete case), shown by the EMStudio vocabulary picker when creating a PropertyNode. Seeded for the temporal qualia (absolute_time_start / absolute_time_end / dating_method); to be filled in for the rest incrementally. Prior (4.x) history: v4.2 added rationale/example scaffolding; v4.1: expanded spatial elevation qualia for pyArchInit us_table quote (all E54_Dimension): elevation_relative, elevation_min_absolute, elevation_max_absolute, elevation_min_relative, elevation_max_relative, elevation_min_usm, elevation_max_usm (the generic 'elevation' = absolute MASL, used by quota_abs). Each pyArchInit quota column maps to its own qualia id so they don't collide on the single-PropertyNode-per-property_name rule. v4.0: verified all v3.0 CIDOC-CRM mappings (correct). Expanded with: volume, area, circumference in dimensional; color, texture, finish, patina, hardness, porosity in material; damage_type, fragility, completeness in state; tool_marks, joining_technique in technical; bounding_box, footprint_area in spatial; duration, terminus_post_quem, terminus_ante_quem, relative_chronology in temporal; ceremonial_function, ritual_function, defensive_function, domestic_function, symbolic_function in telic; school, workshop, period_attribution in stylistic. NEW subcategories: iconographic + semantic under cultural_interpretive (iconographic_subject, narrative_content, iconographic_program, aesthetic_value, religious_significance, monumental_status, attribution). Added provenance_history, exhibition_history, publication_history under administrative; NEW ownership subcategory (current_custodian, ownership_chain). NEW CATEGORY epistemic — meta-qualia central to EM paradata model (confidence_level, certainty_level, uncertainty_factors, methodology_used, validation_method, source_quality, primary_contributor, review_status, last_modified)."
+    },
+    "property_names": {
+      "_note": "EM property names in use that are not a quale (v1.6.8): the readable label of a property is looked up by its name here when no quale has that id. Not vocabulary terms: no mapping, no data_type, no RDF class.",
+      "definition": {
+        "name": "Definition",
+        "description": "What the unit is, said in words (\"wall in opus quadratum\", \"floor layer\") — the property of the EM GraphML templates. The node's own `definition` element is its concept; this is the property a record writes."
+      },
+      "material": {
+        "name": "Material",
+        "description": "The material of the unit, under the name of the EM GraphML tradition.",
+        "quale": "material_type"
+      }
     },
     "qualia_categories": [
       {

{s3dgraphy-1.6.0.dev41 → s3dgraphy-1.6.0.dev42}/src/s3dgraphy/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.6.0.dev41"
+__version__ = "1.6.0.dev42"
 __datamodel_version__ = "1.5.5"  # s3Dgraphy connections datamodel version
 
 # s3Dgraphy/__init__.py

{s3dgraphy-1.6.0.dev41 → s3dgraphy-1.6.0.dev42}/src/s3dgraphy/sync/graph_ingestor.py

@@ -164,6 +164,54 @@ if TYPE_CHECKING:
 log = logging.getLogger("modules.s3dgraphy.sync.graph_ingestor")
 
 
+#: The tables this ingestor INSERTs into with the serial, and their
+#: primary key, for the realignment below.
+_SERIAL_PK_TABLES = (
+    ("us_table", "id_us"),
+    ("periodizzazione_table", "id_perfas"),
+)
+
+
+def _resync_pg_serial_sequences(conn, handle) -> None:
+    """Realign each serial sequence to ``MAX(pk)`` before writing.
+
+    A restored PostgreSQL dump leaves its sequences behind the data —
+    ``pg_restore`` copies the primary keys and does not reset them — so
+    the first auto-key INSERT asks for a value the table already holds
+    and PostgreSQL raises ``UniqueViolation`` on the primary key:
+    creating the epochs of a new site died on
+    ``periodizzazione_table_pkey`` and took the whole ingest with it.
+
+    ``setval`` is not transactional, so the correction stays even when
+    the ingest afterwards rolls back (a dry run, or an error). That is
+    the right outcome either way: ``MAX(pk)`` is the value the sequence
+    should have had. It reads no row and writes none, so nothing that
+    is already in the table moves or is renumbered.
+
+    A no-op on SQLite, whose ``AUTOINCREMENT`` corrects itself, and
+    best-effort everywhere: a schema without one of these tables (the
+    minimal ones the tests build) must not block the ingest.
+    """
+    if not getattr(handle, "is_postgres", False):
+        return
+    for table, pk in _SERIAL_PK_TABLES:
+        # One SAVEPOINT each: in PostgreSQL a failed statement aborts
+        # the whole transaction, so a plain try/except would not
+        # recover — every later INSERT would fail with "current
+        # transaction is aborted". begin_nested() lets a missing table,
+        # column or sequence roll back just this savepoint and leaves
+        # the ingest transaction intact.
+        try:
+            with conn.begin_nested():
+                conn.execute(text(
+                    "SELECT setval("
+                    "pg_get_serial_sequence(:table, :pk), "
+                    "GREATEST((SELECT COALESCE(MAX(%s), 0) FROM %s), 1))"
+                    % (pk, table)), {"table": table, "pk": pk})
+        except Exception:  # pragma: no cover - housekeeping, never fatal
+            log.debug("sequence of %s.%s left as it was", table, pk)
+
+
 class GraphIngestor:
     """Persist a s3dgraphy Graph back to the PyArchInit SQL tables.
 
@@ -391,6 +439,12 @@ class GraphIngestor:
         # _DryRunRollback sentinel to force rollback at the end.
         try:
             with handle.engine.begin() as conn:
+                # Before anything is written: a restored dump's sequences sit
+                # behind its rows, and the first INSERT with the serial would
+                # collide on the primary key. Runs in a dry run too, which
+                # executes the INSERTs before rolling back and would
+                # otherwise crash on the preview.
+                _resync_pg_serial_sequences(conn, handle)
                 # Ensure site_table has a row for `sito` — create if missing.
                 count_row = conn.execute(
                     text("SELECT COUNT(*) FROM site_table WHERE sito = :sito"),
@@ -416,6 +470,8 @@ class GraphIngestor:
                     type_name = type(node).__name__
                     if type_name in _NON_STRAT_TYPES:
                         continue
+                    if _is_synthetic_node(node):
+                        continue
                     attrs = dict(getattr(node, "attributes", None) or {})
                     # Look up by node_uuid. Prefer the explicit attribute
                     # (set by GraphProjector._propagate_node_uuid_and_us);
@@ -541,6 +597,8 @@ class GraphIngestor:
                         type_name = type(node).__name__
                         if type_name in _NON_STRAT_TYPES:
                             continue
+                        if _is_synthetic_node(node):
+                            continue
                         attrs = dict(getattr(node, "attributes", None) or {})
                         # Same priority as the detection loop above:
                         # explicit attrs.node_uuid wins (projector-built graphs),
@@ -1056,6 +1114,23 @@ def _values_equal(col: str, a, b) -> bool:
     return str(a) == str(b)
 
 
+def _is_synthetic_node(node) -> bool:
+    """True for a materialised continuity diamond, by name.
+
+    ``transforms.materialize_continuity`` names them
+    ``_synth_BR_<label>``, and a round trip through GraphML or em.json can
+    hand one back as a plain stratigraphic unit: the class is gone and the
+    name is all that is left to recognise it by. Writing it as a unit gave
+    rows like ``us = '_synth_BR_1'``.
+    """
+    for valore in (getattr(node, "name", None),
+                   getattr(node, "node_id", None),
+                   (getattr(node, "attributes", None) or {}).get("us")):
+        if valore is not None and str(valore).startswith("_synth"):
+            return True
+    return False
+
+
 def _is_epoch_node_local(node) -> bool:
     return type(node).__name__ == "EpochNode"
 
@@ -1328,4 +1403,10 @@ _NON_STRAT_TYPES: frozenset[str] = frozenset({
     "ActivityNodeGroup",
     "LocationNodeGroup",       # AI07: new spatial group node class
     "TimeBranchNodeGroup",
+    # The graph's own scaffolding. A ContinuityNode is the end of a unit's
+    # life, derived from the epochs and synthesised by
+    # transforms.materialize_continuity; a GraphNode stands for the document.
+    # us_table has no row for either — and no unita_tipo that fits them.
+    "ContinuityNode",
+    "GraphNode",
 })

{s3dgraphy-1.6.0.dev41 → s3dgraphy-1.6.0.dev42}/src/s3dgraphy/tools/datamodel_i18n.py

@@ -31,6 +31,7 @@ Shape — one section per kind of key, each keyed by a STABLE identity::
       "dtc_kinds":            {"<dtc kind>":        {"label": {...}}},
       "stratigraphic_kinds":  {"<kind>":            {"label": {...}}},
       "packagings":           {"<packaging>":       {"label": {...}}},
+      "property_names":       {"<property name>":   {"label": {...}}},
       "reasoning":            {"<word>":            {"label": {...}, "description": {...}}}
     }
 
@@ -42,6 +43,12 @@ and its badge («from {owner}» → «da {owner}»; 1.8, connections 1.6.37, «l
 ``source_removed``, ``reasoning_cycle``, ``undeclared_owners``) and the cures —
 ``label`` the title, ``description`` the sentence, ``{placeholders}`` kept.
 
+`property_names.<name>.label` (1.9, em_qualia_types 1.6.8) is the readable label
+of a PROPERTY NAME in use that is not a quale — `definition`, `material` — seeded
+from the `property_names` block of the qualia file: «Material» → «Materiale». A
+client shows it beside the technical name; a name in neither section is shown
+as it is.
+
 `packagings.<packaging>.label` (1.6, dev30) is the name of how a resource's bytes
 are packed — the `packaging` field of ResourceNode, seeded from its `labels`:
 «File set» → «Insieme di file», «Folder» → «Cartella» — what an inspector shows
@@ -127,6 +134,7 @@ SECTIONS: Dict[str, str] = {
     "stratigraphic_kinds": "strat_kind",
     "packagings": "packaging",
     "reasoning": "reasoning",
+    "property_names": "property_name",
 }
 #: the two directions of an edge's `ui_phrase`, as fields of the `edge_types`
 #: section — `ui_phrase.as_source` in the datamodel is `ui_phrase_as_source` here
@@ -199,6 +207,22 @@ def _collect_qualia_en(qualia: Dict[str, Any]) -> Dict[str, Dict[str, Dict[str,
     return out
 
 
+def _collect_property_names_en(qualia: Dict[str, Any]) -> Dict[str, Dict[str, str]]:
+    """{name: {"label": name}} from the qualia file's ``property_names`` block
+    (1.6.8): EM property names that are not a quale. ``_`` keys are notes; a
+    name that is also a quale id is refused (one label per name)."""
+    ids = {q["id"] for cat in qualia.get("qualia_categories", [])
+           for sub in cat.get("subcategories", {}).values() for q in sub.get("qualia", [])}
+    out: Dict[str, Dict[str, str]] = {}
+    for name, spec in (qualia.get("property_names") or {}).items():
+        if name.startswith("_") or not isinstance(spec, dict):
+            continue
+        assert name not in ids, f"property name {name} is a quale"
+        if isinstance(spec.get("name"), str) and spec["name"].strip():
+            out[name] = {"label": spec["name"]}
+    return out
+
+
 def _collect_edge_phrases_en(connections: Dict[str, Any]) -> Dict[str, Dict[str, str]]:
     """{edge type: {"label": ..., "ui_phrase_as_source": ..., "ui_phrase_as_target":
     ...}}: the `label` of EVERY edge type (1.3), and the two phrases of every edge
@@ -297,6 +321,7 @@ def _collect_all_en() -> Dict[str, Dict[str, Dict[str, str]]]:
     out["stratigraphic_kinds"] = _collect_stratigraphic_kinds_en(_load(DATAMODEL))
     out["packagings"] = _collect_packagings_en(_load(DATAMODEL))
     out["reasoning"] = _collect_reasoning_en(_load(CONNECTIONS))
+    out["property_names"] = _collect_property_names_en(_load(QUALIA))
     return out
 
 
@@ -311,7 +336,7 @@ def seed(write: bool = True) -> Dict[str, Any]:
         existing = {}
     doc: Dict[str, Any] = {
         "schema": "s3Dgraphy_datamodel_translations",
-        "version": "1.8",
+        "version": "1.9",
         "languages": LANGUAGES,
     }
     for section in SECTIONS:
@@ -417,6 +442,12 @@ def qualia_label(qualia_id: str, lang: str = "en") -> Optional[str]:
     return translate("qualia", qualia_id, "label", lang)
 
 
+def property_name_label(name: str, lang: str = "en") -> Optional[str]:
+    """Label of an EM property name that is not a quale (``property_names``,
+    em_qualia_types 1.6.8) in ``lang``, English fallback; ``None`` when unknown."""
+    return translate("property_names", name, "label", lang)
+
+
 def qualia_category_label(category_id: str, lang: str = "en") -> Optional[str]:
     return translate("qualia_categories", category_id, "label", lang)
 

{s3dgraphy-1.6.0.dev41 → s3dgraphy-1.6.0.dev42/src/s3dgraphy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: s3dgraphy
-Version: 1.6.0.dev41
+Version: 1.6.0.dev42
 Summary: 3D Stratigraphic Graph Management Library for archaeological and heritage applications
 Author-email: Emanuel Demetrescu <emanuel.demetrescu@cnr.it>
 Maintainer-email: Emanuel Demetrescu <emanuel.demetrescu@cnr.it>

{s3dgraphy-1.6.0.dev41 → s3dgraphy-1.6.0.dev42}/tests/test_datamodel_i18n.py

@@ -176,3 +176,29 @@ def test_reader_on_the_committed_sidecar():
         assert t.is_validated("qualia", "thickness", "label", lang) is False  # a draft
     assert t.qualia_category_label("physical_material", "en") == "Physical and Material Qualia"
     assert t.node_label("EpochNode", "it")
+
+
+def test_property_names_are_labelled_and_are_not_qualia():
+    """em_qualia_types 1.6.8 / translations 1.9 (MICRO badge PD e cronologia,
+    part 5): the EM property names in use that are not a quale — `definition`,
+    `material` — have their own section, seeded from the qualia file's
+    `property_names` block, labelled in every language, it/de validated; a
+    name of that block is never a quale id, and `_` keys are notes."""
+    t._doc.cache_clear()
+    qualia = json.loads(t.QUALIA.read_text(encoding="utf-8"))
+    en = t._collect_property_names_en(qualia)
+    assert set(en) == {"definition", "material"}
+    assert not any(k.startswith("_") for k in en)
+    ids = set(t._collect_qualia_en(qualia)["qualia"])
+    assert not (set(en) & ids)
+    assert qualia["property_names"]["material"]["quale"] in ids
+    assert t.property_name_label("material", "it") == "Materiale"
+    assert t.property_name_label("definition", "it") == "Definizione"
+    assert t.property_name_label("material", "xx") == "Material"
+    assert t.property_name_label("riser_depth", "it") is None
+    for name in en:
+        for lang in ("it", "de"):
+            assert t.is_validated("property_names", name, "label", lang) is True
+    # E.D.'s words for the dating qualia
+    assert t.qualia_label("absolute_time_start", "it") == "Data di inizio"
+    assert t.qualia_label("absolute_time_end", "it") == "Data di fine"

{s3dgraphy-1.6.0.dev41 → s3dgraphy-1.6.0.dev42}/tests/test_edge_ui_phrases.py

@@ -225,7 +225,9 @@ def test_the_version_went_up():
     # 1.7 (2026-10-09): the `reasoning` section — see test_property_as_source
     # 1.8 (2026-10-09, evening): `instance` for documents and properties, the
     # badge's {owner}, no refresh_instance — the instance is a view
-    assert _translations()["version"] == "1.8"
+    # 1.9 (2026-10-09, night): the `property_names` section — see
+    # test_datamodel_i18n.test_property_names_are_labelled_and_are_not_qualia
+    assert _translations()["version"] == "1.9"
 
 
 def test_combines_reads_of_in_english():

{s3dgraphy-1.6.0.dev41 → s3dgraphy-1.6.0.dev42}/tests/test_qualia_dai_d7_d8.py

@@ -65,9 +65,9 @@ def test_mappings_claim_only_what_is_evident(qualia_doc):
 
 def test_the_version_and_the_changelog_say_so(qualia_doc):
     meta = qualia_doc["metadata"]
-    # 1.6.7 dal 5 ott 2026 (alternative_label, A1); la voce 1.6.2 resta
-    # nella storia
-    assert meta["version"] == "1.6.7"
+    # 1.6.7 dal 5 ott 2026 (alternative_label, A1), 1.6.8 dal 9 ott 2026
+    # (property_names); la voce 1.6.2 resta nella storia
+    assert meta["version"] == "1.6.8"
     head = meta["changelog"].split(" v1.6.2:", 1)[1].split(" v1.6.1:")[0]
     assert "feature_shape" in head and "boundary_distinctness" in head
     assert "proposte da Cowork per E.D., 28 set 2026, dalla scheda DAI" in head