linked-rolls 0.7.0 → 0.8.0

package/lib/Agent.d.ts

@@ -16,11 +16,17 @@ export interface Named {
      */
     sameAs: string[];
 }
-export declare const agentRoles: readonly ["pianist", "editor", "publisher"];
+export declare const editorialRoles: readonly ["editor", "transcription", "collation", "encoding", "commentary", "proofreading"];
+/**
+ * The part an editor took in the editorial work.
+ */
+export type EditorialRole = typeof editorialRoles[number];
+declare const nonEditorialRoles: readonly ["pianist", "publisher"];
 /**
  * The role an agent plays in the context of the edition.
  */
-export type AgentRole = typeof agentRoles[number];
+export type AgentRole = EditorialRole | typeof nonEditorialRoles[number];
+export declare const agentRoles: readonly AgentRole[];
 /**
  * A person or a group: a pianist, an editor, a publisher,
  * a manufacturer, a library.
@@ -37,6 +43,16 @@ export interface Agent extends Named, Partial<WithId> {
  * An agent that is a person.
  */
 export type Person = Agent;
+/**
+ * A person who took part in preparing the edition.
+ */
+export interface Editor extends Person {
+    /**
+     * The part this person took in the editorial work.
+     * @see crm:P2 has type
+     */
+    role: EditorialRole;
+}
 export type WithActor = {
     /**
      * The person who carried out this activity.
@@ -57,3 +73,4 @@ export interface Place extends Named {
  */
 export interface Concept extends Named, Partial<WithId> {
 }
+export {};

package/lib/Agent.js

@@ -1 +1,10 @@
-export const agentRoles = ['pianist', 'editor', 'publisher'];
+export const editorialRoles = [
+    'editor',
+    'transcription',
+    'collation',
+    'encoding',
+    'commentary',
+    'proofreading'
+];
+const nonEditorialRoles = ['pianist', 'publisher'];
+export const agentRoles = [...nonEditorialRoles, ...editorialRoles];

package/lib/Edition.d.ts

@@ -2,7 +2,7 @@ import { RollCopy } from "./RollCopy";
 import { Version } from "./Version";
 import { CollationTolerance } from "./Collation";
 import { DateAssignment, ObjectAssumption } from "./Assumption";
-import { Concept, Person, Place } from "./Agent";
+import { Concept, Editor, Person, Place } from "./Agent";
 import { RollTempo } from "./ReproducingSystem";
 /**
  * This type describes the creation of an edition,
@@ -10,6 +10,13 @@ import { RollTempo } from "./ReproducingSystem";
  * @see lrmoo:F28 Expression Creation
  */
 export interface EditionCreation {
+    /**
+     * The persons who prepared the edition, each with the part
+     * they took in the editorial work. An edition written before
+     * this field existed carries none.
+     * @see crm:P14 carried out by
+     */
+    editors?: Editor[];
     /**
      * The person or institution responsible for publishing the edition.
      * @see crm:P14 carried out by

package/lib/migrate.js

@@ -75,4 +75,8 @@ const withRollSystem = (edition) => {
     const system = { '@id': id, ...concept, ...(stated && { name: stated }) };
     return { ...edition, roll: { ...edition.roll, system } };
 };
-export const migrate = (edition) => walk(withRollSystem(edition));
+/** An edition written before the editors were carried names none. */
+const withEditors = (edition) => !edition.creation || edition.creation.editors
+    ? edition
+    : { ...edition, creation: { ...edition.creation, editors: [] } };
+export const migrate = (edition) => walk(withRollSystem(withEditors(edition)));

package/lib/schema.json

@@ -39,13 +39,20 @@
             "type": "object"
         },
         "AgentRole": {
-            "description": "The role an agent plays in the context of the edition.",
-            "enum": [
-                "pianist",
-                "editor",
-                "publisher"
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/EditorialRole"
+                },
+                {
+                    "const": "pianist",
+                    "type": "string"
+                },
+                {
+                    "const": "publisher",
+                    "type": "string"
+                }
             ],
-            "type": "string"
+            "description": "The role an agent plays in the context of the edition."
         },
         "AnyArgumentation": {
             "anyOf": [
@@ -406,6 +413,13 @@
                     "$ref": "#/definitions/CollationTolerance",
                     "description": "The tolerance parameters used when collating (aligning) the different roll copies for this edition. Not exported to RDF."
                 },
+                "editors": {
+                    "description": "The persons who prepared the edition, each with the part they took in the editorial work. An edition written before this field existed carries none. [ontology: crm:P14 carried out by]",
+                    "items": {
+                        "$ref": "#/definitions/Editor"
+                    },
+                    "type": "array"
+                },
                 "publicationDate": {
                     "description": "The date on which the edition was published. [ontology: dcterms:date]",
                     "format": "date",
@@ -422,6 +436,51 @@
             ],
             "type": "object"
         },
+        "Editor": {
+            "description": "A person who took part in preparing the edition.",
+            "properties": {
+                "name": {
+                    "description": "The name, e.g. \"Grünfeld, Alfred\", \"Wien\", \"M. Welte & Söhne\". [ontology: rdfs:label]",
+                    "type": "string"
+                },
+                "role": {
+                    "$ref": "#/definitions/EditorialRole",
+                    "description": "The part this person took in the editorial work. [ontology: crm:P2 has type]"
+                },
+                "sameAs": {
+                    "description": "Authority records for the same thing: GND, Wikidata, geonames or similar. [ontology: owl:sameAs]",
+                    "examples": [
+                        "https://d-nb.info/gnd/116888652"
+                    ],
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "@id": {
+                    "description": "A unique identifier for this object.",
+                    "type": "string"
+                }
+            },
+            "required": [
+                "name",
+                "role",
+                "sameAs"
+            ],
+            "type": "object"
+        },
+        "EditorialRole": {
+            "description": "The part an editor took in the editorial work.",
+            "enum": [
+                "editor",
+                "transcription",
+                "collation",
+                "encoding",
+                "commentary",
+                "proofreading"
+            ],
+            "type": "string"
+        },
         "Expression": {
             "description": "An expression symbol, representing a perforation on the roll that governs dynamics, pedaling, or mechanical functions of the reproducing piano. Each expression has a scope (bass or treble) and a specific expression type. [ontology: reo:Expression]",
             "properties": {

package/lib/spec/context.json

@@ -76,6 +76,7 @@
             "@type": "@id"
         },
         "creation": "lrmoo:R17i_was_created_by",
+        "editors": "crm:P14_carried_out_by",
         "publisher": "crm:P14_carried_out_by",
         "publicationDate": {
             "@id": "dcterms:date",

package/package.json

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