@starklab/stark-mcp 0.1.0 → 0.2.0

package/src/adopt/rnTailwindResolver.test.js

@@ -1,263 +0,0 @@
-import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-
-import { describe, it, expect, afterEach } from 'vitest';
-
-import { resolveRnTailwindTokens } from './rnTailwindResolver.js';
-
-let tmpDirs = [];
-
-afterEach(() => {
-  for (const dir of tmpDirs) rmSync(dir, { recursive: true, force: true });
-  tmpDirs = [];
-});
-
-function fixture(files) {
-  const root = mkdtempSync(path.join(os.tmpdir(), 'stark-adopt-rn-tailwind-'));
-  tmpDirs.push(root);
-  for (const [rel, content] of Object.entries(files)) {
-    const full = path.join(root, rel);
-    mkdirSync(path.dirname(full), { recursive: true });
-    writeFileSync(full, content);
-  }
-  return root;
-}
-
-const NATIVEWIND_PKG = `{ "name": "app", "dependencies": { "nativewind": "^4.0.0" } }`;
-
-function usage(result, className) {
-  return result.usages.find((u) => u.className === className);
-}
-
-describe('resolveRnTailwindTokens — NativeWind detection', () => {
-  it('reports detected:false with no report when there is no NativeWind signal at all', () => {
-    const root = fixture({
-      'package.json': `{ "name": "app", "dependencies": {} }`,
-      'src/App.js': `import { View } from 'react-native'; export const App = () => <View className="flex" />;`,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(result.detected).toBe(false);
-    expect(result.report).toBeNull();
-  });
-
-  it('does not treat a bare tailwind.config.js as a NativeWind signal (could belong to an unrelated web app in the same monorepo)', () => {
-    const root = fixture({
-      'package.json': `{ "name": "app", "dependencies": {} }`,
-      'tailwind.config.js': `
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        module.exports = { theme: { extend: { colors: { primary: stkSurfaceBrand1Strong } } } };
-      `,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(result.detected).toBe(false);
-  });
-
-  it('detects via a "nativewind" package.json dependency', () => {
-    const root = fixture({ 'package.json': NATIVEWIND_PKG });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(result.detected).toBe(true);
-    expect(result.nativewindSignal).toBe('package.json');
-    expect(result.reason).toMatch(/no tailwind\.config/i);
-    expect(result.report).toBeNull();
-  });
-
-  it('detects via a "nativewind/babel" preset in babel.config.js', () => {
-    const root = fixture({
-      'package.json': `{ "name": "app", "dependencies": {} }`,
-      'babel.config.js': `module.exports = { presets: ['babel-preset-expo', 'nativewind/babel'] };`,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(result.detected).toBe(true);
-    expect(result.nativewindSignal).toBe('babel.config');
-  });
-
-  it('detects via a "withNativeWind" wrapper in metro.config.js', () => {
-    const root = fixture({
-      'package.json': `{ "name": "app", "dependencies": {} }`,
-      'metro.config.js': `
-        const { withNativeWind } = require('nativewind/metro');
-        module.exports = withNativeWind(config, { input: './global.css' });
-      `,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(result.detected).toBe(true);
-    expect(result.nativewindSignal).toBe('metro.config');
-  });
-
-  it('reports themeParseIncomplete instead of a zero score for a dynamic/function-based v3 config', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `module.exports = { theme: (helpers) => ({ colors: { primary: helpers.colors.blue } }) };`,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(result.detected).toBe(true);
-    expect(result.themeParseIncomplete).toBe(true);
-    expect(result.report).toBeNull();
-  });
-});
-
-describe('resolveRnTailwindTokens — theme.colors classification', () => {
-  it('classifies a theme entry importing a Stark RN token identifier directly as conformant', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        module.exports = { theme: { extend: { colors: { primary: stkSurfaceBrand1Strong } } } };
-      `,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    const prop = result.properties.find((p) => p.name === '--color-primary');
-    expect(prop.state).toBe('conformant');
-  });
-
-  it('classifies a nested DEFAULT/shade color entry', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        module.exports = { theme: { extend: { colors: { brand: { DEFAULT: stkSurfaceBrand1Strong, 500: '#1956dd' } } } } };
-      `,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(result.properties.find((p) => p.name === '--color-brand').state).toBe('conformant');
-    expect(result.properties.find((p) => p.name === '--color-brand-500').state).toBe('drift');
-  });
-
-  it('classifies a theme entry aliasing a raw literal as drift, not aliased', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `module.exports = { theme: { extend: { colors: { primary: '#1956dd' } } } };`,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    const prop = result.properties.find((p) => p.name === '--color-primary');
-    expect(prop.state).toBe('drift');
-    expect(result.findings.some((f) => f.rule === 'drift-behind-alias' && f.property === '--color-primary')).toBe(true);
-  });
-
-  it('classifies a theme entry aliasing a foreign (non-Stark) import as broken', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `
-        import { someColor } from 'some-other-lib';
-        module.exports = { theme: { extend: { colors: { primary: someColor } } } };
-      `,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    const prop = result.properties.find((p) => p.name === '--color-primary');
-    expect(prop.state).toBe('broken');
-    expect(result.findings.some((f) => f.rule === 'broken-alias' && f.property === '--color-primary')).toBe(true);
-  });
-
-  it('flags a theme entry resolving straight to a primitive RN token as a layer violation', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `
-        import { stkSpacingMd } from '@starklab/stk/rn-spacing';
-        module.exports = { theme: { extend: { colors: { primary: stkSpacingMd } } } };
-      `,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    const prop = result.properties.find((p) => p.name === '--color-primary');
-    expect(prop.state).toBe('conformant');
-    const findings = result.findings.filter((f) => f.rule === 'layer-violation' && f.property === '--color-primary');
-    expect(findings).toHaveLength(1);
-    expect(findings[0].severity).toBe('critical');
-  });
-
-  it('warns past ~3 hops on a multi-hop conformant chain declared in the config file itself', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        const hop4 = stkSurfaceBrand1Strong;
-        const hop3 = hop4;
-        const hop2 = hop3;
-        const hop1 = hop2;
-        module.exports = { theme: { extend: { colors: { primary: hop1 } } } };
-      `,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    const prop = result.properties.find((p) => p.name === '--color-primary');
-    expect(prop.state).toBe('conformant');
-    expect(result.findings.some((f) => f.rule === 'deep-alias-chain' && f.property === '--color-primary')).toBe(true);
-  });
-});
-
-describe('resolveRnTailwindTokens — className usage scanning', () => {
-  it('classifies a className resolving to a conformant theme entry as aliased', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        module.exports = { theme: { extend: { colors: { primary: stkSurfaceBrand1Strong } } } };
-      `,
-      'src/App.js': `import { View } from 'react-native'; export const App = () => <View className="bg-primary" />;`,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(usage(result, 'bg-primary').classification).toBe('aliased');
-    expect(result.report.aliased).toBe(1);
-    expect(result.report.direct).toBe(0);
-  });
-
-  it('classifies a className resolving to a drifted theme entry as drift, not aliased', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `module.exports = { theme: { extend: { colors: { primary: '#1956dd' } } } };`,
-      'src/App.js': `import { View } from 'react-native'; export const App = () => <View className="bg-primary" />;`,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(usage(result, 'bg-primary').classification).toBe('drift');
-  });
-
-  it('strips a variant prefix before matching the base utility', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        module.exports = { theme: { extend: { colors: { primary: stkSurfaceBrand1Strong } } } };
-      `,
-      'src/App.js': `import { View } from 'react-native'; export const App = () => <View className="dark:bg-primary" />;`,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(usage(result, 'dark:bg-primary').classification).toBe('aliased');
-  });
-
-  it('does not count an unrelated utility class or Tailwind default-palette color as a usage', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        module.exports = { theme: { extend: { colors: { primary: stkSurfaceBrand1Strong } } } };
-      `,
-      'src/App.js': `import { View } from 'react-native'; export const App = () => <View className="flex bg-red-500" />;`,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(usage(result, 'flex')).toBeUndefined();
-    expect(usage(result, 'bg-red-500')).toBeUndefined();
-    expect(result.report.total).toBe(0);
-  });
-
-  it('does not count a dynamic className expression (ternary) since it is not statically resolvable', () => {
-    const root = fixture({
-      'package.json': NATIVEWIND_PKG,
-      'tailwind.config.js': `
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        module.exports = { theme: { extend: { colors: { primary: stkSurfaceBrand1Strong } } } };
-      `,
-      'src/App.js': `
-        import { View } from 'react-native';
-        export const App = ({ active }) => <View className={active ? 'bg-primary' : 'bg-primary'} />;
-      `,
-    });
-    const result = resolveRnTailwindTokens(root, { platform: 'native' });
-    expect(result.report.total).toBe(0);
-  });
-});
-
-describe('resolveRnTailwindTokens — platform scope', () => {
-  it('throws for a non-native platform since NativeWind is the RN analog of web Tailwind', () => {
-    const root = fixture({ 'package.json': NATIVEWIND_PKG });
-    expect(() => resolveRnTailwindTokens(root, { platform: 'web' })).toThrow(/native/i);
-  });
-});

package/src/adopt/rnTokenAliasResolver.test.js

@@ -1,260 +0,0 @@
-import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-
-import { describe, it, expect, afterEach } from 'vitest';
-
-import { resolveRnTokenAliases } from './rnTokenAliasResolver.js';
-
-let tmpDirs = [];
-
-afterEach(() => {
-  for (const dir of tmpDirs) rmSync(dir, { recursive: true, force: true });
-  tmpDirs = [];
-});
-
-function fixture(files) {
-  const root = mkdtempSync(path.join(os.tmpdir(), 'stark-adopt-rn-alias-'));
-  tmpDirs.push(root);
-  for (const [rel, content] of Object.entries(files)) {
-    const full = path.join(root, rel);
-    mkdirSync(path.dirname(full), { recursive: true });
-    writeFileSync(full, content);
-  }
-  return root;
-}
-
-function usage(result, stkToken) {
-  return result.usages.find((u) => u.stkToken === stkToken);
-}
-
-function property(result, name) {
-  const found = result.properties.find((p) => p.name === name);
-  if (!found) throw new Error(`No property "${name}" in result. Found: ${result.properties.map((p) => p.name).join(', ')}`);
-  return found;
-}
-
-function findingsFor(result, rule, propName) {
-  return result.findings.filter((f) => f.rule === rule && f.property === propName);
-}
-
-describe('resolveRnTokenAliases — detection', () => {
-  it('reports detected:false with no report when no file imports a Stark RN token package', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        const styles = StyleSheet.create({ container: { backgroundColor: '#1956dd' } });
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    expect(result.detected).toBe(false);
-    expect(result.report).toBeNull();
-  });
-
-  it('detects an import from @starklab/stk/rn even if unused elsewhere', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    expect(result.detected).toBe(true);
-    expect(result.confidence).toBe('uncertain');
-  });
-});
-
-describe('resolveRnTokenAliases — usage classification (Pass 2)', () => {
-  it('classifies a directly-imported token referenced with no indirection as direct', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        const styles = StyleSheet.create({ container: { backgroundColor: stkSurfaceBrand1Strong } });
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    expect(usage(result, 'stkSurfaceBrand1Strong').classification).toBe('direct');
-    expect(result.report.direct).toBe(1);
-  });
-
-  it('classifies a reference through a scalar local const alias as aliased', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        const primary = stkSurfaceBrand1Strong;
-        const styles = StyleSheet.create({ container: { backgroundColor: primary } });
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    const u = result.usages.find((x) => x.ref === 'primary');
-    expect(u.classification).toBe('aliased');
-    expect(result.report.aliased).toBe(1);
-  });
-
-  it('classifies a reference through an object-literal property alias as aliased', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        const theme = { primary: stkSurfaceBrand1Strong };
-        const styles = StyleSheet.create({ container: { backgroundColor: theme.primary } });
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    const u = result.usages.find((x) => x.ref === 'theme.primary');
-    expect(u.classification).toBe('aliased');
-  });
-
-  it('classifies a reference through a raw-literal object alias as drift, not aliased', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        import { stkSpacingMd } from '@starklab/stk/rn-spacing'; // unused, only to satisfy detection
-        const theme = { primary: '#1956dd' };
-        const styles = StyleSheet.create({ container: { backgroundColor: theme.primary } });
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    const p = property(result, 'theme.primary');
-    expect(p.state).toBe('drift');
-    const u = result.usages.find((x) => x.ref === 'theme.primary');
-    expect(u.classification).toBe('drift');
-    expect(findingsFor(result, 'drift-behind-alias', 'theme.primary')).toHaveLength(1);
-  });
-
-  it('classifies a reference through an alias to a foreign (non-Stark) import as broken', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        import { stkSpacingMd } from '@starklab/stk/rn-spacing'; // unused, only to satisfy detection
-        import { someColor } from 'some-other-lib';
-        const theme = { primary: someColor };
-        const styles = StyleSheet.create({ container: { backgroundColor: theme.primary } });
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    const p = property(result, 'theme.primary');
-    expect(p.state).toBe('broken');
-    expect(findingsFor(result, 'broken-alias', 'theme.primary')).toHaveLength(1);
-  });
-
-  it('applies the name-only heuristic when the containing object has no static origin (e.g. a useTokens() hook)', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        import { stkSpacingMd } from '@starklab/stk/rn-spacing'; // unused, only to satisfy detection
-        import { useTokens } from '../theme/ThemeContext';
-        function useStyles() {
-          const t = useTokens();
-          return StyleSheet.create({ container: { backgroundColor: t.stkSurfaceBrand1Strong } });
-        }
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    const u = usage(result, 'stkSurfaceBrand1Strong');
-    expect(u.classification).toBe('direct');
-    expect(u.heuristic).toBe(true);
-  });
-
-  it('does not count an unrelated member/identifier access as a usage', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        import { stkSpacingMd } from '@starklab/stk/rn-spacing'; // unused, only to satisfy detection
-        const styles = StyleSheet.create({ container: { flexDirection: 'row' } });
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    expect(result.report.total).toBe(0);
-  });
-});
-
-describe('resolveRnTokenAliases — layer violations', () => {
-  it('flags a scalar alias resolving straight to a primitive RN token', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        import { stkSpacingMd } from '@starklab/stk/rn-spacing';
-        const gap = stkSpacingMd;
-        const styles = StyleSheet.create({ container: { padding: gap } });
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    const p = property(result, 'gap');
-    expect(p.state).toBe('conformant');
-    const findings = findingsFor(result, 'layer-violation', 'gap');
-    expect(findings).toHaveLength(1);
-    expect(findings[0].severity).toBe('critical');
-  });
-});
-
-describe('resolveRnTokenAliases — depth', () => {
-  it('warns past ~3 hops on a multi-hop conformant scalar chain', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        const hop4 = stkSurfaceBrand1Strong;
-        const hop3 = hop4;
-        const hop2 = hop3;
-        const hop1 = hop2;
-        const styles = StyleSheet.create({ container: { backgroundColor: hop1 } });
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    const p = property(result, 'hop1');
-    expect(p.state).toBe('conformant');
-    expect(findingsFor(result, 'deep-alias-chain', 'hop1')).toHaveLength(1);
-  });
-
-  it('does not warn on a short chain within the depth budget', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        const hop2 = stkSurfaceBrand1Strong;
-        const hop1 = hop2;
-        const styles = StyleSheet.create({ container: { backgroundColor: hop1 } });
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    expect(findingsFor(result, 'deep-alias-chain', 'hop1')).toHaveLength(0);
-  });
-});
-
-describe('resolveRnTokenAliases — alias count and report', () => {
-  it('counts every distinct alias-graph entry and reports the three-number summary', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { StyleSheet } from 'react-native';
-        import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';
-        const primary = stkSurfaceBrand1Strong;
-        const secondary = '#1956dd';
-        const styles = StyleSheet.create({
-          a: { backgroundColor: stkSurfaceBrand1Strong },
-          b: { backgroundColor: primary },
-          c: { backgroundColor: secondary },
-        });
-      `,
-    });
-    const result = resolveRnTokenAliases(root, { platform: 'native' });
-    expect(result.aliasCount).toBe(2); // primary, secondary
-    expect(result.report.direct).toBe(1); // a
-    expect(result.report.aliased).toBe(1); // b
-    // c aliases a plain string local const — the alias graph tracked it (it's
-    // a real consumer-authored indirection), it just doesn't terminate at a
-    // Stark token, so it folds into "unresolved" same as CSS drift does on web.
-    expect(result.report.unresolved).toBe(1); // c
-    expect(result.report.total).toBe(3);
-  });
-});
-
-describe('resolveRnTokenAliases — platform scope', () => {
-  it('throws for a non-native platform since JS-object token indirection has no CSS/Tailwind equivalent', () => {
-    const root = fixture({
-      'src/App.js': `import { stkSurfaceBrand1Strong } from '@starklab/stk/rn';`,
-    });
-    expect(() => resolveRnTokenAliases(root, { platform: 'web' })).toThrow(/native/i);
-  });
-});