linked-rolls 0.68.0 → 0.70.0

package/lib/lookup/paths.d.ts

@@ -7,5 +7,7 @@ export type Path = (string | number)[];
 export declare const getAt: <T>(path: Path, obj: unknown) => T | undefined;
 /** Where the entity with the id stands in the edition, or nothing where it holds none. */
 export declare const pathIn: (edition: Edition, id: string) => Path | undefined;
+/** Every id the edition gives an entity of its own, references left out. */
+export declare const idsIn: (edition: Edition) => Iterable<string>;
 /** Where the edition references the id. */
 export declare const linksTo: (edition: Edition, id: string) => Path[];

package/lib/lookup/paths.js

@@ -74,5 +74,7 @@ export const pathIn = (edition, id) => {
     const trail = placesIn(edition).paths.get(id);
     return trail === undefined ? undefined : laidOut(trail);
 };
+/** Every id the edition gives an entity of its own, references left out. */
+export const idsIn = (edition) => placesIn(edition).paths.keys();
 /** Where the edition references the id. */
 export const linksTo = (edition, id) => (placesIn(edition).links.get(id) ?? []).map(laidOut);

package/lib/model/Edition.d.ts

@@ -21,7 +21,8 @@ export interface EditionCreation {
      */
     publisher: Person;
     /**
-     * The date on which the edition was published.
+     * The date on which the edition was published: where it states a
+     * version, the date of that version.
      * @format date
      * @see dcterms:date
      */
@@ -116,6 +117,16 @@ export interface Edition {
      * @example "https://creativecommons.org/licenses/by/4.0/"
      */
     license: string;
+    /**
+     * The version of the edition, which a citation names together with
+     * the publication date. The editor raises it for each release and
+     * sets the publication date with it, so that what a reader cited can
+     * be told from what has changed since. An edition published before
+     * this field existed states none.
+     * @see owl:versionInfo
+     * @example "1.0"
+     */
+    version?: string;
     /**
      * The roll which is edited in this edition.
      * @see lrmoo:R3i realises
@@ -135,7 +146,7 @@ export interface Edition {
      * best, since its places are what notes and readers cite. Left out,
      * it is the first copy with features that is not aligned
      * (`referenceCopyOf`).
-     * Not exported to RDF.
+     * @see reo:referenceCopy
      */
     referenceCopy?: string;
     /**
@@ -145,7 +156,7 @@ export interface Edition {
      */
     versions: Version[];
 }
-export type EditionMetadata = Pick<Edition, 'base' | 'title' | 'license' | 'creation' | 'roll'>;
+export type EditionMetadata = Pick<Edition, 'base' | 'title' | 'license' | 'version' | 'creation' | 'roll'>;
 /**
  * The copy whose millimetres are the edition's axis: the one it names,
  * or where it names none or one it no longer has, the first copy with

package/lib/schema.json

@@ -601,8 +601,9 @@
                     "ontology": "dcterms:license"
                 },
                 "referenceCopy": {
-                    "description": "The copy whose millimetres are the edition's axis, by id: every place the edition gives along the roll is a place on this copy's paper, counted from where its scan begins, and every other copy is aligned onto it. Choosing it is the one editorial decision the alignment leaves; a copy scanned whole and without tears serves best, since its places are what notes and readers cite. Left out, it is the first copy with features that is not aligned (`referenceCopyOf`). Not exported to RDF.",
-                    "type": "string"
+                    "description": "The copy whose millimetres are the edition's axis, by id: every place the edition gives along the roll is a place on this copy's paper, counted from where its scan begins, and every other copy is aligned onto it. Choosing it is the one editorial decision the alignment leaves; a copy scanned whole and without tears serves best, since its places are what notes and readers cite. Left out, it is the first copy with features that is not aligned (`referenceCopyOf`).",
+                    "type": "string",
+                    "ontology": "reo:referenceCopy"
                 },
                 "roll": {
                     "$ref": "#/definitions/Roll",
@@ -617,6 +618,14 @@
                     "type": "string",
                     "ontology": "dcterms:title"
                 },
+                "version": {
+                    "description": "The version of the edition, which a citation names together with the publication date. The editor raises it for each release and sets the publication date with it, so that what a reader cited can be told from what has changed since. An edition published before this field existed states none.",
+                    "examples": [
+                        "1.0"
+                    ],
+                    "type": "string",
+                    "ontology": "owl:versionInfo"
+                },
                 "versions": {
                     "description": "The different versions of the roll on which this edition is based.",
                     "items": {
@@ -649,7 +658,7 @@
                     "ontology": "crm:P14 carried out by"
                 },
                 "publicationDate": {
-                    "description": "The date on which the edition was published.",
+                    "description": "The date on which the edition was published: where it states a version, the date of that version.",
                     "format": "date",
                     "type": "string",
                     "ontology": "dcterms:date"

package/lib/spec/context.json

@@ -97,6 +97,7 @@
             }
         },
         "title": "dcterms:title",
+        "version": "owl:versionInfo",
         "license": {
             "@id": "dcterms:license",
             "@type": "@id"
@@ -117,7 +118,10 @@
             "@type": "xsd:date"
         },
         "collationTolerance": null,
-        "referenceCopy": null,
+        "referenceCopy": {
+            "@id": "reo:referenceCopy",
+            "@type": "@id"
+        },
         "annotation": null,
         "roll": "lrmoo:R3i_realises",
         "catalogueNumber": "dcterms:identifier",

package/package.json

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