@noldova/desktop.build 0.0.2 → 0.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.md +1 -1
  2. package/models/modules/module-declaration.js +29 -2
  3. package/models/modules/module-declaration.js.map +1 -1
  4. package/models/modules/web-view-keys.js +3 -0
  5. package/models/modules/web-view-keys.js.map +1 -1
  6. package/models/packaging/company-package.js +60 -16
  7. package/models/packaging/company-package.js.map +1 -1
  8. package/models/packaging/locked-package.js +30 -6
  9. package/models/packaging/locked-package.js.map +1 -1
  10. package/models/packaging/package-target.js +11 -4
  11. package/models/packaging/package-target.js.map +1 -1
  12. package/models/release/release-request.js +42 -2
  13. package/models/release/release-request.js.map +1 -1
  14. package/models/release/release-version.js +0 -8
  15. package/models/release/release-version.js.map +1 -1
  16. package/package.json +2 -2
  17. package/resources.js +156 -25
  18. package/resources.js.map +1 -1
  19. package/services/build-command-line.js +5 -3
  20. package/services/build-command-line.js.map +1 -1
  21. package/services/commands/module-range.js +21 -2
  22. package/services/commands/module-range.js.map +1 -1
  23. package/services/commands/package-smoke.js +6 -4
  24. package/services/commands/package-smoke.js.map +1 -1
  25. package/services/commands/package.js +7 -2
  26. package/services/commands/package.js.map +1 -1
  27. package/services/commands/release-assets.js +1 -1
  28. package/services/commands/release-assets.js.map +1 -1
  29. package/services/commands/release-check.js +18 -8
  30. package/services/commands/release-check.js.map +1 -1
  31. package/services/commands/release-publish.js +3 -3
  32. package/services/commands/release-publish.js.map +1 -1
  33. package/services/desktop/electron-binary.js +6 -2
  34. package/services/desktop/electron-binary.js.map +1 -1
  35. package/services/modules/module-artifacts.js +5 -1
  36. package/services/modules/module-artifacts.js.map +1 -1
  37. package/services/modules/module-catalog.js +15 -0
  38. package/services/modules/module-catalog.js.map +1 -1
  39. package/services/modules/module-web-views.js +18 -12
  40. package/services/modules/module-web-views.js.map +1 -1
  41. package/services/packages/addon-builder.js +7 -2
  42. package/services/packages/addon-builder.js.map +1 -1
  43. package/services/packaging/debian-install.js +11 -0
  44. package/services/packaging/debian-install.js.map +1 -1
  45. package/services/packaging/package-configuration.js +6 -3
  46. package/services/packaging/package-configuration.js.map +1 -1
  47. package/services/packaging/package-installer.js +2 -2
  48. package/services/packaging/package-installer.js.map +1 -1
  49. package/services/packaging/package-stage.js +27 -10
  50. package/services/packaging/package-stage.js.map +1 -1
  51. package/services/packaging/packaged-architecture.js +34 -11
  52. package/services/packaging/packaged-architecture.js.map +1 -1
  53. package/services/release/release-file-set.js +12 -10
  54. package/services/release/release-file-set.js.map +1 -1
  55. package/services/release/release-notes.js +9 -6
  56. package/services/release/release-notes.js.map +1 -1
  57. package/services/release/release-publisher.js +29 -21
  58. package/services/release/release-publisher.js.map +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"release-version.js","sourceRoot":"","sources":["../../../../../src/noldova.desktop.build/src/models/release/release-version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,OAAO,cAAc;IACR,KAAK,CAAS;IACd,KAAK,CAAS;IACd,KAAK,CAAS;IAEf,IAAI,CAAS;IAE7B,YAAoB,IAAY,EAAE,KAAa,EAAE,KAAa,EAAE,KAAa;QAC3E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,IAAY,EAAE,MAAc;QAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YACtB,MAAM,IAAI,cAAc,CAAC,SAAS,CAAC,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAChF,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAC,GAAW,EAAE,MAAc;QAChD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,gBAAgB,CAAC;YAC7C,MAAM,IAAI,cAAc,CAAC,SAAS,CAAC,uBAAuB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3E,OAAO,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACpF,CAAC;IAED,IAAW,GAAG;QACZ,OAAO,GAAG,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACrD,CAAC;IAEM,WAAW,CAAC,KAAqB;QACtC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAC5B,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAClC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAC5B,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAClC,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAClC,CAAC;CACF"}
1
+ {"version":3,"file":"release-version.js","sourceRoot":"","sources":["../../../../../src/noldova.desktop.build/src/models/release/release-version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,OAAO,cAAc;IACR,KAAK,CAAS;IACd,KAAK,CAAS;IACd,KAAK,CAAS;IAEf,IAAI,CAAS;IAE7B,YAAoB,IAAY,EAAE,KAAa,EAAE,KAAa,EAAE,KAAa;QAC3E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,IAAY,EAAE,MAAc;QAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YACtB,MAAM,IAAI,cAAc,CAAC,SAAS,CAAC,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAChF,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IAEM,WAAW,CAAC,KAAqB;QACtC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAC5B,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAClC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAC5B,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAClC,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAClC,CAAC;CACF"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@noldova/desktop.build",
3
- "version": "0.0.2",
3
+ "version": "0.0.4",
4
4
  "description": "Noldova Desktop's app build: from an app's desktop section and module list to its window, its development app, signed packages for each target and a release.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -52,5 +52,5 @@
52
52
  "optional": true
53
53
  }
54
54
  },
55
- "gitHead": "4a952ab785ad808de592e9428c3feff7dc979e8f"
55
+ "gitHead": "576d8a6e7035959a5dbddacfd5ab187832c06586"
56
56
  }
package/resources.js CHANGED
@@ -89,6 +89,9 @@ export class Resources {
89
89
  static addonOutputFolder = "native";
90
90
  static addonExtension = ".node";
91
91
  static releaseAddonsVariable = "RELEASE_ADDONS";
92
+ static targetArchitectureVariable = "NOLDOVA_DESKTOP_ARCHITECTURE";
93
+ static companyArchivesVariable = "NOLDOVA_DESKTOP_COMPANY_ARCHIVES";
94
+ static electronArchitectureVariable = "npm_config_arch";
92
95
  static addonWindowsTargets = ["win32-x64", "win32-arm64"];
93
96
  static addonPosixTargets = ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64"];
94
97
  static addonTargets = [...Resources.addonWindowsTargets, ...Resources.addonPosixTargets];
@@ -424,9 +427,8 @@ export class Resources {
424
427
  static stageNoticeSeparator = `\n${"-".repeat(Resources.stageNoticeRuleWidth)}\n\n`;
425
428
  static stageUnreachableRegistry = "http://127.0.0.1:9/";
426
429
  static stageOverridesInvalid = "The root package.json's overrides must be an object, as npm reads them.";
427
- static stageOverrideConflictMarker = "code EOVERRIDE";
428
- static stageOverrideAdvice = "\nThe stage installs each shipped package from its archive as a direct dependency, and npm refuses a top-level override of a direct dependency; "
429
- + "write the override nested under the dependent it is for, as { \"<dependent>\": { \"<package>\": \"<version>\" } }.";
430
+ static stageOverrideReferencePrefix = "$";
431
+ static stageOverrideSelfKey = ".";
430
432
  static stageInstallArguments = [
431
433
  "install", "--offline", "--no-save", "--no-package-lock", "--omit=dev", "--legacy-peer-deps", "--ignore-scripts", "--no-audit", "--no-fund", "--loglevel=error",
432
434
  `--registry=${Resources.stageUnreachableRegistry}`, "--cache"
@@ -435,7 +437,6 @@ export class Resources {
435
437
  static stageIconsRole = "the icons folder that desktop.product.icons names";
436
438
  static stageDictionariesRole = "the spelling dictionaries the window checks text with";
437
439
  static stageNoGallery = "The packaged window holds no Gallery.\n";
438
- static machHeaderLength = 8;
439
440
  static machCpuTypeOffset = 4;
440
441
  static machUniversalCountOffset = 4;
441
442
  static machThinMagic = 0xfeedfacf;
@@ -445,6 +446,21 @@ export class Resources {
445
446
  static machCpuTypes = { arm64: 0x0100000c, x64: 0x01000007 };
446
447
  static machUniversalFile = "a universal Mach-O file";
447
448
  static mach32BitFile = "a 32-bit Mach-O file";
449
+ static machKind = "Mach-O";
450
+ static peHeaderOffsetField = 0x3c;
451
+ static peSignatureLength = 6;
452
+ static peMachineOffset = 4;
453
+ static peMachines = { arm64: 0xaa64, x64: 0x8664 };
454
+ static peKind = "PE";
455
+ static elfClassOffset = 4;
456
+ static elf64BitClass = 2;
457
+ static elfDataOffset = 5;
458
+ static elfLittleEndianData = 1;
459
+ static elfMachineOffset = 18;
460
+ static elfMachines = { arm64: 183, x64: 62 };
461
+ static elfKind = "ELF";
462
+ static elf32BitFile = "a 32-bit ELF file";
463
+ static elfBigEndianFile = "a big-endian ELF file";
448
464
  static packagedBuildCommandLineName = "../build-command-line";
449
465
  static packagedBuildOptions = [Resources.buildCommand, "--packaged", "--output"];
450
466
  static packagedWindowFolder = "window";
@@ -693,6 +709,8 @@ export class Resources {
693
709
  static defaultField = "default";
694
710
  static keysField = "keys";
695
711
  static macKeysField = "macKeys";
712
+ static loadingKeysField = "loadingKeys";
713
+ static escapeKey = "Escape";
696
714
  static newWindowsField = "newWindows";
697
715
  static parametersField = "parameters";
698
716
  static valuesField = "values";
@@ -767,6 +785,8 @@ export class Resources {
767
785
  static moduleDisplayNameMissing = "must have a display name";
768
786
  static moduleDescriptionMissing = "must have a description";
769
787
  static moduleContributesNotObject = "must list its contributions as an object";
788
+ static moduleFormerNamesNotObject = "must give its former names as an object from a command's or a document's name to the names it had before";
789
+ static formerNamesField = "formerNames";
770
790
  static modulePlaceholderRepeated = "declares more than one placeholder, and a window shows one";
771
791
  static modulePlaceholderWithoutWindow = "declares a placeholder without a window part, which registers it";
772
792
  static moduleSettingsPagesWithoutWindow = "declares settings pages without a window part, which registers them";
@@ -905,7 +925,7 @@ export class Resources {
905
925
  "Network.setRequestInterception", "Network.continueInterceptedRequest"
906
926
  ];
907
927
  static webViewRefusedDomains = ["Target", "Browser", "Fetch", "Security"];
908
- static webViewFields = [Resources.methodsKind, Resources.eventsKind, Resources.keysField, Resources.newWindowsField];
928
+ static webViewFields = [Resources.methodsKind, Resources.eventsKind, Resources.keysField, Resources.newWindowsField, Resources.loadingKeysField];
909
929
  static webViewMethodFields = [Resources.nameField, Resources.parametersField];
910
930
  static webViewKeyFields = [Resources.nameField, Resources.keysField, Resources.macKeysField];
911
931
  static webViewRuleFields = [
@@ -913,11 +933,11 @@ export class Resources {
913
933
  ];
914
934
  static webViewStandardPlatforms = "Windows and Linux";
915
935
  static webViewMacPlatform = "macOS";
916
- static webViewFileInvalid = `must be an object with optional ${Resources.methodsKind}, ${Resources.eventsKind}, ${Resources.keysField} and ${Resources.newWindowsField}`;
936
+ static webViewFileInvalid = `must be an object with optional ${Resources.methodsKind}, ${Resources.eventsKind}, ${Resources.keysField}, ${Resources.newWindowsField} and ${Resources.loadingKeysField}`;
917
937
  static webViewMethodRepeated = "names a method more than once";
918
938
  static webViewEventsInvalid = "must list its events once each as a debugging protocol domain, a dot and a name, such as Page.loadEventFired";
919
939
  static webViewNewWindowsNotBoolean = `must say ${Resources.newWindowsField} as true or false`;
920
- static webViewKeysInvalid = `must name each of its keys once, with at most ${Resources.webViewKeysLimit} names`;
940
+ static webViewKeysInvalid = `must name each of its keys and loading keys once, with at most ${Resources.webViewKeysLimit} names in all`;
921
941
  static modulePackageFixturesFolder = `${Resources.moduleFixtureFolder}/packages`;
922
942
  static modulesSourceFolder = `${Resources.sourceFolder}/modules`;
923
943
  static angularCorePackage = "@angular/core";
@@ -1075,11 +1095,17 @@ export class Resources {
1075
1095
  static optionalTargetArchitecture = Resources.architectureArm64;
1076
1096
  static publishedVersionsVariable = "PUBLISHED_VERSIONS";
1077
1097
  static moduleRangeNoOutputFile = `${Resources.githubOutputVariable} names no file for the step's range and version outputs.`;
1098
+ static moduleRangeNoPin = `The root ${Resources.packageManifestFileName} pins no Noldova Desktop package to one exact version, the version a module builds and tests against.`;
1078
1099
  static moduleRangeNoPublished = `${Resources.publishedVersionsVariable} holds no list of versions as npm view's JSON gives it.`;
1079
1100
  static feedSkipVariable = "SKIP_FEED_CHECK";
1080
1101
  static feedVersionVariable = "FEED_VERSION";
1081
1102
  static feedUrlVariable = "FEED_URL";
1082
1103
  static releaseRepositoryVariable = "RELEASE_REPOSITORY";
1104
+ static releaseSourceRepositoryVariable = "RELEASE_SOURCE_REPOSITORY";
1105
+ static releaseBuildRepositoryVariable = "RELEASE_BUILD_REPOSITORY";
1106
+ static gitHubPrivateField = "private";
1107
+ static sourceRepositoryLabel = "the source repository";
1108
+ static releaseTagPrefixVariable = "RELEASE_TAG_PREFIX";
1083
1109
  static feedWaitVariable = "FEED_WAIT_SECONDS";
1084
1110
  static feedSkipValue = "true";
1085
1111
  static feedSkipValues = [String.empty, "false", Resources.feedSkipValue];
@@ -1164,6 +1190,10 @@ export class Resources {
1164
1190
  static aptGetCommand = "apt-get";
1165
1191
  static aptGetInstallArguments = ["install", "--yes"];
1166
1192
  static aptGetRemoveArguments = ["remove", "--yes"];
1193
+ static aptGetSimulateArguments = ["--simulate", "install", "--yes"];
1194
+ static aptGetUpdateArguments = ["update"];
1195
+ static aptGetInstalledPrefix = "Inst ";
1196
+ static aptGetInstalledDetails = /\s.*$/;
1167
1197
  static dpkgDebCommand = "dpkg-deb";
1168
1198
  static dpkgDebFieldOption = "--field";
1169
1199
  static debianPackageField = "Package";
@@ -1344,6 +1374,7 @@ export class Resources {
1344
1374
  static manifestVersionField = "version";
1345
1375
  static manifestDependenciesField = "dependencies";
1346
1376
  static manifestOptionalDependenciesField = "optionalDependencies";
1377
+ static manifestDevDependenciesField = "devDependencies";
1347
1378
  static manifestFilesField = "files";
1348
1379
  static manifestExportsField = "exports";
1349
1380
  static manifestCommitField = "gitHead";
@@ -1542,6 +1573,8 @@ export class Resources {
1542
1573
  static lockedPackageVersion = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.+-]+)?$/;
1543
1574
  static lockResolvedField = "resolved";
1544
1575
  static lockInBundleField = "inBundle";
1576
+ static lockLinkField = "link";
1577
+ static ownArchiveFolder = /^(?:\.\.\/)*_packages$/u;
1545
1578
  static omittedOptionalsField = "omittedOptionals";
1546
1579
  static omittedOptionalsShape = `The root package.json's ${Resources.omittedOptionalsSection} must map each package, as <name>@<version>, to `
1547
1580
  + "{ \"dependencies\": [<optional dependency name>, ...], \"reason\": \"<why the app never loads them>\" }.";
@@ -1669,6 +1702,7 @@ export class Resources {
1669
1702
  static releaseRevisionPattern = /^[0-9a-f]{40}$/u;
1670
1703
  static releaseVersionPattern = /^(0|[1-9]\d{0,8})\.(0|[1-9]\d{0,8})\.(0|[1-9]\d{0,8})$/u;
1671
1704
  static releaseTagPrefix = "v";
1705
+ static releaseTagPrefixPattern = /^(?:v|[a-z0-9]+(?:-[a-z0-9]+)*-)$/u;
1672
1706
  static gitCommand = "git";
1673
1707
  static gitTimeout = 60_000;
1674
1708
  static successExitCodes = [0];
@@ -1788,7 +1822,7 @@ export class Resources {
1788
1822
  static formatStagePartsMissing(missing) {
1789
1823
  return `The stage needs ${missing.join(Resources.listSeparator)}, which is not a package under src/.`;
1790
1824
  }
1791
- static formatMachArchitectureUnknown(architecture, known) {
1825
+ static formatNativeArchitectureUnknown(architecture, known) {
1792
1826
  return `The package's architecture ${architecture} is none of ${known.join(Resources.listSeparator)}.`;
1793
1827
  }
1794
1828
  static formatPackagedModulesNotActive(problems) {
@@ -2170,6 +2204,12 @@ export class Resources {
2170
2204
  static formatDetachAfterCopyFailed(error, detachError) {
2171
2205
  return `${String(error)}\nDetaching the disk image after the failed copy failed too: ${String(detachError)}`;
2172
2206
  }
2207
+ static formatInstallPlatformArguments(system, architecture, library) {
2208
+ return [`--os=${system}`, `--cpu=${architecture}`, ...Object.isNull(library) ? [] : [`--libc=${library}`]];
2209
+ }
2210
+ static formatStageArchivesLeftOut(names) {
2211
+ return `Installing the packages into the stage left out ${names.join(", ")}, which the stage ships for this target.`;
2212
+ }
2173
2213
  static formatStageInstallFailed(exitCode, output) {
2174
2214
  return `Installing the packages into the stage failed with exit code ${exitCode}; it uses only the build's archives and never the registry:\n${output}`;
2175
2215
  }
@@ -2185,15 +2225,21 @@ export class Resources {
2185
2225
  static formatStageLicensedPackage(id, license) {
2186
2226
  return `${id} (${license})`;
2187
2227
  }
2188
- static formatMachArchitectureMismatch(file, found, architecture) {
2189
- return `The installed ${file} is ${found}, not an ${architecture}-only Mach-O file, so it would not run natively on ${architecture}.`;
2228
+ static formatNativeArchitectureMismatch(file, found, kind, architecture) {
2229
+ return `The file ${file} is ${found}, not an ${architecture}-only ${kind} file, so it would not run natively on ${architecture}.`;
2190
2230
  }
2191
- static formatMachArchitectureVerified(application, count, architecture) {
2192
- return `Every Mach-O file in ${application}, ${count} in all, is ${architecture} alone.`;
2231
+ static formatNativeArchitectureVerified(folder, count, architecture) {
2232
+ return `Every Mach-O, PE and ELF file in ${folder}, ${count} in all, is ${architecture} alone.`;
2193
2233
  }
2194
2234
  static formatMachCpuType(type) {
2195
2235
  return `a Mach-O file for CPU type 0x${type.toString(16)}`;
2196
2236
  }
2237
+ static formatPeMachine(machine) {
2238
+ return `a PE file for machine 0x${machine.toString(16)}`;
2239
+ }
2240
+ static formatElfMachine(machine) {
2241
+ return `an ELF file for machine ${String(machine)}`;
2242
+ }
2197
2243
  static formatPackagedBuildFailed(exitCode) {
2198
2244
  return `The packaged build failed with exit code ${exitCode}.`;
2199
2245
  }
@@ -2585,11 +2631,11 @@ export class Resources {
2585
2631
  static formatWebViewKeyRepeated(platform) {
2586
2632
  return `gives a key more than once on ${platform}`;
2587
2633
  }
2588
- static formatWebViewKeyInvalid(index) {
2589
- return `must describe ${Resources.keysField}[${index}] with a name, its keys and optionally its macOS keys`;
2634
+ static formatWebViewKeyInvalid(field, index) {
2635
+ return `must describe ${field}[${index}] with a name, its keys and optionally its macOS keys`;
2590
2636
  }
2591
- static formatWebViewKeyNameInvalid(index) {
2592
- return `must name ${Resources.keysField}[${index}] with a lowercase letter followed by letters and digits`;
2637
+ static formatWebViewKeyNameInvalid(field, index) {
2638
+ return `must name ${field}[${index}] with a lowercase letter followed by letters and digits`;
2593
2639
  }
2594
2640
  static formatWebViewChordsInvalid(where) {
2595
2641
  return `must give ${where} one to ${Resources.webViewChordsLimit} keys`;
@@ -2598,7 +2644,7 @@ export class Resources {
2598
2644
  return `gives ${where} ${text}, which is not a key in Noldova Desktop's format, such as Mod+R or F5`;
2599
2645
  }
2600
2646
  static formatWebViewKeyRefused(where, text, platform) {
2601
- return `gives ${where} ${text}, which cannot be declared on ${platform}: it needs Mod, Ctrl or Alt, or a function key, and it must not be a key that editing, the operating system or Noldova Desktop holds`;
2647
+ return `gives ${where} ${text}, which cannot be declared on ${platform}: it needs Mod, Ctrl or Alt, or a function key, or is Escape among the loading keys, and it must not be a key that editing, the operating system or Noldova Desktop holds`;
2602
2648
  }
2603
2649
  static formatWebViewMethodInvalid(index) {
2604
2650
  return `must describe ${Resources.methodsKind}[${index}] with a name and optionally parameters`;
@@ -2651,6 +2697,21 @@ export class Resources {
2651
2697
  static formatCatalogPermissionsModuleInvalid(name) {
2652
2698
  return `The root ${Resources.packageManifestFileName}'s ${Resources.desktopField}.${Resources.productField}.${Resources.permissionsModuleField} must be the id of a module in ${Resources.modulesListSection}, not ${JSON.stringify(name)}.`;
2653
2699
  }
2700
+ static formatModuleFormerNamesUndeclared(name) {
2701
+ return `gives former names for "${name}", which isn't one of its commands or documents`;
2702
+ }
2703
+ static formatModuleFormerNamesInvalid(name) {
2704
+ return `must give "${name}" its former names as a list of different qualified names, such as "notes.add", none of them its own name`;
2705
+ }
2706
+ static formatModuleFormerNamesReserved(name, former) {
2707
+ return `gives "${name}" the former name "${former}", which belongs to the shell or a reserved id: ${Resources.moduleReservedIds.join(", ")}`;
2708
+ }
2709
+ static formatCatalogFormerNamesRepeated(repeated) {
2710
+ return `Former names repeat in the build, and a former name moves to one command or document: ${repeated.map(([name, files]) => Resources.formatNameInFile(name, files.join(", "))).join("; ")}.`;
2711
+ }
2712
+ static formatCatalogFormerNamesCurrent(current) {
2713
+ return `Former names are names a module contributes in the build: ${current.map(([name, files]) => Resources.formatNameInFile(name, files.join(", "))).join("; ")}.`;
2714
+ }
2654
2715
  static formatContributionPlace(file, kind) {
2655
2716
  return `${file} (${kind})`;
2656
2717
  }
@@ -2832,6 +2893,14 @@ export class Resources {
2832
2893
  static formatModuleRangeNotFollowing(file, range, minimum, following) {
2833
2894
  return `${file}'s ${Resources.noldovaDesktopField} is ${range}, but a range from ${minimum} ends below the next version that may break modules: ${following}.`;
2834
2895
  }
2896
+ static formatModuleRangePinNotExact(name, version) {
2897
+ return `The root ${Resources.packageManifestFileName} names ${name} at ${version}, not at one exact version; `
2898
+ + `a module pins each Noldova Desktop package to the exact version its range starts at, as MODULES.md's "Noldova Desktop versions" says.`;
2899
+ }
2900
+ static formatModuleRangeNotPin(file, range, name, pin) {
2901
+ return `${file}'s ${Resources.noldovaDesktopField} is ${range}, but the root ${Resources.packageManifestFileName} pins ${name} at ${pin}; `
2902
+ + `the range's lowest version is the module's exact development pin, as MODULES.md's "Noldova Desktop versions" says.`;
2903
+ }
2835
2904
  static formatModuleRangeNoneInside(file, range) {
2836
2905
  return `No published Noldova Desktop version is inside ${file}'s ${Resources.noldovaDesktopField} range ${range}.`;
2837
2906
  }
@@ -2900,7 +2969,11 @@ export class Resources {
2900
2969
  return `The packaged product file names the update feed ${JSON.stringify(feed ?? null)}, not ${expected}, so its packages cannot be released.`;
2901
2970
  }
2902
2971
  static formatReleaseCheckUsage(command) {
2903
- return `Usage: ${Resources.releaseRepositoryVariable}=<owner/name> ${Resources.releaseVersionVariable}=<N.N.N> ${Resources.releaseRevisionVariable}=<commit> ${command} ${Resources.releaseCheckCommand}\n`;
2972
+ return `Usage: ${Resources.releaseRepositoryVariable}=<owner/name> ${Resources.releaseVersionVariable}=<N.N.N> ${Resources.releaseRevisionVariable}=<commit> `
2973
+ + `${Resources.formatReleaseSourceOptions()} ${command} ${Resources.releaseCheckCommand}\n`;
2974
+ }
2975
+ static formatReleaseSourceOptions() {
2976
+ return `[${Resources.releaseSourceRepositoryVariable}=<owner/name>] [${Resources.releaseBuildRepositoryVariable}=<owner/name>] [${Resources.releaseTagPrefixVariable}=<prefix>]`;
2904
2977
  }
2905
2978
  static formatRootVersionMismatch(rootVersion, version) {
2906
2979
  return `The root manifest's version is ${rootVersion}, not ${version}; raise it on ${Resources.mainBranch} first.`;
@@ -2935,7 +3008,7 @@ export class Resources {
2935
3008
  }
2936
3009
  static formatReleasePublishUsage(command) {
2937
3010
  return `Usage: ${Resources.releaseRepositoryVariable}=<owner/name> ${Resources.releaseVersionVariable}=<N.N.N> ${Resources.releaseRevisionVariable}=<commit> ${Resources.releaseFolderVariable}=<folder> `
2938
- + `${Resources.releaseReportsVariable}=<folder> ${Resources.releaseRunVariable}=<url> [${Resources.releaseUpdateFeedVariable}=<loopback URL> | ${Resources.releaseInternalVariable}=<N.N.N-internal.N>] ${command} ${Resources.releasePublishCommand}\n`;
3011
+ + `${Resources.formatReleaseSourceOptions()} ${Resources.releaseReportsVariable}=<folder> ${Resources.releaseRunVariable}=<url> [${Resources.releaseUpdateFeedVariable}=<loopback URL> | ${Resources.releaseInternalVariable}=<N.N.N-internal.N>] ${command} ${Resources.releasePublishCommand}\n`;
2939
3012
  }
2940
3013
  static formatTestFeedPublishesNothing(feed) {
2941
3014
  return `This run tests updating with the feed ${feed}, so it publishes nothing.\n`;
@@ -3133,6 +3206,9 @@ export class Resources {
3133
3206
  static formatAddonBuildFailed(packageName, kind, addon, exitCode, text) {
3134
3207
  return `Building ${packageName}'s ${kind} addon ${addon} failed with exit code ${exitCode}:\n${text}`;
3135
3208
  }
3209
+ static formatAddonArchitectureRefused(packageName, architecture, machineArchitecture) {
3210
+ return `${packageName}'s addons can't be built for ${architecture} on this ${machineArchitecture} machine, since node-gyp builds for the machine's own processor. Build on a ${architecture} machine, or name a folder of release builds in ${Resources.releaseAddonsVariable}.`;
3211
+ }
3136
3212
  static formatReleaseAddonMissing(target, packageName, addon, directory, build) {
3137
3213
  return `${Resources.releaseAddonsVariable} lacks the ${target} build of ${packageName}'s addon ${addon}, ${directory}/${build}.`;
3138
3214
  }
@@ -3193,6 +3269,11 @@ export class Resources {
3193
3269
  static formatDebianPackageUnnamed(file, exitCode, text) {
3194
3270
  return `dpkg-deb found no package name in ${file}, ${Resources.formatExitCodeProblem(exitCode, text)}`;
3195
3271
  }
3272
+ static formatDebianDependenciesMissing(file, missing, simulation, exitCode, text) {
3273
+ const lacking = missing.length > 0 ? `needs ${missing.join(Resources.listSeparator)}, which this runner lacks` : `has dependencies apt-get could not resolve here: ${simulation.trim()}`;
3274
+ return `${file} ${lacking}, and sudo --non-interactive apt-get update could not run to find them, ${Resources.formatExitCodeProblem(exitCode, text)}. `
3275
+ + "The Debian package's smoke needs the runner's user to run apt-get as root without a password, as it installs and removes the package with sudo.";
3276
+ }
3196
3277
  static formatDebianCommandUnresolved(command, exitCode, text) {
3197
3278
  return `The Debian package left no command at ${command} that leads to its program, ${Resources.formatExitCodeProblem(exitCode, text)}`;
3198
3279
  }
@@ -3309,6 +3390,13 @@ export class Resources {
3309
3390
  static formatCompanyPackageUnreadable(id, location) {
3310
3391
  return `${id} could not be read at ${location}, where npm ci installs it after checking it against package-lock.json; the stage takes the company's packages only from there.`;
3311
3392
  }
3393
+ static formatCompanyPackageUnreadableOrUnfetched(id, location, archive) {
3394
+ return `${id} could not be read at ${location}, where npm ci installs it after checking it against package-lock.json, or at ${archive}, `
3395
+ + `where the install packs a company package that npm ci leaves out for another processor or system; the stage takes the company's packages only from there.`;
3396
+ }
3397
+ static formatFetchedCompanyArchiveMismatch(archive, id) {
3398
+ return `${archive} does not match the integrity package-lock.json locks for ${id}, so it cannot ship.`;
3399
+ }
3312
3400
  static formatCompanyPackageMismatch(location, id) {
3313
3401
  return `${location} does not hold ${id}, which package-lock.json locks; run npm ci, so the stage takes the locked package.`;
3314
3402
  }
@@ -3367,6 +3455,26 @@ export class Resources {
3367
3455
  static formatLockedPackageUnlocked(name, version, location) {
3368
3456
  return `${name}@${version} at ${location} is installed but not locked in package-lock.json, and only a package installed from the app's own archive may ship unlocked.`;
3369
3457
  }
3458
+ static formatLockedPackageLinked(location, resolved) {
3459
+ return `${location} in package-lock.json links to the folder ${resolved}; a linked folder cannot ship, so lock the package to its archive in the repository's own ${Resources.archivesFolder} folder.`;
3460
+ }
3461
+ static formatLockedArchiveRefused(name, version, location, resolved) {
3462
+ return `${name}@${version} at ${location} in package-lock.json is locked to ${resolved}; a locked file ships only as a ${Resources.packageArchiveExtension} archive of a Noldova package `
3463
+ + `directly in the ${Resources.archivesFolder} folder of the app's folder or of a folder above it.`;
3464
+ }
3465
+ static formatLockedArchiveMisnamed(name, version, location, resolved, expected) {
3466
+ return `${name}@${version} at ${location} in package-lock.json is locked to ${resolved}; its archive must be named ${expected}, the name npm pack gives ${name}@${version}.`;
3467
+ }
3468
+ static formatLockedArchiveOutside(id, archive, repository) {
3469
+ return `${id} is locked to ${archive}, which is outside the repository at ${repository}; an app ships only the archives in its own repository's ${Resources.archivesFolder} folders.`;
3470
+ }
3471
+ static formatLockedArchiveThroughLink(id, archive, real) {
3472
+ return `${id} is locked to ${archive}, which a link leads to ${real}; an app ships an archive only from its repository's own ${Resources.archivesFolder} folder, not through a link.`;
3473
+ }
3474
+ static formatLockedArchiveNoIntegrity(name, version, location, resolved) {
3475
+ return `${name}@${version} at ${location} in package-lock.json is locked to ${resolved} with an integrity that holds no SHA-512, so its archive cannot be verified; `
3476
+ + `write "integrity": "sha512-<the archive's SHA-512 digest in base64>" beside its "resolved", or leave the integrity out to ship the archive as it is.`;
3477
+ }
3370
3478
  static formatLockedPackageUnresolved(name, version, location) {
3371
3479
  return `${name}@${version} at ${location} in package-lock.json is not resolved to a registry tarball, so it cannot ship.`;
3372
3480
  }
@@ -3382,8 +3490,8 @@ export class Resources {
3382
3490
  static formatTargetId(platform, architecture) {
3383
3491
  return `${platform}-${architecture}`;
3384
3492
  }
3385
- static formatTargetFileName(productName, platform, architecture, extension) {
3386
- return `${productName}-${platform}-${architecture}.${extension}`;
3493
+ static formatTargetFileName(productName, version, platform, architecture, extension) {
3494
+ return `${productName}-${version}-${platform}-${architecture}.${extension}`;
3387
3495
  }
3388
3496
  static formatTarEntryType(type) {
3389
3497
  return `a tar entry of type ${type}`;
@@ -3477,6 +3585,9 @@ export class Resources {
3477
3585
  static formatReleaseRunCheck(runUrl) {
3478
3586
  return `Each target's package passed its install check on that target's own runner in the run that built it: ${runUrl}`;
3479
3587
  }
3588
+ static formatReleaseSource(repository, revision) {
3589
+ return `Built from ${repository} at ${revision}.`;
3590
+ }
3480
3591
  static formatUnsignedTestRelease(name, repository) {
3481
3592
  return `Unsigned test release of ${name}, published in ${repository}; an installed ${name} never updates from it.`;
3482
3593
  }
@@ -3568,6 +3679,23 @@ export class Resources {
3568
3679
  static formatTagAnnotated(tag) {
3569
3680
  return `The tag ${tag} is annotated; a release's tag points straight at its commit.`;
3570
3681
  }
3682
+ static formatReleaseTagTaken(tag, repository) {
3683
+ return `The tag ${tag} already exists in ${repository}, which isn't the source repository, so it can't be this release's own; this release needs a new version.`;
3684
+ }
3685
+ static formatReleaseTagMissing(tag, repository) {
3686
+ return `The tag ${tag} doesn't exist in ${repository}, though its release is published.`;
3687
+ }
3688
+ static formatReleaseTagPrefixNeeded(repository, sourceRepository) {
3689
+ return `${Resources.releaseTagPrefixVariable} must name the app, such as app-, for a release in ${repository}, which isn't its source repository ${sourceRepository}: `
3690
+ + `a v tag there can't say which app it belongs to.`;
3691
+ }
3692
+ static formatReleaseSourceNotPublic(sourceRepository, buildRepository) {
3693
+ return `The release runs in ${buildRepository} and reads its source ${sourceRepository} with the run's own token, which reads no other private repository, so ${sourceRepository} must be public; it is private or doesn't exist.`;
3694
+ }
3695
+ static formatSeparateReleaseNeedsFeed(repository, sourceRepository) {
3696
+ return `The release publishes in ${repository}, not in its source repository ${sourceRepository}, so product.json must name its updateFeed: `
3697
+ + `the latest release of ${repository} may be another app's.`;
3698
+ }
3571
3699
  static formatTagMoved(tag, commit, revision) {
3572
3700
  return `The tag ${tag} already points at ${commit}, not at ${revision}; a tag is never moved, so this release needs a new version.`;
3573
3701
  }
@@ -3583,8 +3711,11 @@ export class Resources {
3583
3711
  static formatYamlQuoted(text) {
3584
3712
  return `'${text.replaceAll("'", "''")}'`;
3585
3713
  }
3586
- static formatReleaseRepositoryInvalid(repository) {
3587
- return `${Resources.releaseRepositoryVariable} must name a repository as owner/name, not "${repository}".`;
3714
+ static formatReleaseRepositoryInvalid(repository, variable = Resources.releaseRepositoryVariable) {
3715
+ return `${variable} must name a repository as owner/name, not "${repository}".`;
3716
+ }
3717
+ static formatReleaseTagPrefixInvalid(prefix) {
3718
+ return `${Resources.releaseTagPrefixVariable} must be v, or lowercase words joined by dashes and ending in a dash, such as app-, not "${prefix}".`;
3588
3719
  }
3589
3720
  static formatReleaseRevisionInvalid(revision) {
3590
3721
  return `${Resources.releaseRevisionVariable} must be a full commit SHA of 40 lowercase hexadecimal digits, not "${revision}".`;
@@ -3592,8 +3723,8 @@ export class Resources {
3592
3723
  static formatReleaseVersionInvalid(source, text) {
3593
3724
  return `${source} must be a plain version such as 0.0.2, not "${text}".`;
3594
3725
  }
3595
- static formatReleaseTagInvalid(source, tag) {
3596
- return `${source} must be a tag such as v0.0.2, not "${tag}".`;
3726
+ static formatReleaseTagInvalid(source, tag, prefix) {
3727
+ return `${source} must be a tag such as ${prefix}0.0.2, not "${tag}".`;
3597
3728
  }
3598
3729
  static formatTagReferencesContext(tag) {
3599
3730
  return `the references of the tag ${tag}`;