@speleotica/frcsdata 5.0.0-beta.4 → 5.0.0

package/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":["_yargs","_interopRequireDefault","require","_getRequireWildcardCache","e","WeakMap","r","t","_interopRequireWildcard","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","yargs","process","argv","slice","command","describe","builder","positional","type","demandOption","handler","file","checkSurvey","Promise","resolve","then","parseSurvey","summarizeSurvey","surveyFile","summaryFile","checkSurveyCorrespondence","demandCommand"],"sources":["src/cli.ts"],"sourcesContent":["import yargs from 'yargs/yargs'\n\nvoid yargs(process.argv.slice(2))\n  .command({\n    command: 'check-survey <file>',\n    describe: 'check survey file for errors or warnings',\n    builder: (yargs) =>\n      yargs.positional('file', {\n        type: 'string',\n        demandOption: true,\n      }),\n    handler: async ({ file }) => {\n      const { checkSurvey } = await import('./cli/check-survey')\n      await checkSurvey(file)\n    },\n  })\n  .command({\n    command: 'parse-survey <file>',\n    describe: 'parse survey file and output JSON parse tree',\n    builder: (yargs) =>\n      yargs.positional('file', {\n        type: 'string',\n        demandOption: true,\n      }),\n    handler: async ({ file }) => {\n      const { parseSurvey } = await import('./cli/parse-survey')\n      await parseSurvey(file)\n    },\n  })\n  .command({\n    command: 'summarize-survey <file>',\n    describe: 'parse survey file and output trip summaries',\n    builder: (yargs) =>\n      yargs.positional('file', {\n        type: 'string',\n        demandOption: true,\n      }),\n    handler: async ({ file }) => {\n      const { summarizeSurvey } = await import('./cli/summarize-survey')\n      await summarizeSurvey(file)\n    },\n  })\n  .command({\n    command: 'check-survey-correspondence <surveyFile> <summaryFile>',\n    describe: 'parse survey file and output trip summaries',\n    builder: (yargs) =>\n      yargs\n        .positional('surveyFile', {\n          type: 'string',\n          demandOption: true,\n        })\n        .positional('summaryFile', {\n          type: 'string',\n          demandOption: true,\n        }),\n    handler: async ({ surveyFile, summaryFile }) => {\n      const { checkSurveyCorrespondence } = await import(\n        './cli/check-survey-correspondence'\n      )\n      await checkSurveyCorrespondence(surveyFile, summaryFile)\n    },\n  })\n  .demandCommand().argv\n"],"mappings":";;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA+B,SAAAC,yBAAAC,CAAA,6BAAAC,OAAA,mBAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,CAAAC,CAAA,WAAAA,CAAA,GAAAG,CAAA,GAAAD,CAAA,KAAAF,CAAA;AAAA,SAAAI,wBAAAJ,CAAA,EAAAE,CAAA,SAAAA,CAAA,IAAAF,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,eAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,WAAAM,OAAA,EAAAN,CAAA,QAAAG,CAAA,GAAAJ,wBAAA,CAAAG,CAAA,OAAAC,CAAA,IAAAA,CAAA,CAAAI,GAAA,CAAAP,CAAA,UAAAG,CAAA,CAAAK,GAAA,CAAAR,CAAA,OAAAS,CAAA,KAAAC,SAAA,UAAAC,CAAA,GAAAC,MAAA,CAAAC,cAAA,IAAAD,MAAA,CAAAE,wBAAA,WAAAC,CAAA,IAAAf,CAAA,oBAAAe,CAAA,OAAAC,cAAA,CAAAC,IAAA,CAAAjB,CAAA,EAAAe,CAAA,SAAAG,CAAA,GAAAP,CAAA,GAAAC,MAAA,CAAAE,wBAAA,CAAAd,CAAA,EAAAe,CAAA,UAAAG,CAAA,KAAAA,CAAA,CAAAV,GAAA,IAAAU,CAAA,CAAAC,GAAA,IAAAP,MAAA,CAAAC,cAAA,CAAAJ,CAAA,EAAAM,CAAA,EAAAG,CAAA,IAAAT,CAAA,CAAAM,CAAA,IAAAf,CAAA,CAAAe,CAAA,YAAAN,CAAA,CAAAH,OAAA,GAAAN,CAAA,EAAAG,CAAA,IAAAA,CAAA,CAAAgB,GAAA,CAAAnB,CAAA,EAAAS,CAAA,GAAAA,CAAA;AAE/B,KAAK,IAAAW,cAAK,EAACC,OAAO,CAACC,IAAI,CAACC,KAAK,CAAC,CAAC,CAAC,CAAC,CAC9BC,OAAO,CAAC;EACPA,OAAO,EAAE,qBAAqB;EAC9BC,QAAQ,EAAE,0CAA0C;EACpDC,OAAO,EAAGN,KAAK,IACbA,KAAK,CAACO,UAAU,CAAC,MAAM,EAAE;IACvBC,IAAI,EAAE,QAAQ;IACdC,YAAY,EAAE;EAChB,CAAC,CAAC;EACJC,OAAO,EAAE,MAAAA,CAAO;IAAEC;EAAK,CAAC,KAAK;IAC3B,MAAM;MAAEC;IAAY,CAAC,GAAG,MAAAC,OAAA,CAAAC,OAAA,GAAAC,IAAA,OAAA/B,uBAAA,CAAAN,OAAA,2BAAkC;IAC1D,MAAMkC,WAAW,CAACD,IAAI,CAAC;EACzB;AACF,CAAC,CAAC,CACDP,OAAO,CAAC;EACPA,OAAO,EAAE,qBAAqB;EAC9BC,QAAQ,EAAE,8CAA8C;EACxDC,OAAO,EAAGN,KAAK,IACbA,KAAK,CAACO,UAAU,CAAC,MAAM,EAAE;IACvBC,IAAI,EAAE,QAAQ;IACdC,YAAY,EAAE;EAChB,CAAC,CAAC;EACJC,OAAO,EAAE,MAAAA,CAAO;IAAEC;EAAK,CAAC,KAAK;IAC3B,MAAM;MAAEK;IAAY,CAAC,GAAG,MAAAH,OAAA,CAAAC,OAAA,GAAAC,IAAA,OAAA/B,uBAAA,CAAAN,OAAA,2BAAkC;IAC1D,MAAMsC,WAAW,CAACL,IAAI,CAAC;EACzB;AACF,CAAC,CAAC,CACDP,OAAO,CAAC;EACPA,OAAO,EAAE,yBAAyB;EAClCC,QAAQ,EAAE,6CAA6C;EACvDC,OAAO,EAAGN,KAAK,IACbA,KAAK,CAACO,UAAU,CAAC,MAAM,EAAE;IACvBC,IAAI,EAAE,QAAQ;IACdC,YAAY,EAAE;EAChB,CAAC,CAAC;EACJC,OAAO,EAAE,MAAAA,CAAO;IAAEC;EAAK,CAAC,KAAK;IAC3B,MAAM;MAAEM;IAAgB,CAAC,GAAG,MAAAJ,OAAA,CAAAC,OAAA,GAAAC,IAAA,OAAA/B,uBAAA,CAAAN,OAAA,+BAAsC;IAClE,MAAMuC,eAAe,CAACN,IAAI,CAAC;EAC7B;AACF,CAAC,CAAC,CACDP,OAAO,CAAC;EACPA,OAAO,EAAE,wDAAwD;EACjEC,QAAQ,EAAE,6CAA6C;EACvDC,OAAO,EAAGN,KAAK,IACbA,KAAK,CACFO,UAAU,CAAC,YAAY,EAAE;IACxBC,IAAI,EAAE,QAAQ;IACdC,YAAY,EAAE;EAChB,CAAC,CAAC,CACDF,UAAU,CAAC,aAAa,EAAE;IACzBC,IAAI,EAAE,QAAQ;IACdC,YAAY,EAAE;EAChB,CAAC,CAAC;EACNC,OAAO,EAAE,MAAAA,CAAO;IAAEQ,UAAU;IAAEC;EAAY,CAAC,KAAK;IAC9C,MAAM;MAAEC;IAA0B,CAAC,GAAG,MAAAP,OAAA,CAAAC,OAAA,GAAAC,IAAA,OAAA/B,uBAAA,CAAAN,OAAA,0CAErC;IACD,MAAM0C,yBAAyB,CAACF,UAAU,EAAEC,WAAW,CAAC;EAC1D;AACF,CAAC,CAAC,CACDE,aAAa,CAAC,CAAC,CAACnB,IAAI","ignoreList":[]}
+{"version":3,"file":"cli.js","names":["_yargs","_interopRequireDefault","require","_getRequireWildcardCache","e","WeakMap","r","t","_interopRequireWildcard","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","yargs","process","argv","slice","command","describe","builder","positional","type","demandOption","handler","file","checkSurvey","Promise","resolve","then","parseSurvey","summarizeSurvey","option","alias","counts","suggestReplacements","listSurveyNames","listNames","includeCounts","surveyFile","replacementsFile","replaceSurveyNames","replaceNames","array","namesFiles","mergeNamesFiles","summaryFile","checkSurveyCorrespondence","demandCommand"],"sources":["src/cli.ts"],"sourcesContent":["import yargs from 'yargs/yargs'\n\nvoid yargs(process.argv.slice(2))\n  .command({\n    command: 'check <file>',\n    describe: 'check survey file for errors or warnings',\n    builder: (yargs) =>\n      yargs.positional('file', {\n        type: 'string',\n        demandOption: true,\n      }),\n    handler: async ({ file }) => {\n      const { checkSurvey } = await import('./cli/check')\n      await checkSurvey(file)\n    },\n  })\n  .command({\n    command: 'parse <file>',\n    describe: 'parse survey file and output JSON parse tree',\n    builder: (yargs) =>\n      yargs.positional('file', {\n        type: 'string',\n        demandOption: true,\n      }),\n    handler: async ({ file }) => {\n      const { parseSurvey } = await import('./cli/parse-survey')\n      await parseSurvey(file)\n    },\n  })\n  .command({\n    command: 'summarize <file>',\n    describe: 'parse survey file and output trip summaries',\n    builder: (yargs) =>\n      yargs.positional('file', {\n        type: 'string',\n        demandOption: true,\n      }),\n    handler: async ({ file }) => {\n      const { summarizeSurvey } = await import('./cli/summarize')\n      await summarizeSurvey(file)\n    },\n  })\n  .command({\n    command: 'list-names <file>',\n    describe: 'parse survey file and output surveyor name/count table',\n    builder: (yargs) =>\n      yargs\n        .positional('file', {\n          type: 'string',\n          demandOption: true,\n        })\n        .option('counts', {\n          alias: 'c',\n          type: 'boolean',\n          describe: 'count the number of occurrences of each name',\n          demandOption: false,\n        })\n        .option('suggest-replacements', {\n          alias: 's',\n          type: 'boolean',\n          describe: 'output suggested replacements',\n          demandOption: false,\n        }),\n    handler: async ({ file, counts, suggestReplacements }) => {\n      const { listSurveyNames: listNames } = await import('./cli/list-names')\n      await listNames(file, { includeCounts: counts, suggestReplacements })\n    },\n  })\n  .command({\n    command: 'replace-names <surveyFile> <replacementsFile>',\n    describe: 'replace names survey file',\n    builder: (yargs) =>\n      yargs\n        .positional('surveyFile', {\n          type: 'string',\n          demandOption: true,\n        })\n        .positional('replacementsFile', {\n          type: 'string',\n          demandOption: true,\n        }),\n    handler: async ({ surveyFile, replacementsFile }) => {\n      const { replaceSurveyNames: replaceNames } = await import(\n        './cli/replace-names'\n      )\n      await replaceNames(surveyFile, replacementsFile)\n    },\n  })\n  .command({\n    command: 'merge-names-files <namesFiles..>',\n    describe: 'merge two or more names files',\n    builder: (yargs) =>\n      yargs.positional('namesFiles', {\n        type: 'string',\n        array: true,\n        demandOption: true,\n      }),\n    handler: async ({ namesFiles }) => {\n      const { mergeNamesFiles } = await import('./cli/merge-names-files')\n      await mergeNamesFiles(...namesFiles)\n    },\n  })\n  .command({\n    command: 'check-correspondence <surveyFile> <summaryFile>',\n    describe: 'parse survey file and output trip summaries',\n    builder: (yargs) =>\n      yargs\n        .positional('surveyFile', {\n          type: 'string',\n          demandOption: true,\n        })\n        .positional('summaryFile', {\n          type: 'string',\n          demandOption: true,\n        }),\n    handler: async ({ surveyFile, summaryFile }) => {\n      const { checkSurveyCorrespondence } = await import(\n        './cli/check-correspondence'\n      )\n      await checkSurveyCorrespondence(surveyFile, summaryFile)\n    },\n  })\n  .demandCommand().argv\n"],"mappings":"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","ignoreList":[]}

package/index.d.ts

@@ -1,12 +1,14 @@
-import type { FrcsShot, FrcsSurveyFile, FrcsTrip, FrcsTripHeader } from './survey/FrcsSurveyFile';
+import type { FrcsShot, FrcsSurveyFile, FrcsTrip, FrcsTripHeader, InvalidFrcsShot, InvalidFrcsSurveyFile, InvalidFrcsTrip, InvalidFrcsTripHeader, InvalidFrcsUnits } from './survey/FrcsSurveyFile';
 import parseFrcsSurveyFile from './survey/parseFrcsSurveyFile';
-import { FrcsPlotShot } from './FrcsPlotShot';
-import { FrcsPlotFile } from './FrcsPlotFile';
+import type { FrcsPlotShot } from './FrcsPlotShot';
+import type { FrcsPlotFile } from './FrcsPlotFile';
 import parseFrcsPlotFile from './parseFrcsPlotFile';
-import { FrcsTripSummary } from './FrcsTripSummary';
-import { FrcsTripSummaryFile } from './FrcsTripSummaryFile';
+import type { FrcsTripSummary } from './FrcsTripSummary';
+import { type FrcsTripSummaryFile } from './FrcsTripSummaryFile';
 import parseFrcsTripSummaryFile from './parseFrcsTripSummaryFile';
 import formatFrcsShot from './survey/formatFrcsShot';
 import { formatFrcsSurveyFile } from './survey/formatFrcsSurveyFile';
-export { FrcsShot, FrcsSurveyFile, FrcsTrip, FrcsTripHeader, parseFrcsSurveyFile, FrcsPlotShot, FrcsPlotFile, parseFrcsPlotFile, FrcsTripSummary, FrcsTripSummaryFile, parseFrcsTripSummaryFile, formatFrcsShot, formatFrcsSurveyFile, };
+import { formatIssues } from './formatIssues';
+export type { FrcsShot, FrcsSurveyFile, FrcsTrip, FrcsTripHeader, InvalidFrcsShot, InvalidFrcsSurveyFile, InvalidFrcsTrip, InvalidFrcsTripHeader, InvalidFrcsUnits, FrcsPlotShot, FrcsPlotFile, FrcsTripSummary, FrcsTripSummaryFile, };
+export { parseFrcsSurveyFile, parseFrcsPlotFile, parseFrcsTripSummaryFile, formatFrcsShot, formatFrcsSurveyFile, formatIssues, };
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,cAAc,EACf,MAAM,yBAAyB,CAAA;AAChC,OAAO,mBAAmB,MAAM,8BAA8B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,wBAAwB,MAAM,4BAA4B,CAAA;AACjE,OAAO,cAAc,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AAEpE,OAAO,EACL,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,GACrB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,yBAAyB,CAAA;AAChC,OAAO,mBAAmB,MAAM,8BAA8B,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,wBAAwB,MAAM,4BAA4B,CAAA;AACjE,OAAO,cAAc,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,YAAY,EACV,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,mBAAmB,GACpB,CAAA;AAED,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,YAAY,GACb,CAAA"}

package/index.js

@@ -4,30 +4,6 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-Object.defineProperty(exports, "FrcsPlotFile", {
-  enumerable: true,
-  get: function () {
-    return _FrcsPlotFile.FrcsPlotFile;
-  }
-});
-Object.defineProperty(exports, "FrcsPlotShot", {
-  enumerable: true,
-  get: function () {
-    return _FrcsPlotShot.FrcsPlotShot;
-  }
-});
-Object.defineProperty(exports, "FrcsTripSummary", {
-  enumerable: true,
-  get: function () {
-    return _FrcsTripSummary.FrcsTripSummary;
-  }
-});
-Object.defineProperty(exports, "FrcsTripSummaryFile", {
-  enumerable: true,
-  get: function () {
-    return _FrcsTripSummaryFile.FrcsTripSummaryFile;
-  }
-});
 Object.defineProperty(exports, "formatFrcsShot", {
   enumerable: true,
   get: function () {
@@ -40,6 +16,12 @@ Object.defineProperty(exports, "formatFrcsSurveyFile", {
     return _formatFrcsSurveyFile.formatFrcsSurveyFile;
   }
 });
+Object.defineProperty(exports, "formatIssues", {
+  enumerable: true,
+  get: function () {
+    return _formatIssues.formatIssues;
+  }
+});
 Object.defineProperty(exports, "parseFrcsPlotFile", {
   enumerable: true,
   get: function () {
@@ -59,12 +41,9 @@ Object.defineProperty(exports, "parseFrcsTripSummaryFile", {
   }
 });
 var _parseFrcsSurveyFile = _interopRequireDefault(require("./survey/parseFrcsSurveyFile.js"));
-var _FrcsPlotShot = require("./FrcsPlotShot.js");
-var _FrcsPlotFile = require("./FrcsPlotFile.js");
 var _parseFrcsPlotFile = _interopRequireDefault(require("./parseFrcsPlotFile.js"));
-var _FrcsTripSummary = require("./FrcsTripSummary.js");
-var _FrcsTripSummaryFile = require("./FrcsTripSummaryFile.js");
 var _parseFrcsTripSummaryFile = _interopRequireDefault(require("./parseFrcsTripSummaryFile.js"));
 var _formatFrcsShot = _interopRequireDefault(require("./survey/formatFrcsShot.js"));
 var _formatFrcsSurveyFile = require("./survey/formatFrcsSurveyFile.js");
+var _formatIssues = require("./formatIssues.js");
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_parseFrcsSurveyFile","_interopRequireDefault","require","_FrcsPlotShot","_FrcsPlotFile","_parseFrcsPlotFile","_FrcsTripSummary","_FrcsTripSummaryFile","_parseFrcsTripSummaryFile","_formatFrcsShot","_formatFrcsSurveyFile"],"sources":["src/index.ts"],"sourcesContent":["import type {\n  FrcsShot,\n  FrcsSurveyFile,\n  FrcsTrip,\n  FrcsTripHeader,\n} from './survey/FrcsSurveyFile'\nimport parseFrcsSurveyFile from './survey/parseFrcsSurveyFile'\nimport { FrcsPlotShot } from './FrcsPlotShot'\nimport { FrcsPlotFile } from './FrcsPlotFile'\nimport parseFrcsPlotFile from './parseFrcsPlotFile'\nimport { FrcsTripSummary } from './FrcsTripSummary'\nimport { FrcsTripSummaryFile } from './FrcsTripSummaryFile'\nimport parseFrcsTripSummaryFile from './parseFrcsTripSummaryFile'\nimport formatFrcsShot from './survey/formatFrcsShot'\nimport { formatFrcsSurveyFile } from './survey/formatFrcsSurveyFile'\n\nexport {\n  FrcsShot,\n  FrcsSurveyFile,\n  FrcsTrip,\n  FrcsTripHeader,\n  parseFrcsSurveyFile,\n  FrcsPlotShot,\n  FrcsPlotFile,\n  parseFrcsPlotFile,\n  FrcsTripSummary,\n  FrcsTripSummaryFile,\n  parseFrcsTripSummaryFile,\n  formatFrcsShot,\n  formatFrcsSurveyFile,\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,IAAAA,oBAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AACA,IAAAE,aAAA,GAAAF,OAAA;AACA,IAAAG,kBAAA,GAAAJ,sBAAA,CAAAC,OAAA;AACA,IAAAI,gBAAA,GAAAJ,OAAA;AACA,IAAAK,oBAAA,GAAAL,OAAA;AACA,IAAAM,yBAAA,GAAAP,sBAAA,CAAAC,OAAA;AACA,IAAAO,eAAA,GAAAR,sBAAA,CAAAC,OAAA;AACA,IAAAQ,qBAAA,GAAAR,OAAA","ignoreList":[]}
+{"version":3,"file":"index.js","names":["_parseFrcsSurveyFile","_interopRequireDefault","require","_parseFrcsPlotFile","_parseFrcsTripSummaryFile","_formatFrcsShot","_formatFrcsSurveyFile","_formatIssues"],"sources":["src/index.ts"],"sourcesContent":["import type {\n  FrcsShot,\n  FrcsSurveyFile,\n  FrcsTrip,\n  FrcsTripHeader,\n  InvalidFrcsShot,\n  InvalidFrcsSurveyFile,\n  InvalidFrcsTrip,\n  InvalidFrcsTripHeader,\n  InvalidFrcsUnits,\n} from './survey/FrcsSurveyFile'\nimport parseFrcsSurveyFile from './survey/parseFrcsSurveyFile'\nimport type { FrcsPlotShot } from './FrcsPlotShot'\nimport type { FrcsPlotFile } from './FrcsPlotFile'\nimport parseFrcsPlotFile from './parseFrcsPlotFile'\nimport type { FrcsTripSummary } from './FrcsTripSummary'\nimport { type FrcsTripSummaryFile } from './FrcsTripSummaryFile'\nimport parseFrcsTripSummaryFile from './parseFrcsTripSummaryFile'\nimport formatFrcsShot from './survey/formatFrcsShot'\nimport { formatFrcsSurveyFile } from './survey/formatFrcsSurveyFile'\nimport { formatIssues } from './formatIssues'\n\nexport type {\n  FrcsShot,\n  FrcsSurveyFile,\n  FrcsTrip,\n  FrcsTripHeader,\n  InvalidFrcsShot,\n  InvalidFrcsSurveyFile,\n  InvalidFrcsTrip,\n  InvalidFrcsTripHeader,\n  InvalidFrcsUnits,\n  FrcsPlotShot,\n  FrcsPlotFile,\n  FrcsTripSummary,\n  FrcsTripSummaryFile,\n}\n\nexport {\n  parseFrcsSurveyFile,\n  parseFrcsPlotFile,\n  parseFrcsTripSummaryFile,\n  formatFrcsShot,\n  formatFrcsSurveyFile,\n  formatIssues,\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,IAAAA,oBAAA,GAAAC,sBAAA,CAAAC,OAAA;AAGA,IAAAC,kBAAA,GAAAF,sBAAA,CAAAC,OAAA;AAGA,IAAAE,yBAAA,GAAAH,sBAAA,CAAAC,OAAA;AACA,IAAAG,eAAA,GAAAJ,sBAAA,CAAAC,OAAA;AACA,IAAAI,qBAAA,GAAAJ,OAAA;AACA,IAAAK,aAAA,GAAAL,OAAA","ignoreList":[]}

package/node/index.d.ts

@@ -1,4 +1,4 @@
-export declare const parseFrcsSurveyFile: (file: string, rest_0?: import("../survey/FrcsSurveyFile").ParseFrcsSurveyFileOptions | undefined) => Promise<import("..").FrcsSurveyFile | import("../survey/FrcsSurveyFile").InvalidFrcsSurveyFile>;
+export declare const parseFrcsSurveyFile: (file: string, rest_0?: import("../survey/FrcsSurveyFile").ParseFrcsSurveyFileOptions | undefined) => Promise<import("..").FrcsSurveyFile | import("..").InvalidFrcsSurveyFile>;
 export declare const parseFrcsPlotFile: (file: string) => Promise<import("..").FrcsPlotFile>;
 export declare const parseFrcsTripSummaryFile: (file: string, rest_0?: {
     indexBy?: "tripNumber" | "occurrence";

package/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,mBAAmB,SAHvB,MAAM,wLAG2D,CAAA;AAC1E,eAAO,MAAM,iBAAiB,SAfrB,MAAM,uCAesD,CAAA;AACrE,eAAO,MAAM,wBAAwB,SAhB5B,MAAM;;2DAkBd,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,mBAAmB,SAHvB,MAAM,kKAG2D,CAAA;AAC1E,eAAO,MAAM,iBAAiB,SAfrB,MAAM,uCAesD,CAAA;AACrE,eAAO,MAAM,wBAAwB,SAhB5B,MAAM;;2DAkBd,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speleotica/frcsdata",
-  "version": "5.0.0-beta.4",
+  "version": "5.0.0",
   "description": "parser for Chip Hopper's survey data format used in Fisher Ridge Cave System",
   "sideEffects": false,
   "publishConfig": {
@@ -21,6 +21,7 @@
   "homepage": "https://github.com/speleotica/frcsdata#readme",
   "dependencies": {
     "@babel/runtime": "^7.18.6",
+    "@jcoreio/utils": "0.0.0-development",
     "@speleotica/unitized": "^2.0.0",
     "chalk": "^4",
     "dedent-js": "^1.0.1",

package/replaceRanges.d.ts

@@ -0,0 +1,6 @@
+export declare function replaceRanges(source: string, replacements: {
+    start: number;
+    end: number;
+    value: string;
+}[]): string;
+//# sourceMappingURL=replaceRanges.d.ts.map

package/replaceRanges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replaceRanges.d.ts","sourceRoot":"","sources":["src/replaceRanges.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAC5D,MAAM,CAiBR"}

package/replaceRanges.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.replaceRanges = replaceRanges;
+function replaceRanges(source, replacements) {
+  replacements.sort((a, b) => a.start - b.start);
+  const parts = [];
+  let end = 0;
+  for (const r of replacements) {
+    if (r.start > end) {
+      parts.push(source.substring(end, r.start));
+    }
+    parts.push(r.value);
+    end = r.end;
+  }
+  if (end < source.length) {
+    parts.push(source.substring(end));
+  }
+  return parts.join('');
+}
+//# sourceMappingURL=replaceRanges.js.map

package/replaceRanges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replaceRanges.js","names":["replaceRanges","source","replacements","sort","a","b","start","parts","end","r","push","substring","value","length","join"],"sources":["src/replaceRanges.ts"],"sourcesContent":["export function replaceRanges(\n  source: string,\n  replacements: { start: number; end: number; value: string }[]\n): string {\n  replacements.sort((a, b) => a.start - b.start)\n\n  const parts = []\n  let end = 0\n  for (const r of replacements) {\n    if (r.start > end) {\n      parts.push(source.substring(end, r.start))\n    }\n    parts.push(r.value)\n    end = r.end\n  }\n  if (end < source.length) {\n    parts.push(source.substring(end))\n  }\n\n  return parts.join('')\n}\n"],"mappings":";;;;;;AAAO,SAASA,aAAaA,CAC3BC,MAAc,EACdC,YAA6D,EACrD;EACRA,YAAY,CAACC,IAAI,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKD,CAAC,CAACE,KAAK,GAAGD,CAAC,CAACC,KAAK,CAAC;EAE9C,MAAMC,KAAK,GAAG,EAAE;EAChB,IAAIC,GAAG,GAAG,CAAC;EACX,KAAK,MAAMC,CAAC,IAAIP,YAAY,EAAE;IAC5B,IAAIO,CAAC,CAACH,KAAK,GAAGE,GAAG,EAAE;MACjBD,KAAK,CAACG,IAAI,CAACT,MAAM,CAACU,SAAS,CAACH,GAAG,EAAEC,CAAC,CAACH,KAAK,CAAC,CAAC;IAC5C;IACAC,KAAK,CAACG,IAAI,CAACD,CAAC,CAACG,KAAK,CAAC;IACnBJ,GAAG,GAAGC,CAAC,CAACD,GAAG;EACb;EACA,IAAIA,GAAG,GAAGP,MAAM,CAACY,MAAM,EAAE;IACvBN,KAAK,CAACG,IAAI,CAACT,MAAM,CAACU,SAAS,CAACH,GAAG,CAAC,CAAC;EACnC;EAEA,OAAOD,KAAK,CAACO,IAAI,CAAC,EAAE,CAAC;AACvB","ignoreList":[]}

package/src/cli/{check-survey-correspondence.ts → check-correspondence.ts}

@@ -1,20 +1,21 @@
 /* eslint-disable no-console */
 import chalk from 'chalk'
-import { parseFrcsSurveyFile } from '../string/index'
-import fs from 'fs/promises'
+import { parseFrcsSurveyFile, parseFrcsTripSummaryFile } from '../string/index'
 import { summarizeSurvey } from '../survey/summarizeSurvey'
-import { parseFrcsTripSummaryFile } from '../node/index.js'
 import { formatFrcsTripSummaryFile } from '../formatFrcsTripSummaryFile.js'
 import { isDeepStrictEqual } from 'util'
+import { readFile } from './readFile'
 
 export async function checkSurveyCorrespondence(
   surveyFile: string,
   summaryFile: string
 ) {
-  const source = await fs.readFile(surveyFile, 'utf8')
+  const source = await readFile(surveyFile)
   const parsedSurvey = await parseFrcsSurveyFile(surveyFile, source)
   const parsedSummaries = (
-    await parseFrcsTripSummaryFile(summaryFile, { indexBy: 'occurrence' })
+    await parseFrcsTripSummaryFile(summaryFile, await readFile(summaryFile), {
+      indexBy: 'occurrence',
+    })
   ).tripSummaries.sort((a, b) => (a?.tripNumber ?? 0) - (b?.tripNumber ?? 0))
   const convertedSummaries = summarizeSurvey(parsedSurvey, {
     ignoreVerticalOfHShots: true,

package/src/cli/{check-survey.ts → check.ts}

@@ -1,11 +1,11 @@
 /* eslint-disable no-console */
-import fs from 'fs/promises'
+import { readFile } from './readFile'
 import parseFrcsSurveyFile from '../survey/parseFrcsSurveyFile'
 import chalk from 'chalk'
 import { formatIssues } from '../formatIssues.js'
 
 export async function checkSurvey(file: string) {
-  const source = await fs.readFile(file, 'utf8')
+  const source = await readFile(file)
   const parsed = await parseFrcsSurveyFile(file, [source])
 
   const issues = parsed.issues || []

package/src/cli/compareNames.ts

@@ -0,0 +1,13 @@
+const splitName = (name: string) => {
+  return /^(.+)\s+(\S+)$/.exec(name)?.slice(1) || ['', name]
+}
+
+export function compareNames(a: string, b: string) {
+  const [aFirst, aLast] = splitName(a.toLowerCase())
+  const [bFirst, bLast] = splitName(b.toLowerCase())
+  return (
+    aLast.localeCompare(bLast) ||
+    aFirst.localeCompare(bFirst) ||
+    a[0].localeCompare(b[0])
+  )
+}

package/src/cli/formatNamesFile.ts

@@ -0,0 +1,13 @@
+import { compareNames } from './compareNames'
+
+export function formatNamesFile(names: Map<string, { replacement?: string }>) {
+  return (
+    [...names.entries()]
+      .sort((a, b) => compareNames(a[0], b[0]))
+      .map(
+        ([name, { replacement }]) =>
+          `${name}${replacement ? ` => ${replacement}` : ''}`
+      )
+      .join('\n') + '\n'
+  )
+}

package/src/cli/list-names.ts

@@ -0,0 +1,94 @@
+/* eslint-disable no-console */
+import { parseFrcsSurveyFile } from '../string/index'
+import { normalizeNameCapitalization } from '../survey/normalizeTeamMemberName'
+import { ZodValidOrInvalidFrcsSurveyFileToJson } from '../survey/ZodFrcsSurveyFileToJson'
+import { unwrapInvalid } from '../unwrapInvalid'
+import { groupBy } from '@jcoreio/utils/groupBy'
+import { compareNames } from './compareNames'
+import { readFile } from './readFile'
+
+export async function listSurveyNames(
+  file: string,
+  options?: { includeCounts?: boolean; suggestReplacements?: boolean }
+) {
+  const parsed = ZodValidOrInvalidFrcsSurveyFileToJson.parse(
+    await parseFrcsSurveyFile(file, await readFile(file), {
+      normalizeNames: false,
+    })
+  )
+  const nameCounts = new Map<string, number>()
+  for (const trip of unwrapInvalid(parsed).trips) {
+    const { team } = unwrapInvalid(unwrapInvalid(trip).header)
+    if (!team) continue
+    for (const name of team) {
+      nameCounts.set(name, (nameCounts.get(name) ?? 0) + 1)
+    }
+  }
+
+  const table = [...nameCounts.entries()].sort((a, b) =>
+    compareNames(a[0], b[0])
+  )
+  const maxNameCount = table.reduce((max, [, count]) => Math.max(max, count), 0)
+  const countLength = maxNameCount.toFixed().length
+
+  const includeCounts = options?.includeCounts ?? false
+
+  const names = [...nameCounts.keys()]
+
+  const replacements = new Map<string, string>()
+  if (options?.suggestReplacements) {
+    for (const group of groupBy(names, (name) => name.toLowerCase()).values()) {
+      if (group.length === 1) {
+        const [name] = group
+        const normalized = normalizeNameCapitalization(name)
+        if (normalized !== name) replacements.set(name, normalized)
+        continue
+      }
+      const best = group
+        .map((name) => normalizeNameCapitalization(name))
+        .reduce((a, b) => (countCaps(a) > countCaps(b) ? a : b))
+      for (const name of group) {
+        if (name !== best) replacements.set(name, best)
+      }
+    }
+
+    const firstInitials = groupBy(
+      names.filter((name) => /^\S[. ]/.test(name)),
+      (name) => name.toLowerCase().replace(/\.\s*/g, ' ')
+    )
+
+    for (const name of names) {
+      if (/^\S[. ]/.test(name)) continue
+      const firstInitial = name
+        .toLowerCase()
+        .replace(/^\S+/, (m) => m.substring(0, 1))
+        .replace(/\.\s*/g, ' ')
+      const matches = firstInitials.get(firstInitial)
+      if (matches) {
+        for (const match of matches) {
+          replacements.set(match, replacements.get(name) ?? name)
+        }
+      }
+    }
+  }
+
+  for (const [name, count] of table) {
+    const replacement = replacements.get(name)
+    if (includeCounts)
+      console.log(
+        count.toFixed().padStart(countLength),
+        name,
+        ...(replacement ? ['=>', replacement] : [])
+      )
+    else console.log(name, ...(replacement ? ['=>', replacement] : []))
+  }
+}
+
+const countCaps = (name: string) => {
+  const lower = name.toLowerCase()
+  let count = 0
+  for (let i = 0; i < name.length; i++) {
+    if (name[i] !== lower[i]) count++
+  }
+  return count
+}

package/src/cli/merge-names-files.ts

@@ -0,0 +1,18 @@
+import { parseNamesFile } from './parseNamesFile'
+import { formatNamesFile } from './formatNamesFile'
+import { readFile } from './readFile'
+
+export async function mergeNamesFiles(...files: string[]) {
+  const names = new Map<string, { replacement?: string }>()
+
+  for (const file of files) {
+    const parsed = parseNamesFile(await readFile(file))
+    for (const [name, { replacement }] of parsed) {
+      const existing = names.get(name)
+      if (!existing) names.set(name, { replacement })
+      else if (!existing.replacement) existing.replacement = replacement
+    }
+  }
+
+  process.stdout.write(formatNamesFile(names))
+}

package/src/cli/parse-survey.ts

@@ -1,10 +1,11 @@
 /* eslint-disable no-console */
-import { parseFrcsSurveyFile } from '../node/index'
+import { parseFrcsSurveyFile } from '../string/index'
 import { ZodValidOrInvalidFrcsSurveyFileToJson } from '../survey/ZodFrcsSurveyFileToJson'
+import { readFile } from './readFile'
 
 export async function parseSurvey(file: string) {
   const parsed = ZodValidOrInvalidFrcsSurveyFileToJson.parse(
-    await parseFrcsSurveyFile(file)
+    await parseFrcsSurveyFile(file, await readFile(file))
   )
   console.log(JSON.stringify(parsed))
 }

package/src/cli/parseNamesFile.ts

@@ -0,0 +1,10 @@
+export function parseNamesFile(content: string) {
+  const names = new Map<string, { replacement?: string }>()
+  for (const line of content.split(/\r\n?|\n/gm)) {
+    const match = /^\s*(.+)\s*(?:=>\s*(.+)\s*)?$/.exec(line)
+    if (match) {
+      names.set(match[1].trim(), { replacement: match[2]?.trim() })
+    }
+  }
+  return names
+}

package/src/cli/readFile.ts

@@ -0,0 +1,6 @@
+import fs from 'fs'
+import { promisify } from 'util'
+
+export async function readFile(file: string) {
+  return await promisify<string>((cb) => fs.readFile(file || 0, 'utf8', cb))()
+}

package/src/cli/replace-names.ts

@@ -0,0 +1,41 @@
+/* eslint-disable no-console */
+import parseFrcsSurveyFile from '../survey/parseFrcsSurveyFile'
+import { replaceRanges } from '../replaceRanges'
+import { ZodValidOrInvalidFrcsSurveyFileToJson } from '../survey/ZodFrcsSurveyFileToJson'
+import { unwrapInvalid } from '../unwrapInvalid'
+import { parseNamesFile } from './parseNamesFile'
+import { readFile } from './readFile'
+
+export async function replaceSurveyNames(
+  surveyFile: string,
+  replacementsFile: string
+) {
+  const source = await readFile(surveyFile)
+  const parsed = ZodValidOrInvalidFrcsSurveyFileToJson.parse(
+    await parseFrcsSurveyFile(surveyFile, [source], {
+      normalizeNames: false,
+      includeLocs: true,
+    })
+  )
+  const names = await parseNamesFile(await readFile(replacementsFile))
+
+  const replacements: { start: number; end: number; value: string }[] = []
+  for (const trip of unwrapInvalid(parsed).trips) {
+    const { team, locs: { team: teamLocs } = {} } = unwrapInvalid(
+      unwrapInvalid(trip).header
+    )
+    if (!team || !teamLocs) continue
+    for (let i = 0; i < team.length; i++) {
+      const replacement = names.get(team[i])?.replacement
+      if (replacement && teamLocs[i]) {
+        replacements.push({
+          start: teamLocs[i].start.index,
+          end: teamLocs[i].end.index,
+          value: replacement,
+        })
+      }
+    }
+  }
+
+  process.stdout.write(replaceRanges(source, replacements))
+}

package/src/cli/{summarize-survey.ts → summarize.ts}

@@ -2,12 +2,12 @@
 import chalk from 'chalk'
 import { formatIssues } from '../formatIssues'
 import { parseFrcsSurveyFile } from '../string/index'
-import fs from 'fs/promises'
 import { formatFrcsTripSummaryFile } from '../formatFrcsTripSummaryFile'
 import { summarizeSurvey as baseSummarizeSurvey } from '../survey/summarizeSurvey'
+import { readFile } from './readFile'
 
 export async function summarizeSurvey(file: string) {
-  const source = await fs.readFile(file, 'utf8')
+  const source = await readFile(file)
   const parsed = await parseFrcsSurveyFile(file, source)
   if ('INVALID' in parsed) {
     console.log(

package/src/cli.ts

@@ -2,7 +2,7 @@ import yargs from 'yargs/yargs'
 
 void yargs(process.argv.slice(2))
   .command({
-    command: 'check-survey <file>',
+    command: 'check <file>',
     describe: 'check survey file for errors or warnings',
     builder: (yargs) =>
       yargs.positional('file', {
@@ -10,12 +10,12 @@ void yargs(process.argv.slice(2))
         demandOption: true,
       }),
     handler: async ({ file }) => {
-      const { checkSurvey } = await import('./cli/check-survey')
+      const { checkSurvey } = await import('./cli/check')
       await checkSurvey(file)
     },
   })
   .command({
-    command: 'parse-survey <file>',
+    command: 'parse <file>',
     describe: 'parse survey file and output JSON parse tree',
     builder: (yargs) =>
       yargs.positional('file', {
@@ -28,7 +28,7 @@ void yargs(process.argv.slice(2))
     },
   })
   .command({
-    command: 'summarize-survey <file>',
+    command: 'summarize <file>',
     describe: 'parse survey file and output trip summaries',
     builder: (yargs) =>
       yargs.positional('file', {
@@ -36,12 +36,72 @@ void yargs(process.argv.slice(2))
         demandOption: true,
       }),
     handler: async ({ file }) => {
-      const { summarizeSurvey } = await import('./cli/summarize-survey')
+      const { summarizeSurvey } = await import('./cli/summarize')
       await summarizeSurvey(file)
     },
   })
   .command({
-    command: 'check-survey-correspondence <surveyFile> <summaryFile>',
+    command: 'list-names <file>',
+    describe: 'parse survey file and output surveyor name/count table',
+    builder: (yargs) =>
+      yargs
+        .positional('file', {
+          type: 'string',
+          demandOption: true,
+        })
+        .option('counts', {
+          alias: 'c',
+          type: 'boolean',
+          describe: 'count the number of occurrences of each name',
+          demandOption: false,
+        })
+        .option('suggest-replacements', {
+          alias: 's',
+          type: 'boolean',
+          describe: 'output suggested replacements',
+          demandOption: false,
+        }),
+    handler: async ({ file, counts, suggestReplacements }) => {
+      const { listSurveyNames: listNames } = await import('./cli/list-names')
+      await listNames(file, { includeCounts: counts, suggestReplacements })
+    },
+  })
+  .command({
+    command: 'replace-names <surveyFile> <replacementsFile>',
+    describe: 'replace names survey file',
+    builder: (yargs) =>
+      yargs
+        .positional('surveyFile', {
+          type: 'string',
+          demandOption: true,
+        })
+        .positional('replacementsFile', {
+          type: 'string',
+          demandOption: true,
+        }),
+    handler: async ({ surveyFile, replacementsFile }) => {
+      const { replaceSurveyNames: replaceNames } = await import(
+        './cli/replace-names'
+      )
+      await replaceNames(surveyFile, replacementsFile)
+    },
+  })
+  .command({
+    command: 'merge-names-files <namesFiles..>',
+    describe: 'merge two or more names files',
+    builder: (yargs) =>
+      yargs.positional('namesFiles', {
+        type: 'string',
+        array: true,
+        demandOption: true,
+      }),
+    handler: async ({ namesFiles }) => {
+      const { mergeNamesFiles } = await import('./cli/merge-names-files')
+      await mergeNamesFiles(...namesFiles)
+    },
+  })
+  .command({
+    command: 'check-correspondence <surveyFile> <summaryFile>',
     describe: 'parse survey file and output trip summaries',
     builder: (yargs) =>
       yargs
@@ -55,7 +115,7 @@ void yargs(process.argv.slice(2))
         }),
     handler: async ({ surveyFile, summaryFile }) => {
       const { checkSurveyCorrespondence } = await import(
-        './cli/check-survey-correspondence'
+        './cli/check-correspondence'
       )
       await checkSurveyCorrespondence(surveyFile, summaryFile)
     },