linked-rolls 0.33.0 → 0.34.0

package/lib/reservations.d.ts

@@ -24,7 +24,7 @@ export interface Reservation<T extends string = ReservationType> {
  * the measurement leaves open, then who holds it.
  */
 export declare const reservationsAbout: (copy: RollCopy) => Reservation[];
-export declare const versionReservationTypes: readonly ['text-not-stated', 'witnessed-by-statement-only'];
+export declare const versionReservationTypes: readonly ['text-not-stated', 'witnessed-by-statement-only', 'no-direct-witness'];
 export type VersionReservationType = typeof versionReservationTypes[number];
 /** What the edition cannot vouch for in a version, in the order the checks are listed. */
 export declare const reservationsAboutVersion: (view: EditionView, version: Readonly<Version>) => Reservation<VersionReservationType>[];

package/lib/reservations.js

@@ -102,7 +102,8 @@ const checks = [
 export const reservationsAbout = (copy) => checks.flatMap(check => check(copy) ?? []);
 export const versionReservationTypes = [
     'text-not-stated',
-    'witnessed-by-statement-only'
+    'witnessed-by-statement-only',
+    'no-direct-witness'
 ];
 const textStated = (_view, version) => version.edits ? undefined : {
     type: 'text-not-stated',
@@ -115,6 +116,18 @@ const witnessedByFeatures = (view, version) => {
         note: 'No copy\'s features carry what the version inserts; only copies that state they carry it bear witness to it.'
     } : undefined;
 };
-const versionChecks = [textStated, witnessedByFeatures];
+/**
+ * A version every copy reaches only through a version derived from it.
+ * Its text is a reconstruction from below, as a lost state's is, and
+ * nothing surviving shows it as it stood.
+ */
+const witnessedAtFirstHand = (view, version) => {
+    const carriers = witnessesOf(view, version.id).filter(({ by }) => by === 'carriers');
+    return carriers.length > 0 && carriers.every(({ through }) => through !== undefined) ? {
+        type: 'no-direct-witness',
+        note: 'No copy carries it at first hand; it is attested only through the versions derived from it.'
+    } : undefined;
+};
+const versionChecks = [textStated, witnessedByFeatures, witnessedAtFirstHand];
 /** What the edition cannot vouch for in a version, in the order the checks are listed. */
 export const reservationsAboutVersion = (view, version) => versionChecks.flatMap(check => check(view, version) ?? []);

package/package.json

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