linked-rolls 0.54.0 → 0.56.0

package/lib/editionOps.js

@@ -8,9 +8,9 @@ import { asSymbols, barOf, featuresByAct, featuresOf, isPaperStretch, statesNoth
 import { systemOf } from "./TrackerBar.js";
 import { substitutionsBetween } from "./substitution.js";
 import { trackerBarOf } from "./systems/index.js";
-import { applyShift, applyScale, revertShift, revertScale, revertShortening, shortenHoles } from "./alignment.js";
+import { applyShift, applyScale, revertShift, revertScale, revertShortening, shortenChains } from "./alignment.js";
 import { assignReference, idOf } from "./Assumption.js";
-import { conditions as conditionsAllowed, featuresBorneBy, isGluedOn, withBorneFeatures } from "./Feature.js";
+import { conditions as conditionsAllowed, featuresBorneBy, isPatch, withBorneFeatures } from "./Feature.js";
 import { distance, mm, subtract } from "./Quantity.js";
 const noChange = () => undefined;
 const onCopy = (copyId, op) => draft => {
@@ -138,11 +138,11 @@ export const unalignCopy = (copyId) => onCopy(copyId, copy => {
 });
 /**
  * Takes the extension a pneumatic reader adds off the ends of the
- * copy's holes, and records how much was taken, so that its lengths
+ * copy's chains of holes, and records how much was taken, so that their lengths
  * can be compared with a scanned copy's at all.
  */
-export const shortenCopy = (copyId, extension, leaving) => onCopy(copyId, copy => shortenHoles(extension, copy, leaving));
-/** Puts the reader's extension back on the copy's holes. */
+export const shortenCopy = (copyId, extension, leaving) => onCopy(copyId, copy => shortenChains(extension, copy, leaving));
+/** Puts the reader's extension back on the copy's chains of holes. */
 export const unshortenCopy = (copyId) => onCopy(copyId, copy => revertShortening(copy));
 /** States what the copy's features were read from, in place of any earlier statement. */
 export const stateSource = (copyId, source) => onCopy(copyId, copy => {
@@ -369,7 +369,7 @@ const goneWith = (features, named) => features.flatMap(feature => named.has(feat
     : goneWith(featuresBorneBy(feature), named));
 /** The feature with the named ones gone from what it bears, or the very same one where it bears none of them. */
 const withoutBorne = (feature, named) => {
-    if (!isGluedOn(feature) || !feature.features)
+    if (!isPatch(feature) || !feature.features)
         return feature;
     const borne = withoutFeatures(feature.features, named);
     return borne === feature.features ? feature : { ...feature, features: borne };
@@ -443,7 +443,7 @@ const actFor = (copy, patch, act) => {
  * the feature goes into an act of its own.
  */
 export const addFeature = (copyId, feature, act = {}) => onCopy(copyId, copy => {
-    actFor(copy, isGluedOn(feature), act).push(feature);
+    actFor(copy, isPatch(feature), act).push(feature);
 });
 /**
  * States that the patch bears the feature. What a patch bears came onto
@@ -452,7 +452,7 @@ export const addFeature = (copyId, feature, act = {}) => onCopy(copyId, copy =>
  */
 export const addBorneFeature = (copyId, patchId, feature) => onCopy(copyId, copy => {
     const patch = featuresOf(copy).flatMap(withBorneFeatures).find(borne => borne.id === patchId);
-    if (!patch || !isGluedOn(patch))
+    if (!patch || !isPatch(patch))
         return;
     if (!patch.features)
         patch.features = [];
@@ -502,7 +502,7 @@ const sayTheSame = (a, b) => {
  */
 const nature = (feature) => {
     const { id, horizontal, depiction, condition, ...rest } = feature;
-    return isGluedOn(feature) && feature.features
+    return isPatch(feature) && feature.features
         ? { ...rest, features: feature.features.map(borne => borne.id) }
         : rest;
 };

package/lib/migrate.js

@@ -11,6 +11,14 @@ const renamedKeys = {
     annotates: 'depiction',
     classification: 'editType'
 };
+/**
+ * Classes of feature renamed since: a chain of holes was named after a
+ * single hole, and a patch after the act that glued it on.
+ */
+const renamedTypes = {
+    Hole: 'HoleChain',
+    GluedOn: 'Patch'
+};
 const referenceKeys = ['alignedWith', 'pairedWith', 'basedOn'];
 /**
  * The five type terms that were capitalised while the rest of the
@@ -33,6 +41,9 @@ const withTypology = (node) => {
     }
     return node;
 };
+const withRenamedType = (node) => Object.hasOwn(renamedTypes, node['@type']) ? { ...node, '@type': renamedTypes[node['@type']] } : node;
+/** Whether the feature is of the class under either name, since a node is migrated before its children are. */
+const isOfType = (type) => (feature) => feature?.['@type'] === type || renamedTypes[feature?.['@type']] === type;
 /** A version once stated whether it served as a master or stood on one copy. */
 const withoutVersionType = (node) => {
     if (!Object.hasOwn(node, 'versionType'))
@@ -163,9 +174,9 @@ const withTypedPerforator = (node) => {
 };
 const asynchronous = 'https://w3id.org/reo/type/drive/asynchronous';
 /**
- * Each hole once stated its punching pattern. A staggering hole the copy
- * was punched with shows that its perforator drove each punch on its
- * own; one a later act made shows nothing about the machine. Regular
+ * Each chain once stated its punching pattern. A staggering chain the
+ * copy was punched with shows that its perforator drove each punch on
+ * its own; one a later act made shows nothing about the machine. Regular
  * and accelerating bridges are not carried over: the chain pitch states
  * the one, and for the other no source was found. The features are in
  * their acts here, since a node is migrated before its children are.
@@ -180,7 +191,7 @@ const withDriveOfStaggering = (node) => {
     return { ...node, production: { ...node.production, perforator: { ...perforator, drive: { '@id': asynchronous } } } };
 };
 const withoutPattern = (node) => {
-    if (node['@type'] !== 'Hole' || !Object.hasOwn(node, 'pattern'))
+    if (node['@type'] !== 'HoleChain' || !Object.hasOwn(node, 'pattern'))
         return node;
     const { pattern: _moved, ...rest } = node;
     return rest;
@@ -193,13 +204,13 @@ const featuresOf = (copy) => [
     ...(Array.isArray(copy.features) ? copy.features : []),
     ...(Array.isArray(copy.production?.produced) ? copy.production.produced : [])
 ];
+const isHoleChain = isOfType('HoleChain');
 /**
  * A copy read on a roll reader was stated as a recording before a sound
  * recording could be one. A sound recording gives no holes, so a recording
  * with holes is a reading.
  */
-const withReadingKind = (node) => node.readFrom?.kind === 'recording'
-    && featuresOf(node).some((feature) => feature?.['@type'] === 'Hole')
+const withReadingKind = (node) => node.readFrom?.kind === 'recording' && featuresOf(node).some(isHoleChain)
     ? { ...node, readFrom: { ...node.readFrom, kind: 'reading' } }
     : node;
 /** A feature written while the kind of a feature was a type beside its class. */
@@ -209,7 +220,7 @@ const withoutFeatureKind = (node) => {
     const { kind: _typed, ...rest } = node;
     return rest;
 };
-const isPatch = (feature) => feature?.['@type'] === 'GluedOn';
+const isPatch = isOfType('Patch');
 /**
  * A feature a patch bears was sometimes written without an id, and what
  * has no id can be referred to from nowhere: neither by a reading of it
@@ -300,7 +311,7 @@ const withTimeSpanDates = (node) => {
     const { '@value': within, '@type': _typed, ...rest } = node;
     return { ...rest, within };
 };
-const migrateNode = (node) => [withRenamedKeys, withTypology, withoutVersionType, withoutVersionSiglum, withLowerCaseTerms, withSplitMethod, withReferences, withKeeper, withoutEmptyKeeper,
+const migrateNode = (node) => [withRenamedKeys, withTypology, withRenamedType, withoutVersionType, withoutVersionSiglum, withLowerCaseTerms, withSplitMethod, withReferences, withKeeper, withoutEmptyKeeper,
     withPerforator, withProductionNodes, withTypedPerforator, withScale, withDerivationList, withReadingKind, withTimeSpanDates,
     withoutFeatureKind, withBorneFeaturesNamed, withFeaturesInActs, withDriveOfStaggering, withoutPattern]
     .reduce((result, step) => step(result), node);

package/lib/readers/phillipsEroll.d.ts

@@ -14,17 +14,17 @@ import { Millimeters, Seconds } from "../Quantity.js";
  * elapsed time, not paper, and the take-up spool accelerates the paper
  * as it fills, so `placeAt` has to put the time back onto the paper.
  * And a switch stays open longer than its perforation is long, so a
- * hole read here runs past the punched one: Phillips measures the
+ * chain read here runs past the punched one: Phillips measures the
  * pneumatic on-time as exceeding the apparent length of a perforation
  * (p. 178), and names what it depends on as the length of the
  * perforation, the height of the tracker bar hole and the paper speed
  * (p. 180).
  *
  * Left in, that extension is not a difference between copies at all:
- * the end of a hole here is a pneumatic on-time where the end of a
- * scanned copy's hole is a punched slot, so a collation comparing the
+ * the end of a chain here is a pneumatic on-time where the end of a
+ * scanned copy's chain is a punched slot, so a collation comparing the
  * two reads the one as a lengthening of the other. `extension` takes it
- * off at the end of every hole, and the copy records what was taken.
+ * off at the end of every chain, and the copy records what was taken.
  *
  * How much to take off is measured rather than derived, since he gives
  * only the 0.5 mm by which the Welte bar's holes exceed the Licensee's
@@ -71,8 +71,8 @@ export interface PhillipsErollOptions {
     placeAt?: (elapsed: Seconds) => Millimeters;
     /**
      * How much longer a valve is held on than the perforation that
-     * opened it, taken off the end of every hole so that these lengths
-     * can be compared with a scanned copy's. Nothing leaves the holes
+     * opened it, taken off the end of every chain so that these lengths
+     * can be compared with a scanned copy's. Nothing leaves the chains
      * as the reader reported them, which is what every copy read before
      * this option existed states.
      *

package/lib/readers/phillipsEroll.js

@@ -2,7 +2,7 @@ import { read } from "midifile-ts";
 import { v4 } from "uuid";
 import { assignObject } from "../Assumption.js";
 import { systemOf } from "../TrackerBar.js";
-import { shortenHoles } from "../alignment.js";
+import { shortenChains } from "../alignment.js";
 import { welteT100 } from "../systems/welteT100/bar.js";
 import { welteLicensee } from "../systems/welteLicensee/bar.js";
 import { inMetersPerMinute, mm, seconds, track } from "../Quantity.js";
@@ -19,17 +19,17 @@ import { inMetersPerMinute, mm, seconds, track } from "../Quantity.js";
  * elapsed time, not paper, and the take-up spool accelerates the paper
  * as it fills, so `placeAt` has to put the time back onto the paper.
  * And a switch stays open longer than its perforation is long, so a
- * hole read here runs past the punched one: Phillips measures the
+ * chain read here runs past the punched one: Phillips measures the
  * pneumatic on-time as exceeding the apparent length of a perforation
  * (p. 178), and names what it depends on as the length of the
  * perforation, the height of the tracker bar hole and the paper speed
  * (p. 180).
  *
  * Left in, that extension is not a difference between copies at all:
- * the end of a hole here is a pneumatic on-time where the end of a
- * scanned copy's hole is a punched slot, so a collation comparing the
+ * the end of a chain here is a pneumatic on-time where the end of a
+ * scanned copy's chain is a punched slot, so a collation comparing the
  * two reads the one as a lengthening of the other. `extension` takes it
- * off at the end of every hole, and the copy records what was taken.
+ * off at the end of every chain, and the copy records what was taken.
  *
  * How much to take off is measured rather than derived, since he gives
  * only the 0.5 mm by which the Welte bar's holes exceed the Licensee's
@@ -153,7 +153,7 @@ export function readFromPhillipsEroll(buffer, { system = welteT100, controlOffse
         if (!system.meaningOf(position))
             return [];
         return [{
-                type: 'Hole',
+                type: 'HoleChain',
                 id: v4(),
                 vertical: { from: position, unit: 'track' },
                 horizontal: {
@@ -174,11 +174,11 @@ export function readFromPhillipsEroll(buffer, { system = welteT100, controlOffse
         readFrom: {
             kind: 'reading',
             actor: assignObject({ name: 'Phillips, Peter', sameAs: [] }),
-            note: 'Read on Phillips’s pneumatic roll reader. The places are elapsed time put back onto the paper, and a hole runs as long as its switch stayed open, which is longer than the perforation.'
+            note: 'Read on Phillips’s pneumatic roll reader. The places are elapsed time put back onto the paper, and a chain of holes runs as long as its switch stayed open, which is longer than the perforation.'
         }
     };
     if (extension !== undefined)
-        shortenHoles(extension, copy);
+        shortenChains(extension, copy);
     return copy;
 }
 /** The bars his files are known to be numbered by. */

package/lib/readers/spencerBar.d.ts

@@ -19,7 +19,7 @@ export interface SpencerBarOptions {
 }
 /**
  * Reads the copy on the bar it was cut for, whose numbering it keeps.
- * A hole on a position that bar does not read is left out, as the bar
+ * A chain on a position that bar does not read is left out, as the bar
  * would leave it.
  */
 export declare function readFromSpencerBar(buffer: ArrayBuffer, { rowsPerInch, system }?: SpencerBarOptions): RollCopy;

package/lib/readers/spencerBar.js

@@ -80,7 +80,7 @@ const holesOf = (events) => {
 };
 /**
  * Reads the copy on the bar it was cut for, whose numbering it keeps.
- * A hole on a position that bar does not read is left out, as the bar
+ * A chain on a position that bar does not read is left out, as the bar
  * would leave it.
  */
 export function readFromSpencerBar(buffer, { rowsPerInch = SPENCER_ROWS_PER_INCH, system = welteLicensee } = {}) {
@@ -95,7 +95,7 @@ export function readFromSpencerBar(buffer, { rowsPerInch = SPENCER_ROWS_PER_INCH
         if (!system.meaningOf(position))
             return [];
         return [{
-                type: 'Hole',
+                type: 'HoleChain',
                 id: v4(),
                 vertical: {
                     from: position,

package/lib/readers/stanfordAton.js

@@ -136,7 +136,7 @@ export function readFromStanfordAton(atonString, { trackShift, system = welteT10
         const column = readPx(hole.ORIGIN_COL);
         const columnWidth = readPx(hole.WIDTH_COL);
         return [{
-                type: 'Hole',
+                type: 'HoleChain',
                 id: v4(),
                 ...(stanford && {
                     depiction: stanford.depictionOf(column, attack, columnWidth, subtract(release, attack))

package/lib/schema.json

@@ -78,7 +78,7 @@
         "AnyFeature": {
             "anyOf": [
                 {
-                    "$ref": "#/definitions/Hole"
+                    "$ref": "#/definitions/HoleChain"
                 },
                 {
                     "$ref": "#/definitions/Writing"
@@ -87,7 +87,7 @@
                     "$ref": "#/definitions/Mark"
                 }
             ],
-            "description": "The features proper: a hole, a writing and a mark are all human-made features, and each of them is borne by whatever it sits on. A patch is an object glued onto the paper and stands apart from them."
+            "description": "The features proper: a chain of holes, a writing and a mark are all human-made features, and each of them is borne by whatever it sits on. A patch is an object glued onto the paper and stands apart from them."
         },
         "AnySymbol": {
             "anyOf": [
@@ -688,7 +688,7 @@
                     "ontology": "reo:before"
                 },
                 "carriers": {
-                    "description": "References to the physical features (e.g. holes) on the roll copies that carry this symbol. Since the association might be debatable, it can be annotated. There might be e.g. doubts about the meaning and correct transcription of a feature on a physical roll. This points to a feature by its `@id`.",
+                    "description": "References to the physical features (e.g. chains of holes) on the roll copies that carry this symbol. Since the association might be debatable, it can be annotated. There might be e.g. doubts about the meaning and correct transcription of a feature on a physical roll. This points to a feature by its `@id`.",
                     "items": {
                         "$ref": "#/definitions/ReferenceAssumption"
                     },
@@ -793,99 +793,8 @@
             "type": "object",
             "ontology": "crm:E7 Activity"
         },
-        "GluedOn": {
-            "description": "A piece of material (paper or tape) glued onto the roll surface. Glued-on features are typically used to cover perforations (for corrections) or to reinforce damaged areas. They may themselves carry other features such as writings or additional holes.",
-            "properties": {
-                "condition": {
-                    "$ref": "#/definitions/ObjectAssumption%3CConditionState%3C(%22detaching%22%7C%22ripped%22)%3E%3E",
-                    "description": "This can be used e.g. to indicate a perforation which is torn out or in any other way damaged.",
-                    "ontology": "crm:P44 has condition"
-                },
-                "depiction": {
-                    "description": "IIIF region pointing to a depiction of this feature in the scan.",
-                    "type": "string",
-                    "ontology": "crm:P138i has representation"
-                },
-                "features": {
-                    "description": "A glued-on feature itself may carry other features. Nested features do not need to be positioned explicitly.",
-                    "items": {
-                        "$ref": "#/definitions/NestedFeature"
-                    },
-                    "type": "array",
-                    "ontology": "crm:P46 is composed of"
-                },
-                "horizontal": {
-                    "$ref": "#/definitions/HorizontalSpan",
-                    "description": "Horizontal span of the feature on the roll.",
-                    "ontology": "crm:P43 has dimension"
-                },
-                "material": {
-                    "description": "The material of the glued-on feature.",
-                    "enum": [
-                        "paper",
-                        "tape"
-                    ],
-                    "type": "string",
-                    "ontology": "crm:P45 consists of"
-                },
-                "rotation": {
-                    "$ref": "#/definitions/Measure%3C%22deg%22%3E",
-                    "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": {
-                    "description": "The face of the roll it lies on: the side that faces the reader as the roll plays, or the back of it.",
-                    "enum": [
-                        "recto",
-                        "verso"
-                    ],
-                    "type": "string",
-                    "ontology": "reo:side"
-                },
-                "vertical": {
-                    "$ref": "#/definitions/VerticalSpan",
-                    "description": "Vertical span of the feature on the roll.",
-                    "ontology": "crm:P43 has dimension"
-                },
-                "@id": {
-                    "description": "A unique identifier for this object.",
-                    "type": "string"
-                },
-                "@type": {
-                    "const": "GluedOn",
-                    "description": "The type discriminator for this object.",
-                    "type": "string",
-                    "ontology": "rdf:type"
-                },
-                "bears": {
-                    "type": "array",
-                    "items": {
-                        "type": "object",
-                        "properties": {
-                            "@id": {
-                                "type": "string"
-                            }
-                        },
-                        "required": [
-                            "@id"
-                        ]
-                    },
-                    "description": "The features the patch bears. Derived on export.",
-                    "ontology": "crm:P56 bears feature"
-                }
-            },
-            "required": [
-                "horizontal",
-                "@id",
-                "material",
-                "@type",
-                "vertical"
-            ],
-            "type": "object",
-            "ontology": "reo:GluedOn"
-        },
-        "Hole": {
-            "description": "A hole (perforation) in the roll paper. Holes are the primary carriers of musical information on piano rolls, as they trigger notes and expression controls when passing over the tracker bar. A punched hole is a human-made feature: CRM counts \"the information encoding features on mechanical or digital carriers\" among the features purposely created by human activity.",
+        "HoleChain": {
+            "description": "A chain of holes punched along the roll, which the tracker bar reads as it passes. The perforator cuts a held note or function as a row of punches with bridges of paper left between them, so most perforations are chains; one without a bridge is a chain of a single hole. The holes are the chain's parts and are not stated one by one. A punched chain is a human-made feature: CRM counts \"the information encoding features on mechanical or digital carriers\" among the features purposely created by human activity.",
             "properties": {
                 "condition": {
                     "$ref": "#/definitions/ObjectAssumption%3CConditionState%3C(%22partially-torn%22%7C%22missing-perforation%22)%3E%3E",
@@ -912,7 +821,7 @@
                     "type": "string"
                 },
                 "@type": {
-                    "const": "Hole",
+                    "const": "HoleChain",
                     "description": "The type discriminator for this object.",
                     "type": "string",
                     "ontology": "rdf:type"
@@ -925,7 +834,7 @@
                 "vertical"
             ],
             "type": "object",
-            "ontology": "reo:Hole"
+            "ontology": "reo:HoleChain"
         },
         "HorizontalSpan": {
             "description": "Describes the horizontal extent of a feature on the roll, measured in millimeters from the beginning of the roll. The `from` value is the start position and `to` is the end position.",
@@ -1254,7 +1163,7 @@
                         "added": {
                             "description": "The patches glued onto the copy, each with whatever it bears.",
                             "items": {
-                                "$ref": "#/definitions/GluedOn"
+                                "$ref": "#/definitions/Patch"
                             },
                             "type": "array",
                             "ontology": "crm:P111 added"
@@ -1455,7 +1364,7 @@
                             "type": "string"
                         },
                         "@type": {
-                            "const": "Hole",
+                            "const": "HoleChain",
                             "description": "The type discriminator for this object.",
                             "type": "string",
                             "ontology": "rdf:type"
@@ -1608,7 +1517,7 @@
                             "ontology": "crm:P138i has representation"
                         },
                         "features": {
-                            "description": "A glued-on feature itself may carry other features. Nested features do not need to be positioned explicitly.",
+                            "description": "The features the patch itself carries. They need not be positioned explicitly.",
                             "items": {
                                 "$ref": "#/definitions/NestedFeature"
                             },
@@ -1621,7 +1530,7 @@
                             "ontology": "crm:P43 has dimension"
                         },
                         "material": {
-                            "description": "The material of the glued-on feature.",
+                            "description": "What the patch is made of.",
                             "enum": [
                                 "paper",
                                 "tape"
@@ -1653,7 +1562,7 @@
                             "type": "string"
                         },
                         "@type": {
-                            "const": "GluedOn",
+                            "const": "Patch",
                             "description": "The type discriminator for this object.",
                             "type": "string",
                             "ontology": "rdf:type"
@@ -1703,7 +1612,7 @@
                     "ontology": "reo:before"
                 },
                 "carriers": {
-                    "description": "References to the physical features (e.g. holes) on the roll copies that carry this symbol. Since the association might be debatable, it can be annotated. There might be e.g. doubts about the meaning and correct transcription of a feature on a physical roll. This points to a feature by its `@id`.",
+                    "description": "References to the physical features (e.g. chains of holes) on the roll copies that carry this symbol. Since the association might be debatable, it can be annotated. There might be e.g. doubts about the meaning and correct transcription of a feature on a physical roll. This points to a feature by its `@id`.",
                     "items": {
                         "$ref": "#/definitions/ReferenceAssumption"
                     },
@@ -2678,6 +2587,97 @@
             ],
             "type": "object"
         },
+        "Patch": {
+            "description": "A piece of paper or tape glued onto the roll: a label naming it, a strip covering perforations, or a patch reinforcing a tear. A patch may itself carry other features, such as writings or holes.",
+            "properties": {
+                "condition": {
+                    "$ref": "#/definitions/ObjectAssumption%3CConditionState%3C(%22detaching%22%7C%22ripped%22)%3E%3E",
+                    "description": "This can be used e.g. to indicate a perforation which is torn out or in any other way damaged.",
+                    "ontology": "crm:P44 has condition"
+                },
+                "depiction": {
+                    "description": "IIIF region pointing to a depiction of this feature in the scan.",
+                    "type": "string",
+                    "ontology": "crm:P138i has representation"
+                },
+                "features": {
+                    "description": "The features the patch itself carries. They need not be positioned explicitly.",
+                    "items": {
+                        "$ref": "#/definitions/NestedFeature"
+                    },
+                    "type": "array",
+                    "ontology": "crm:P46 is composed of"
+                },
+                "horizontal": {
+                    "$ref": "#/definitions/HorizontalSpan",
+                    "description": "Horizontal span of the feature on the roll.",
+                    "ontology": "crm:P43 has dimension"
+                },
+                "material": {
+                    "description": "What the patch is made of.",
+                    "enum": [
+                        "paper",
+                        "tape"
+                    ],
+                    "type": "string",
+                    "ontology": "crm:P45 consists of"
+                },
+                "rotation": {
+                    "$ref": "#/definitions/Measure%3C%22deg%22%3E",
+                    "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": {
+                    "description": "The face of the roll it lies on: the side that faces the reader as the roll plays, or the back of it.",
+                    "enum": [
+                        "recto",
+                        "verso"
+                    ],
+                    "type": "string",
+                    "ontology": "reo:side"
+                },
+                "vertical": {
+                    "$ref": "#/definitions/VerticalSpan",
+                    "description": "Vertical span of the feature on the roll.",
+                    "ontology": "crm:P43 has dimension"
+                },
+                "@id": {
+                    "description": "A unique identifier for this object.",
+                    "type": "string"
+                },
+                "@type": {
+                    "const": "Patch",
+                    "description": "The type discriminator for this object.",
+                    "type": "string",
+                    "ontology": "rdf:type"
+                },
+                "bears": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "@id": {
+                                "type": "string"
+                            }
+                        },
+                        "required": [
+                            "@id"
+                        ]
+                    },
+                    "description": "The features the patch bears. Derived on export.",
+                    "ontology": "crm:P56 bears feature"
+                }
+            },
+            "required": [
+                "horizontal",
+                "@id",
+                "material",
+                "@type",
+                "vertical"
+            ],
+            "type": "object",
+            "ontology": "reo:Patch"
+        },
         "Perforator": {
             "description": "The machine that punched the copy. It stands for this production alone. Whether it is the one another copy was punched on is left to a statement of identity made about it elsewhere, which its id allows.",
             "properties": {
@@ -2808,7 +2808,7 @@
                     "ontology": "crm:P16 used specific object"
                 },
                 "produced": {
-                    "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.",
+                    "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 chain of holes 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"
                     },
@@ -3064,10 +3064,10 @@
                             "ontology": "crmdig:L23 used software or firmware"
                         },
                         "readerExtension": {
-                            "description": "What a pneumatic reader added to this copy's holes, where it was taken off again. Such a reader reports how long a valve stayed open, which exceeds the perforation that opened it, so its holes are overlong by a constant while its onsets agree. Nothing for a copy read by other means, whose holes are the punched slots themselves. Not exported to RDF.",
+                            "description": "What a pneumatic reader added to this copy's chains of holes, where it was taken off again. Such a reader reports how long a valve stayed open, which exceeds the perforation that opened it, so its chains are overlong by a constant while its onsets agree. Nothing for a copy read by other means, whose chains are the punched ones themselves. Not exported to RDF.",
                             "properties": {
                                 "leaving": {
-                                    "description": "The holes it was not taken off, by `@id`, being no longer than it is. The constant reaches its limit there rather than the copy being wrong, and why they were left is for the edition to state about the features themselves; this only records that they stand as the reader gave them, so that putting the extension back does not lengthen a hole nothing was taken from.",
+                                    "description": "The chains it was not taken off, by `@id`, being no longer than it is. The constant reaches its limit there rather than the copy being wrong, and why they were left is for the edition to state about the features themselves; this only records that they stand as the reader gave them, so that putting the extension back does not lengthen a chain nothing was taken from.",
                                     "items": {
                                         "type": "string"
                                     },
@@ -3075,7 +3075,7 @@
                                 },
                                 "length": {
                                     "$ref": "#/definitions/Millimeters",
-                                    "description": "How much longer the reading of a hole ran than the perforation that caused it."
+                                    "description": "How much longer the reading of a chain ran than the perforation that caused it."
                                 }
                             },
                             "required": [
@@ -3258,7 +3258,7 @@
             "description": "A textual symbol, e.g. a label or annotation found on the roll.",
             "properties": {
                 "carriers": {
-                    "description": "References to the physical features (e.g. holes) on the roll copies that carry this symbol. Since the association might be debatable, it can be annotated. There might be e.g. doubts about the meaning and correct transcription of a feature on a physical roll. This points to a feature by its `@id`.",
+                    "description": "References to the physical features (e.g. chains of holes) on the roll copies that carry this symbol. Since the association might be debatable, it can be annotated. There might be e.g. doubts about the meaning and correct transcription of a feature on a physical roll. This points to a feature by its `@id`.",
                     "items": {
                         "$ref": "#/definitions/ReferenceAssumption"
                     },

package/lib/spec/context.json

@@ -14,10 +14,10 @@
         "Edition": "lrmoo:F2_Expression",
         "Version": "lrmoo:F2_Expression",
         "RollCopy": "reo:RollCopy",
-        "Hole": "reo:Hole",
+        "HoleChain": "reo:HoleChain",
         "Mark": "reo:Mark",
         "Writing": "reo:Writing",
-        "GluedOn": "reo:GluedOn",
+        "Patch": "reo:Patch",
         "Attachment": "crm:E79_Part_Addition",
         "Removal": "crm:E80_Part_Removal",
         "Alteration": "crm:E12_Production",

package/package.json

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