linked-rolls 0.42.0 → 0.43.0

package/lib/Agent.d.ts

@@ -67,10 +67,15 @@ export type WithActor = {
 export interface Place extends Named {
 }
 /**
- * A term from a vocabulary, such as a roll system or a kind of
- * paper. A term the type vocabulary knows carries its IRI as `id`.
+ * A term from a vocabulary, such as a roll system, a procedure or a
+ * kind of paper.
+ *
+ * A term the type vocabulary declares is named by its IRI, and what it
+ * is called stands in the vocabulary rather than in the edition, so it
+ * needs no name of its own; `nameOf` reads one either way. A term the
+ * vocabulary does not have is given by name, which is then all there is
+ * to go on.
  * @see crm:E55 Type
  */
-export interface Concept extends Named, Partial<WithId> {
-}
+export type Concept = (WithId & Partial<Named>) | (Named & Partial<WithId>);
 export {};

package/lib/index.d.ts

@@ -18,6 +18,7 @@ export * from './ReproducingSystem';
 export * from './FeatureSource';
 export * from './RollCopy';
 export * from './procedures';
+export * from './vocabulary';
 export * from './reservations';
 export * from './witnesses';
 export * from './alignment';

package/lib/index.js

@@ -18,6 +18,7 @@ export * from './ReproducingSystem';
 export * from './FeatureSource';
 export * from './RollCopy';
 export * from './procedures';
+export * from './vocabulary';
 export * from './reservations';
 export * from './witnesses';
 export * from './alignment';

package/lib/schema.json

@@ -222,34 +222,66 @@
             "type": "object"
         },
         "Concept": {
-            "description": "A term from a vocabulary, such as a roll system or a kind of paper. A term the type vocabulary knows carries its IRI as `id`.",
-            "properties": {
-                "name": {
-                    "description": "The name, e.g. \"Grünfeld, Alfred\", \"Wien\", \"M. Welte & Söhne\".",
-                    "type": "string",
-                    "ontology": "rdfs:label"
-                },
-                "sameAs": {
-                    "description": "Authority records for the same thing: GND, Wikidata, geonames or similar.",
-                    "examples": [
-                        "https://d-nb.info/gnd/116888652"
-                    ],
-                    "items": {
-                        "type": "string"
+            "anyOf": [
+                {
+                    "properties": {
+                        "name": {
+                            "description": "The name, e.g. \"Grünfeld, Alfred\", \"Wien\", \"M. Welte & Söhne\".",
+                            "type": "string",
+                            "ontology": "rdfs:label"
+                        },
+                        "sameAs": {
+                            "description": "Authority records for the same thing: GND, Wikidata, geonames or similar.",
+                            "examples": [
+                                "https://d-nb.info/gnd/116888652"
+                            ],
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array",
+                            "ontology": "owl:sameAs"
+                        },
+                        "@id": {
+                            "description": "A unique identifier for this object.",
+                            "type": "string"
+                        }
                     },
-                    "type": "array",
-                    "ontology": "owl:sameAs"
+                    "required": [
+                        "@id"
+                    ],
+                    "type": "object"
                 },
-                "@id": {
-                    "description": "A unique identifier for this object.",
-                    "type": "string"
+                {
+                    "properties": {
+                        "name": {
+                            "description": "The name, e.g. \"Grünfeld, Alfred\", \"Wien\", \"M. Welte & Söhne\".",
+                            "type": "string",
+                            "ontology": "rdfs:label"
+                        },
+                        "sameAs": {
+                            "description": "Authority records for the same thing: GND, Wikidata, geonames or similar.",
+                            "examples": [
+                                "https://d-nb.info/gnd/116888652"
+                            ],
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array",
+                            "ontology": "owl:sameAs"
+                        },
+                        "@id": {
+                            "description": "A unique identifier for this object.",
+                            "type": "string"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "sameAs"
+                    ],
+                    "type": "object"
                 }
-            },
-            "required": [
-                "name",
-                "sameAs"
             ],
-            "type": "object",
+            "description": "A term from a vocabulary, such as a roll system, a procedure or a kind of paper.\n\nA term the type vocabulary declares is named by its IRI, and what it is called stands in the vocabulary rather than in the edition, so it needs no name of its own; `nameOf` reads one either way. A term the vocabulary does not have is given by name, which is then all there is to go on.",
             "ontology": "crm:E55 Type"
         },
         "DateAssignment": {

package/lib/vocabulary.d.ts

@@ -0,0 +1,15 @@
+import { Concept } from "./Agent";
+/**
+ * The concepts the type vocabulary declares, whatever kind they are:
+ * the reproducing systems and the procedures. An edition names one of
+ * them by its IRI alone.
+ */
+export declare const vocabulary: readonly Concept[];
+/** The concept of that IRI, where the vocabulary declares one. */
+export declare const conceptOf: (id: string | undefined) => Concept | undefined;
+/**
+ * What a concept is called: the name it states, else the one the
+ * vocabulary gives it, else its IRI, so that a reader always has
+ * something to show.
+ */
+export declare const nameOf: (concept: Concept) => string;

package/lib/vocabulary.js

@@ -0,0 +1,20 @@
+import { procedures } from "./procedures";
+import { systemOf } from "./TrackerBar";
+import { trackerBars } from "./systems";
+/**
+ * The concepts the type vocabulary declares, whatever kind they are:
+ * the reproducing systems and the procedures. An edition names one of
+ * them by its IRI alone.
+ */
+export const vocabulary = [
+    ...trackerBars.map(systemOf),
+    ...procedures
+];
+/** The concept of that IRI, where the vocabulary declares one. */
+export const conceptOf = (id) => id === undefined ? undefined : vocabulary.find(concept => concept.id === id);
+/**
+ * What a concept is called: the name it states, else the one the
+ * vocabulary gives it, else its IRI, so that a reader always has
+ * something to show.
+ */
+export const nameOf = (concept) => concept.name ?? conceptOf(concept.id)?.name ?? concept.id ?? '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linked-rolls",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "description": "Digital editions of piano rolls: import, collation, editorial assumptions, JSON-LD export, and emulation through a reproducing system",
   "license": "MIT",
   "repository": {