@greenharness/greenrack-cli 0.0.0-reserved → 7.0.0
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/README.md +334 -1
- package/agents/design-system-lookup.md +59 -0
- package/dist/bin.d.ts +3 -0
- package/dist/bin.d.ts.map +1 -0
- package/dist/bin.js +145 -0
- package/dist/bin.js.map +1 -0
- package/dist/catalog.d.ts +13 -0
- package/dist/catalog.d.ts.map +1 -0
- package/dist/catalog.js +67 -0
- package/dist/catalog.js.map +1 -0
- package/dist/commands/context.d.ts +17 -0
- package/dist/commands/context.d.ts.map +1 -0
- package/dist/commands/context.js +110 -0
- package/dist/commands/context.js.map +1 -0
- package/dist/commands/doctor.d.ts +75 -0
- package/dist/commands/doctor.d.ts.map +1 -0
- package/dist/commands/doctor.js +1008 -0
- package/dist/commands/doctor.js.map +1 -0
- package/dist/commands/hook.d.ts +10 -0
- package/dist/commands/hook.d.ts.map +1 -0
- package/dist/commands/hook.js +323 -0
- package/dist/commands/hook.js.map +1 -0
- package/dist/commands/list.d.ts +4 -0
- package/dist/commands/list.d.ts.map +1 -0
- package/dist/commands/list.js +59 -0
- package/dist/commands/list.js.map +1 -0
- package/dist/commands/lookup.d.ts +13 -0
- package/dist/commands/lookup.d.ts.map +1 -0
- package/dist/commands/lookup.js +66 -0
- package/dist/commands/lookup.js.map +1 -0
- package/dist/commands/manifest.d.ts +5 -0
- package/dist/commands/manifest.d.ts.map +1 -0
- package/dist/commands/manifest.js +33 -0
- package/dist/commands/manifest.js.map +1 -0
- package/dist/commands/mcp.d.ts +159 -0
- package/dist/commands/mcp.d.ts.map +1 -0
- package/dist/commands/mcp.js +235 -0
- package/dist/commands/mcp.js.map +1 -0
- package/dist/commands/mockup.d.ts +80 -0
- package/dist/commands/mockup.d.ts.map +1 -0
- package/dist/commands/mockup.js +714 -0
- package/dist/commands/mockup.js.map +1 -0
- package/dist/commands/skill.d.ts +15 -0
- package/dist/commands/skill.d.ts.map +1 -0
- package/dist/commands/skill.js +398 -0
- package/dist/commands/skill.js.map +1 -0
- package/dist/disambiguation.d.ts +24 -0
- package/dist/disambiguation.d.ts.map +1 -0
- package/dist/disambiguation.js +56 -0
- package/dist/disambiguation.js.map +1 -0
- package/dist/extension-pointer.d.ts +7 -0
- package/dist/extension-pointer.d.ts.map +1 -0
- package/dist/extension-pointer.js +30 -0
- package/dist/extension-pointer.js.map +1 -0
- package/dist/format.d.ts +19 -0
- package/dist/format.d.ts.map +1 -0
- package/dist/format.js +213 -0
- package/dist/format.js.map +1 -0
- package/dist/hook-script.d.ts +73 -0
- package/dist/hook-script.d.ts.map +1 -0
- package/dist/hook-script.js +165 -0
- package/dist/hook-script.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +6 -0
- package/dist/index.js.map +1 -0
- package/dist/legacy-names.d.ts +26 -0
- package/dist/legacy-names.d.ts.map +1 -0
- package/dist/legacy-names.js +26 -0
- package/dist/legacy-names.js.map +1 -0
- package/dist/manifest.d.ts +51 -0
- package/dist/manifest.d.ts.map +1 -0
- package/dist/manifest.js +229 -0
- package/dist/manifest.js.map +1 -0
- package/dist/registry-types.d.ts +106 -0
- package/dist/registry-types.d.ts.map +1 -0
- package/dist/registry-types.js +2 -0
- package/dist/registry-types.js.map +1 -0
- package/dist/registry.d.ts +52 -0
- package/dist/registry.d.ts.map +1 -0
- package/dist/registry.js +95 -0
- package/dist/registry.js.map +1 -0
- package/dist/scan.d.ts +19 -0
- package/dist/scan.d.ts.map +1 -0
- package/dist/scan.js +29 -0
- package/dist/scan.js.map +1 -0
- package/dist/search.d.ts +16 -0
- package/dist/search.d.ts.map +1 -0
- package/dist/search.js +75 -0
- package/dist/search.js.map +1 -0
- package/dist/skill-template.d.ts +24 -0
- package/dist/skill-template.d.ts.map +1 -0
- package/dist/skill-template.js +140 -0
- package/dist/skill-template.js.map +1 -0
- package/greenharness.toml +38 -0
- package/package.json +76 -4
- package/registry.json +12893 -0
- package/skills/colors/LICENSE +21 -0
- package/skills/colors/NOTICE.md +36 -0
- package/skills/colors/SKILL.md +101 -0
- package/skills/colors/color-formats.md +90 -0
- package/skills/colors/color-usage.md +109 -0
- package/skills/colors/contrast.md +70 -0
- package/skills/colors/palette-generation.md +108 -0
- package/skills/colors/palette-structure.md +72 -0
- package/skills/colors/token-naming.md +99 -0
- package/skills/greenrack-mockup/SKILL.md +115 -0
- package/skills/typography/LICENSE +21 -0
- package/skills/typography/NOTICE.md +36 -0
- package/skills/typography/SKILL.md +171 -0
- package/skills/typography/choosing-fonts.md +53 -0
- package/skills/typography/css-cheat-sheet.md +67 -0
- package/skills/typography/details-and-accessibility.md +84 -0
- package/skills/typography/spacing-and-sizing.md +87 -0
- package/skills/typography/variable-fonts-and-opentype.md +100 -0
- package/skills/typography/wrapping-and-punctuation.md +23 -0
- package/skills/ui/LICENSE +21 -0
- package/skills/ui/NOTICE.md +38 -0
- package/skills/ui/SKILL.md +141 -0
- package/skills/ui/animations.md +170 -0
- package/skills/ui/enter-exit.md +157 -0
- package/skills/ui/icon-transitions.md +72 -0
- package/skills/ui/icons.md +105 -0
- package/skills/ui/performance.md +63 -0
- package/skills/ui/surfaces.md +166 -0
package/dist/catalog.js
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import { runList } from './commands/list.js';
|
|
2
|
+
import { relatedPairs } from './disambiguation.js';
|
|
3
|
+
import { renderPairs } from './format.js';
|
|
4
|
+
// Injected into agent context by a Claude Code SessionStart hook. The point
|
|
5
|
+
// is to turn "consult the design system before building UI" from a remembered
|
|
6
|
+
// step into ambient context: with the catalog already in front of it, an
|
|
7
|
+
// agent has nothing to remember and no excuse to hand-roll a widget the
|
|
8
|
+
// design system ships.
|
|
9
|
+
export const PREAMBLE = [
|
|
10
|
+
'greenrack design-system session bootstrap (greenrack context).',
|
|
11
|
+
'The catalog below is already in your context — before hand-rolling ANY',
|
|
12
|
+
'interactive element (menu, badge, tag, dialog, select, tooltip, ...),',
|
|
13
|
+
'pick the design-system component or recipe from this list. When two of',
|
|
14
|
+
'them could both fit, the neighbors section decides; the compose section',
|
|
15
|
+
'says what already wraps what, so you never rebuild it. Details:',
|
|
16
|
+
'greenrack <Component> (props+usage) · greenrack <recipe> --source-only ·',
|
|
17
|
+
'greenrack spacing|icons|rules.',
|
|
18
|
+
'A new screen, page or UI proposal starts with the /greenrack-mockup skill',
|
|
19
|
+
'(greenrack skill install if this repo lacks it; it also installs the colors,',
|
|
20
|
+
'typography and ui interface skills): token-seeded artboards, checked,',
|
|
21
|
+
'then implemented from their component map.',
|
|
22
|
+
].join('\n');
|
|
23
|
+
/** One index line: the guides are fetched by name, never listed in the catalog. */
|
|
24
|
+
function renderGuideIndex(registry) {
|
|
25
|
+
const skills = Object.keys(registry.guides ?? {});
|
|
26
|
+
if (skills.length === 0)
|
|
27
|
+
return '';
|
|
28
|
+
return `GUIDES: ${skills.map((skill) => `guide:${skill}`).join(' · ')} — interface rules, read with greenrack_lookup or greenrack guide:<name>`;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Recipes are in the index too, but buried under 65 components. A screen
|
|
32
|
+
* starts from one of these before any grid is hand-rolled, so they lead.
|
|
33
|
+
*/
|
|
34
|
+
function renderScreens(registry) {
|
|
35
|
+
const entries = Object.entries(registry.recipes).sort(([a], [b]) => a.localeCompare(b));
|
|
36
|
+
if (entries.length === 0)
|
|
37
|
+
return '';
|
|
38
|
+
const width = Math.max(...entries.map(([name]) => name.length)) + 2;
|
|
39
|
+
const rows = entries.map(([name, entry]) => ` ${name.padEnd(width)}${entry.meta.description}`);
|
|
40
|
+
return [
|
|
41
|
+
`SCREENS — START FROM A RECIPE (${entries.length})`,
|
|
42
|
+
'A new screen copies the closest recipe (greenrack <recipe> --source-only) and',
|
|
43
|
+
'edits it; a hand-rolled page layout needs a reason in the PR.',
|
|
44
|
+
...rows,
|
|
45
|
+
].join('\n');
|
|
46
|
+
}
|
|
47
|
+
/** The catalog session context: preamble, screens, index, guides, neighbour tables. */
|
|
48
|
+
export function renderCatalog(registry) {
|
|
49
|
+
const list = runList(registry);
|
|
50
|
+
// The index says what exists; the guard says which one is wrong. Both ship
|
|
51
|
+
// in the same injection so neither waits on a call the agent may skip.
|
|
52
|
+
const contrast = relatedPairs(registry, 'contrast');
|
|
53
|
+
const composition = relatedPairs(registry, 'composition');
|
|
54
|
+
const sections = [
|
|
55
|
+
PREAMBLE,
|
|
56
|
+
renderScreens(registry),
|
|
57
|
+
list.text,
|
|
58
|
+
renderGuideIndex(registry),
|
|
59
|
+
renderPairs(contrast, 'PICKING BETWEEN NEIGHBORS', 'vs'),
|
|
60
|
+
renderPairs(composition, 'COMPOSE — DO NOT HAND-ROLL THE WRAPPER', '+'),
|
|
61
|
+
].filter(Boolean);
|
|
62
|
+
return {
|
|
63
|
+
text: sections.join('\n\n'),
|
|
64
|
+
data: { preamble: PREAMBLE, entries: list.data, contrast, composition },
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
//# sourceMappingURL=catalog.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { Registry } from '../registry-types.js';
|
|
2
|
+
import type { CommandResult } from './lookup.js';
|
|
3
|
+
export interface ContextOptions {
|
|
4
|
+
/** Print only the catalog; leave the doctor block out. */
|
|
5
|
+
catalogOnly?: boolean;
|
|
6
|
+
/** Repo root. Defaults to the process cwd. */
|
|
7
|
+
cwd?: string;
|
|
8
|
+
/** Where the doctor cache lives. Defaults to `${XDG_CACHE_HOME:-~/.cache}`. */
|
|
9
|
+
cacheHome?: string;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* `greenrack context`: what a session should know about the design system. The
|
|
13
|
+
* catalog, then the doctor block when the build wiring is wrong. Outside a
|
|
14
|
+
* greenrack consumer it prints nothing, so a harness can run it anywhere.
|
|
15
|
+
*/
|
|
16
|
+
export declare function runContext(registry: Registry, options?: ContextOptions): CommandResult;
|
|
17
|
+
//# sourceMappingURL=context.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAA;AAGlD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AAG9C,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA2FD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CAU1F"}
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
|
|
3
|
+
import { homedir } from 'node:os';
|
|
4
|
+
import { join, relative, resolve } from 'node:path';
|
|
5
|
+
import { renderCatalog } from '../catalog.js';
|
|
6
|
+
import { isGreenrackConsumer, runDoctor } from './doctor.js';
|
|
7
|
+
import { cliVersion } from './manifest.js';
|
|
8
|
+
/** Directories the build-file scan never enters. */
|
|
9
|
+
const PRUNED = new Set(['node_modules', '.git', 'dist', 'build']);
|
|
10
|
+
const SCAN_DEPTH = 4;
|
|
11
|
+
/** The files `greenrack doctor` reads: build config, entries, stylesheets, manifests. */
|
|
12
|
+
const BUILD_FILE = /^(?:package\.json|pnpm-workspace\.yaml|.*\.css|vite.*|babel.*|\.babelrc.*|.*\.babel\..*|postcss.*|root\.tsx|main\.tsx|index\.tsx)$/;
|
|
13
|
+
function defaultCacheHome() {
|
|
14
|
+
const xdg = process.env.XDG_CACHE_HOME;
|
|
15
|
+
return xdg ? xdg : join(homedir(), '.cache');
|
|
16
|
+
}
|
|
17
|
+
/** Every build file under `root` within SCAN_DEPTH, as repo-relative POSIX paths, sorted. */
|
|
18
|
+
function buildFiles(root) {
|
|
19
|
+
const found = [];
|
|
20
|
+
const walk = (dir, depth) => {
|
|
21
|
+
let entries;
|
|
22
|
+
try {
|
|
23
|
+
entries = readdirSync(dir, { withFileTypes: true });
|
|
24
|
+
}
|
|
25
|
+
catch {
|
|
26
|
+
return;
|
|
27
|
+
}
|
|
28
|
+
for (const entry of entries) {
|
|
29
|
+
const path = join(dir, entry.name);
|
|
30
|
+
if (entry.isDirectory()) {
|
|
31
|
+
if (depth < SCAN_DEPTH && !PRUNED.has(entry.name))
|
|
32
|
+
walk(path, depth + 1);
|
|
33
|
+
}
|
|
34
|
+
else if (entry.isFile() && BUILD_FILE.test(entry.name)) {
|
|
35
|
+
found.push(relative(root, path).split('\\').join('/'));
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
};
|
|
39
|
+
walk(root, 1);
|
|
40
|
+
return found.sort();
|
|
41
|
+
}
|
|
42
|
+
/** Changes when any build file, or the CLI that reads them, changes. */
|
|
43
|
+
function buildKey(root) {
|
|
44
|
+
const hash = createHash('sha1').update(`greenrack ${cliVersion()}\n`);
|
|
45
|
+
for (const path of buildFiles(root)) {
|
|
46
|
+
try {
|
|
47
|
+
hash
|
|
48
|
+
.update(`${path}\0`)
|
|
49
|
+
.update(readFileSync(join(root, path)))
|
|
50
|
+
.update('\0');
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
hash.update(`${path}\0unreadable\0`);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
return hash.digest('hex');
|
|
57
|
+
}
|
|
58
|
+
function readCache(path) {
|
|
59
|
+
try {
|
|
60
|
+
return readFileSync(path, 'utf8');
|
|
61
|
+
}
|
|
62
|
+
catch {
|
|
63
|
+
return null;
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
/** tmp-then-rename; a failed write is silent, the next session recomputes. */
|
|
67
|
+
function writeCache(path, content) {
|
|
68
|
+
try {
|
|
69
|
+
mkdirSync(join(path, '..'), { recursive: true });
|
|
70
|
+
const partialPath = `${path}.tmp`;
|
|
71
|
+
writeFileSync(partialPath, content, 'utf8');
|
|
72
|
+
renameSync(partialPath, path);
|
|
73
|
+
}
|
|
74
|
+
catch {
|
|
75
|
+
// The cache is an optimisation: an unwritable cache dir costs a rerun.
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
/** `greenrack doctor --session` output, re-run only when the build files' key changes. */
|
|
79
|
+
function cachedDoctor(root, cacheHome) {
|
|
80
|
+
const dir = join(cacheHome, 'greenrack', createHash('sha1').update(root).digest('hex').slice(0, 16));
|
|
81
|
+
const key = buildKey(root);
|
|
82
|
+
if (readCache(join(dir, 'doctor.key')) === key) {
|
|
83
|
+
const cached = readCache(join(dir, 'doctor'));
|
|
84
|
+
if (cached !== null)
|
|
85
|
+
return cached;
|
|
86
|
+
}
|
|
87
|
+
const text = runDoctor({ session: true, cwd: root }).text;
|
|
88
|
+
writeCache(join(dir, 'doctor'), text);
|
|
89
|
+
writeCache(join(dir, 'doctor.key'), key);
|
|
90
|
+
return text;
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* `greenrack context`: what a session should know about the design system. The
|
|
94
|
+
* catalog, then the doctor block when the build wiring is wrong. Outside a
|
|
95
|
+
* greenrack consumer it prints nothing, so a harness can run it anywhere.
|
|
96
|
+
*/
|
|
97
|
+
export function runContext(registry, options = {}) {
|
|
98
|
+
const root = resolve(options.cwd ?? process.cwd());
|
|
99
|
+
if (!isGreenrackConsumer(root))
|
|
100
|
+
return { text: '', data: { consumer: false } };
|
|
101
|
+
const catalog = renderCatalog(registry);
|
|
102
|
+
if (options.catalogOnly)
|
|
103
|
+
return { text: catalog.text, data: catalog.data };
|
|
104
|
+
const doctor = cachedDoctor(root, options.cacheHome ?? defaultCacheHome());
|
|
105
|
+
return {
|
|
106
|
+
text: doctor === '' ? catalog.text : `${catalog.text}\n\n${doctor}`,
|
|
107
|
+
data: { ...catalog.data, doctor },
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
//# sourceMappingURL=context.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import type { CommandResult } from './lookup.js';
|
|
2
|
+
/**
|
|
3
|
+
* `greenrack doctor` — checks how the app in the cwd wires @greenharness/greenrack-ui into its
|
|
4
|
+
* build. Every rule here is a way a consumer has shipped design-system
|
|
5
|
+
* components with their spacing flattened while the design system's own
|
|
6
|
+
* stylesheet was correct: the stylesheet is layered (`reset`, then StyleX's
|
|
7
|
+
* `priority1..5`), and anything that lands outside those layers, or declares
|
|
8
|
+
* them in the wrong order, outranks it. Each app used to rediscover this
|
|
9
|
+
* alone; the contract lives here now. One rule is about the tokens rather
|
|
10
|
+
* than the cascade: an app whose build never compiles @greenharness/greenrack-tokens'
|
|
11
|
+
* sources cannot use them in css.create (`tokens-compiled`). And one reads
|
|
12
|
+
* fresh build output: a built `@media` that compares against a `var(--…)`
|
|
13
|
+
* never matches (`media-var`).
|
|
14
|
+
*
|
|
15
|
+
* Static and dependency-free on purpose: it runs under npx from the
|
|
16
|
+
* SessionStart hook, so it reads files with regexes over comment-masked
|
|
17
|
+
* source instead of loading a parser or executing the app's config.
|
|
18
|
+
*/
|
|
19
|
+
export type DoctorRule = 'runtime-injection' | 'layered-extraction' | 'css-imported' | 'css-load-order' | 'unlayered-reset' | 'version-skew' | 'tokens-compiled' | 'media-var' | 'legacy-names';
|
|
20
|
+
export interface DoctorFinding {
|
|
21
|
+
rule: DoctorRule;
|
|
22
|
+
severity: 'error' | 'warn';
|
|
23
|
+
/** Relative to the checked package root. */
|
|
24
|
+
file: string;
|
|
25
|
+
line?: number;
|
|
26
|
+
message: string;
|
|
27
|
+
fix: string;
|
|
28
|
+
}
|
|
29
|
+
export interface DoctorOptions {
|
|
30
|
+
/** Package root to check. Defaults to the process cwd. */
|
|
31
|
+
cwd?: string;
|
|
32
|
+
/**
|
|
33
|
+
* SessionStart mode: print nothing when healthy, an agent-facing block
|
|
34
|
+
* otherwise, and always exit 0 — findings are context for the session, and
|
|
35
|
+
* a non-zero exit is what the hook script reads as "npx failed".
|
|
36
|
+
*/
|
|
37
|
+
session?: boolean;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* The package names one scope reads and writes. An app is on the scope whose
|
|
41
|
+
* UI package it depends on; every package-sensitive check takes that scope, so
|
|
42
|
+
* the other scope's names are never evidence of a correct wiring.
|
|
43
|
+
*/
|
|
44
|
+
export interface Scope {
|
|
45
|
+
/** The current names, or the old ones this CLI still recognises until the census. */
|
|
46
|
+
kind: 'greenrack' | 'legacy';
|
|
47
|
+
ui: string;
|
|
48
|
+
tokens: string;
|
|
49
|
+
cli: string;
|
|
50
|
+
proseLayer: string;
|
|
51
|
+
/** The prefix of the CSS custom properties the scope publishes. */
|
|
52
|
+
cssVariablePrefix: string;
|
|
53
|
+
/** The prefix of the data attributes the scope's components set. */
|
|
54
|
+
dataAttributePrefix: string;
|
|
55
|
+
}
|
|
56
|
+
/** New scope first: an app that depends on both is checked as the new one. */
|
|
57
|
+
export declare const SCOPES: readonly Scope[];
|
|
58
|
+
/** True when the root, a workspace package or a package one directory down depends on either scope's UI package. */
|
|
59
|
+
export declare function isGreenrackConsumer(root: string): boolean;
|
|
60
|
+
export declare function runDoctor(options?: DoctorOptions): CommandResult;
|
|
61
|
+
/**
|
|
62
|
+
* The installed UI package's version when it differs from this CLI's: the
|
|
63
|
+
* given scope's, or either scope's when none is given. The package's exports
|
|
64
|
+
* map does not expose ./package.json, so require() cannot read it: walk up
|
|
65
|
+
* node_modules the way resolution does and read the file. A workspace link
|
|
66
|
+
* (the design system's own checkout) resolves outside any node_modules: its
|
|
67
|
+
* version is the source's, with no release to skew against.
|
|
68
|
+
*/
|
|
69
|
+
export declare function uiVersionSkew(cwd: string, scopes: readonly Scope[]): {
|
|
70
|
+
own: string;
|
|
71
|
+
installed: string;
|
|
72
|
+
ui: string;
|
|
73
|
+
cli: string;
|
|
74
|
+
} | null;
|
|
75
|
+
//# sourceMappingURL=doctor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AAY9C;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,UAAU,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,cAAc,GACd,gBAAgB,GAChB,iBAAiB,GACjB,cAAc,GACd,iBAAiB,GACjB,WAAW,GACX,cAAc,CAAA;AAElB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAA;IAC1B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,qFAAqF;IACrF,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAA;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,CAAA;IACzB,oEAAoE;IACpE,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAsBD,8EAA8E;AAC9E,eAAO,MAAM,MAAM,EAAE,SAAS,KAAK,EAAoC,CAAA;AAwFvE,oHAAoH;AACpH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,aAAa,CAyBpE;AA2MD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,KAAK,EAAE,GACvB;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAC,GAAG,IAAI,CAgBlE"}
|