linked-rolls 0.67.0 → 0.69.0

package/lib/analysis/text.d.ts

@@ -10,6 +10,11 @@ export declare const placedCarriersOf: (edition: Pick<Edition, 'copies'>, symbol
  * Where along the roll the symbol lies, as its carriers put it, or
  * nothing for a symbol no copy carries.
  *
+ * Either end is the median of the carriers' rather than their mean, so
+ * that a copy which puts the symbol well away from the rest, torn,
+ * stretched or badly aligned there, does not draw it away from where
+ * the others agree it lies. Two carriers have the two alike.
+ *
  * Only the place is measured. Which track the symbol sits on is not
  * a measurement but a question for a tracker bar, since a note of
  * one pitch sits on exactly one position of a given bar: ask
@@ -20,7 +25,7 @@ export declare const placedCarriersOf: (edition: Pick<Edition, 'copies'>, symbol
  * position a semitone away on either bar.
  */
 export declare const placeOf: (edition: Pick<Edition, 'copies'>, symbol: AnySymbol) => Readonly<HorizontalSpan> | undefined;
-/** Where the symbol begins, as the mean onset of its carriers, or nothing for a symbol without a place. */
+/** Where the symbol begins, as the median onset of its carriers, or nothing for a symbol without a place. */
 export declare const onsetOf: (edition: Pick<Edition, 'copies'>, symbol: AnySymbol) => Millimeters | undefined;
 /**
  * The symbols the version shows: what it and its ancestors insert,

package/lib/analysis/text.js

@@ -1,7 +1,7 @@
 import { isPlaced } from "../model/Feature.js";
 import { deletedBy, insertedBy } from "../model/Version.js";
 import { idsOf } from "../model/Assumption.js";
-import { mean } from "../model/Quantity.js";
+import { medianOf } from "../collation/statistics.js";
 import { featuresIn } from "../lookup/lookup.js";
 import { perState } from "../lookup/perState.js";
 import { lineageOf } from "./stemma.js";
@@ -12,6 +12,11 @@ export const placedCarriersOf = (edition, symbol) => carriersOf(edition, symbol)
  * Where along the roll the symbol lies, as its carriers put it, or
  * nothing for a symbol no copy carries.
  *
+ * Either end is the median of the carriers' rather than their mean, so
+ * that a copy which puts the symbol well away from the rest, torn,
+ * stretched or badly aligned there, does not draw it away from where
+ * the others agree it lies. Two carriers have the two alike.
+ *
  * Only the place is measured. Which track the symbol sits on is not
  * a measurement but a question for a tracker bar, since a note of
  * one pitch sits on exactly one position of a given bar: ask
@@ -23,15 +28,13 @@ export const placedCarriersOf = (edition, symbol) => carriersOf(edition, symbol)
  */
 export const placeOf = (edition, symbol) => {
     const carriers = placedCarriersOf(edition, symbol);
-    if (carriers.length === 0)
+    const from = medianOf(carriers.map(carrier => carrier.horizontal.from));
+    const to = medianOf(carriers.map(carrier => carrier.horizontal.to));
+    if (from === undefined || to === undefined)
         return;
-    return {
-        unit: 'mm',
-        from: mean(carriers.map(carrier => carrier.horizontal.from)),
-        to: mean(carriers.map(carrier => carrier.horizontal.to))
-    };
+    return { unit: 'mm', from, to };
 };
-/** Where the symbol begins, as the mean onset of its carriers, or nothing for a symbol without a place. */
+/** Where the symbol begins, as the median onset of its carriers, or nothing for a symbol without a place. */
 export const onsetOf = (edition, symbol) => placeOf(edition, symbol)?.from;
 /** The symbols by onset, those without a place first; symbols at one place keep their order. */
 const inOrderOfPlace = (edition, symbols) => symbols

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
@@ -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

@@ -617,6 +617,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 +657,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"

package/package.json

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