@lushly-dev/violet-afd 0.0.0-stage → 0.3.0-preview.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 (335) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +29 -2
  3. package/dist/commands/analyze/compare.d.ts +36 -0
  4. package/dist/commands/analyze/compare.d.ts.map +1 -0
  5. package/dist/commands/analyze/compare.js +196 -0
  6. package/dist/commands/analyze/compare.js.map +1 -0
  7. package/dist/commands/analyze/compliance.d.ts +41 -0
  8. package/dist/commands/analyze/compliance.d.ts.map +1 -0
  9. package/dist/commands/analyze/compliance.js +166 -0
  10. package/dist/commands/analyze/compliance.js.map +1 -0
  11. package/dist/commands/analyze/deviations.d.ts +30 -0
  12. package/dist/commands/analyze/deviations.d.ts.map +1 -0
  13. package/dist/commands/analyze/deviations.js +201 -0
  14. package/dist/commands/analyze/deviations.js.map +1 -0
  15. package/dist/commands/analyze/health.d.ts +211 -0
  16. package/dist/commands/analyze/health.d.ts.map +1 -0
  17. package/dist/commands/analyze/health.js +697 -0
  18. package/dist/commands/analyze/health.js.map +1 -0
  19. package/dist/commands/analyze/index.d.ts +15 -0
  20. package/dist/commands/analyze/index.d.ts.map +1 -0
  21. package/dist/commands/analyze/index.js +31 -0
  22. package/dist/commands/analyze/index.js.map +1 -0
  23. package/dist/commands/analyze/snapshot.d.ts +64 -0
  24. package/dist/commands/analyze/snapshot.d.ts.map +1 -0
  25. package/dist/commands/analyze/snapshot.js +126 -0
  26. package/dist/commands/analyze/snapshot.js.map +1 -0
  27. package/dist/commands/analyze/trends.d.ts +82 -0
  28. package/dist/commands/analyze/trends.d.ts.map +1 -0
  29. package/dist/commands/analyze/trends.js +312 -0
  30. package/dist/commands/analyze/trends.js.map +1 -0
  31. package/dist/commands/analyze/violations.d.ts +84 -0
  32. package/dist/commands/analyze/violations.d.ts.map +1 -0
  33. package/dist/commands/analyze/violations.js +158 -0
  34. package/dist/commands/analyze/violations.js.map +1 -0
  35. package/dist/commands/apikeys/check.d.ts +39 -0
  36. package/dist/commands/apikeys/check.d.ts.map +1 -0
  37. package/dist/commands/apikeys/check.js +61 -0
  38. package/dist/commands/apikeys/check.js.map +1 -0
  39. package/dist/commands/apikeys/create.d.ts +36 -0
  40. package/dist/commands/apikeys/create.d.ts.map +1 -0
  41. package/dist/commands/apikeys/create.js +116 -0
  42. package/dist/commands/apikeys/create.js.map +1 -0
  43. package/dist/commands/apikeys/index.d.ts +15 -0
  44. package/dist/commands/apikeys/index.d.ts.map +1 -0
  45. package/dist/commands/apikeys/index.js +21 -0
  46. package/dist/commands/apikeys/index.js.map +1 -0
  47. package/dist/commands/apikeys/keys.d.ts +79 -0
  48. package/dist/commands/apikeys/keys.d.ts.map +1 -0
  49. package/dist/commands/apikeys/keys.js +239 -0
  50. package/dist/commands/apikeys/keys.js.map +1 -0
  51. package/dist/commands/audit/index.d.ts +11 -0
  52. package/dist/commands/audit/index.d.ts.map +1 -0
  53. package/dist/commands/audit/index.js +15 -0
  54. package/dist/commands/audit/index.js.map +1 -0
  55. package/dist/commands/audit/list.d.ts +101 -0
  56. package/dist/commands/audit/list.d.ts.map +1 -0
  57. package/dist/commands/audit/list.js +230 -0
  58. package/dist/commands/audit/list.js.map +1 -0
  59. package/dist/commands/changes/impact.d.ts +477 -0
  60. package/dist/commands/changes/impact.d.ts.map +1 -0
  61. package/dist/commands/changes/impact.js +541 -0
  62. package/dist/commands/changes/impact.js.map +1 -0
  63. package/dist/commands/changes/index.d.ts +11 -0
  64. package/dist/commands/changes/index.d.ts.map +1 -0
  65. package/dist/commands/changes/index.js +15 -0
  66. package/dist/commands/changes/index.js.map +1 -0
  67. package/dist/commands/constraints/index.d.ts +11 -0
  68. package/dist/commands/constraints/index.d.ts.map +1 -0
  69. package/dist/commands/constraints/index.js +19 -0
  70. package/dist/commands/constraints/index.js.map +1 -0
  71. package/dist/commands/constraints/list.d.ts +52 -0
  72. package/dist/commands/constraints/list.d.ts.map +1 -0
  73. package/dist/commands/constraints/list.js +103 -0
  74. package/dist/commands/constraints/list.js.map +1 -0
  75. package/dist/commands/constraints/set.d.ts +50 -0
  76. package/dist/commands/constraints/set.d.ts.map +1 -0
  77. package/dist/commands/constraints/set.js +137 -0
  78. package/dist/commands/constraints/set.js.map +1 -0
  79. package/dist/commands/constraints/validate.d.ts +38 -0
  80. package/dist/commands/constraints/validate.d.ts.map +1 -0
  81. package/dist/commands/constraints/validate.js +164 -0
  82. package/dist/commands/constraints/validate.js.map +1 -0
  83. package/dist/commands/docs/generator.d.ts +77 -0
  84. package/dist/commands/docs/generator.d.ts.map +1 -0
  85. package/dist/commands/docs/generator.js +256 -0
  86. package/dist/commands/docs/generator.js.map +1 -0
  87. package/dist/commands/docs/index.d.ts +6 -0
  88. package/dist/commands/docs/index.d.ts.map +1 -0
  89. package/dist/commands/docs/index.js +6 -0
  90. package/dist/commands/docs/index.js.map +1 -0
  91. package/dist/commands/export/export.d.ts +64 -0
  92. package/dist/commands/export/export.d.ts.map +1 -0
  93. package/dist/commands/export/export.js +193 -0
  94. package/dist/commands/export/export.js.map +1 -0
  95. package/dist/commands/export/index.d.ts +9 -0
  96. package/dist/commands/export/index.d.ts.map +1 -0
  97. package/dist/commands/export/index.js +13 -0
  98. package/dist/commands/export/index.js.map +1 -0
  99. package/dist/commands/import/flatten.d.ts +30 -0
  100. package/dist/commands/import/flatten.d.ts.map +1 -0
  101. package/dist/commands/import/flatten.js +121 -0
  102. package/dist/commands/import/flatten.js.map +1 -0
  103. package/dist/commands/import/index.d.ts +11 -0
  104. package/dist/commands/import/index.d.ts.map +1 -0
  105. package/dist/commands/import/index.js +19 -0
  106. package/dist/commands/import/index.js.map +1 -0
  107. package/dist/commands/import/json.d.ts +40 -0
  108. package/dist/commands/import/json.d.ts.map +1 -0
  109. package/dist/commands/import/json.js +209 -0
  110. package/dist/commands/import/json.js.map +1 -0
  111. package/dist/commands/import/tree.d.ts +39 -0
  112. package/dist/commands/import/tree.d.ts.map +1 -0
  113. package/dist/commands/import/tree.js +247 -0
  114. package/dist/commands/import/tree.js.map +1 -0
  115. package/dist/commands/import/validate.d.ts +53 -0
  116. package/dist/commands/import/validate.d.ts.map +1 -0
  117. package/dist/commands/import/validate.js +201 -0
  118. package/dist/commands/import/validate.js.map +1 -0
  119. package/dist/commands/index.d.ts +21 -0
  120. package/dist/commands/index.d.ts.map +1 -0
  121. package/dist/commands/index.js +21 -0
  122. package/dist/commands/index.js.map +1 -0
  123. package/dist/commands/json-schema.d.ts +21 -0
  124. package/dist/commands/json-schema.d.ts.map +1 -0
  125. package/dist/commands/json-schema.js +41 -0
  126. package/dist/commands/json-schema.js.map +1 -0
  127. package/dist/commands/node/create.d.ts +80 -0
  128. package/dist/commands/node/create.d.ts.map +1 -0
  129. package/dist/commands/node/create.js +174 -0
  130. package/dist/commands/node/create.js.map +1 -0
  131. package/dist/commands/node/delete.d.ts +28 -0
  132. package/dist/commands/node/delete.d.ts.map +1 -0
  133. package/dist/commands/node/delete.js +134 -0
  134. package/dist/commands/node/delete.js.map +1 -0
  135. package/dist/commands/node/deprecation.d.ts +23 -0
  136. package/dist/commands/node/deprecation.d.ts.map +1 -0
  137. package/dist/commands/node/deprecation.js +59 -0
  138. package/dist/commands/node/deprecation.js.map +1 -0
  139. package/dist/commands/node/get.d.ts +79 -0
  140. package/dist/commands/node/get.d.ts.map +1 -0
  141. package/dist/commands/node/get.js +106 -0
  142. package/dist/commands/node/get.js.map +1 -0
  143. package/dist/commands/node/graph.d.ts +138 -0
  144. package/dist/commands/node/graph.d.ts.map +1 -0
  145. package/dist/commands/node/graph.js +285 -0
  146. package/dist/commands/node/graph.js.map +1 -0
  147. package/dist/commands/node/index.d.ts +17 -0
  148. package/dist/commands/node/index.d.ts.map +1 -0
  149. package/dist/commands/node/index.js +31 -0
  150. package/dist/commands/node/index.js.map +1 -0
  151. package/dist/commands/node/list.d.ts +74 -0
  152. package/dist/commands/node/list.d.ts.map +1 -0
  153. package/dist/commands/node/list.js +130 -0
  154. package/dist/commands/node/list.js.map +1 -0
  155. package/dist/commands/node/operations.d.ts +35 -0
  156. package/dist/commands/node/operations.d.ts.map +1 -0
  157. package/dist/commands/node/operations.js +66 -0
  158. package/dist/commands/node/operations.js.map +1 -0
  159. package/dist/commands/node/scope.d.ts +14 -0
  160. package/dist/commands/node/scope.d.ts.map +1 -0
  161. package/dist/commands/node/scope.js +49 -0
  162. package/dist/commands/node/scope.js.map +1 -0
  163. package/dist/commands/node/update.d.ts +84 -0
  164. package/dist/commands/node/update.d.ts.map +1 -0
  165. package/dist/commands/node/update.js +229 -0
  166. package/dist/commands/node/update.js.map +1 -0
  167. package/dist/commands/registry.d.ts +126 -0
  168. package/dist/commands/registry.d.ts.map +1 -0
  169. package/dist/commands/registry.js +141 -0
  170. package/dist/commands/registry.js.map +1 -0
  171. package/dist/commands/specimen/get.d.ts +47 -0
  172. package/dist/commands/specimen/get.d.ts.map +1 -0
  173. package/dist/commands/specimen/get.js +124 -0
  174. package/dist/commands/specimen/get.js.map +1 -0
  175. package/dist/commands/specimen/index.d.ts +10 -0
  176. package/dist/commands/specimen/index.d.ts.map +1 -0
  177. package/dist/commands/specimen/index.js +16 -0
  178. package/dist/commands/specimen/index.js.map +1 -0
  179. package/dist/commands/specimen/set.d.ts +31 -0
  180. package/dist/commands/specimen/set.d.ts.map +1 -0
  181. package/dist/commands/specimen/set.js +198 -0
  182. package/dist/commands/specimen/set.js.map +1 -0
  183. package/dist/commands/specimen/shared.d.ts +15 -0
  184. package/dist/commands/specimen/shared.d.ts.map +1 -0
  185. package/dist/commands/specimen/shared.js +26 -0
  186. package/dist/commands/specimen/shared.js.map +1 -0
  187. package/dist/commands/system/doctor.d.ts +48 -0
  188. package/dist/commands/system/doctor.d.ts.map +1 -0
  189. package/dist/commands/system/doctor.js +224 -0
  190. package/dist/commands/system/doctor.js.map +1 -0
  191. package/dist/commands/system/index.d.ts +12 -0
  192. package/dist/commands/system/index.d.ts.map +1 -0
  193. package/dist/commands/system/index.js +17 -0
  194. package/dist/commands/system/index.js.map +1 -0
  195. package/dist/commands/system/validate.d.ts +47 -0
  196. package/dist/commands/system/validate.d.ts.map +1 -0
  197. package/dist/commands/system/validate.js +245 -0
  198. package/dist/commands/system/validate.js.map +1 -0
  199. package/dist/commands/token/add.d.ts +94 -0
  200. package/dist/commands/token/add.d.ts.map +1 -0
  201. package/dist/commands/token/add.js +162 -0
  202. package/dist/commands/token/add.js.map +1 -0
  203. package/dist/commands/token/catalog.d.ts +69 -0
  204. package/dist/commands/token/catalog.d.ts.map +1 -0
  205. package/dist/commands/token/catalog.js +175 -0
  206. package/dist/commands/token/catalog.js.map +1 -0
  207. package/dist/commands/token/compare.d.ts +140 -0
  208. package/dist/commands/token/compare.d.ts.map +1 -0
  209. package/dist/commands/token/compare.js +207 -0
  210. package/dist/commands/token/compare.js.map +1 -0
  211. package/dist/commands/token/copy.d.ts +31 -0
  212. package/dist/commands/token/copy.d.ts.map +1 -0
  213. package/dist/commands/token/copy.js +179 -0
  214. package/dist/commands/token/copy.js.map +1 -0
  215. package/dist/commands/token/definitions.d.ts +29 -0
  216. package/dist/commands/token/definitions.d.ts.map +1 -0
  217. package/dist/commands/token/definitions.js +63 -0
  218. package/dist/commands/token/definitions.js.map +1 -0
  219. package/dist/commands/token/index.d.ts +22 -0
  220. package/dist/commands/token/index.d.ts.map +1 -0
  221. package/dist/commands/token/index.js +44 -0
  222. package/dist/commands/token/index.js.map +1 -0
  223. package/dist/commands/token/lineage.d.ts +43 -0
  224. package/dist/commands/token/lineage.d.ts.map +1 -0
  225. package/dist/commands/token/lineage.js +187 -0
  226. package/dist/commands/token/lineage.js.map +1 -0
  227. package/dist/commands/token/matrix.d.ts +249 -0
  228. package/dist/commands/token/matrix.d.ts.map +1 -0
  229. package/dist/commands/token/matrix.js +658 -0
  230. package/dist/commands/token/matrix.js.map +1 -0
  231. package/dist/commands/token/override.d.ts +51 -0
  232. package/dist/commands/token/override.d.ts.map +1 -0
  233. package/dist/commands/token/override.js +158 -0
  234. package/dist/commands/token/override.js.map +1 -0
  235. package/dist/commands/token/previous-value.d.ts +23 -0
  236. package/dist/commands/token/previous-value.d.ts.map +1 -0
  237. package/dist/commands/token/previous-value.js +26 -0
  238. package/dist/commands/token/previous-value.js.map +1 -0
  239. package/dist/commands/token/reset.d.ts +29 -0
  240. package/dist/commands/token/reset.d.ts.map +1 -0
  241. package/dist/commands/token/reset.js +143 -0
  242. package/dist/commands/token/reset.js.map +1 -0
  243. package/dist/commands/token/resolve.d.ts +43 -0
  244. package/dist/commands/token/resolve.d.ts.map +1 -0
  245. package/dist/commands/token/resolve.js +136 -0
  246. package/dist/commands/token/resolve.js.map +1 -0
  247. package/dist/commands/token/subtract.d.ts +27 -0
  248. package/dist/commands/token/subtract.d.ts.map +1 -0
  249. package/dist/commands/token/subtract.js +129 -0
  250. package/dist/commands/token/subtract.js.map +1 -0
  251. package/dist/commands/webhooks/delete.d.ts +31 -0
  252. package/dist/commands/webhooks/delete.d.ts.map +1 -0
  253. package/dist/commands/webhooks/delete.js +94 -0
  254. package/dist/commands/webhooks/delete.js.map +1 -0
  255. package/dist/commands/webhooks/get.d.ts +50 -0
  256. package/dist/commands/webhooks/get.d.ts.map +1 -0
  257. package/dist/commands/webhooks/get.js +122 -0
  258. package/dist/commands/webhooks/get.js.map +1 -0
  259. package/dist/commands/webhooks/index.d.ts +24 -0
  260. package/dist/commands/webhooks/index.d.ts.map +1 -0
  261. package/dist/commands/webhooks/index.js +41 -0
  262. package/dist/commands/webhooks/index.js.map +1 -0
  263. package/dist/commands/webhooks/list.d.ts +72 -0
  264. package/dist/commands/webhooks/list.d.ts.map +1 -0
  265. package/dist/commands/webhooks/list.js +116 -0
  266. package/dist/commands/webhooks/list.js.map +1 -0
  267. package/dist/commands/webhooks/logs.d.ts +65 -0
  268. package/dist/commands/webhooks/logs.d.ts.map +1 -0
  269. package/dist/commands/webhooks/logs.js +138 -0
  270. package/dist/commands/webhooks/logs.js.map +1 -0
  271. package/dist/commands/webhooks/redact.d.ts +18 -0
  272. package/dist/commands/webhooks/redact.d.ts.map +1 -0
  273. package/dist/commands/webhooks/redact.js +24 -0
  274. package/dist/commands/webhooks/redact.js.map +1 -0
  275. package/dist/commands/webhooks/register.d.ts +78 -0
  276. package/dist/commands/webhooks/register.d.ts.map +1 -0
  277. package/dist/commands/webhooks/register.js +175 -0
  278. package/dist/commands/webhooks/register.js.map +1 -0
  279. package/dist/commands/webhooks/test.d.ts +32 -0
  280. package/dist/commands/webhooks/test.d.ts.map +1 -0
  281. package/dist/commands/webhooks/test.js +101 -0
  282. package/dist/commands/webhooks/test.js.map +1 -0
  283. package/dist/commands/webhooks/update.d.ts +77 -0
  284. package/dist/commands/webhooks/update.d.ts.map +1 -0
  285. package/dist/commands/webhooks/update.js +198 -0
  286. package/dist/commands/webhooks/update.js.map +1 -0
  287. package/dist/css.d.ts +3 -0
  288. package/dist/css.d.ts.map +1 -0
  289. package/dist/css.js +3 -0
  290. package/dist/css.js.map +1 -0
  291. package/dist/demo/index.d.ts +8 -0
  292. package/dist/demo/index.d.ts.map +1 -0
  293. package/dist/demo/index.js +8 -0
  294. package/dist/demo/index.js.map +1 -0
  295. package/dist/demo/realistic-system.d.ts +54 -0
  296. package/dist/demo/realistic-system.d.ts.map +1 -0
  297. package/dist/demo/realistic-system.js +919 -0
  298. package/dist/demo/realistic-system.js.map +1 -0
  299. package/dist/index.d.ts +21 -0
  300. package/dist/index.d.ts.map +1 -0
  301. package/dist/index.js +60 -0
  302. package/dist/index.js.map +1 -0
  303. package/dist/types/command-result.d.ts +10 -0
  304. package/dist/types/command-result.d.ts.map +1 -0
  305. package/dist/types/command-result.js +11 -0
  306. package/dist/types/command-result.js.map +1 -0
  307. package/dist/types/index.d.ts +8 -0
  308. package/dist/types/index.d.ts.map +1 -0
  309. package/dist/types/index.js +10 -0
  310. package/dist/types/index.js.map +1 -0
  311. package/dist/version.d.ts +3 -0
  312. package/dist/version.d.ts.map +1 -0
  313. package/dist/version.js +4 -0
  314. package/dist/version.js.map +1 -0
  315. package/dist/webhooks/dispatcher.d.ts +147 -0
  316. package/dist/webhooks/dispatcher.d.ts.map +1 -0
  317. package/dist/webhooks/dispatcher.js +420 -0
  318. package/dist/webhooks/dispatcher.js.map +1 -0
  319. package/dist/webhooks/index.d.ts +9 -0
  320. package/dist/webhooks/index.d.ts.map +1 -0
  321. package/dist/webhooks/index.js +9 -0
  322. package/dist/webhooks/index.js.map +1 -0
  323. package/dist/webhooks/signer.d.ts +119 -0
  324. package/dist/webhooks/signer.d.ts.map +1 -0
  325. package/dist/webhooks/signer.js +149 -0
  326. package/dist/webhooks/signer.js.map +1 -0
  327. package/dist/webhooks/url-policy.d.ts +73 -0
  328. package/dist/webhooks/url-policy.d.ts.map +1 -0
  329. package/dist/webhooks/url-policy.js +250 -0
  330. package/dist/webhooks/url-policy.js.map +1 -0
  331. package/dist/worker.d.ts +11 -0
  332. package/dist/worker.d.ts.map +1 -0
  333. package/dist/worker.js +31 -0
  334. package/dist/worker.js.map +1 -0
  335. package/package.json +84 -3
@@ -0,0 +1,124 @@
1
+ import { SPECIMEN_COMPONENTS, conventionToken, specimenRoleDeclaration, } from '@lushly-dev/violet-core/css';
2
+ import { InheritanceResolutionError, resolveNodeTokenMap } from '@lushly-dev/violet-core/engine';
3
+ import { SpecimenMapSchema } from '@lushly-dev/violet-core/types';
4
+ import { z } from 'zod';
5
+ import { ErrorCodes, failure, success } from '../../types/command-result.js';
6
+ import { treeRootOf } from './shared.js';
7
+ /**
8
+ * Input schema for specimen.get command
9
+ */
10
+ const InputSchema = z.object({
11
+ nodeId: z.string().min(1), // Any node; the map is read from the root of its tree
12
+ });
13
+ const RoleSchema = z.object({
14
+ role: z.string(),
15
+ /** The token that draws the role on this node */
16
+ tokenId: z.string(),
17
+ /** From the stored map, or the `<component>.<role>` naming convention */
18
+ source: z.enum(['map', 'convention']),
19
+ /** The token resolves on the node */
20
+ resolves: z.boolean(),
21
+ /** Its value passes the role's CSS validator, so the role is drawn */
22
+ valid: z.boolean(),
23
+ /** The resolved value, when it resolves */
24
+ value: z.union([z.string(), z.number()]).optional(),
25
+ });
26
+ /**
27
+ * Output schema for specimen.get command
28
+ */
29
+ const OutputSchema = z.object({
30
+ nodeId: z.string(),
31
+ /** The root of the node's tree, where the map is stored */
32
+ rootId: z.string(),
33
+ /** The stored map; empty when none is stored */
34
+ map: SpecimenMapSchema,
35
+ stored: z.boolean(),
36
+ updatedAt: z.string().nullable(),
37
+ updatedBy: z.string().nullable(),
38
+ /** Every component the Specimens view draws, with each role on this node */
39
+ components: z.array(z.object({
40
+ component: z.string(),
41
+ label: z.string(),
42
+ /** The role the specimen cannot be drawn without */
43
+ required: z.string(),
44
+ /** Drawn on this node: its required role resolves to a valid value */
45
+ drawn: z.boolean(),
46
+ roles: z.array(RoleSchema),
47
+ })),
48
+ });
49
+ /**
50
+ * specimen.get command
51
+ *
52
+ * The specimen role map of a node's tree (#118) and, for each component the
53
+ * Specimens view draws, which token draws each role on the node, whether it
54
+ * resolves there, and whether its value passes the role's CSS validator.
55
+ */
56
+ export const specimenGetCommand = {
57
+ name: 'specimen.get',
58
+ description: "The specimen role map of a node's tree, and which component roles resolve and draw on the node",
59
+ category: 'specimen',
60
+ inputSchema: InputSchema,
61
+ outputSchema: OutputSchema,
62
+ async handler(rawInput, context) {
63
+ const { db } = context;
64
+ const input = InputSchema.parse(rawInput);
65
+ const tree = await treeRootOf(db, input.nodeId);
66
+ if (!tree) {
67
+ return failure({
68
+ code: ErrorCodes.NODE_NOT_FOUND,
69
+ message: `Node '${input.nodeId}' not found`,
70
+ suggestion: `Use 'node.list' to see available nodes`,
71
+ });
72
+ }
73
+ let tokens;
74
+ try {
75
+ tokens = await resolveNodeTokenMap(db, input.nodeId);
76
+ }
77
+ catch (error) {
78
+ if (!(error instanceof InheritanceResolutionError))
79
+ throw error;
80
+ return failure({
81
+ code: ErrorCodes.CIRCULAR_REFERENCE,
82
+ message: `Node '${input.nodeId}' could not be resolved: ${error.message}`,
83
+ suggestion: 'Fix the copy/include cycle, then try again',
84
+ });
85
+ }
86
+ const record = await db.getSpecimenMap(tree.rootId);
87
+ const map = record?.map ?? {};
88
+ const components = Object.entries(SPECIMEN_COMPONENTS).map(([component, specimen]) => {
89
+ const { label, required } = specimen;
90
+ const roles = specimen.roles.map((role) => {
91
+ const mapped = map[component]?.[role];
92
+ const tokenId = mapped ?? conventionToken(component, role);
93
+ const token = tokens.get(tokenId);
94
+ const value = token?.resolvedValue;
95
+ return {
96
+ role,
97
+ tokenId,
98
+ source: mapped ? 'map' : 'convention',
99
+ resolves: Boolean(token),
100
+ valid: value !== undefined && specimenRoleDeclaration(role, value) !== null,
101
+ ...(value !== undefined ? { value } : {}),
102
+ };
103
+ });
104
+ const drawn = roles.some((entry) => entry.role === required && entry.valid);
105
+ return { component, label, required, drawn, roles };
106
+ });
107
+ const drawn = components.filter((entry) => entry.drawn).map((entry) => entry.component);
108
+ return success({
109
+ nodeId: input.nodeId,
110
+ rootId: tree.rootId,
111
+ map,
112
+ stored: Boolean(record),
113
+ updatedAt: record?.updatedAt ?? null,
114
+ updatedBy: record?.updatedBy ?? null,
115
+ components,
116
+ }, {
117
+ reasoning: `${record ? `Stored map on '${tree.rootId}'` : `No stored map on '${tree.rootId}', so the naming convention`}; ${drawn.length > 0 ? `draws ${drawn.join(', ')}` : 'draws no component'} on '${input.nodeId}'`,
118
+ });
119
+ },
120
+ examples: [
121
+ { description: 'Which component roles draw on xbox-dark', input: { nodeId: 'xbox-dark' } },
122
+ ],
123
+ };
124
+ //# sourceMappingURL=get.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/specimen/get.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Specimen Commands
3
+ */
4
+ export * from './get.js';
5
+ export * from './set.js';
6
+ /**
7
+ * Register all specimen commands
8
+ */
9
+ export declare function registerSpecimenCommands(): void;
10
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/specimen/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AAEzB;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Specimen Commands
3
+ */
4
+ import { registry } from '../registry.js';
5
+ import { specimenGetCommand } from './get.js';
6
+ import { specimenSetCommand } from './set.js';
7
+ export * from './get.js';
8
+ export * from './set.js';
9
+ /**
10
+ * Register all specimen commands
11
+ */
12
+ export function registerSpecimenCommands() {
13
+ registry.register(specimenGetCommand);
14
+ registry.register(specimenSetCommand);
15
+ }
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/specimen/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AAEzB;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AACvC,CAAC"}
@@ -0,0 +1,31 @@
1
+ import { z } from 'zod';
2
+ import type { CommandDefinition } from '../registry.js';
3
+ /**
4
+ * Input schema for specimen.set command
5
+ */
6
+ declare const InputSchema: z.ZodObject<{
7
+ nodeId: z.ZodString;
8
+ map: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
9
+ replace: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
10
+ }, z.core.$strip>;
11
+ /**
12
+ * Output schema for specimen.set command
13
+ */
14
+ declare const OutputSchema: z.ZodObject<{
15
+ rootId: z.ZodString;
16
+ map: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>;
17
+ changed: z.ZodArray<z.ZodString>;
18
+ updatedAt: z.ZodNullable<z.ZodString>;
19
+ }, z.core.$strip>;
20
+ type Output = z.infer<typeof OutputSchema>;
21
+ /**
22
+ * specimen.set command
23
+ *
24
+ * Store which token draws each role of each component specimen, for systems
25
+ * whose component tokens are not named `<component>.<role>` (#118). The map is
26
+ * kept once per tree, on its root. Components and roles must be ones the
27
+ * Specimens view draws, and every token must be defined in the tree.
28
+ */
29
+ export declare const specimenSetCommand: CommandDefinition<typeof InputSchema, Output>;
30
+ export {};
31
+ //# sourceMappingURL=set.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/commands/specimen/set.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxE;;GAEG;AACH,QAAA,MAAM,WAAW;;;;iBAMf,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,YAAY;;;;;iBAOhB,CAAC;AAEH,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAwC3C;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,CAAC,OAAO,WAAW,EAAE,MAAM,CAsJ5E,CAAC"}
@@ -0,0 +1,198 @@
1
+ import { SPECIMEN_COMPONENTS, specimenComponentHasRole, specimenRoleDeclaration, } from '@lushly-dev/violet-core/css';
2
+ import { InheritanceResolutionError, resolveNodeTokenMap } from '@lushly-dev/violet-core/engine';
3
+ import { SpecimenMapSchema } from '@lushly-dev/violet-core/types';
4
+ import { nanoid } from 'nanoid';
5
+ import { z } from 'zod';
6
+ import { ErrorCodes, failure, success } from '../../types/command-result.js';
7
+ import { KNOWN_COMPONENTS, treeRootOf, treeTokenIds } from './shared.js';
8
+ /**
9
+ * Input schema for specimen.set command
10
+ */
11
+ const InputSchema = z.object({
12
+ nodeId: z.string().min(1), // Any node; the map is stored on the root of its tree
13
+ /** `{ component: { role: tokenId } }`; a null token removes the role (and an empty component) */
14
+ map: z.record(z.string(), z.record(z.string(), z.string().min(1).nullable())),
15
+ /** Replace the stored map instead of merging into it */
16
+ replace: z.boolean().optional().default(false),
17
+ });
18
+ /**
19
+ * Output schema for specimen.set command
20
+ */
21
+ const OutputSchema = z.object({
22
+ rootId: z.string(),
23
+ /** The map now stored; empty when it was removed */
24
+ map: SpecimenMapSchema,
25
+ /** Roles whose token changed, as `component.role` */
26
+ changed: z.array(z.string()),
27
+ updatedAt: z.string().nullable(),
28
+ });
29
+ const has = (record, key) => Object.hasOwn(record, key);
30
+ /** The stored map with `changes` applied; null entries remove roles */
31
+ function applyChanges(stored, changes, replace) {
32
+ const next = replace ? {} : structuredClone(stored);
33
+ for (const [component, roles] of Object.entries(changes)) {
34
+ const entry = { ...(next[component] ?? {}) };
35
+ for (const [role, tokenId] of Object.entries(roles)) {
36
+ if (tokenId === null)
37
+ delete entry[role];
38
+ else
39
+ entry[role] = tokenId;
40
+ }
41
+ if (Object.keys(entry).length > 0)
42
+ next[component] = entry;
43
+ else
44
+ delete next[component];
45
+ }
46
+ return next;
47
+ }
48
+ /** `component.role` for every role whose token differs between two maps */
49
+ function changedRoles(before, after) {
50
+ const keys = new Set();
51
+ for (const map of [before, after]) {
52
+ for (const [component, roles] of Object.entries(map)) {
53
+ for (const role of Object.keys(roles))
54
+ keys.add(`${component}.${role}`);
55
+ }
56
+ }
57
+ return [...keys]
58
+ .filter((key) => {
59
+ const [component, ...rest] = key.split('.');
60
+ const role = rest.join('.');
61
+ return before[component]?.[role] !== after[component]?.[role];
62
+ })
63
+ .sort();
64
+ }
65
+ /**
66
+ * specimen.set command
67
+ *
68
+ * Store which token draws each role of each component specimen, for systems
69
+ * whose component tokens are not named `<component>.<role>` (#118). The map is
70
+ * kept once per tree, on its root. Components and roles must be ones the
71
+ * Specimens view draws, and every token must be defined in the tree.
72
+ */
73
+ export const specimenSetCommand = {
74
+ name: 'specimen.set',
75
+ description: "Store which tokens draw each component specimen's roles, on the root of a node's tree",
76
+ category: 'specimen',
77
+ inputSchema: InputSchema,
78
+ outputSchema: OutputSchema,
79
+ async handler(rawInput, context) {
80
+ const { db, actor } = context;
81
+ const input = InputSchema.parse(rawInput);
82
+ const tree = await treeRootOf(db, input.nodeId);
83
+ if (!tree) {
84
+ return failure({
85
+ code: ErrorCodes.NODE_NOT_FOUND,
86
+ message: `Node '${input.nodeId}' not found`,
87
+ suggestion: `Use 'node.list' to see available nodes`,
88
+ });
89
+ }
90
+ const unknownComponents = Object.keys(input.map).filter((component) => !has(SPECIMEN_COMPONENTS, component));
91
+ if (unknownComponents.length > 0) {
92
+ return failure({
93
+ code: ErrorCodes.VALIDATION_ERROR,
94
+ message: `Unknown component(s): ${unknownComponents.join(', ')}`,
95
+ suggestion: `Map one of: ${KNOWN_COMPONENTS.join(', ')}`,
96
+ });
97
+ }
98
+ const unknownRoles = Object.entries(input.map).flatMap(([component, roles]) => Object.keys(roles)
99
+ .filter((role) => !specimenComponentHasRole(component, role))
100
+ .map((role) => ({ component, role })));
101
+ if (unknownRoles.length > 0) {
102
+ const components = [...new Set(unknownRoles.map(({ component }) => component))];
103
+ return failure({
104
+ code: ErrorCodes.VALIDATION_ERROR,
105
+ message: `Role(s) the component does not take: ${unknownRoles.map(({ component, role }) => `${component}.${role}`).join(', ')}`,
106
+ suggestion: components
107
+ .map((component) => `${component} roles are: ${SPECIMEN_COMPONENTS[component].roles.join(', ')}`)
108
+ .join('; '),
109
+ });
110
+ }
111
+ const known = await treeTokenIds(db, tree.rootId);
112
+ const unknownTokens = Object.entries(input.map).flatMap(([component, roles]) => Object.entries(roles)
113
+ .filter(([, tokenId]) => tokenId !== null && !known.has(tokenId))
114
+ .map(([role, tokenId]) => `${component}.${role} → ${tokenId}`));
115
+ if (unknownTokens.length > 0) {
116
+ return failure({
117
+ code: ErrorCodes.TOKEN_NOT_FOUND,
118
+ message: `No token with these ids in the '${tree.rootId}' tree: ${unknownTokens.join(', ')}`,
119
+ suggestion: `Use 'tokens.catalog' to find the token ids defined in the tree`,
120
+ });
121
+ }
122
+ const stored = await db.getSpecimenMap(tree.rootId);
123
+ const before = stored?.map ?? {};
124
+ const after = applyChanges(before, input.map, input.replace);
125
+ const changed = changedRoles(before, after);
126
+ if (changed.length === 0) {
127
+ return success({ rootId: tree.rootId, map: before, changed, updatedAt: stored?.updatedAt ?? null }, { reasoning: 'No changes to the specimen map' });
128
+ }
129
+ // A mapped value that fails its validator on the root is drawn nowhere it is inherited
130
+ const warnings = [];
131
+ try {
132
+ const tokens = await resolveNodeTokenMap(db, tree.rootId);
133
+ for (const [component, roles] of Object.entries(after)) {
134
+ for (const [role, tokenId] of Object.entries(roles)) {
135
+ const token = tokens.get(tokenId);
136
+ if (token && specimenRoleDeclaration(role, token.resolvedValue) === null) {
137
+ warnings.push({
138
+ code: 'ROLE_VALUE_INVALID',
139
+ message: `${tokenId} (${String(token.resolvedValue)}) is not a valid ${role} on '${tree.rootId}', so ${component}.${role} is not drawn there`,
140
+ severity: 'warning',
141
+ details: { component, role, tokenId },
142
+ });
143
+ }
144
+ }
145
+ }
146
+ }
147
+ catch (error) {
148
+ if (!(error instanceof InheritanceResolutionError))
149
+ throw error;
150
+ }
151
+ const now = new Date().toISOString();
152
+ const empty = Object.keys(after).length === 0;
153
+ await db.setSpecimenMap(tree.rootId, empty ? null : { rootId: tree.rootId, map: after, updatedAt: now, updatedBy: actor ?? null });
154
+ await db.addAuditEvent({
155
+ id: nanoid(),
156
+ timestamp: now,
157
+ eventType: 'specimen_map_updated',
158
+ actor: actor || 'system',
159
+ targetNode: tree.rootId,
160
+ targetToken: null,
161
+ oldValue: stored ? JSON.stringify(before) : null,
162
+ newValue: empty ? null : JSON.stringify(after),
163
+ metadata: JSON.stringify({ changed }),
164
+ });
165
+ return success({ rootId: tree.rootId, map: after, changed, updatedAt: empty ? null : now }, {
166
+ reasoning: empty
167
+ ? `Removed the specimen map from '${tree.rootId}'; specimens use the naming convention`
168
+ : `Stored the specimen map on '${tree.rootId}': ${changed.length} role(s) changed`,
169
+ sources: [{ type: 'node', id: tree.rootId, title: tree.rootId }],
170
+ ...(warnings.length > 0 ? { warnings } : {}),
171
+ });
172
+ },
173
+ examples: [
174
+ {
175
+ description: 'Draw the button from tokens named btn.*',
176
+ input: {
177
+ nodeId: 'global',
178
+ map: { button: { background: 'btn.bg', foreground: 'btn.fg', radius: 'btn.corner' } },
179
+ },
180
+ },
181
+ {
182
+ description: 'Draw the focus ring from tokens named focus-indicator.*',
183
+ input: {
184
+ nodeId: 'global',
185
+ map: { focus: { ring: 'focus-indicator.color', 'ring.width': 'focus-indicator.width' } },
186
+ },
187
+ },
188
+ {
189
+ description: 'Go back to the naming convention for the button border',
190
+ input: { nodeId: 'global', map: { button: { border: null } } },
191
+ },
192
+ {
193
+ description: 'Remove the whole map',
194
+ input: { nodeId: 'global', map: {}, replace: true },
195
+ },
196
+ ],
197
+ };
198
+ //# sourceMappingURL=set.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"set.js","sourceRoot":"","sources":["../../../src/commands/specimen/set.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import type { Node } from '@lushly-dev/violet-core/types';
2
+ import type { Database } from '../registry.js';
3
+ /** A live node and the root of its tree, where the specimen map is stored */
4
+ export declare function treeRootOf(db: Database, nodeId: string): Promise<{
5
+ node: Node;
6
+ rootId: string;
7
+ } | null>;
8
+ /**
9
+ * Every token id defined in a tree: added or copied by one of its nodes or by
10
+ * a node they mix in. A map may point at any of them.
11
+ */
12
+ export declare function treeTokenIds(db: Database, rootId: string): Promise<Set<string>>;
13
+ /** Known components, for error suggestions */
14
+ export declare const KNOWN_COMPONENTS: string[];
15
+ //# sourceMappingURL=shared.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/specimen/shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAmB,MAAM,+BAA+B,CAAC;AAE3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,6EAA6E;AAC7E,wBAAsB,UAAU,CAC/B,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAKhD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAMrF;AAED,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB,UAAmC,CAAC"}
@@ -0,0 +1,26 @@
1
+ import { SPECIMEN_COMPONENTS } from '@lushly-dev/violet-core/css';
2
+ import { selectSubtree } from '../node/scope.js';
3
+ import { collectDefinitions } from '../token/definitions.js';
4
+ /** A live node and the root of its tree, where the specimen map is stored */
5
+ export async function treeRootOf(db, nodeId) {
6
+ const node = await db.getNode(nodeId);
7
+ if (!node || node.deletedAt)
8
+ return null;
9
+ const chain = await db.getAncestryChain(nodeId);
10
+ return { node, rootId: chain[0] ?? nodeId };
11
+ }
12
+ /**
13
+ * Every token id defined in a tree: added or copied by one of its nodes or by
14
+ * a node they mix in. A map may point at any of them.
15
+ */
16
+ export async function treeTokenIds(db, rootId) {
17
+ const nodes = (await selectSubtree(db, rootId)) ?? [];
18
+ const ids = [...new Set([...nodes.map((node) => node.id), ...nodes.flatMap((n) => n.includes)])];
19
+ const opsByNode = new Map();
20
+ for (const id of ids)
21
+ opsByNode.set(id, await db.getOperations(id));
22
+ return new Set(collectDefinitions(ids, opsByNode).keys());
23
+ }
24
+ /** Known components, for error suggestions */
25
+ export const KNOWN_COMPONENTS = Object.keys(SPECIMEN_COMPONENTS);
26
+ //# sourceMappingURL=shared.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/specimen/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,EAAY,EACZ,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAY,EAAE,MAAc;IAC9D,MAAM,KAAK,GAAG,CAAC,MAAM,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACjG,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IACvD,KAAK,MAAM,EAAE,IAAI,GAAG;QAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;IACpE,OAAO,IAAI,GAAG,CAAC,kBAAkB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,8CAA8C;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC"}
@@ -0,0 +1,48 @@
1
+ import { z } from 'zod';
2
+ import { type CommandDefinition } from '../registry.js';
3
+ /**
4
+ * Doctor command input schema
5
+ */
6
+ declare const DoctorInputSchema: z.ZodObject<{
7
+ verbose: z.ZodDefault<z.ZodBoolean>;
8
+ }, z.core.$strip>;
9
+ /**
10
+ * Doctor command output
11
+ */
12
+ declare const DoctorOutputSchema: z.ZodObject<{
13
+ healthy: z.ZodBoolean;
14
+ checks: z.ZodArray<z.ZodObject<{
15
+ name: z.ZodString;
16
+ status: z.ZodEnum<{
17
+ fail: "fail";
18
+ pass: "pass";
19
+ warn: "warn";
20
+ }>;
21
+ message: z.ZodString;
22
+ detail: z.ZodOptional<z.ZodString>;
23
+ }, z.core.$strip>>;
24
+ summary: z.ZodObject<{
25
+ passed: z.ZodNumber;
26
+ warnings: z.ZodNumber;
27
+ failed: z.ZodNumber;
28
+ total: z.ZodNumber;
29
+ }, z.core.$strip>;
30
+ environment: z.ZodOptional<z.ZodObject<{
31
+ nodeVersion: z.ZodString;
32
+ platform: z.ZodString;
33
+ arch: z.ZodString;
34
+ cwd: z.ZodString;
35
+ packageVersion: z.ZodString;
36
+ }, z.core.$strip>>;
37
+ }, z.core.$strip>;
38
+ type DoctorOutput = z.infer<typeof DoctorOutputSchema>;
39
+ /**
40
+ * Doctor command definition
41
+ */
42
+ export declare const doctorCommand: CommandDefinition<typeof DoctorInputSchema, DoctorOutput>;
43
+ /**
44
+ * Register system commands
45
+ */
46
+ export declare function registerSystemCommands(): void;
47
+ export {};
48
+ //# sourceMappingURL=doctor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/commands/system/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAuB,KAAK,iBAAiB,EAAY,MAAM,gBAAgB,CAAC;AA2BvF;;GAEG;AACH,QAAA,MAAM,iBAAiB;;iBAErB,CAAC;AAIH;;GAEG;AACH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;iBAUtB,CAAC;AAEH,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AA+KvD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,iBAAiB,CAAC,OAAO,iBAAiB,EAAE,YAAY,CAiBnF,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}