linked-rolls 0.39.0 → 0.39.1

package/README.md

@@ -78,12 +78,17 @@ derivation loads as a list of one.
 ## What brought a feature about
 
 A copy states no list of features. Each feature stands in the act that
-brought it about: the perforations in the copy's own production, a
-writing or a mark in the `Alteration` that made it, a patch in the
-`Attachment` that glued it on. A `Removal` names by id what was taken
-off, which stood there before the act. A feature no later act is known
-to have made belongs to the punching, which is where a reading of a
-scan puts every hole it finds.
+brought it about: the copy's own production for what the punching made,
+an `Alteration` for what a later hand made, an `Attachment` for a patch
+glued on. A `Removal` names by id what was taken off, which stood there
+before the act.
+
+Which act a feature stands in says when it came about and by whose
+hand, and says nothing about what kind of feature it is. A hole may be
+punched by hand long after the roll was cut, and a mark may come from
+the factory, rarely though that happens. A feature no later act is
+known to have made belongs to the punching, which is where a reading of
+a scan puts every hole it finds.
 
 Three kinds of act rather than two, because the CRM tells them apart.
 E79 Part Addition asks that what is added be "a separate identifiable

package/lib/Feature.d.ts

@@ -169,9 +169,11 @@ export interface Writing extends Trace<'Writing'> {
      */
     transcription: ObjectAssumption<Transcription>;
     /**
-     * How far the writing stands askew, clockwise from the line across
-     * the roll. A stamp pressed crooked and a label written along the
-     * roll rather than across it are both stated here.
+     * How far the writing stands askew. At zero it reads across the
+     * roll, from the bass side towards the treble, and the angle turns
+     * that reading direction towards the end of the roll, so that a
+     * right angle leaves it reading along the roll. A stamp pressed
+     * crooked and a label written lengthwise are both stated here.
      * @see reo:rotation
      */
     rotation?: Measure<'deg'>;
@@ -204,8 +206,9 @@ export interface GluedOn extends RollFeature<'GluedOn', typeof conditions.GluedO
      */
     material: 'paper' | 'tape';
     /**
-     * How far the patch was stuck on askew, clockwise from the line
-     * across the roll.
+     * How far the patch was stuck on askew. At zero its edges stand
+     * square to the roll, and the angle turns them towards the end of
+     * it, as a writing's reading direction turns.
      * @see reo:rotation
      */
     rotation?: Measure<'deg'>;

package/lib/Quantity.d.ts

@@ -28,7 +28,7 @@ export type FeetPerMinute = Quantity<'ft/min'>;
 export type MetersPerMinute = Quantity<'m/min'>;
 /** How finely a scan was read: pixels of the image per inch of paper. */
 export type Resolution = Quantity<'px/in'>;
-/** An angle, clockwise from the line across the roll. */
+/** An angle on the roll, turning from the line across the paper towards the end of the roll. */
 export type Degrees = Quantity<'deg'>;
 /** Names a number in a unit. Partially apply it to make a constructor. */
 export declare const quantity: <U extends string>(value: number) => Quantity<U>;

package/lib/RollCopy.d.ts

@@ -115,10 +115,12 @@ export interface ProductionEvent {
      */
     speed?: ObjectAssumption<PaperSpeed>;
     /**
-     * The features the punching brought into being, which are the note
-     * and expression perforations. A reading of a scan finds every hole
-     * on the paper at once and states it here. A hole an editor reads as
-     * punched later belongs in the act that made it.
+     * The features the copy came from its punching with: the note and
+     * expression perforations, and now and then a mark the perforator
+     * left. A reading of a scan finds every hole on the paper at once
+     * and states it here, and a feature an editor reads as the work of
+     * a later hand belongs in the act that made it, whichever kind of
+     * feature it is.
      * @see crm:P108 has produced
      */
     produced?: AnyFeature[];
@@ -161,7 +163,9 @@ export type Modification = Partial<{
     type: 'Alteration';
     /**
      * The features the act brought into being: a date written on the
-     * paper, a circle in pencil, a hole punched by hand.
+     * paper, a circle in pencil, a hole punched by hand. Any kind of
+     * feature may come of a later act, as any kind may come of the
+     * punching.
      * @see crm:P108 has produced
      */
     produced: AnyFeature[];

package/lib/editionOps.d.ts

@@ -77,7 +77,7 @@ export declare const symbolsCarriedOnlyBy: (edition: Edition, copyId: string) =>
  * punched, being glued on, so `punched` says nothing of one.
  */
 export interface FeatureAct {
-    /** The copy was punched with it, which is where a reading of a scan puts every hole. */
+    /** The copy came from its punching with it, which is where a reading of a scan puts every hole. */
     punched?: boolean;
     /** The act that brought this feature about brought the new one about as well. */
     beside?: string;

package/lib/schema.json

@@ -782,7 +782,7 @@
                 },
                 "rotation": {
                     "$ref": "#/definitions/Measure%3C%22deg%22%3E",
-                    "description": "How far the patch was stuck on askew, clockwise from the line across the roll.",
+                    "description": "How far the patch was stuck on askew. At zero its edges stand square to the roll, and the angle turns them towards the end of it, as a writing's reading direction turns.",
                     "ontology": "reo:rotation"
                 },
                 "side": {
@@ -1264,7 +1264,7 @@
                             "ontology": "crm:P4 has time-span"
                         },
                         "produced": {
-                            "description": "The features the act brought into being: a date written on the paper, a circle in pencil, a hole punched by hand.",
+                            "description": "The features the act brought into being: a date written on the paper, a circle in pencil, a hole punched by hand. Any kind of feature may come of a later act, as any kind may come of the punching.",
                             "items": {
                                 "$ref": "#/definitions/AnyFeature"
                             },
@@ -1458,7 +1458,7 @@
                         },
                         "rotation": {
                             "$ref": "#/definitions/Measure%3C%22deg%22%3E",
-                            "description": "How far the writing stands askew, clockwise from the line across the roll. A stamp pressed crooked and a label written along the roll rather than across it are both stated here.",
+                            "description": "How far the writing stands askew. At zero it reads across the roll, from the bass side towards the treble, and the angle turns that reading direction towards the end of the roll, so that a right angle leaves it reading along the roll. A stamp pressed crooked and a label written lengthwise are both stated here.",
                             "ontology": "reo:rotation"
                         },
                         "side": {
@@ -1588,7 +1588,7 @@
                         },
                         "rotation": {
                             "$ref": "#/definitions/Measure%3C%22deg%22%3E",
-                            "description": "How far the patch was stuck on askew, clockwise from the line across the roll.",
+                            "description": "How far the patch was stuck on askew. At zero its edges stand square to the roll, and the angle turns them towards the end of it, as a writing's reading direction turns.",
                             "ontology": "reo:rotation"
                         },
                         "side": {
@@ -2467,7 +2467,7 @@
                     "ontology": "crm:P126 employed"
                 },
                 "produced": {
-                    "description": "The features the punching brought into being, which are the note and expression perforations. A reading of a scan finds every hole on the paper at once and states it here. A hole an editor reads as punched later belongs in the act that made it.",
+                    "description": "The features the copy came from its punching with: the note and expression perforations, and now and then a mark the perforator left. A reading of a scan finds every hole on the paper at once and states it here, and a feature an editor reads as the work of a later hand belongs in the act that made it, whichever kind of feature it is.",
                     "items": {
                         "$ref": "#/definitions/AnyFeature"
                     },
@@ -3092,7 +3092,7 @@
                 },
                 "rotation": {
                     "$ref": "#/definitions/Measure%3C%22deg%22%3E",
-                    "description": "How far the writing stands askew, clockwise from the line across the roll. A stamp pressed crooked and a label written along the roll rather than across it are both stated here.",
+                    "description": "How far the writing stands askew. At zero it reads across the roll, from the bass side towards the treble, and the angle turns that reading direction towards the end of the roll, so that a right angle leaves it reading along the roll. A stamp pressed crooked and a label written lengthwise are both stated here.",
                     "ontology": "reo:rotation"
                 },
                 "side": {

package/package.json

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