linked-rolls 0.59.0 → 0.60.0

package/lib/collation/Collation.d.ts

@@ -108,19 +108,23 @@ export declare const uncheckedMotivation: {
 };
 /**
  * Whether the edit is one a collation writes by itself: a bare
- * insertion or a bare deletion saying nothing further, or an
- * equivalence between two systems' spellings for one command.
+ * insertion or a bare deletion saying nothing further, or a recoding
+ * that exchanges two systems' spellings for one command.
  *
  * Collating again rewrites these and keeps the rest. An edit that says
  * what the change is, or why it was made, or what it rests on, is an
  * editor's reading of the difference between two texts, and collating
  * the two again is no reason to discard it.
  *
- * An equivalence counts as the collation's own even where an editor
+ * Such an exchange counts as the collation's own even where an editor
  * added a motivation to it, because it is derived rather than read:
  * freezing it would leave the transfers, where nearly every edit is
  * one, unable to be collated again at all. What an editor wrote on it
- * is not lost by that, since `connectVersions` keeps an equivalence it
+ * is not lost by that, since `connectVersions` keeps an exchange it
  * draws a second time over the very same symbols.
+ *
+ * A recoding that only inserts or only deletes is the editor's: a
+ * collation types no one-sided edit, so one typed so is a reading of
+ * the transfer that collating again must not undo.
  */
 export declare const isCollationsOwn: (edit: Readonly<Edit>) => boolean;

package/lib/collation/Collation.js

@@ -88,7 +88,7 @@ export const collationsOf = (own, inherited, locate, tolerance = defaultCollatio
         .map(({ symbol: counterpart }) => ({ symbol, counterpart })));
 };
 /** The edit type a collation draws by itself, from the two systems' vocabularies rather than off the paper. */
-const drawnByCollation = 'replace-with-equivalent';
+const drawnByCollation = 'recoding';
 /**
  * The motivation a collation writes on what it makes, saying that
  * nobody has read it yet.
@@ -112,22 +112,26 @@ export const uncheckedMotivation = {
 };
 /**
  * Whether the edit is one a collation writes by itself: a bare
- * insertion or a bare deletion saying nothing further, or an
- * equivalence between two systems' spellings for one command.
+ * insertion or a bare deletion saying nothing further, or a recoding
+ * that exchanges two systems' spellings for one command.
  *
  * Collating again rewrites these and keeps the rest. An edit that says
  * what the change is, or why it was made, or what it rests on, is an
  * editor's reading of the difference between two texts, and collating
  * the two again is no reason to discard it.
  *
- * An equivalence counts as the collation's own even where an editor
+ * Such an exchange counts as the collation's own even where an editor
  * added a motivation to it, because it is derived rather than read:
  * freezing it would leave the transfers, where nearly every edit is
  * one, unable to be collated again at all. What an editor wrote on it
- * is not lost by that, since `connectVersions` keeps an equivalence it
+ * is not lost by that, since `connectVersions` keeps an exchange it
  * draws a second time over the very same symbols.
+ *
+ * A recoding that only inserts or only deletes is the editor's: a
+ * collation types no one-sided edit, so one typed so is a reading of
+ * the transfer that collating again must not undo.
  */
-export const isCollationsOwn = (edit) => edit.editType === drawnByCollation
+export const isCollationsOwn = (edit) => (edit.editType === drawnByCollation && !!edit.insert?.length && !!edit.delete?.length)
     || (edit.editType === undefined
         && (edit.motivation === undefined || edit.motivation === unchecked)
         && edit['@annotation'] === undefined);

package/lib/io/migrate.js

@@ -54,6 +54,13 @@ const withTypology = (node) => {
     }
     return node;
 };
+/** Edit types renamed since: an exchange of two systems' spellings is one kind of recoding. */
+const renamedEditTypes = {
+    'replace-with-equivalent': 'recoding'
+};
+const withRenamedEditType = (node) => typeof node.editType === 'string' && Object.hasOwn(renamedEditTypes, node.editType)
+    ? { ...node, editType: renamedEditTypes[node.editType] }
+    : 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;
@@ -371,7 +378,7 @@ const withTimeSpanDates = (node) => {
     const { '@value': within, '@type': _typed, ...rest } = node;
     return { ...rest, within };
 };
-const migrateNode = (node) => [withRenamedKeys, withTypology, withRenamedType, withoutVersionType, withoutVersionSiglum, withLowerCaseTerms, withSplitMethod, withReferences, withKeeper, withoutEmptyKeeper,
+const migrateNode = (node) => [withRenamedKeys, withRenamedEditType, withTypology, withRenamedType, withoutVersionType, withoutVersionSiglum, withLowerCaseTerms, withSplitMethod, withReferences, withKeeper, withoutEmptyKeeper,
     withPerforator, withProductionNodes, withTypedPerforator, withScale, withoutOps, withDerivationList, withReadingKind, withTimeSpanDates,
     withoutFeatureKind, withBorneFeaturesNamed, withFeaturesInActs, withDriveOfStaggering, withoutPattern, withoutBearings, withoutEntailedType]
     .reduce((result, step) => step(result), node);

package/lib/model/Edit.d.ts

@@ -7,7 +7,14 @@ export declare const editTypes: readonly [
  * sforzando on/off due to the short space left between
  * the notes to be differentiated.
  */
-'short-dynamic-differentation', 'additional-accent', 'add-redundancy', 'remove-redundancy', 'replace-with-equivalent', 'shift', 'correct-error', 'shorten', 'prolong'];
+'short-dynamic-differentation', 'additional-accent', 'add-redundancy', 'remove-redundancy', 
+/**
+ * Carries the text into another reproducing system's coding: a
+ * latched pair of one system giving way to the other's held command,
+ * a command the other system cannot read struck, or one of its own
+ * put in where the first had no word for it.
+ */
+'recoding', 'shift', 'correct-error', 'shorten', 'prolong'];
 /**
  * The type of editorial change applied to a symbol or set of symbols.
  * Classifies the nature of the edit, e.g. whether it corrects an error,

package/lib/model/Edit.js

@@ -8,7 +8,13 @@ export const editTypes = [
     'additional-accent',
     'add-redundancy',
     'remove-redundancy',
-    'replace-with-equivalent',
+    /**
+     * Carries the text into another reproducing system's coding: a
+     * latched pair of one system giving way to the other's held command,
+     * a command the other system cannot read struck, or one of its own
+     * put in where the first had no word for it.
+     */
+    'recoding',
     'shift',
     'correct-error',
     'shorten',

package/lib/ops/collation.js

@@ -98,7 +98,7 @@ export const connectVersions = (given, childId, parentId, tolerance = defaultCol
         return alreadyStated.get(exchangeKey(inserted, deleted)) ?? {
             type: 'edit',
             id: v4(),
-            editType: 'replace-with-equivalent',
+            editType: 'recoding',
             motivation: unchecked,
             insert: [...by],
             delete: deleted

package/lib/ops/edits.js

@@ -31,18 +31,24 @@ const guessEditType = (view, versionId, edit) => {
     const bar = trackerBarOf(view.version(versionId)?.system);
     const parentBar = trackerBarOf(view.predecessorOf(versionId)?.system);
     /**
-     * Where the version is coded for another system than its parent, an
-     * exchange of expression matter is the transfer being carried out:
-     * a red ForzandoOn and ForzandoOff pair giving way to one held green
-     * SforzandoForte says the same thing in the other system's words,
-     * which is what 'replace-with-equivalent' is for. Calling it a
-     * corrected error would say the editor made a mistake.
+     * Where the version is coded for another system than its parent,
+     * expression matter changed is the transfer being carried out: a red
+     * ForzandoOn and ForzandoOff pair giving way to one held green
+     * SforzandoForte says the same thing in the other system's words, and
+     * a red command the green bar cannot read struck, or a green hold put
+     * in where the red had no word for it, belongs to the same act. That
+     * is a recoding. Calling it a corrected error would say the editor
+     * made a mistake. Only an insertion spelling the bar's own accent
+     * reads more narrowly, as the accent it spells.
      */
-    if (bar && parentBar && bar.id !== parentBar.id && inserted.length > 0 && deleted.length > 0) {
-        return 'replace-with-equivalent';
-    }
+    const transferred = bar && parentBar && bar.id !== parentBar.id;
+    if (transferred && inserted.length > 0 && deleted.length > 0)
+        return 'recoding';
     if (deleted.length === 0 && accentsOn(bar).some(accent => sameSequence(inserted, accent)))
         return 'additional-accent';
+    const onlyExpressions = [...inserts, ...deletes].every(symbol => symbol.type === 'expression');
+    if (transferred && onlyExpressions && inserted.length + deleted.length > 0)
+        return 'recoding';
     if (inserted.length > 1 && sameSequence(inserted, deleted))
         return 'shift';
     if (inserted.length === 0 && deleted.length === 1)

package/lib/schema.json

@@ -516,7 +516,7 @@
                 "additional-accent",
                 "add-redundancy",
                 "remove-redundancy",
-                "replace-with-equivalent",
+                "recoding",
                 "shift",
                 "correct-error",
                 "shorten",

package/package.json

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