@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.
- package/LICENSE +21 -0
- package/README.md +29 -2
- package/dist/commands/analyze/compare.d.ts +36 -0
- package/dist/commands/analyze/compare.d.ts.map +1 -0
- package/dist/commands/analyze/compare.js +196 -0
- package/dist/commands/analyze/compare.js.map +1 -0
- package/dist/commands/analyze/compliance.d.ts +41 -0
- package/dist/commands/analyze/compliance.d.ts.map +1 -0
- package/dist/commands/analyze/compliance.js +166 -0
- package/dist/commands/analyze/compliance.js.map +1 -0
- package/dist/commands/analyze/deviations.d.ts +30 -0
- package/dist/commands/analyze/deviations.d.ts.map +1 -0
- package/dist/commands/analyze/deviations.js +201 -0
- package/dist/commands/analyze/deviations.js.map +1 -0
- package/dist/commands/analyze/health.d.ts +211 -0
- package/dist/commands/analyze/health.d.ts.map +1 -0
- package/dist/commands/analyze/health.js +697 -0
- package/dist/commands/analyze/health.js.map +1 -0
- package/dist/commands/analyze/index.d.ts +15 -0
- package/dist/commands/analyze/index.d.ts.map +1 -0
- package/dist/commands/analyze/index.js +31 -0
- package/dist/commands/analyze/index.js.map +1 -0
- package/dist/commands/analyze/snapshot.d.ts +64 -0
- package/dist/commands/analyze/snapshot.d.ts.map +1 -0
- package/dist/commands/analyze/snapshot.js +126 -0
- package/dist/commands/analyze/snapshot.js.map +1 -0
- package/dist/commands/analyze/trends.d.ts +82 -0
- package/dist/commands/analyze/trends.d.ts.map +1 -0
- package/dist/commands/analyze/trends.js +312 -0
- package/dist/commands/analyze/trends.js.map +1 -0
- package/dist/commands/analyze/violations.d.ts +84 -0
- package/dist/commands/analyze/violations.d.ts.map +1 -0
- package/dist/commands/analyze/violations.js +158 -0
- package/dist/commands/analyze/violations.js.map +1 -0
- package/dist/commands/apikeys/check.d.ts +39 -0
- package/dist/commands/apikeys/check.d.ts.map +1 -0
- package/dist/commands/apikeys/check.js +61 -0
- package/dist/commands/apikeys/check.js.map +1 -0
- package/dist/commands/apikeys/create.d.ts +36 -0
- package/dist/commands/apikeys/create.d.ts.map +1 -0
- package/dist/commands/apikeys/create.js +116 -0
- package/dist/commands/apikeys/create.js.map +1 -0
- package/dist/commands/apikeys/index.d.ts +15 -0
- package/dist/commands/apikeys/index.d.ts.map +1 -0
- package/dist/commands/apikeys/index.js +21 -0
- package/dist/commands/apikeys/index.js.map +1 -0
- package/dist/commands/apikeys/keys.d.ts +79 -0
- package/dist/commands/apikeys/keys.d.ts.map +1 -0
- package/dist/commands/apikeys/keys.js +239 -0
- package/dist/commands/apikeys/keys.js.map +1 -0
- package/dist/commands/audit/index.d.ts +11 -0
- package/dist/commands/audit/index.d.ts.map +1 -0
- package/dist/commands/audit/index.js +15 -0
- package/dist/commands/audit/index.js.map +1 -0
- package/dist/commands/audit/list.d.ts +101 -0
- package/dist/commands/audit/list.d.ts.map +1 -0
- package/dist/commands/audit/list.js +230 -0
- package/dist/commands/audit/list.js.map +1 -0
- package/dist/commands/changes/impact.d.ts +477 -0
- package/dist/commands/changes/impact.d.ts.map +1 -0
- package/dist/commands/changes/impact.js +541 -0
- package/dist/commands/changes/impact.js.map +1 -0
- package/dist/commands/changes/index.d.ts +11 -0
- package/dist/commands/changes/index.d.ts.map +1 -0
- package/dist/commands/changes/index.js +15 -0
- package/dist/commands/changes/index.js.map +1 -0
- package/dist/commands/constraints/index.d.ts +11 -0
- package/dist/commands/constraints/index.d.ts.map +1 -0
- package/dist/commands/constraints/index.js +19 -0
- package/dist/commands/constraints/index.js.map +1 -0
- package/dist/commands/constraints/list.d.ts +52 -0
- package/dist/commands/constraints/list.d.ts.map +1 -0
- package/dist/commands/constraints/list.js +103 -0
- package/dist/commands/constraints/list.js.map +1 -0
- package/dist/commands/constraints/set.d.ts +50 -0
- package/dist/commands/constraints/set.d.ts.map +1 -0
- package/dist/commands/constraints/set.js +137 -0
- package/dist/commands/constraints/set.js.map +1 -0
- package/dist/commands/constraints/validate.d.ts +38 -0
- package/dist/commands/constraints/validate.d.ts.map +1 -0
- package/dist/commands/constraints/validate.js +164 -0
- package/dist/commands/constraints/validate.js.map +1 -0
- package/dist/commands/docs/generator.d.ts +77 -0
- package/dist/commands/docs/generator.d.ts.map +1 -0
- package/dist/commands/docs/generator.js +256 -0
- package/dist/commands/docs/generator.js.map +1 -0
- package/dist/commands/docs/index.d.ts +6 -0
- package/dist/commands/docs/index.d.ts.map +1 -0
- package/dist/commands/docs/index.js +6 -0
- package/dist/commands/docs/index.js.map +1 -0
- package/dist/commands/export/export.d.ts +64 -0
- package/dist/commands/export/export.d.ts.map +1 -0
- package/dist/commands/export/export.js +193 -0
- package/dist/commands/export/export.js.map +1 -0
- package/dist/commands/export/index.d.ts +9 -0
- package/dist/commands/export/index.d.ts.map +1 -0
- package/dist/commands/export/index.js +13 -0
- package/dist/commands/export/index.js.map +1 -0
- package/dist/commands/import/flatten.d.ts +30 -0
- package/dist/commands/import/flatten.d.ts.map +1 -0
- package/dist/commands/import/flatten.js +121 -0
- package/dist/commands/import/flatten.js.map +1 -0
- package/dist/commands/import/index.d.ts +11 -0
- package/dist/commands/import/index.d.ts.map +1 -0
- package/dist/commands/import/index.js +19 -0
- package/dist/commands/import/index.js.map +1 -0
- package/dist/commands/import/json.d.ts +40 -0
- package/dist/commands/import/json.d.ts.map +1 -0
- package/dist/commands/import/json.js +209 -0
- package/dist/commands/import/json.js.map +1 -0
- package/dist/commands/import/tree.d.ts +39 -0
- package/dist/commands/import/tree.d.ts.map +1 -0
- package/dist/commands/import/tree.js +247 -0
- package/dist/commands/import/tree.js.map +1 -0
- package/dist/commands/import/validate.d.ts +53 -0
- package/dist/commands/import/validate.d.ts.map +1 -0
- package/dist/commands/import/validate.js +201 -0
- package/dist/commands/import/validate.js.map +1 -0
- package/dist/commands/index.d.ts +21 -0
- package/dist/commands/index.d.ts.map +1 -0
- package/dist/commands/index.js +21 -0
- package/dist/commands/index.js.map +1 -0
- package/dist/commands/json-schema.d.ts +21 -0
- package/dist/commands/json-schema.d.ts.map +1 -0
- package/dist/commands/json-schema.js +41 -0
- package/dist/commands/json-schema.js.map +1 -0
- package/dist/commands/node/create.d.ts +80 -0
- package/dist/commands/node/create.d.ts.map +1 -0
- package/dist/commands/node/create.js +174 -0
- package/dist/commands/node/create.js.map +1 -0
- package/dist/commands/node/delete.d.ts +28 -0
- package/dist/commands/node/delete.d.ts.map +1 -0
- package/dist/commands/node/delete.js +134 -0
- package/dist/commands/node/delete.js.map +1 -0
- package/dist/commands/node/deprecation.d.ts +23 -0
- package/dist/commands/node/deprecation.d.ts.map +1 -0
- package/dist/commands/node/deprecation.js +59 -0
- package/dist/commands/node/deprecation.js.map +1 -0
- package/dist/commands/node/get.d.ts +79 -0
- package/dist/commands/node/get.d.ts.map +1 -0
- package/dist/commands/node/get.js +106 -0
- package/dist/commands/node/get.js.map +1 -0
- package/dist/commands/node/graph.d.ts +138 -0
- package/dist/commands/node/graph.d.ts.map +1 -0
- package/dist/commands/node/graph.js +285 -0
- package/dist/commands/node/graph.js.map +1 -0
- package/dist/commands/node/index.d.ts +17 -0
- package/dist/commands/node/index.d.ts.map +1 -0
- package/dist/commands/node/index.js +31 -0
- package/dist/commands/node/index.js.map +1 -0
- package/dist/commands/node/list.d.ts +74 -0
- package/dist/commands/node/list.d.ts.map +1 -0
- package/dist/commands/node/list.js +130 -0
- package/dist/commands/node/list.js.map +1 -0
- package/dist/commands/node/operations.d.ts +35 -0
- package/dist/commands/node/operations.d.ts.map +1 -0
- package/dist/commands/node/operations.js +66 -0
- package/dist/commands/node/operations.js.map +1 -0
- package/dist/commands/node/scope.d.ts +14 -0
- package/dist/commands/node/scope.d.ts.map +1 -0
- package/dist/commands/node/scope.js +49 -0
- package/dist/commands/node/scope.js.map +1 -0
- package/dist/commands/node/update.d.ts +84 -0
- package/dist/commands/node/update.d.ts.map +1 -0
- package/dist/commands/node/update.js +229 -0
- package/dist/commands/node/update.js.map +1 -0
- package/dist/commands/registry.d.ts +126 -0
- package/dist/commands/registry.d.ts.map +1 -0
- package/dist/commands/registry.js +141 -0
- package/dist/commands/registry.js.map +1 -0
- package/dist/commands/specimen/get.d.ts +47 -0
- package/dist/commands/specimen/get.d.ts.map +1 -0
- package/dist/commands/specimen/get.js +124 -0
- package/dist/commands/specimen/get.js.map +1 -0
- package/dist/commands/specimen/index.d.ts +10 -0
- package/dist/commands/specimen/index.d.ts.map +1 -0
- package/dist/commands/specimen/index.js +16 -0
- package/dist/commands/specimen/index.js.map +1 -0
- package/dist/commands/specimen/set.d.ts +31 -0
- package/dist/commands/specimen/set.d.ts.map +1 -0
- package/dist/commands/specimen/set.js +198 -0
- package/dist/commands/specimen/set.js.map +1 -0
- package/dist/commands/specimen/shared.d.ts +15 -0
- package/dist/commands/specimen/shared.d.ts.map +1 -0
- package/dist/commands/specimen/shared.js +26 -0
- package/dist/commands/specimen/shared.js.map +1 -0
- package/dist/commands/system/doctor.d.ts +48 -0
- package/dist/commands/system/doctor.d.ts.map +1 -0
- package/dist/commands/system/doctor.js +224 -0
- package/dist/commands/system/doctor.js.map +1 -0
- package/dist/commands/system/index.d.ts +12 -0
- package/dist/commands/system/index.d.ts.map +1 -0
- package/dist/commands/system/index.js +17 -0
- package/dist/commands/system/index.js.map +1 -0
- package/dist/commands/system/validate.d.ts +47 -0
- package/dist/commands/system/validate.d.ts.map +1 -0
- package/dist/commands/system/validate.js +245 -0
- package/dist/commands/system/validate.js.map +1 -0
- package/dist/commands/token/add.d.ts +94 -0
- package/dist/commands/token/add.d.ts.map +1 -0
- package/dist/commands/token/add.js +162 -0
- package/dist/commands/token/add.js.map +1 -0
- package/dist/commands/token/catalog.d.ts +69 -0
- package/dist/commands/token/catalog.d.ts.map +1 -0
- package/dist/commands/token/catalog.js +175 -0
- package/dist/commands/token/catalog.js.map +1 -0
- package/dist/commands/token/compare.d.ts +140 -0
- package/dist/commands/token/compare.d.ts.map +1 -0
- package/dist/commands/token/compare.js +207 -0
- package/dist/commands/token/compare.js.map +1 -0
- package/dist/commands/token/copy.d.ts +31 -0
- package/dist/commands/token/copy.d.ts.map +1 -0
- package/dist/commands/token/copy.js +179 -0
- package/dist/commands/token/copy.js.map +1 -0
- package/dist/commands/token/definitions.d.ts +29 -0
- package/dist/commands/token/definitions.d.ts.map +1 -0
- package/dist/commands/token/definitions.js +63 -0
- package/dist/commands/token/definitions.js.map +1 -0
- package/dist/commands/token/index.d.ts +22 -0
- package/dist/commands/token/index.d.ts.map +1 -0
- package/dist/commands/token/index.js +44 -0
- package/dist/commands/token/index.js.map +1 -0
- package/dist/commands/token/lineage.d.ts +43 -0
- package/dist/commands/token/lineage.d.ts.map +1 -0
- package/dist/commands/token/lineage.js +187 -0
- package/dist/commands/token/lineage.js.map +1 -0
- package/dist/commands/token/matrix.d.ts +249 -0
- package/dist/commands/token/matrix.d.ts.map +1 -0
- package/dist/commands/token/matrix.js +658 -0
- package/dist/commands/token/matrix.js.map +1 -0
- package/dist/commands/token/override.d.ts +51 -0
- package/dist/commands/token/override.d.ts.map +1 -0
- package/dist/commands/token/override.js +158 -0
- package/dist/commands/token/override.js.map +1 -0
- package/dist/commands/token/previous-value.d.ts +23 -0
- package/dist/commands/token/previous-value.d.ts.map +1 -0
- package/dist/commands/token/previous-value.js +26 -0
- package/dist/commands/token/previous-value.js.map +1 -0
- package/dist/commands/token/reset.d.ts +29 -0
- package/dist/commands/token/reset.d.ts.map +1 -0
- package/dist/commands/token/reset.js +143 -0
- package/dist/commands/token/reset.js.map +1 -0
- package/dist/commands/token/resolve.d.ts +43 -0
- package/dist/commands/token/resolve.d.ts.map +1 -0
- package/dist/commands/token/resolve.js +136 -0
- package/dist/commands/token/resolve.js.map +1 -0
- package/dist/commands/token/subtract.d.ts +27 -0
- package/dist/commands/token/subtract.d.ts.map +1 -0
- package/dist/commands/token/subtract.js +129 -0
- package/dist/commands/token/subtract.js.map +1 -0
- package/dist/commands/webhooks/delete.d.ts +31 -0
- package/dist/commands/webhooks/delete.d.ts.map +1 -0
- package/dist/commands/webhooks/delete.js +94 -0
- package/dist/commands/webhooks/delete.js.map +1 -0
- package/dist/commands/webhooks/get.d.ts +50 -0
- package/dist/commands/webhooks/get.d.ts.map +1 -0
- package/dist/commands/webhooks/get.js +122 -0
- package/dist/commands/webhooks/get.js.map +1 -0
- package/dist/commands/webhooks/index.d.ts +24 -0
- package/dist/commands/webhooks/index.d.ts.map +1 -0
- package/dist/commands/webhooks/index.js +41 -0
- package/dist/commands/webhooks/index.js.map +1 -0
- package/dist/commands/webhooks/list.d.ts +72 -0
- package/dist/commands/webhooks/list.d.ts.map +1 -0
- package/dist/commands/webhooks/list.js +116 -0
- package/dist/commands/webhooks/list.js.map +1 -0
- package/dist/commands/webhooks/logs.d.ts +65 -0
- package/dist/commands/webhooks/logs.d.ts.map +1 -0
- package/dist/commands/webhooks/logs.js +138 -0
- package/dist/commands/webhooks/logs.js.map +1 -0
- package/dist/commands/webhooks/redact.d.ts +18 -0
- package/dist/commands/webhooks/redact.d.ts.map +1 -0
- package/dist/commands/webhooks/redact.js +24 -0
- package/dist/commands/webhooks/redact.js.map +1 -0
- package/dist/commands/webhooks/register.d.ts +78 -0
- package/dist/commands/webhooks/register.d.ts.map +1 -0
- package/dist/commands/webhooks/register.js +175 -0
- package/dist/commands/webhooks/register.js.map +1 -0
- package/dist/commands/webhooks/test.d.ts +32 -0
- package/dist/commands/webhooks/test.d.ts.map +1 -0
- package/dist/commands/webhooks/test.js +101 -0
- package/dist/commands/webhooks/test.js.map +1 -0
- package/dist/commands/webhooks/update.d.ts +77 -0
- package/dist/commands/webhooks/update.d.ts.map +1 -0
- package/dist/commands/webhooks/update.js +198 -0
- package/dist/commands/webhooks/update.js.map +1 -0
- package/dist/css.d.ts +3 -0
- package/dist/css.d.ts.map +1 -0
- package/dist/css.js +3 -0
- package/dist/css.js.map +1 -0
- package/dist/demo/index.d.ts +8 -0
- package/dist/demo/index.d.ts.map +1 -0
- package/dist/demo/index.js +8 -0
- package/dist/demo/index.js.map +1 -0
- package/dist/demo/realistic-system.d.ts +54 -0
- package/dist/demo/realistic-system.d.ts.map +1 -0
- package/dist/demo/realistic-system.js +919 -0
- package/dist/demo/realistic-system.js.map +1 -0
- package/dist/index.d.ts +21 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +60 -0
- package/dist/index.js.map +1 -0
- package/dist/types/command-result.d.ts +10 -0
- package/dist/types/command-result.d.ts.map +1 -0
- package/dist/types/command-result.js +11 -0
- package/dist/types/command-result.js.map +1 -0
- package/dist/types/index.d.ts +8 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +10 -0
- package/dist/types/index.js.map +1 -0
- package/dist/version.d.ts +3 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +4 -0
- package/dist/version.js.map +1 -0
- package/dist/webhooks/dispatcher.d.ts +147 -0
- package/dist/webhooks/dispatcher.d.ts.map +1 -0
- package/dist/webhooks/dispatcher.js +420 -0
- package/dist/webhooks/dispatcher.js.map +1 -0
- package/dist/webhooks/index.d.ts +9 -0
- package/dist/webhooks/index.d.ts.map +1 -0
- package/dist/webhooks/index.js +9 -0
- package/dist/webhooks/index.js.map +1 -0
- package/dist/webhooks/signer.d.ts +119 -0
- package/dist/webhooks/signer.d.ts.map +1 -0
- package/dist/webhooks/signer.js +149 -0
- package/dist/webhooks/signer.js.map +1 -0
- package/dist/webhooks/url-policy.d.ts +73 -0
- package/dist/webhooks/url-policy.d.ts.map +1 -0
- package/dist/webhooks/url-policy.js +250 -0
- package/dist/webhooks/url-policy.js.map +1 -0
- package/dist/worker.d.ts +11 -0
- package/dist/worker.d.ts.map +1 -0
- package/dist/worker.js +31 -0
- package/dist/worker.js.map +1 -0
- package/package.json +84 -3
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
import { TokenCategorySchema } from '@lushly-dev/violet-core/types';
|
|
2
|
+
import { z } from 'zod';
|
|
3
|
+
import { ErrorCodes, failure, success } from '../../types/command-result.js';
|
|
4
|
+
import { MatrixCellSchema, computeTokenMatrix, } from './matrix.js';
|
|
5
|
+
/** Fewest and most nodes one comparison takes */
|
|
6
|
+
export const MIN_COMPARE_NODES = 2;
|
|
7
|
+
export const MAX_COMPARE_NODES = 4;
|
|
8
|
+
const InputSchema = z.object({
|
|
9
|
+
// Nodes side by side, in order; the first is the baseline each cell is compared with
|
|
10
|
+
nodeIds: z.array(z.string().min(1)).min(MIN_COMPARE_NODES).max(MAX_COMPARE_NODES),
|
|
11
|
+
filter: z.string().optional(), // Glob pattern like "color.*"
|
|
12
|
+
category: TokenCategorySchema.optional(), // Only tokens of this category
|
|
13
|
+
onlyDifferent: z.boolean().optional().default(true), // Leave out tokens equal everywhere
|
|
14
|
+
});
|
|
15
|
+
const CompareCellSchema = MatrixCellSchema.extend({
|
|
16
|
+
/** The value here differs from the baseline (the first node) */
|
|
17
|
+
differs: z.boolean(),
|
|
18
|
+
});
|
|
19
|
+
const OutputSchema = z.object({
|
|
20
|
+
nodes: z.array(z.object({
|
|
21
|
+
id: z.string(),
|
|
22
|
+
name: z.string(),
|
|
23
|
+
type: z.string(),
|
|
24
|
+
depth: z.number(),
|
|
25
|
+
error: z.string().optional(),
|
|
26
|
+
})),
|
|
27
|
+
/** The first node: each cell's `differs` compares with it */
|
|
28
|
+
baseline: z.string(),
|
|
29
|
+
tokens: z.array(z.object({
|
|
30
|
+
id: z.string(),
|
|
31
|
+
category: z.string(),
|
|
32
|
+
tier: z.string(),
|
|
33
|
+
/** Not every node has the same value */
|
|
34
|
+
differs: z.boolean(),
|
|
35
|
+
cells: z.record(z.string(), CompareCellSchema),
|
|
36
|
+
})),
|
|
37
|
+
summary: z.object({
|
|
38
|
+
/** Tokens compared (after filter and category), different or not */
|
|
39
|
+
compared: z.number(),
|
|
40
|
+
different: z.number(),
|
|
41
|
+
identical: z.number(),
|
|
42
|
+
/** Per category, in category order, over every compared token */
|
|
43
|
+
categories: z.array(z.object({ id: z.string(), compared: z.number(), different: z.number() })),
|
|
44
|
+
/** Each pair of nodes: how many tokens differ and the share that match (0–100) */
|
|
45
|
+
pairs: z.array(z.object({
|
|
46
|
+
nodes: z.tuple([z.string(), z.string()]),
|
|
47
|
+
different: z.number(),
|
|
48
|
+
similarity: z.number(),
|
|
49
|
+
})),
|
|
50
|
+
}),
|
|
51
|
+
});
|
|
52
|
+
/**
|
|
53
|
+
* What a cell's value is, for comparing: its value with references followed in
|
|
54
|
+
* that node, or a marker for "no value here". Unresolved nodes are left out.
|
|
55
|
+
*/
|
|
56
|
+
function comparisonKey(cell) {
|
|
57
|
+
if (cell.state === 'unresolved')
|
|
58
|
+
return null;
|
|
59
|
+
if (cell.resolvedValue === undefined)
|
|
60
|
+
return '∅';
|
|
61
|
+
return JSON.stringify(cell.resolvedValue);
|
|
62
|
+
}
|
|
63
|
+
/** The nodes to compare, in order, or why they can't be compared */
|
|
64
|
+
async function loadColumns(context, nodeIds) {
|
|
65
|
+
if (new Set(nodeIds).size !== nodeIds.length) {
|
|
66
|
+
return {
|
|
67
|
+
error: {
|
|
68
|
+
code: ErrorCodes.VALIDATION_ERROR,
|
|
69
|
+
message: 'nodeIds lists a node more than once',
|
|
70
|
+
suggestion: `Pass ${MIN_COMPARE_NODES}–${MAX_COMPARE_NODES} different nodes`,
|
|
71
|
+
},
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
const columns = [];
|
|
75
|
+
for (const nodeId of nodeIds) {
|
|
76
|
+
const node = await context.db.getNode(nodeId);
|
|
77
|
+
if (!node || node.deletedAt) {
|
|
78
|
+
return {
|
|
79
|
+
error: {
|
|
80
|
+
code: ErrorCodes.NODE_NOT_FOUND,
|
|
81
|
+
message: `Node '${nodeId}' not found`,
|
|
82
|
+
suggestion: `Use 'node.list' to see available nodes`,
|
|
83
|
+
},
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
columns.push(node);
|
|
87
|
+
}
|
|
88
|
+
return { columns };
|
|
89
|
+
}
|
|
90
|
+
/** One matrix row compared across `nodeIds`: whether it differs, and each cell against the baseline */
|
|
91
|
+
function compareRow(row, nodeIds) {
|
|
92
|
+
const keys = new Map(nodeIds.map((id) => [id, comparisonKey(row.cells[id])]));
|
|
93
|
+
const known = [...keys.values()].filter((key) => key !== null);
|
|
94
|
+
const baseKey = keys.get(nodeIds[0]) ?? null;
|
|
95
|
+
const cells = {};
|
|
96
|
+
for (const id of nodeIds) {
|
|
97
|
+
const key = keys.get(id) ?? null;
|
|
98
|
+
cells[id] = { ...row.cells[id], differs: key !== null && baseKey !== null && key !== baseKey };
|
|
99
|
+
}
|
|
100
|
+
const differs = new Set(known).size > 1;
|
|
101
|
+
return { row: { id: row.id, category: row.category, tier: row.tier, differs, cells }, keys };
|
|
102
|
+
}
|
|
103
|
+
/** Counts per category and per pair of nodes over every compared row */
|
|
104
|
+
function summarize(compared, nodeIds) {
|
|
105
|
+
const categories = new Map();
|
|
106
|
+
for (const { row } of compared) {
|
|
107
|
+
const category = categories.get(row.category) ?? {
|
|
108
|
+
id: row.category,
|
|
109
|
+
compared: 0,
|
|
110
|
+
different: 0,
|
|
111
|
+
};
|
|
112
|
+
category.compared += 1;
|
|
113
|
+
category.different += row.differs ? 1 : 0;
|
|
114
|
+
categories.set(row.category, category);
|
|
115
|
+
}
|
|
116
|
+
const order = TokenCategorySchema.options;
|
|
117
|
+
const rank = (id) => (order.includes(id) ? order.indexOf(id) : order.length);
|
|
118
|
+
const pairs = nodeIds.flatMap((a, i) => nodeIds.slice(i + 1).map((b) => {
|
|
119
|
+
const both = compared
|
|
120
|
+
.map(({ keys }) => [keys.get(a), keys.get(b)])
|
|
121
|
+
.filter(([x, y]) => x != null && y != null);
|
|
122
|
+
const different = both.filter(([x, y]) => x !== y).length;
|
|
123
|
+
const similarity = both.length === 0 ? 100 : Math.round(((both.length - different) / both.length) * 100);
|
|
124
|
+
return { nodes: [a, b], different, similarity };
|
|
125
|
+
}));
|
|
126
|
+
const different = compared.filter(({ row }) => row.differs).length;
|
|
127
|
+
return {
|
|
128
|
+
compared: compared.length,
|
|
129
|
+
different,
|
|
130
|
+
identical: compared.length - different,
|
|
131
|
+
categories: [...categories.values()].sort((a, b) => rank(a.id) - rank(b.id) || a.id.localeCompare(b.id)),
|
|
132
|
+
pairs,
|
|
133
|
+
};
|
|
134
|
+
}
|
|
135
|
+
/** "3 of 40 token(s) differ across a, b (92% the same)" */
|
|
136
|
+
function describeResult(summary, nodes) {
|
|
137
|
+
const unresolved = nodes.filter((node) => node.error).length;
|
|
138
|
+
const unresolvedNote = unresolved > 0 ? `; ${unresolved} node(s) could not be resolved` : '';
|
|
139
|
+
const closest = [...summary.pairs].sort((a, b) => b.similarity - a.similarity)[0];
|
|
140
|
+
const pairNote = nodes.length > 2 && closest
|
|
141
|
+
? `; closest pair ${closest.nodes.join(' and ')} (${closest.similarity}% the same)`
|
|
142
|
+
: ` (${summary.pairs[0]?.similarity ?? 100}% the same)`;
|
|
143
|
+
const ids = nodes.map((node) => node.id).join(', ');
|
|
144
|
+
return `${summary.different} of ${summary.compared} token(s) differ across ${ids}${pairNote}${unresolvedNote}`;
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* tokens.compare command
|
|
148
|
+
*
|
|
149
|
+
* Put two to four nodes side by side and report, per token, each node's value
|
|
150
|
+
* (references followed), how it got there, and whether it differs from the
|
|
151
|
+
* first node. Answers "why does Xbox dark look different from VS Code dark?"
|
|
152
|
+
* and powers the Specimens compare view.
|
|
153
|
+
*/
|
|
154
|
+
export const tokensCompareCommand = {
|
|
155
|
+
name: 'tokens.compare',
|
|
156
|
+
description: 'Compare 2–4 nodes token by token: each value, how it got there, and what differs from the first node',
|
|
157
|
+
category: 'token',
|
|
158
|
+
inputSchema: InputSchema,
|
|
159
|
+
outputSchema: OutputSchema,
|
|
160
|
+
async handler(rawInput, context) {
|
|
161
|
+
const input = InputSchema.parse(rawInput);
|
|
162
|
+
const loaded = await loadColumns(context, input.nodeIds);
|
|
163
|
+
if ('error' in loaded) {
|
|
164
|
+
return failure(loaded.error);
|
|
165
|
+
}
|
|
166
|
+
const { nodes, rows } = await computeTokenMatrix(context, loaded.columns, {
|
|
167
|
+
filter: input.filter,
|
|
168
|
+
category: input.category,
|
|
169
|
+
});
|
|
170
|
+
const nodeIds = nodes.map((node) => node.id);
|
|
171
|
+
const compared = rows.map((row) => compareRow(row, nodeIds));
|
|
172
|
+
const summary = summarize(compared, nodeIds);
|
|
173
|
+
const tokens = compared
|
|
174
|
+
.map(({ row }) => row)
|
|
175
|
+
.filter((row) => row.differs || !input.onlyDifferent);
|
|
176
|
+
return success({
|
|
177
|
+
nodes: nodes.map(({ id, name, type, depth, error }) => ({
|
|
178
|
+
id,
|
|
179
|
+
name,
|
|
180
|
+
type,
|
|
181
|
+
depth,
|
|
182
|
+
...(error ? { error } : {}),
|
|
183
|
+
})),
|
|
184
|
+
baseline: nodeIds[0],
|
|
185
|
+
tokens,
|
|
186
|
+
summary,
|
|
187
|
+
}, {
|
|
188
|
+
reasoning: describeResult(summary, nodes),
|
|
189
|
+
sources: nodes.map((node) => ({ type: 'node', id: node.id, title: node.name })),
|
|
190
|
+
});
|
|
191
|
+
},
|
|
192
|
+
examples: [
|
|
193
|
+
{
|
|
194
|
+
description: 'What differs between two dark themes',
|
|
195
|
+
input: { nodeIds: ['xbox-dark', 'vscode-dark'] },
|
|
196
|
+
},
|
|
197
|
+
{
|
|
198
|
+
description: 'Spacing tokens across three platforms, equal ones included',
|
|
199
|
+
input: {
|
|
200
|
+
nodeIds: ['xbox-ios', 'xbox-android', 'xbox-web'],
|
|
201
|
+
category: 'spacing',
|
|
202
|
+
onlyDifferent: false,
|
|
203
|
+
},
|
|
204
|
+
},
|
|
205
|
+
],
|
|
206
|
+
};
|
|
207
|
+
//# sourceMappingURL=compare.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../../src/commands/token/compare.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAE7E,OAAO,EAEN,gBAAgB,EAGhB,kBAAkB,GAClB,MAAM,aAAa,CAAC;AAErB,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,qFAAqF;IACrF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACjF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,8BAA8B;IAC7D,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,EAAE,EAAE,+BAA+B;IACzE,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,oCAAoC;CACzF,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,MAAM,CAAC;IACjD,gEAAgE;IAChE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;QACR,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B,CAAC,CACF;IACD,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;QACR,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,wCAAwC;QACxC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC;KAC9C,CAAC,CACF;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,oEAAoE;QACpE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,iEAAiE;QACjE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9F,kFAAkF;QAClF,KAAK,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;YACR,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;SACtB,CAAC,CACF;KACD,CAAC;CACF,CAAC,CAAC;AAMH;;;GAGG;AACH,SAAS,aAAa,CAAC,IAAgB;IACtC,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACjD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAC3C,CAAC;AAID,oEAAoE;AACpE,KAAK,UAAU,WAAW,CACzB,OAAuB,EACvB,OAAiB;IAEjB,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;QAC9C,OAAO;YACN,KAAK,EAAE;gBACN,IAAI,EAAE,UAAU,CAAC,gBAAgB;gBACjC,OAAO,EAAE,qCAAqC;gBAC9C,UAAU,EAAE,QAAQ,iBAAiB,IAAI,iBAAiB,kBAAkB;aAC5E;SACD,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAW,EAAE,CAAC;IAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC7B,OAAO;gBACN,KAAK,EAAE;oBACN,IAAI,EAAE,UAAU,CAAC,cAAc;oBAC/B,OAAO,EAAE,SAAS,MAAM,aAAa;oBACrC,UAAU,EAAE,wCAAwC;iBACpD;aACD,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACpB,CAAC;AAED,uGAAuG;AACvG,SAAS,UAAU,CAClB,GAAc,EACd,OAAiB;IAEjB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC7C,MAAM,KAAK,GAAgC,EAAE,CAAC;IAC9C,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;QACjC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;IAChG,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACxC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC;AAC9F,CAAC;AAED,wEAAwE;AACxE,SAAS,SAAS,CAAC,QAAyC,EAAE,OAAiB;IAC9E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyC,CAAC;IACpE,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI;YAChD,EAAE,EAAE,GAAG,CAAC,QAAQ;YAChB,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,CAAC;SACZ,CAAC;QACF,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC;QACvB,QAAQ,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAA4B,CAAC;IAC/D,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAErF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACtC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,QAAQ;aACnB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC7C,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1D,MAAM,UAAU,GACf,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;QACvF,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAqB,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACrE,CAAC,CAAC,CACF,CAAC;IAEF,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACnE,OAAO;QACN,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,SAAS;QACT,SAAS,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS;QACtC,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACxC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAC7D;QACD,KAAK;KACL,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,SAAS,cAAc,CAAC,OAAgB,EAAE,KAAmB;IAC5D,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAC7D,MAAM,cAAc,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,gCAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7F,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,QAAQ,GACb,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO;QAC1B,CAAC,CAAC,kBAAkB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,aAAa;QACnF,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,IAAI,GAAG,aAAa,CAAC;IAC1D,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,GAAG,OAAO,CAAC,SAAS,OAAO,OAAO,CAAC,QAAQ,2BAA2B,GAAG,GAAG,QAAQ,GAAG,cAAc,EAAE,CAAC;AAChH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAkD;IAClF,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACV,sGAAsG;IACvG,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,YAAY;IAE1B,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAuB;QAC9C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;YACzE,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,QAAQ;aACrB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC;aACrB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAEvD,OAAO,OAAO,CACb;YACC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;gBACvD,EAAE;gBACF,IAAI;gBACJ,IAAI;gBACJ,KAAK;gBACL,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3B,CAAC,CAAC;YACH,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YACpB,MAAM;YACN,OAAO;SACP,EACD;YACC,SAAS,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC;YACzC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;SAC/E,CACD,CAAC;IACH,CAAC;IAED,QAAQ,EAAE;QACT;YACC,WAAW,EAAE,sCAAsC;YACnD,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE;SAChD;QACD;YACC,WAAW,EAAE,4DAA4D;YACzE,KAAK,EAAE;gBACN,OAAO,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,UAAU,CAAC;gBACjD,QAAQ,EAAE,SAAS;gBACnB,aAAa,EAAE,KAAK;aACpB;SACD;KACD;CACD,CAAC"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import type { CommandDefinition } from '../registry.js';
|
|
3
|
+
/**
|
|
4
|
+
* Input schema for token.copy command
|
|
5
|
+
*/
|
|
6
|
+
declare const InputSchema: z.ZodObject<{
|
|
7
|
+
nodeId: z.ZodString;
|
|
8
|
+
tokenId: z.ZodString;
|
|
9
|
+
fromNode: z.ZodString;
|
|
10
|
+
asTokenId: z.ZodOptional<z.ZodString>;
|
|
11
|
+
reason: z.ZodOptional<z.ZodString>;
|
|
12
|
+
}, z.core.$strip>;
|
|
13
|
+
/**
|
|
14
|
+
* Output schema for token.copy command
|
|
15
|
+
*/
|
|
16
|
+
declare const OutputSchema: z.ZodObject<{
|
|
17
|
+
nodeId: z.ZodString;
|
|
18
|
+
tokenId: z.ZodString;
|
|
19
|
+
fromNode: z.ZodString;
|
|
20
|
+
fromTokenId: z.ZodString;
|
|
21
|
+
operationId: z.ZodString;
|
|
22
|
+
}, z.core.$strip>;
|
|
23
|
+
type Output = z.infer<typeof OutputSchema>;
|
|
24
|
+
/**
|
|
25
|
+
* token.copy command
|
|
26
|
+
*
|
|
27
|
+
* Copy a token's value from another node (not necessarily an ancestor).
|
|
28
|
+
*/
|
|
29
|
+
export declare const tokenCopyCommand: CommandDefinition<typeof InputSchema, Output>;
|
|
30
|
+
export {};
|
|
31
|
+
//# sourceMappingURL=copy.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../src/commands/token/copy.ts"],"names":[],"mappings":"AAEA,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;;;;;;iBAMhB,CAAC;AAEH,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,CAAC,OAAO,WAAW,EAAE,MAAM,CAuK1E,CAAC"}
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
import { findDependencyPath, validateTokenId } from '@lushly-dev/violet-core/engine';
|
|
2
|
+
import { nanoid } from 'nanoid';
|
|
3
|
+
import { z } from 'zod';
|
|
4
|
+
import { ErrorCodes, failure, success } from '../../types/command-result.js';
|
|
5
|
+
import { resolvePreviousValue } from './previous-value.js';
|
|
6
|
+
/**
|
|
7
|
+
* Input schema for token.copy command
|
|
8
|
+
*/
|
|
9
|
+
const InputSchema = z.object({
|
|
10
|
+
nodeId: z.string().min(1),
|
|
11
|
+
tokenId: z.string().min(1),
|
|
12
|
+
fromNode: z.string().min(1),
|
|
13
|
+
asTokenId: z.string().optional(), // Rename if copying to a different name
|
|
14
|
+
reason: z.string().optional(),
|
|
15
|
+
});
|
|
16
|
+
/**
|
|
17
|
+
* Output schema for token.copy command
|
|
18
|
+
*/
|
|
19
|
+
const OutputSchema = z.object({
|
|
20
|
+
nodeId: z.string(),
|
|
21
|
+
tokenId: z.string(),
|
|
22
|
+
fromNode: z.string(),
|
|
23
|
+
fromTokenId: z.string(),
|
|
24
|
+
operationId: z.string(),
|
|
25
|
+
});
|
|
26
|
+
/**
|
|
27
|
+
* token.copy command
|
|
28
|
+
*
|
|
29
|
+
* Copy a token's value from another node (not necessarily an ancestor).
|
|
30
|
+
*/
|
|
31
|
+
export const tokenCopyCommand = {
|
|
32
|
+
name: 'token.copy',
|
|
33
|
+
description: "Copy a token's value from another node",
|
|
34
|
+
category: 'token',
|
|
35
|
+
inputSchema: InputSchema,
|
|
36
|
+
outputSchema: OutputSchema,
|
|
37
|
+
async handler(rawInput, context) {
|
|
38
|
+
const { db, actor } = context;
|
|
39
|
+
// Parse input to apply defaults
|
|
40
|
+
const input = InputSchema.parse(rawInput);
|
|
41
|
+
// Reject ids that could reach Object.prototype when exported as object keys
|
|
42
|
+
const tokenIdError = validateTokenId(input.asTokenId || input.tokenId);
|
|
43
|
+
if (tokenIdError) {
|
|
44
|
+
return failure({
|
|
45
|
+
code: ErrorCodes.VALIDATION_ERROR,
|
|
46
|
+
message: tokenIdError,
|
|
47
|
+
suggestion: "Avoid the path segments '__proto__', 'constructor' and 'prototype'",
|
|
48
|
+
});
|
|
49
|
+
}
|
|
50
|
+
// Verify target node exists
|
|
51
|
+
const node = await db.getNode(input.nodeId);
|
|
52
|
+
if (!node) {
|
|
53
|
+
return failure({
|
|
54
|
+
code: ErrorCodes.NODE_NOT_FOUND,
|
|
55
|
+
message: `Node '${input.nodeId}' not found`,
|
|
56
|
+
suggestion: `Use 'node.list' to see available nodes`,
|
|
57
|
+
});
|
|
58
|
+
}
|
|
59
|
+
if (node.deletedAt) {
|
|
60
|
+
return failure({
|
|
61
|
+
code: ErrorCodes.NODE_NOT_FOUND,
|
|
62
|
+
message: `Node '${input.nodeId}' has been deleted`,
|
|
63
|
+
});
|
|
64
|
+
}
|
|
65
|
+
// Verify source node exists
|
|
66
|
+
const sourceNode = await db.getNode(input.fromNode);
|
|
67
|
+
if (!sourceNode) {
|
|
68
|
+
return failure({
|
|
69
|
+
code: ErrorCodes.NODE_NOT_FOUND,
|
|
70
|
+
message: `Source node '${input.fromNode}' not found`,
|
|
71
|
+
suggestion: `Use 'node.list' to see available nodes`,
|
|
72
|
+
});
|
|
73
|
+
}
|
|
74
|
+
if (sourceNode.deletedAt) {
|
|
75
|
+
return failure({
|
|
76
|
+
code: ErrorCodes.NODE_NOT_FOUND,
|
|
77
|
+
message: `Source node '${input.fromNode}' has been deleted`,
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
// A node resolves its copy sources through the same inheritance resolver it
|
|
81
|
+
// is being resolved by, so copying from the node itself (under any token id)
|
|
82
|
+
// is always self-referential.
|
|
83
|
+
if (input.nodeId === input.fromNode) {
|
|
84
|
+
return failure({
|
|
85
|
+
code: ErrorCodes.VALIDATION_ERROR,
|
|
86
|
+
message: `Cannot copy a token from node '${input.nodeId}' to itself`,
|
|
87
|
+
suggestion: 'Choose a different source node, or use token.add/token.override on this node',
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
// Reject copies that would close a loop (e.g. A <- B then B <- A, or copying
|
|
91
|
+
// from a descendant of the target). The source must not depend on the target
|
|
92
|
+
// through parent, include, or existing copy relationships.
|
|
93
|
+
const cyclePath = await findDependencyPath(db, input.fromNode, input.nodeId);
|
|
94
|
+
if (cyclePath) {
|
|
95
|
+
return failure({
|
|
96
|
+
code: ErrorCodes.CIRCULAR_REFERENCE,
|
|
97
|
+
message: `Copying from '${input.fromNode}' to '${input.nodeId}' would create a circular reference`,
|
|
98
|
+
suggestion: `'${input.fromNode}' already depends on '${input.nodeId}' (${cyclePath.join(' -> ')})`,
|
|
99
|
+
});
|
|
100
|
+
}
|
|
101
|
+
const targetTokenId = input.asTokenId || input.tokenId;
|
|
102
|
+
// The value the copy replaces, when the node already had the token (#90)
|
|
103
|
+
const before = await resolvePreviousValue(db, input.nodeId, targetTokenId);
|
|
104
|
+
// Create the operation
|
|
105
|
+
const existingOps = await db.getOperations(input.nodeId);
|
|
106
|
+
const operationId = nanoid();
|
|
107
|
+
const now = new Date().toISOString();
|
|
108
|
+
await db.addOperation({
|
|
109
|
+
id: operationId,
|
|
110
|
+
nodeId: input.nodeId,
|
|
111
|
+
sequence: existingOps.length + 1,
|
|
112
|
+
type: 'copy',
|
|
113
|
+
// For copy operations `tokenId` is the SOURCE token on `fromNode`; the id the
|
|
114
|
+
// value lands under on this node is `asTokenId` (or `tokenId` when not renamed).
|
|
115
|
+
// The resolver looks the source up by `tokenId` and stores it as `asTokenId`.
|
|
116
|
+
tokenId: input.tokenId,
|
|
117
|
+
value: null,
|
|
118
|
+
metadata: null,
|
|
119
|
+
fromNode: input.fromNode,
|
|
120
|
+
asTokenId: input.asTokenId || null,
|
|
121
|
+
toAncestor: null,
|
|
122
|
+
reason: input.reason || null,
|
|
123
|
+
author: actor || null,
|
|
124
|
+
createdAt: now,
|
|
125
|
+
});
|
|
126
|
+
// Log audit event
|
|
127
|
+
await db.addAuditEvent({
|
|
128
|
+
id: nanoid(),
|
|
129
|
+
timestamp: now,
|
|
130
|
+
eventType: 'token_created',
|
|
131
|
+
actor: actor || 'system',
|
|
132
|
+
targetNode: input.nodeId,
|
|
133
|
+
targetToken: targetTokenId,
|
|
134
|
+
oldValue: before.oldValue,
|
|
135
|
+
newValue: JSON.stringify({
|
|
136
|
+
copy: true,
|
|
137
|
+
fromNode: input.fromNode,
|
|
138
|
+
fromTokenId: input.tokenId,
|
|
139
|
+
}),
|
|
140
|
+
metadata: JSON.stringify({ reason: input.reason, ...before.metadata }),
|
|
141
|
+
});
|
|
142
|
+
return success({
|
|
143
|
+
nodeId: input.nodeId,
|
|
144
|
+
tokenId: targetTokenId,
|
|
145
|
+
fromNode: input.fromNode,
|
|
146
|
+
fromTokenId: input.tokenId,
|
|
147
|
+
operationId,
|
|
148
|
+
}, {
|
|
149
|
+
reasoning: `Copied '${input.tokenId}' from '${input.fromNode}' to '${input.nodeId}'${input.asTokenId ? ` as '${input.asTokenId}'` : ''}`,
|
|
150
|
+
sources: [
|
|
151
|
+
{ type: 'node', id: input.nodeId, title: node.name },
|
|
152
|
+
{ type: 'node', id: input.fromNode, title: sourceNode.name },
|
|
153
|
+
{ type: 'token', id: input.tokenId },
|
|
154
|
+
],
|
|
155
|
+
});
|
|
156
|
+
},
|
|
157
|
+
examples: [
|
|
158
|
+
{
|
|
159
|
+
description: 'Copy accent color from VS Code to Azure',
|
|
160
|
+
input: {
|
|
161
|
+
nodeId: 'azure',
|
|
162
|
+
tokenId: 'color.accent.primary',
|
|
163
|
+
fromNode: 'vscode',
|
|
164
|
+
reason: 'Aligning Azure accent with VS Code',
|
|
165
|
+
},
|
|
166
|
+
},
|
|
167
|
+
{
|
|
168
|
+
description: 'Copy and rename',
|
|
169
|
+
input: {
|
|
170
|
+
nodeId: 'xbox',
|
|
171
|
+
tokenId: 'color.brand.primary',
|
|
172
|
+
fromNode: 'global-base',
|
|
173
|
+
asTokenId: 'color.xbox.signature',
|
|
174
|
+
reason: 'Creating Xbox-specific alias',
|
|
175
|
+
},
|
|
176
|
+
},
|
|
177
|
+
],
|
|
178
|
+
};
|
|
179
|
+
//# sourceMappingURL=copy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../src/commands/token/copy.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { OperationRecord } from '@lushly-dev/violet-core/types';
|
|
2
|
+
import { type TokenMetadata } from '@lushly-dev/violet-core/types';
|
|
3
|
+
/** Where and how a token is defined: its `add` operation's node and metadata. */
|
|
4
|
+
export interface TokenDefinitionSite {
|
|
5
|
+
id: string;
|
|
6
|
+
definedAt: string;
|
|
7
|
+
metadata: TokenMetadata;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Token definitions from the `add` operations of the given nodes. Pass nodes
|
|
11
|
+
* root-most first: the first definition of an id wins, matching how the
|
|
12
|
+
* resolver ignores a later `add` of a token that already exists.
|
|
13
|
+
*
|
|
14
|
+
* Tokens created by a copy (the target id did not exist) take the copied
|
|
15
|
+
* token's metadata.
|
|
16
|
+
*/
|
|
17
|
+
export declare function collectDefinitions(nodeIds: string[], opsByNode: Map<string, OperationRecord[]>): Map<string, TokenDefinitionSite>;
|
|
18
|
+
/**
|
|
19
|
+
* Order nodes for `collectDefinitions`: ancestors first, then the main
|
|
20
|
+
* hierarchy, then mixins. A mixin that re-adds a token (e.g. a high-contrast
|
|
21
|
+
* text colour) must not be reported as where that token is defined.
|
|
22
|
+
*/
|
|
23
|
+
export declare function definitionOrder(ancestors: string[], nodes: Array<{
|
|
24
|
+
id: string;
|
|
25
|
+
includes?: string[];
|
|
26
|
+
}>, extra?: string[]): string[];
|
|
27
|
+
/** The token an operation changes on its node (a copy may rename it). */
|
|
28
|
+
export declare function operationTarget(op: OperationRecord): string;
|
|
29
|
+
//# sourceMappingURL=definitions.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/commands/token/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,+BAA+B,CAAC;AAExF,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;CACxB;AAWD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,GACvC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CA2BlC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC9B,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EACjD,KAAK,GAAE,MAAM,EAAO,GAClB,MAAM,EAAE,CAKV;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,EAAE,EAAE,eAAe,GAAG,MAAM,CAE3D"}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { TokenMetadataSchema } from '@lushly-dev/violet-core/types';
|
|
2
|
+
function parseMetadata(raw) {
|
|
3
|
+
if (!raw)
|
|
4
|
+
return TokenMetadataSchema.parse({});
|
|
5
|
+
try {
|
|
6
|
+
return TokenMetadataSchema.parse(JSON.parse(raw));
|
|
7
|
+
}
|
|
8
|
+
catch {
|
|
9
|
+
return TokenMetadataSchema.parse({});
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Token definitions from the `add` operations of the given nodes. Pass nodes
|
|
14
|
+
* root-most first: the first definition of an id wins, matching how the
|
|
15
|
+
* resolver ignores a later `add` of a token that already exists.
|
|
16
|
+
*
|
|
17
|
+
* Tokens created by a copy (the target id did not exist) take the copied
|
|
18
|
+
* token's metadata.
|
|
19
|
+
*/
|
|
20
|
+
export function collectDefinitions(nodeIds, opsByNode) {
|
|
21
|
+
const definitions = new Map();
|
|
22
|
+
for (const nodeId of nodeIds) {
|
|
23
|
+
for (const op of opsByNode.get(nodeId) ?? []) {
|
|
24
|
+
if (op.type === 'add' && !definitions.has(op.tokenId)) {
|
|
25
|
+
definitions.set(op.tokenId, {
|
|
26
|
+
id: op.tokenId,
|
|
27
|
+
definedAt: nodeId,
|
|
28
|
+
metadata: parseMetadata(op.metadata),
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
for (const nodeId of nodeIds) {
|
|
34
|
+
for (const op of opsByNode.get(nodeId) ?? []) {
|
|
35
|
+
const target = op.asTokenId ?? op.tokenId;
|
|
36
|
+
if (op.type === 'copy' && !definitions.has(target)) {
|
|
37
|
+
const source = definitions.get(op.tokenId);
|
|
38
|
+
definitions.set(target, {
|
|
39
|
+
id: target,
|
|
40
|
+
definedAt: nodeId,
|
|
41
|
+
metadata: source?.metadata ?? TokenMetadataSchema.parse({}),
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
return definitions;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Order nodes for `collectDefinitions`: ancestors first, then the main
|
|
50
|
+
* hierarchy, then mixins. A mixin that re-adds a token (e.g. a high-contrast
|
|
51
|
+
* text colour) must not be reported as where that token is defined.
|
|
52
|
+
*/
|
|
53
|
+
export function definitionOrder(ancestors, nodes, extra = []) {
|
|
54
|
+
const mixins = new Set(nodes.flatMap((node) => node.includes ?? []));
|
|
55
|
+
const ids = [...ancestors, ...nodes.map((node) => node.id), ...extra];
|
|
56
|
+
const unique = [...new Set(ids)];
|
|
57
|
+
return [...unique.filter((id) => !mixins.has(id)), ...unique.filter((id) => mixins.has(id))];
|
|
58
|
+
}
|
|
59
|
+
/** The token an operation changes on its node (a copy may rename it). */
|
|
60
|
+
export function operationTarget(op) {
|
|
61
|
+
return op.type === 'copy' && op.asTokenId ? op.asTokenId : op.tokenId;
|
|
62
|
+
}
|
|
63
|
+
//# sourceMappingURL=definitions.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../src/commands/token/definitions.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AASxF,SAAS,aAAa,CAAC,GAAkB;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC;QACJ,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CACjC,OAAiB,EACjB,SAAyC;IAEzC,MAAM,WAAW,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC3D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,IAAI,EAAE,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvD,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE;oBAC3B,EAAE,EAAE,EAAE,CAAC,OAAO;oBACd,SAAS,EAAE,MAAM;oBACjB,QAAQ,EAAE,aAAa,CAAC,EAAE,CAAC,QAAQ,CAAC;iBACpC,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,OAAO,CAAC;YAC1C,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;gBAC3C,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE;oBACvB,EAAE,EAAE,MAAM;oBACV,SAAS,EAAE,MAAM;oBACjB,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;iBAC3D,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC9B,SAAmB,EACnB,KAAiD,EACjD,KAAK,GAAa,EAAE;IAEpB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,EAAmB;IAClD,OAAO,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC;AACvE,CAAC"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Token Commands
|
|
3
|
+
*
|
|
4
|
+
* Commands for managing tokens (add, override, subtract, reset, copy).
|
|
5
|
+
*/
|
|
6
|
+
export * from './add.js';
|
|
7
|
+
export * from './override.js';
|
|
8
|
+
export * from './subtract.js';
|
|
9
|
+
export * from './reset.js';
|
|
10
|
+
export * from './copy.js';
|
|
11
|
+
export * from './resolve.js';
|
|
12
|
+
export * from './lineage.js';
|
|
13
|
+
export * from './matrix.js';
|
|
14
|
+
export * from './compare.js';
|
|
15
|
+
export { ResolutionCache, withResolutionCache } from '@lushly-dev/violet-core/engine';
|
|
16
|
+
export * from './catalog.js';
|
|
17
|
+
export * from './definitions.js';
|
|
18
|
+
/**
|
|
19
|
+
* Register all token commands
|
|
20
|
+
*/
|
|
21
|
+
export declare function registerTokenCommands(): void;
|
|
22
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/token/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACtF,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAcjC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAW5C"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Token Commands
|
|
3
|
+
*
|
|
4
|
+
* Commands for managing tokens (add, override, subtract, reset, copy).
|
|
5
|
+
*/
|
|
6
|
+
export * from './add.js';
|
|
7
|
+
export * from './override.js';
|
|
8
|
+
export * from './subtract.js';
|
|
9
|
+
export * from './reset.js';
|
|
10
|
+
export * from './copy.js';
|
|
11
|
+
export * from './resolve.js';
|
|
12
|
+
export * from './lineage.js';
|
|
13
|
+
export * from './matrix.js';
|
|
14
|
+
export * from './compare.js';
|
|
15
|
+
export { ResolutionCache, withResolutionCache } from '@lushly-dev/violet-core/engine';
|
|
16
|
+
export * from './catalog.js';
|
|
17
|
+
export * from './definitions.js';
|
|
18
|
+
import { registry } from '../registry.js';
|
|
19
|
+
import { tokenAddCommand } from './add.js';
|
|
20
|
+
import { tokensCatalogCommand } from './catalog.js';
|
|
21
|
+
import { tokensCompareCommand } from './compare.js';
|
|
22
|
+
import { tokenCopyCommand } from './copy.js';
|
|
23
|
+
import { tokenLineageCommand } from './lineage.js';
|
|
24
|
+
import { tokensMatrixCommand } from './matrix.js';
|
|
25
|
+
import { tokenOverrideCommand } from './override.js';
|
|
26
|
+
import { tokenResetCommand } from './reset.js';
|
|
27
|
+
import { tokensResolveCommand } from './resolve.js';
|
|
28
|
+
import { tokenSubtractCommand } from './subtract.js';
|
|
29
|
+
/**
|
|
30
|
+
* Register all token commands
|
|
31
|
+
*/
|
|
32
|
+
export function registerTokenCommands() {
|
|
33
|
+
registry.register(tokenAddCommand);
|
|
34
|
+
registry.register(tokenOverrideCommand);
|
|
35
|
+
registry.register(tokenSubtractCommand);
|
|
36
|
+
registry.register(tokenResetCommand);
|
|
37
|
+
registry.register(tokenCopyCommand);
|
|
38
|
+
registry.register(tokensResolveCommand);
|
|
39
|
+
registry.register(tokenLineageCommand);
|
|
40
|
+
registry.register(tokensMatrixCommand);
|
|
41
|
+
registry.register(tokensCompareCommand);
|
|
42
|
+
registry.register(tokensCatalogCommand);
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/token/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACtF,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AACzC,CAAC"}
|