@_linked/core 2.17.0 → 2.18.0-next.20260829125240

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 2.18.0
+
+### Minor Changes
+
+- [#205](https://github.com/linked-cm/core/pull/205) [`48ecb4d`](https://github.com/linked-cm/core/commit/48ecb4dbdc20471bf19a4c4cc9d58ef90f5cd1b1) Thanks [@flyon](https://github.com/flyon)! - Expose the meta-model's SHACL constraint table via `getPropertyShapeTerms()` /
+  `getPropertyShapeTerm(label)`, so an alternative serializer can look up each constraint's
+  predicate, datatype and node kind rather than hard-coding its own copy.
+
+  Purely additive — `buildPropertyShapeData` is unchanged. Create Now's code→RDF shape sync uses
+  this to emit the full SHACL constraint set (pattern, `sh:in`, ranges, lengths, class) instead of
+  the five it previously enumerated by hand.
+
 ## 2.17.0
 
 ### Minor Changes

package/lib/esm/shapes/propertyShapeTerms.d.ts

@@ -0,0 +1,36 @@
+import '../utils/Package.js';
+/**
+ * How ONE SHACL constraint of a `sh:PropertyShape` is written to RDF: which predicate
+ * it uses and (when the meta-model pins one) which literal datatype / node kind.
+ */
+export interface PropertyShapeTerm {
+    /**
+     * The constraint's name as used by the decorator config and by `PropertyShapeData`
+     * — e.g. `pattern`, `minLength`, `in`. (A few `PropertyShapeData` fields carry a
+     * disambiguating suffix — `equalsConstraint`, `hasValueConstraint` — the LABEL is
+     * always the bare SHACL name, `equals` / `hasValue`.)
+     */
+    label: string;
+    /** The predicate IRI the constraint serializes to, e.g. `sh:pattern`. */
+    predicate: string;
+    /** Fixed literal datatype IRI, when the meta-model pins one (e.g. `xsd:integer` for `sh:minLength`). */
+    datatype?: string;
+    /** `sh:IRI` or `sh:Literal`, when the meta-model pins one (absent for the generic `sh:hasValue`). */
+    nodeKind?: string;
+}
+/**
+ * The SHACL constraints a `sh:PropertyShape` can carry, keyed by label — derived from the
+ * core meta-model (`PropertyShape.shape`, set up in `utils/Package.ts`) rather than from a
+ * hand-kept list, so a constraint added to the meta-model is immediately known here.
+ *
+ * This is the seam for **alternative serializers**: code that writes SHACL by a route other
+ * than the create pipeline (e.g. raw SPARQL `INSERT DATA`) can look up the predicate and the
+ * literal datatype for a constraint instead of re-deriving them. Constraints whose meta-model
+ * path is a complex property path are omitted (they have no single predicate).
+ *
+ * Requires the meta-model to have been set up (importing `@_linked/core` or `utils/Package`
+ * does that). The result is cached once non-empty.
+ */
+export declare function getPropertyShapeTerms(): ReadonlyMap<string, PropertyShapeTerm>;
+/** Lookup of a single constraint by label — see {@link getPropertyShapeTerms}. */
+export declare function getPropertyShapeTerm(label: string): PropertyShapeTerm | undefined;

package/lib/esm/shapes/propertyShapeTerms.js

@@ -0,0 +1,49 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import '../utils/Package.js'; // side effect: sets up the meta-model this table reads
+import { isPathRef } from '../paths/PropertyPathExpr.js';
+import { PropertyShape } from './SHACL.js';
+let cached;
+/**
+ * The SHACL constraints a `sh:PropertyShape` can carry, keyed by label — derived from the
+ * core meta-model (`PropertyShape.shape`, set up in `utils/Package.ts`) rather than from a
+ * hand-kept list, so a constraint added to the meta-model is immediately known here.
+ *
+ * This is the seam for **alternative serializers**: code that writes SHACL by a route other
+ * than the create pipeline (e.g. raw SPARQL `INSERT DATA`) can look up the predicate and the
+ * literal datatype for a constraint instead of re-deriving them. Constraints whose meta-model
+ * path is a complex property path are omitted (they have no single predicate).
+ *
+ * Requires the meta-model to have been set up (importing `@_linked/core` or `utils/Package`
+ * does that). The result is cached once non-empty.
+ */
+export function getPropertyShapeTerms() {
+    var _a, _b, _c, _d;
+    if (cached && cached.size)
+        return cached;
+    const map = new Map();
+    for (const ps of (_b = (_a = PropertyShape.shape) === null || _a === void 0 ? void 0 : _a.propertyShapes) !== null && _b !== void 0 ? _b : []) {
+        // Only single-predicate paths describe a constraint; skip complex paths.
+        if (!ps.path || !isPathRef(ps.path))
+            continue;
+        const predicate = typeof ps.path === 'string' ? ps.path : ps.path.id;
+        if (!predicate)
+            continue;
+        map.set(ps.label, {
+            label: ps.label,
+            predicate,
+            datatype: (_c = ps.datatype) === null || _c === void 0 ? void 0 : _c.id,
+            nodeKind: (_d = ps.nodeKind) === null || _d === void 0 ? void 0 : _d.id,
+        });
+    }
+    cached = map;
+    return map;
+}
+/** Lookup of a single constraint by label — see {@link getPropertyShapeTerms}. */
+export function getPropertyShapeTerm(label) {
+    return getPropertyShapeTerms().get(label);
+}
+//# sourceMappingURL=propertyShapeTerms.js.map

package/lib/esm/shapes/propertyShapeTerms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propertyShapeTerms.js","sourceRoot":"","sources":["../../../src/shapes/propertyShapeTerms.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,qBAAqB,CAAC,CAAC,uDAAuD;AACrF,OAAO,EAAC,SAAS,EAAC,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAAC,aAAa,EAAC,MAAM,YAAY,CAAC;AAsBzC,IAAI,MAAkD,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB;;IACnC,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,GAAG,EAA6B,CAAC;IACjD,KAAK,MAAM,EAAE,IAAI,MAAA,MAAA,aAAa,CAAC,KAAK,0CAAE,cAAc,mCAAI,EAAE,EAAE,CAAC;QAC3D,yEAAyE;QACzE,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC;YAAE,SAAS;QAC9C,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE;YAChB,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,SAAS;YACT,QAAQ,EAAE,MAAA,EAAE,CAAC,QAAQ,0CAAE,EAAE;YACzB,QAAQ,EAAE,MAAA,EAAE,CAAC,QAAQ,0CAAE,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,GAAG,GAAG,CAAC;IACb,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,qBAAqB,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@_linked/core",
-  "version": "2.17.0",
+  "version": "2.18.0-next.20260829125240",
   "license": "MIT",
   "linkedPackage": true,
   "type": "module",