@detergent-software/atk 9.4.0-dev.9 → 9.4.1-dev.1

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 (212) hide show
  1. package/CHANGELOG.md +401 -0
  2. package/README.md +7 -2
  3. package/build/command-manifest.json +33 -7
  4. package/build/commands/_app.d.ts.map +1 -1
  5. package/build/commands/_app.js +4 -2
  6. package/build/commands/_app.js.map +1 -1
  7. package/build/commands/audit.d.ts.map +1 -1
  8. package/build/commands/audit.js +7 -4
  9. package/build/commands/audit.js.map +1 -1
  10. package/build/commands/diff.d.ts.map +1 -1
  11. package/build/commands/diff.js +10 -10
  12. package/build/commands/diff.js.map +1 -1
  13. package/build/commands/doctor.d.ts.map +1 -1
  14. package/build/commands/doctor.js +1 -1
  15. package/build/commands/doctor.js.map +1 -1
  16. package/build/commands/info.d.ts.map +1 -1
  17. package/build/commands/info.js +16 -14
  18. package/build/commands/info.js.map +1 -1
  19. package/build/commands/init.d.ts.map +1 -1
  20. package/build/commands/init.js +1 -1
  21. package/build/commands/init.js.map +1 -1
  22. package/build/commands/install.d.ts.map +1 -1
  23. package/build/commands/install.js +161 -90
  24. package/build/commands/install.js.map +1 -1
  25. package/build/commands/move.d.ts.map +1 -1
  26. package/build/commands/move.js +5 -4
  27. package/build/commands/move.js.map +1 -1
  28. package/build/commands/outdated.js +1 -1
  29. package/build/commands/outdated.js.map +1 -1
  30. package/build/commands/sync.d.ts.map +1 -1
  31. package/build/commands/sync.js +6 -4
  32. package/build/commands/sync.js.map +1 -1
  33. package/build/commands/update.d.ts +1 -1
  34. package/build/commands/update.d.ts.map +1 -1
  35. package/build/commands/update.js +1 -1
  36. package/build/commands/update.js.map +1 -1
  37. package/build/commands/upgrade.d.ts +16 -0
  38. package/build/commands/upgrade.d.ts.map +1 -0
  39. package/build/commands/upgrade.js +64 -0
  40. package/build/commands/upgrade.js.map +1 -0
  41. package/build/commands/why.d.ts.map +1 -1
  42. package/build/commands/why.js +28 -7
  43. package/build/commands/why.js.map +1 -1
  44. package/build/components/DiffView.d.ts +3 -1
  45. package/build/components/DiffView.d.ts.map +1 -1
  46. package/build/components/DiffView.js +18 -4
  47. package/build/components/DiffView.js.map +1 -1
  48. package/build/components/EnabledEntriesHint.d.ts +14 -0
  49. package/build/components/EnabledEntriesHint.d.ts.map +1 -0
  50. package/build/components/EnabledEntriesHint.js +13 -0
  51. package/build/components/EnabledEntriesHint.js.map +1 -0
  52. package/build/components/InitSuccess.d.ts.map +1 -1
  53. package/build/components/InitSuccess.js +4 -1
  54. package/build/components/InitSuccess.js.map +1 -1
  55. package/build/components/InstallSummary.d.ts +7 -2
  56. package/build/components/InstallSummary.d.ts.map +1 -1
  57. package/build/components/InstallSummary.js +3 -1
  58. package/build/components/InstallSummary.js.map +1 -1
  59. package/build/components/LeftoverFilesHint.d.ts +21 -0
  60. package/build/components/LeftoverFilesHint.d.ts.map +1 -0
  61. package/build/components/LeftoverFilesHint.js +13 -0
  62. package/build/components/LeftoverFilesHint.js.map +1 -0
  63. package/build/components/PreferredScopeWarning.d.ts +4 -3
  64. package/build/components/PreferredScopeWarning.d.ts.map +1 -1
  65. package/build/components/PreferredScopeWarning.js +5 -2
  66. package/build/components/PreferredScopeWarning.js.map +1 -1
  67. package/build/components/index.d.ts +2 -0
  68. package/build/components/index.d.ts.map +1 -1
  69. package/build/components/index.js +2 -0
  70. package/build/components/index.js.map +1 -1
  71. package/build/hooks/useInitState.d.ts +9 -1
  72. package/build/hooks/useInitState.d.ts.map +1 -1
  73. package/build/hooks/useInitState.js +52 -10
  74. package/build/hooks/useInitState.js.map +1 -1
  75. package/build/hooks/useListActions.d.ts.map +1 -1
  76. package/build/hooks/useListActions.js +4 -1
  77. package/build/hooks/useListActions.js.map +1 -1
  78. package/build/hooks/useUninstallState.d.ts.map +1 -1
  79. package/build/hooks/useUninstallState.js +46 -23
  80. package/build/hooks/useUninstallState.js.map +1 -1
  81. package/build/lib/adapter.d.ts +14 -9
  82. package/build/lib/adapter.d.ts.map +1 -1
  83. package/build/lib/adapter.js +46 -8
  84. package/build/lib/adapter.js.map +1 -1
  85. package/build/lib/api-client.d.ts.map +1 -1
  86. package/build/lib/api-client.js +2 -1
  87. package/build/lib/api-client.js.map +1 -1
  88. package/build/lib/asset-tools.d.ts +8 -0
  89. package/build/lib/asset-tools.d.ts.map +1 -1
  90. package/build/lib/asset-tools.js +14 -0
  91. package/build/lib/asset-tools.js.map +1 -1
  92. package/build/lib/completion/candidates.d.ts.map +1 -1
  93. package/build/lib/completion/candidates.js +21 -8
  94. package/build/lib/completion/candidates.js.map +1 -1
  95. package/build/lib/config-entries.d.ts +3 -3
  96. package/build/lib/config-entries.d.ts.map +1 -1
  97. package/build/lib/config-entries.js +16 -6
  98. package/build/lib/config-entries.js.map +1 -1
  99. package/build/lib/config-lock.d.ts +2 -1
  100. package/build/lib/config-lock.d.ts.map +1 -1
  101. package/build/lib/config-lock.js +10 -2
  102. package/build/lib/config-lock.js.map +1 -1
  103. package/build/lib/cross-scope.d.ts +6 -2
  104. package/build/lib/cross-scope.d.ts.map +1 -1
  105. package/build/lib/cross-scope.js +20 -13
  106. package/build/lib/cross-scope.js.map +1 -1
  107. package/build/lib/diagnostics.d.ts +3 -2
  108. package/build/lib/diagnostics.d.ts.map +1 -1
  109. package/build/lib/diagnostics.js +11 -11
  110. package/build/lib/diagnostics.js.map +1 -1
  111. package/build/lib/diff-command.d.ts +9 -3
  112. package/build/lib/diff-command.d.ts.map +1 -1
  113. package/build/lib/diff-command.js +58 -21
  114. package/build/lib/diff-command.js.map +1 -1
  115. package/build/lib/diff.d.ts +8 -4
  116. package/build/lib/diff.d.ts.map +1 -1
  117. package/build/lib/diff.js +23 -4
  118. package/build/lib/diff.js.map +1 -1
  119. package/build/lib/doctor-fix.d.ts +8 -3
  120. package/build/lib/doctor-fix.d.ts.map +1 -1
  121. package/build/lib/doctor-fix.js +50 -3
  122. package/build/lib/doctor-fix.js.map +1 -1
  123. package/build/lib/enabled-list.d.ts +7 -3
  124. package/build/lib/enabled-list.d.ts.map +1 -1
  125. package/build/lib/enabled-list.js +7 -5
  126. package/build/lib/enabled-list.js.map +1 -1
  127. package/build/lib/gitignore.d.ts +8 -0
  128. package/build/lib/gitignore.d.ts.map +1 -1
  129. package/build/lib/gitignore.js +51 -6
  130. package/build/lib/gitignore.js.map +1 -1
  131. package/build/lib/hook-config.d.ts +90 -7
  132. package/build/lib/hook-config.d.ts.map +1 -1
  133. package/build/lib/hook-config.js +135 -11
  134. package/build/lib/hook-config.js.map +1 -1
  135. package/build/lib/hook-script.d.ts +45 -0
  136. package/build/lib/hook-script.d.ts.map +1 -1
  137. package/build/lib/hook-script.js +118 -1
  138. package/build/lib/hook-script.js.map +1 -1
  139. package/build/lib/init.d.ts +34 -12
  140. package/build/lib/init.d.ts.map +1 -1
  141. package/build/lib/init.js +180 -32
  142. package/build/lib/init.js.map +1 -1
  143. package/build/lib/install-targets.d.ts +20 -6
  144. package/build/lib/install-targets.d.ts.map +1 -1
  145. package/build/lib/install-targets.js +65 -8
  146. package/build/lib/install-targets.js.map +1 -1
  147. package/build/lib/installer.d.ts +15 -5
  148. package/build/lib/installer.d.ts.map +1 -1
  149. package/build/lib/installer.js +201 -41
  150. package/build/lib/installer.js.map +1 -1
  151. package/build/lib/local-edits.d.ts +15 -2
  152. package/build/lib/local-edits.d.ts.map +1 -1
  153. package/build/lib/local-edits.js +40 -13
  154. package/build/lib/local-edits.js.map +1 -1
  155. package/build/lib/lockfile.d.ts +2 -2
  156. package/build/lib/lockfile.js +4 -4
  157. package/build/lib/lockfile.js.map +1 -1
  158. package/build/lib/mover.d.ts +5 -4
  159. package/build/lib/mover.d.ts.map +1 -1
  160. package/build/lib/mover.js +43 -35
  161. package/build/lib/mover.js.map +1 -1
  162. package/build/lib/multi-tool-install.d.ts +28 -5
  163. package/build/lib/multi-tool-install.d.ts.map +1 -1
  164. package/build/lib/multi-tool-install.js +105 -26
  165. package/build/lib/multi-tool-install.js.map +1 -1
  166. package/build/lib/named-entry.d.ts +12 -0
  167. package/build/lib/named-entry.d.ts.map +1 -1
  168. package/build/lib/named-entry.js +16 -8
  169. package/build/lib/named-entry.js.map +1 -1
  170. package/build/lib/notices.d.ts +2 -0
  171. package/build/lib/notices.d.ts.map +1 -1
  172. package/build/lib/notices.js +10 -0
  173. package/build/lib/notices.js.map +1 -1
  174. package/build/lib/preferred-scope.d.ts +19 -5
  175. package/build/lib/preferred-scope.d.ts.map +1 -1
  176. package/build/lib/preferred-scope.js +38 -18
  177. package/build/lib/preferred-scope.js.map +1 -1
  178. package/build/lib/schemas/adapter.d.ts +33 -0
  179. package/build/lib/schemas/adapter.d.ts.map +1 -1
  180. package/build/lib/schemas/adapter.js +31 -5
  181. package/build/lib/schemas/adapter.js.map +1 -1
  182. package/build/lib/self-upgrade.d.ts +66 -0
  183. package/build/lib/self-upgrade.d.ts.map +1 -0
  184. package/build/lib/self-upgrade.js +183 -0
  185. package/build/lib/self-upgrade.js.map +1 -0
  186. package/build/lib/sync.d.ts +39 -0
  187. package/build/lib/sync.d.ts.map +1 -1
  188. package/build/lib/sync.js +181 -10
  189. package/build/lib/sync.js.map +1 -1
  190. package/build/lib/touched-paths.d.ts.map +1 -1
  191. package/build/lib/touched-paths.js +2 -1
  192. package/build/lib/touched-paths.js.map +1 -1
  193. package/build/lib/uninstaller.d.ts +29 -1
  194. package/build/lib/uninstaller.d.ts.map +1 -1
  195. package/build/lib/uninstaller.js +99 -5
  196. package/build/lib/uninstaller.js.map +1 -1
  197. package/build/lib/update-check.d.ts +27 -1
  198. package/build/lib/update-check.d.ts.map +1 -1
  199. package/build/lib/update-check.js +74 -8
  200. package/build/lib/update-check.js.map +1 -1
  201. package/build/lib/updater.d.ts +2 -0
  202. package/build/lib/updater.d.ts.map +1 -1
  203. package/build/lib/updater.js +36 -3
  204. package/build/lib/updater.js.map +1 -1
  205. package/build/lib/version.d.ts +12 -4
  206. package/build/lib/version.d.ts.map +1 -1
  207. package/build/lib/version.js +19 -7
  208. package/build/lib/version.js.map +1 -1
  209. package/package.json +1 -1
  210. package/tool-adapters/claude-code.json +2 -1
  211. package/tool-adapters/codex-cli.json +5 -1
  212. package/tool-adapters/copilot-cli.json +58 -9
@@ -15,6 +15,13 @@ export interface FindNamedEntryOptions {
15
15
  /** A requested version, carried into the suggested commands. */
16
16
  version?: string;
17
17
  }
18
+ /** What a name reaches in a lockfile, as {@link lookupNamedEntry} resolves it. */
19
+ export interface NamedEntryLookup {
20
+ /** When the name reaches no entry: how the commands name the entries of that name it missed. */
21
+ elsewhere: string[];
22
+ /** The entries the name reaches: one, or one per type when it needs `--type`. */
23
+ matches: InstalledAsset[];
24
+ }
18
25
  /**
19
26
  * How a command names an installed entry so that {@link findNamedEntry} finds it again: `@org/name`
20
27
  * for an org's entry, and the bare name for a global one, unless the lockfile org has an entry of
@@ -29,4 +36,9 @@ export declare function entrySpec(lockfile: Lockfile, asset: Pick<InstalledAsset
29
36
  * type needs `type` to pick one.
30
37
  */
31
38
  export declare function findNamedEntry(lockfile: Lockfile, spec: string, { command, error: NamedError, root, scope, type, version }: FindNamedEntryOptions): InstalledAsset;
39
+ /**
40
+ * The entries a name reaches, as {@link findNamedEntry} resolves it, for a command that reports a
41
+ * name it doesn't reach instead of refusing it (`why`), or words its own refusal (`move`).
42
+ */
43
+ export declare function lookupNamedEntry(lockfile: Lockfile, spec: string, type?: AssetType): NamedEntryLookup;
32
44
  //# sourceMappingURL=named-entry.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"named-entry.d.ts","sourceRoot":"","sources":["../../src/lib/named-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,EAAE,KAAK,KAAK,EAA6B,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACpC,sGAAsG;IACtG,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,KAAK,CAAC;IACpE,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC,EACpD,IAAI,CAAC,EAAE,SAAS,GACf,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,qBAAqB,GAChF,cAAc,CAmChB"}
1
+ {"version":3,"file":"named-entry.d.ts","sourceRoot":"","sources":["../../src/lib/named-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,EAAE,KAAK,KAAK,EAA6B,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACpC,sGAAsG;IACtG,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,KAAK,CAAC;IACpE,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,gGAAgG;IAChG,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iFAAiF;IACjF,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC,EACpD,IAAI,CAAC,EAAE,SAAS,GACf,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,qBAAqB,GAChF,cAAc,CA4BhB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAUrG"}
@@ -19,13 +19,7 @@ export function entrySpec(lockfile, asset, type) {
19
19
  * type needs `type` to pick one.
20
20
  */
21
21
  export function findNamedEntry(lockfile, spec, { command, error: NamedError, root, scope, type, version }) {
22
- const named = parseNameScope(spec);
23
- const sameName = (lockfile.assets ?? []).filter((a) => a.name === named.name && (!type || a.type === type));
24
- const inOrg = (org) => sameName.filter((a) => a.org === org);
25
- let matches = inOrg(named.kind === 'default' ? lockfile.org : inlineOrgOf(named));
26
- if (matches.length === 0 && named.kind === 'default' && lockfile.org) {
27
- matches = inOrg(undefined);
28
- }
22
+ const { elsewhere, matches } = lookupNamedEntry(lockfile, spec, type);
29
23
  const versionSuffix = version ? `@${version}` : '';
30
24
  if (matches.length > 1) {
31
25
  const types = matches.map((a) => a.type).sort();
@@ -34,7 +28,6 @@ export function findNamedEntry(lockfile, spec, { command, error: NamedError, roo
34
28
  if (matches.length === 1)
35
29
  return matches[0];
36
30
  const notInstalled = `Asset "${spec}" is not installed${root ? ` in ${scopeLabel({ root, scope: scope ?? 'project' })}` : ''}.`;
37
- const elsewhere = [...new Set(sameName.map((a) => entrySpec(lockfile, a, type)))].sort();
38
31
  if (elsewhere.length > 0) {
39
32
  throw new NamedError(`${notInstalled} Installed as: ${elsewhere.join(', ')}.`, elsewhere.length === 1
40
33
  ? {
@@ -44,4 +37,19 @@ export function findNamedEntry(lockfile, spec, { command, error: NamedError, roo
44
37
  }
45
38
  throw new NamedError(notInstalled);
46
39
  }
40
+ /**
41
+ * The entries a name reaches, as {@link findNamedEntry} resolves it, for a command that reports a
42
+ * name it doesn't reach instead of refusing it (`why`), or words its own refusal (`move`).
43
+ */
44
+ export function lookupNamedEntry(lockfile, spec, type) {
45
+ const named = parseNameScope(spec);
46
+ const sameName = (lockfile.assets ?? []).filter((a) => a.name === named.name && (!type || a.type === type));
47
+ const inOrg = (org) => sameName.filter((a) => a.org === org);
48
+ let matches = inOrg(named.kind === 'default' ? lockfile.org : inlineOrgOf(named));
49
+ if (matches.length === 0 && named.kind === 'default' && lockfile.org) {
50
+ matches = inOrg(undefined);
51
+ }
52
+ const elsewhere = matches.length > 0 ? [] : [...new Set(sameName.map((a) => entrySpec(lockfile, a, type)))].sort();
53
+ return { elsewhere, matches };
54
+ }
47
55
  //# sourceMappingURL=named-entry.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"named-entry.js","sourceRoot":"","sources":["../../src/lib/named-entry.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"named-entry.js","sourceRoot":"","sources":["../../src/lib/named-entry.ts"],"names":[],"mappings":"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"}
@@ -32,6 +32,8 @@ export declare function addNotice(notice: Notice): void;
32
32
  export declare function clearNotices(): void;
33
33
  /** Current notices, as a stable array reference (safe for `useSyncExternalStore`). */
34
34
  export declare function getNotices(): readonly Notice[];
35
+ /** Drop the queued notice of one kind, once the run has dealt with it (`atk upgrade` and `update-available`). */
36
+ export declare function removeNotice(kind: string): void;
35
37
  /** Subscribe to changes; returns the unsubscribe function. */
36
38
  export declare function subscribeNotices(listener: Listener): () => void;
37
39
  export declare function toJsonNotice({ command, kind, text }: Notice): JsonNotice;
@@ -1 +1 @@
1
- {"version":3,"file":"notices.d.ts","sourceRoot":"","sources":["../../src/lib/notices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAK3B,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ9C;AAED,oDAAoD;AACpD,wBAAgB,YAAY,IAAI,IAAI,CAKnC;AAED,sFAAsF;AACtF,wBAAgB,UAAU,IAAI,SAAS,MAAM,EAAE,CAE9C;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAK/D;AAED,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,GAAG,UAAU,CAExE"}
1
+ {"version":3,"file":"notices.d.ts","sourceRoot":"","sources":["../../src/lib/notices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAK3B,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ9C;AAED,oDAAoD;AACpD,wBAAgB,YAAY,IAAI,IAAI,CAKnC;AAED,sFAAsF;AACtF,wBAAgB,UAAU,IAAI,SAAS,MAAM,EAAE,CAE9C;AAED,iHAAiH;AACjH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ/C;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAK/D;AAED,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,GAAG,UAAU,CAExE"}
@@ -32,6 +32,16 @@ export function clearNotices() {
32
32
  export function getNotices() {
33
33
  return notices;
34
34
  }
35
+ /** Drop the queued notice of one kind, once the run has dealt with it (`atk upgrade` and `update-available`). */
36
+ export function removeNotice(kind) {
37
+ if (!notices.some((n) => n.kind === kind)) {
38
+ return;
39
+ }
40
+ notices = notices.filter((n) => n.kind !== kind);
41
+ for (const listener of listeners) {
42
+ listener();
43
+ }
44
+ }
35
45
  /** Subscribe to changes; returns the unsubscribe function. */
36
46
  export function subscribeNotices(listener) {
37
47
  listeners.add(listener);
@@ -1 +1 @@
1
- {"version":3,"file":"notices.js","sourceRoot":"","sources":["../../src/lib/notices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsBH,IAAI,OAAO,GAAsB,EAAE,CAAC;AACpC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;AAEtC,qEAAqE;AACrE,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,OAAO;IACT,CAAC;IACD,OAAO,GAAG,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,QAAQ,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,YAAY;IAC1B,OAAO,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,QAAQ,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAU;IAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC"}
1
+ {"version":3,"file":"notices.js","sourceRoot":"","sources":["../../src/lib/notices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsBH,IAAI,OAAO,GAAsB,EAAE,CAAC;AACpC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;AAEtC,qEAAqE;AACrE,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,OAAO;IACT,CAAC;IACD,OAAO,GAAG,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,QAAQ,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,YAAY;IAC1B,OAAO,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,QAAQ,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACjD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,QAAQ,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAU;IAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC"}
@@ -19,14 +19,22 @@ export interface PreferredScope {
19
19
  scope: Scope;
20
20
  }
21
21
  /**
22
- * Whether an install could move to `scope`: the user scope when its root exists, and the project when
23
- * the cwd is in one other than the user root.
22
+ * Whether an install could move to a scope, and, when it can't only because the user scope isn't set
23
+ * up for it, `setup`: the command that sets it up.
24
24
  */
25
- export declare function canInstallAt(scope: Scope): Promise<boolean>;
25
+ export type ScopeReadiness = {
26
+ ready: false;
27
+ setup?: string;
28
+ } | {
29
+ ready: true;
30
+ };
26
31
  /** `The author says atk-guide works best at the user level.` */
27
32
  export declare function describePreferredScope({ assets, scope }: PreferredScope): string;
28
- /** The `preferred-scope` notice: what the authors say, and `command`, the install at their scope. */
29
- export declare function preferredScopeNotice(preferred: PreferredScope, command: string): Notice;
33
+ /**
34
+ * The `preferred-scope` notice: what the authors say, and `command`, the install at their scope; or,
35
+ * when that scope needs `setup` first, the setup as the command and both in the text.
36
+ */
37
+ export declare function preferredScopeNotice(preferred: PreferredScope, command: string, setup?: string): Notice;
30
38
  /**
31
39
  * The plan's direct targets (the asset, a bundle's members, each named asset) that prefer the scope
32
40
  * other than `scope`; undefined when none does. Dependencies install with what needs them, so their
@@ -35,4 +43,10 @@ export declare function preferredScopeNotice(preferred: PreferredScope, command:
35
43
  export declare function preferredScopeOf(plan: InstallPlan, scope: Scope): PreferredScope | undefined;
36
44
  /** How a question offers the preferred scope: `with --user`, or `in the project`. */
37
45
  export declare function preferredScopeOffer(scope: Scope): string;
46
+ /**
47
+ * Whether the install of `tool` (`--tool`, or the scope's own tools) would work at `scope`, as the
48
+ * install moved there would run it: its root resolved as `resolveScope` resolves it (the user root, or
49
+ * the cwd's project when that isn't the user root), and its tools resolved there.
50
+ */
51
+ export declare function scopeReadiness(scope: Scope, tool?: string): Promise<ScopeReadiness>;
38
52
  //# sourceMappingURL=preferred-scope.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"preferred-scope.d.ts","sourceRoot":"","sources":["../../src/lib/preferred-scope.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAIpD,OAAO,EAA+B,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErE,qGAAqG;AACrG,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAC/D;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAMjE;AAED,gEAAgE;AAChE,wBAAgB,sBAAsB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,cAAc,GAAG,MAAM,CAMhF;AAED,qGAAqG;AACrG,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,GAAG,SAAS,CAa5F;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAExD"}
1
+ {"version":3,"file":"preferred-scope.d.ts","sourceRoot":"","sources":["../../src/lib/preferred-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAIpD,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAGtD,qGAAqG;AACrG,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAC/D;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,CAAC;AAEhF,gEAAgE;AAChE,wBAAgB,sBAAsB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,cAAc,GAAG,MAAM,CAMhF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,GAAG,SAAS,CAa5F;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAiBzF"}
@@ -1,19 +1,7 @@
1
- import { existsSync } from 'node:fs';
1
+ import { SetupRequiredError } from './errors.js';
2
2
  import { formatOrgName } from './org.js';
3
- import { findProjectRoot } from './paths.js';
4
- import { isUserRoot, resolveUserRoot } from './scope.js';
5
- /**
6
- * Whether an install could move to `scope`: the user scope when its root exists, and the project when
7
- * the cwd is in one other than the user root.
8
- */
9
- export async function canInstallAt(scope) {
10
- try {
11
- return scope === 'user' ? existsSync(await resolveUserRoot()) : !(await isUserRoot(findProjectRoot()));
12
- }
13
- catch {
14
- return false;
15
- }
16
- }
3
+ import { resolveScope } from './scope.js';
4
+ import { resolvePlacingTools } from './tool-resolver.js';
17
5
  /** `The author says atk-guide works best at the user level.` */
18
6
  export function describePreferredScope({ assets, scope }) {
19
7
  const names = assets.map((asset) => formatOrgName(asset.org, asset.name)).join(', ');
@@ -22,9 +10,15 @@ export function describePreferredScope({ assets, scope }) {
22
10
  ? `The author says ${names} works best ${where}.`
23
11
  : `The authors say ${names} work best ${where}.`;
24
12
  }
25
- /** The `preferred-scope` notice: what the authors say, and `command`, the install at their scope. */
26
- export function preferredScopeNotice(preferred, command) {
27
- return { command, kind: 'preferred-scope', text: describePreferredScope(preferred) };
13
+ /**
14
+ * The `preferred-scope` notice: what the authors say, and `command`, the install at their scope; or,
15
+ * when that scope needs `setup` first, the setup as the command and both in the text.
16
+ */
17
+ export function preferredScopeNotice(preferred, command, setup) {
18
+ const text = describePreferredScope(preferred);
19
+ return setup
20
+ ? { command: setup, kind: 'preferred-scope', text: `${text} Run \`${setup}\` first, then \`${command}\`.` }
21
+ : { command, kind: 'preferred-scope', text };
28
22
  }
29
23
  /**
30
24
  * The plan's direct targets (the asset, a bundle's members, each named asset) that prefer the scope
@@ -50,4 +44,30 @@ export function preferredScopeOf(plan, scope) {
50
44
  export function preferredScopeOffer(scope) {
51
45
  return scope === 'user' ? 'with --user' : 'in the project';
52
46
  }
47
+ /**
48
+ * Whether the install of `tool` (`--tool`, or the scope's own tools) would work at `scope`, as the
49
+ * install moved there would run it: its root resolved as `resolveScope` resolves it (the user root, or
50
+ * the cwd's project when that isn't the user root), and its tools resolved there.
51
+ */
52
+ export async function scopeReadiness(scope, tool) {
53
+ let root;
54
+ try {
55
+ const resolved = await resolveScope({ user: scope === 'user' });
56
+ if (resolved.scope !== scope)
57
+ return { ready: false };
58
+ root = resolved.root;
59
+ }
60
+ catch {
61
+ return { ready: false };
62
+ }
63
+ try {
64
+ await resolvePlacingTools(tool, root);
65
+ return { ready: true };
66
+ }
67
+ catch (error) {
68
+ // Only the user scope has one place to set up: the project the warning means may be another folder.
69
+ const setup = scope === 'user' && error instanceof SetupRequiredError ? error.command : undefined;
70
+ return { ready: false, ...(setup ? { setup } : {}) };
71
+ }
72
+ }
53
73
  //# sourceMappingURL=preferred-scope.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"preferred-scope.js","sourceRoot":"","sources":["../../src/lib/preferred-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAMrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAc,MAAM,YAAY,CAAC;AAerE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAY;IAC7C,IAAI,CAAC;QACH,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IACzG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,sBAAsB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAkB;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrF,MAAM,KAAK,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,cAAc,CAAC;IACtE,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC;QACxB,CAAC,CAAC,mBAAmB,KAAK,eAAe,KAAK,GAAG;QACjD,CAAC,CAAC,mBAAmB,KAAK,cAAc,KAAK,GAAG,CAAC;AACrD,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,oBAAoB,CAAC,SAAyB,EAAE,OAAe;IAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;AACvF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAiB,EAAE,KAAY;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAC/G,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC;IACrF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;QACH,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM;QACxC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,CAAC,cAAe;KAC7C,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,mBAAmB,CAAC,KAAY;IAC9C,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC;AAC7D,CAAC"}
1
+ {"version":3,"file":"preferred-scope.js","sourceRoot":"","sources":["../../src/lib/preferred-scope.ts"],"names":[],"mappings":"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"}
@@ -2,6 +2,7 @@ import { z } from 'zod';
2
2
  export declare const PlacementConfig: z.ZodObject<{
3
3
  configCommand: z.ZodOptional<z.ZodString>;
4
4
  configCommandEntryDefaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
5
+ configCommandPowershell: z.ZodOptional<z.ZodString>;
5
6
  configCommandPrefix: z.ZodOptional<z.ZodString>;
6
7
  configEntryDefaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
7
8
  configFile: z.ZodOptional<z.ZodString>;
@@ -11,16 +12,26 @@ export declare const PlacementConfig: z.ZodObject<{
11
12
  }>>;
12
13
  configFragment: z.ZodOptional<z.ZodBoolean>;
13
14
  configFragmentKey: z.ZodOptional<z.ZodString>;
15
+ configHookEvents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
16
+ configHookFormat: z.ZodOptional<z.ZodEnum<{
17
+ "matcher-groups": "matcher-groups";
18
+ copilot: "copilot";
19
+ }>>;
14
20
  configHookMerge: z.ZodOptional<z.ZodBoolean>;
15
21
  configKey: z.ZodOptional<z.ZodString>;
16
22
  configLockFile: z.ZodOptional<z.ZodString>;
17
23
  configMerge: z.ZodOptional<z.ZodBoolean>;
24
+ disabledListKey: z.ZodOptional<z.ZodString>;
18
25
  enabledListFile: z.ZodOptional<z.ZodString>;
19
26
  enabledListKey: z.ZodOptional<z.ZodString>;
20
27
  entrypointName: z.ZodOptional<z.ZodString>;
21
28
  fileless: z.ZodOptional<z.ZodBoolean>;
29
+ jsonEntrypoint: z.ZodOptional<z.ZodObject<{
30
+ path: z.ZodString;
31
+ }, z.core.$strip>>;
22
32
  nodeEntrypoint: z.ZodOptional<z.ZodObject<{
23
33
  configCommand: z.ZodString;
34
+ configCommandPowershell: z.ZodOptional<z.ZodString>;
24
35
  path: z.ZodString;
25
36
  }, z.core.$strip>>;
26
37
  path: z.ZodString;
@@ -54,6 +65,7 @@ export declare const AdapterSchema: z.ZodObject<{
54
65
  }> & z.core.$partial, z.ZodObject<{
55
66
  configCommand: z.ZodOptional<z.ZodString>;
56
67
  configCommandEntryDefaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
68
+ configCommandPowershell: z.ZodOptional<z.ZodString>;
57
69
  configCommandPrefix: z.ZodOptional<z.ZodString>;
58
70
  configEntryDefaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
59
71
  configFile: z.ZodOptional<z.ZodString>;
@@ -63,16 +75,26 @@ export declare const AdapterSchema: z.ZodObject<{
63
75
  }>>;
64
76
  configFragment: z.ZodOptional<z.ZodBoolean>;
65
77
  configFragmentKey: z.ZodOptional<z.ZodString>;
78
+ configHookEvents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
79
+ configHookFormat: z.ZodOptional<z.ZodEnum<{
80
+ "matcher-groups": "matcher-groups";
81
+ copilot: "copilot";
82
+ }>>;
66
83
  configHookMerge: z.ZodOptional<z.ZodBoolean>;
67
84
  configKey: z.ZodOptional<z.ZodString>;
68
85
  configLockFile: z.ZodOptional<z.ZodString>;
69
86
  configMerge: z.ZodOptional<z.ZodBoolean>;
87
+ disabledListKey: z.ZodOptional<z.ZodString>;
70
88
  enabledListFile: z.ZodOptional<z.ZodString>;
71
89
  enabledListKey: z.ZodOptional<z.ZodString>;
72
90
  entrypointName: z.ZodOptional<z.ZodString>;
73
91
  fileless: z.ZodOptional<z.ZodBoolean>;
92
+ jsonEntrypoint: z.ZodOptional<z.ZodObject<{
93
+ path: z.ZodString;
94
+ }, z.core.$strip>>;
74
95
  nodeEntrypoint: z.ZodOptional<z.ZodObject<{
75
96
  configCommand: z.ZodString;
97
+ configCommandPowershell: z.ZodOptional<z.ZodString>;
76
98
  path: z.ZodString;
77
99
  }, z.core.$strip>>;
78
100
  path: z.ZodString;
@@ -107,6 +129,7 @@ export declare const AdapterSchema: z.ZodObject<{
107
129
  }> & z.core.$partial, z.ZodObject<{
108
130
  configCommand: z.ZodOptional<z.ZodString>;
109
131
  configCommandEntryDefaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
132
+ configCommandPowershell: z.ZodOptional<z.ZodString>;
110
133
  configCommandPrefix: z.ZodOptional<z.ZodString>;
111
134
  configEntryDefaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
112
135
  configFile: z.ZodOptional<z.ZodString>;
@@ -116,16 +139,26 @@ export declare const AdapterSchema: z.ZodObject<{
116
139
  }>>;
117
140
  configFragment: z.ZodOptional<z.ZodBoolean>;
118
141
  configFragmentKey: z.ZodOptional<z.ZodString>;
142
+ configHookEvents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
143
+ configHookFormat: z.ZodOptional<z.ZodEnum<{
144
+ "matcher-groups": "matcher-groups";
145
+ copilot: "copilot";
146
+ }>>;
119
147
  configHookMerge: z.ZodOptional<z.ZodBoolean>;
120
148
  configKey: z.ZodOptional<z.ZodString>;
121
149
  configLockFile: z.ZodOptional<z.ZodString>;
122
150
  configMerge: z.ZodOptional<z.ZodBoolean>;
151
+ disabledListKey: z.ZodOptional<z.ZodString>;
123
152
  enabledListFile: z.ZodOptional<z.ZodString>;
124
153
  enabledListKey: z.ZodOptional<z.ZodString>;
125
154
  entrypointName: z.ZodOptional<z.ZodString>;
126
155
  fileless: z.ZodOptional<z.ZodBoolean>;
156
+ jsonEntrypoint: z.ZodOptional<z.ZodObject<{
157
+ path: z.ZodString;
158
+ }, z.core.$strip>>;
127
159
  nodeEntrypoint: z.ZodOptional<z.ZodObject<{
128
160
  configCommand: z.ZodString;
161
+ configCommandPowershell: z.ZodOptional<z.ZodString>;
129
162
  path: z.ZodString;
130
163
  }, z.core.$strip>>;
131
164
  path: z.ZodString;
@@ -1 +1 @@
1
- {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;iBAiG1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,aAAa;;;;;;iBAyBxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;EAIpB,CAAC;AACJ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG;IACpD;;;;OAIG;IACH,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC,CAAC"}
1
+ {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuI1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,aAAa;;;;;;iBAyBxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;EAIpB,CAAC;AACJ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG;IACpD;;;;OAIG;IACH,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC,CAAC"}
@@ -4,15 +4,19 @@ export const PlacementConfig = z.object({
4
4
  configCommand: z
5
5
  .string()
6
6
  .optional()
7
- .describe('For hook placements: the hook command template (supports {name}, and {path} for the placed path), used instead of configCommandPrefix + the installed script path when the command does not name that path as a prefix would (e.g. "\\"$HOME/.claude/hooks/{name}.sh\\"")'),
7
+ .describe('For hook placements: the hook command template (supports {name}, {path} for the placed path, and {homePath}: at the user scope, "$HOME/" + the placed path, or the path itself when it is absolute), used instead of configCommandPrefix + the installed script path when the command does not name that path as a prefix would (e.g. "\\"$HOME/.claude/hooks/{name}.sh\\"")'),
8
8
  configCommandEntryDefaults: z
9
9
  .record(z.string(), z.unknown())
10
10
  .optional()
11
11
  .describe('For configFragment placements: keys added to each merged entry that has a command (a local stdio server) and lacks them, on top of configEntryDefaults (e.g. {"args": []} for Copilot CLI’s ~/.copilot/mcp-config.json, which refuses the whole file when a local server has no args list)'),
12
+ configCommandPowershell: z
13
+ .string()
14
+ .optional()
15
+ .describe('For "copilot" configHookFormat placements: the template for an entry’s powershell command, which Copilot CLI runs on Windows, with configCommand’s placeholders; without it, powershell gets the bash command. For a .sh hook, so it can find Git Bash itself rather than the bash PowerShell finds first on PATH, which can be WSL’s'),
12
16
  configCommandPrefix: z
13
17
  .string()
14
18
  .optional()
15
- .describe('For hook placements: prefix prepended to the installed script path to form the hook command (e.g. "$CLAUDE_PROJECT_DIR/")'),
19
+ .describe('For hook placements: prefix prepended to the installed script path to form the hook command (e.g. `: "$(exit 0)"; exec "$CLAUDE_PROJECT_DIR"/`: quoted so a path with a space stays one word, and a line PowerShell parses and exits 0 on, since Copilot CLI runs it there on Windows)'),
16
20
  configEntryDefaults: z
17
21
  .record(z.string(), z.unknown())
18
22
  .optional()
@@ -30,6 +34,14 @@ export const PlacementConfig = z.object({
30
34
  .string()
31
35
  .optional()
32
36
  .describe('For configFragment placements: key inside the asset content that holds the entry map when it differs from configKey (e.g. "mcpServers" when configKey is "mcp_servers"). Lookup order: content[configKey], then content[configFragmentKey], then the whole content.'),
37
+ configHookEvents: z
38
+ .record(z.string(), z.string())
39
+ .optional()
40
+ .describe('For configHookMerge placements: the tool’s own name for each hookConfig event (hookConfig uses Claude Code’s, e.g. {"Stop": "agentStop"} for Copilot CLI). When set, an event that is neither a key nor a value here is left out.'),
41
+ configHookFormat: z
42
+ .enum(['matcher-groups', 'copilot'])
43
+ .optional()
44
+ .describe('For configHookMerge placements: the shape of each event’s entries. "matcher-groups" (the default) is Claude Code’s `{ matcher?, hooks: [{ type, command, timeout? }] }`; "copilot" is Copilot CLI’s `{ type, bash, powershell, timeoutSec? }` in a `{ "version": 1, "hooks": … }` file, which takes no matcher'),
33
45
  configHookMerge: z
34
46
  .boolean()
35
47
  .optional()
@@ -43,6 +55,10 @@ export const PlacementConfig = z.object({
43
55
  .boolean()
44
56
  .optional()
45
57
  .describe('When true, merge actual asset content into configFile[configKey] instead of writing a simple marker'),
58
+ disabledListKey: z
59
+ .string()
60
+ .optional()
61
+ .describe('Key of the string array within enabledListFile that lists entry names the user denied (e.g., disabledMcpjsonServers). ATK never adds a name listed there to enabledListKey.'),
46
62
  enabledListFile: z
47
63
  .string()
48
64
  .optional()
@@ -59,11 +75,21 @@ export const PlacementConfig = z.object({
59
75
  .boolean()
60
76
  .optional()
61
77
  .describe('When true, no standalone files are placed. Asset content is only used for config merging.'),
78
+ jsonEntrypoint: z
79
+ .object({
80
+ path: z.string().describe('Placement path template for the entrypoint (supports {name})'),
81
+ })
82
+ .optional()
83
+ .describe('For hook placements: where a hook whose manifest entrypoint is the tool’s own hook config (.json) is placed, as it is, in place of path and with no config merge (e.g. Copilot CLI’s ".github/hooks/{name}.json")'),
62
84
  nodeEntrypoint: z
63
85
  .object({
64
86
  configCommand: z
65
87
  .string()
66
- .describe('The hook command that runs the placed script with node, with no shell syntax, so it runs the same under every shell the tool may use (e.g. cmd on Windows). Supports {name}, and {path}: the placed path, relative to the project or user root, or absolute when a moved user config directory is on another drive (resolve it, do not join it, at the user scope)'),
88
+ .describe('The hook command that runs the placed script with node. Without a configCommandPowershell beside it, use no shell syntax, so it runs the same under every shell the tool may use (e.g. cmd on Windows). Supports {name}, and {path}: the placed path, relative to the project or user root, or absolute when a moved user config directory is on another drive (resolve it, do not join it, at the user scope), and {homePath}, as for the placement’s configCommand, for a tool whose hooks run only under shells that expand $HOME (Copilot CLI’s bash and PowerShell)'),
89
+ configCommandPowershell: z
90
+ .string()
91
+ .optional()
92
+ .describe('For "copilot" configHookFormat placements: the template for an entry’s powershell command, with configCommand’s placeholders, when configCommand has syntax only bash runs; without it, powershell gets configCommand. The placement’s own configCommandPowershell is for its script entrypoint and never applies here'),
67
93
  path: z.string().describe('Placement path template for the entrypoint (supports {name})'),
68
94
  })
69
95
  .optional()
@@ -84,11 +110,11 @@ export const UserConfigDir = z.object({
84
110
  keep: z
85
111
  .array(z.string())
86
112
  .optional()
87
- .describe('User placement paths under `dir/` that stay put while `env` is set, as path prefixes (e.g. [".copilot/hooks/"] for Copilot CLI, whose hooks always read the home directory)'),
113
+ .describe('User placement paths under `dir/` that stay put while `env` is set, as path prefixes (e.g. [".tool/hooks/"] for a tool that reads its hooks from the home directory whatever `env` says)'),
88
114
  subdir: z
89
115
  .string()
90
116
  .optional()
91
- .describe('The tool’s directory inside the path `env` names, when it is not that path itself (e.g. ".copilot" for Copilot CLI’s `$XDG_CONFIG_HOME/.copilot`)'),
117
+ .describe('The tool’s directory inside the path `env` names, when it is not that path itself (e.g. ".tool" for a tool that reads `$XDG_CONFIG_HOME/.tool`)'),
92
118
  });
93
119
  export const ScopeClash = z
94
120
  .enum(['both', 'project', 'user'])
@@ -1 +1 @@
1
- {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/lib/schemas/adapter.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/lib/schemas/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,IAAI,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEvE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,8WAA8W,CAC/W;IACH,0BAA0B,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CACP,4RAA4R,CAC7R;IACH,uBAAuB,EAAE,CAAC;SACvB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uUAAuU,CACxU;IACH,mBAAmB,EAAE,CAAC;SACnB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,wRAAwR,CACzR;IACH,mBAAmB,EAAE,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CACP,qSAAqS,CACtS;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IAC1G,YAAY,EAAE,CAAC;SACZ,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACtB,QAAQ,EAAE;SACV,QAAQ,CACP,0IAA0I,CAC3I;IACH,cAAc,EAAE,CAAC;SACd,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,0PAA0P,CAC3P;IACH,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qQAAqQ,CACtQ;IACH,gBAAgB,EAAE,CAAC;SAChB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC9B,QAAQ,EAAE;SACV,QAAQ,CACP,mOAAmO,CACpO;IACH,gBAAgB,EAAE,CAAC;SAChB,IAAI,CAAC,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;SACnC,QAAQ,EAAE;SACV,QAAQ,CACP,gTAAgT,CACjT;IACH,eAAe,EAAE,CAAC;SACf,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,qMAAqM,CACtM;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACtF,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4OAA4O,CAC7O;IACH,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,qGAAqG,CAAC;IAClH,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6KAA6K,CAC9K;IACH,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,0GAA0G,CAC3G;IACH,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,kHAAkH,CACnH;IACH,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qIAAqI,CACtI;IACH,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,2FAA2F,CAAC;IACxG,cAAc,EAAE,CAAC;SACd,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;KAC1F,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACP,mNAAmN,CACpN;IACH,cAAc,EAAE,CAAC;SACd,MAAM,CAAC;QACN,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,QAAQ,CACP,0iBAA0iB,CAC3iB;QACH,uBAAuB,EAAE,CAAC;aACvB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,wTAAwT,CACzT;QACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;KAC1F,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACP,uOAAuO,CACxO;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;CACrF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CAAC,6FAA6F,CAAC;IAC1G,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CAAC,oGAAoG,CAAC;IACjH,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,uHAAuH,CACxH;IACH,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,0LAA0L,CAC3L;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iJAAiJ,CAClJ;CACJ,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;KACjC,QAAQ,CACP,kMAAkM,CACnM,CAAC;AAGJ,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACvG,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IACnH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC5D,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACvG,UAAU,EAAE,CAAC;SACV,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC;SACpC,QAAQ,EAAE;SACV,QAAQ,CACP,6LAA6L,CAC9L;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAChE,aAAa,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC9C,sMAAsM,CACvM;IACD,cAAc,EAAE,CAAC;SACd,aAAa,CAAC,SAAS,EAAE,eAAe,CAAC;SACzC,QAAQ,EAAE;SACV,QAAQ,CACP,yJAAyJ,CAC1J;CACJ,CAAC,CAAC"}
@@ -0,0 +1,66 @@
1
+ import { ApiCodeError } from './errors.js';
2
+ import { type DistTags } from './update-check.js';
3
+ export declare const UPGRADE_TAGS: readonly ["dev", "latest"];
4
+ export type UpgradeTag = (typeof UPGRADE_TAGS)[number];
5
+ export interface NpmResult {
6
+ /** The exit code, or null when npm was stopped (a timeout) or never started. */
7
+ code: null | number;
8
+ /** stdout and stderr together, for a failure's tail. */
9
+ output: string;
10
+ /** stdout alone, for an answer npm prints there (`npm root --global`). */
11
+ stdout: string;
12
+ }
13
+ /** Every effect `atk upgrade` has, so its order of work is tested without npm (as `conduct upgrade`'s is). */
14
+ export interface UpgradeDeps {
15
+ /** The realpath of the running package's folder. */
16
+ cliPath: string;
17
+ /** The version this process loaded. */
18
+ currentVersion: string;
19
+ /** The installed package's version, read again from disk after the install. */
20
+ installedVersion: () => string;
21
+ npmInstall: (spec: string) => Promise<NpmResult>;
22
+ /** The realpath of `npm root --global`; throws when npm can't be asked. */
23
+ npmRoot: () => Promise<string>;
24
+ offline: boolean;
25
+ platform?: NodeJS.Platform;
26
+ progress: (message: string) => void;
27
+ /** npm's dist-tags read fresh, or null when npm couldn't be read. */
28
+ tagVersions: () => Promise<DistTags | null>;
29
+ }
30
+ export type UpgradeErrorCode = 'downgrade_refused' | 'install_failed' | 'not_npm_global' | 'npm_unreachable' | 'offline' | 'tag_missing';
31
+ export interface UpgradeOptions {
32
+ allowDowngrade?: boolean;
33
+ /** The dist-tag to install from; by default the running CLI's channel. */
34
+ tag?: UpgradeTag;
35
+ }
36
+ export interface UpgradeResult {
37
+ from: string;
38
+ outcome: 'current' | 'downgraded' | 'upgraded';
39
+ tag: UpgradeTag;
40
+ to: string;
41
+ }
42
+ /** Why `atk upgrade` installed nothing, or why its install failed. */
43
+ export declare class UpgradeError extends ApiCodeError {
44
+ code: UpgradeErrorCode;
45
+ name: string;
46
+ constructor(code: UpgradeErrorCode, message: string, options?: {
47
+ command?: string;
48
+ hint?: string;
49
+ });
50
+ }
51
+ /** The real npm, the running package and the update check's npm read. */
52
+ export declare function defaultUpgradeDeps(progress: (message: string) => void): UpgradeDeps;
53
+ /** True when cliPath lies under npm's global node_modules. A linked checkout and npx's cache resolve outside it. */
54
+ export declare function isGlobalInstall(cliPath: string, npmRoot: string, platform?: NodeJS.Platform): boolean;
55
+ /**
56
+ * The realpath of the folder `npm root --global` printed. stdout alone: npm writes its warnings
57
+ * (an unknown .npmrc key, its update notice) to stderr. Throws when npm failed.
58
+ */
59
+ export declare function npmRootOf(result: NpmResult): string;
60
+ /**
61
+ * Install the tag's version over the running CLI. Refuses, before it installs anything: offline,
62
+ * outside an npm global install, a tag npm doesn't have, and a version older than the running one
63
+ * unless allowDowngrade. Does nothing when the tag's version is the running one.
64
+ */
65
+ export declare function upgradeCli(options: UpgradeOptions, deps: UpgradeDeps): Promise<UpgradeResult>;
66
+ //# sourceMappingURL=self-upgrade.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"self-upgrade.d.ts","sourceRoot":"","sources":["../../src/lib/self-upgrade.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,KAAK,QAAQ,EAAqB,MAAM,mBAAmB,CAAC;AAWrE,eAAO,MAAM,YAAY,4BAA6B,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAQvD,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IACpB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8GAA8G;AAC9G,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,MAAM,CAAC;IAC/B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACjD,2EAA2E;IAC3E,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,qEAAqE;IACrE,WAAW,EAAE,MAAM,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,gBAAgB,GAC1B,mBAAmB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,SAAS,GAAG,aAAa,CAAC;AAE5G,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,CAAC;IAC/C,GAAG,EAAE,UAAU,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,sEAAsE;AACtE,qBAAa,YAAa,SAAQ,YAAY;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACtB,IAAI,SAAkB;gBAEnB,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO;CAGvG;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW,CAanF;AAED,oHAAoH;AACpH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAIT;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAKnD;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CA+EnG"}