@starklab/stark-mcp 0.1.0 → 0.2.1

package/src/adopt/referenceResolver.test.js

@@ -1,213 +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 { resolveReferences } from './referenceResolver.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-'));
-  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 component(result, name) {
-  const found = result.components.find((c) => c.name === name);
-  if (!found) throw new Error(`No component named "${name}" in result`);
-  return found;
-}
-
-describe('resolveReferences — reference kind classification', () => {
-  it('classifies a directly-imported JSX element as jsx, without double-counting the closing tag', () => {
-    const root = fixture({
-      'src/App.jsx': `
-        import { Button } from '@starklab/stk-components';
-        export const App = () => <Button variant="primary">Click</Button>;
-      `,
-    });
-    const result = resolveReferences(root, { platform: 'web' });
-    const button = component(result, 'Button');
-    expect(button.counts).toEqual({ jsx: 1, createElement: 0, hoc: 0, indirect: 0, reexport: 0 });
-    expect(button.sites).toHaveLength(1);
-    expect(button.sites[0].confidence).toBe('certain');
-  });
-
-  it('classifies a compound JSX member expression (<Foo.Bar/>) as jsx, once per element', () => {
-    const root = fixture({
-      'src/App.jsx': `
-        import { Accordion } from '@starklab/stk-components';
-        export const App = () => <Accordion.Item>content</Accordion.Item>;
-      `,
-    });
-    const result = resolveReferences(root, { platform: 'web' });
-    const accordion = component(result, 'Accordion');
-    expect(accordion.counts.jsx).toBe(1);
-  });
-
-  it('classifies React.createElement(Component, ...) and a bare invocation as createElement', () => {
-    const root = fixture({
-      'src/App.js': `
-        import React from 'react';
-        import { Button } from '@starklab/stk-components';
-        const a = React.createElement(Button, { variant: 'primary' });
-        const b = Button({ variant: 'ghost' });
-      `,
-    });
-    const result = resolveReferences(root, { platform: 'web' });
-    const button = component(result, 'Button');
-    expect(button.counts.createElement).toBe(2);
-    expect(button.counts.jsx).toBe(0);
-  });
-
-  it('classifies a component passed as an argument to another function as hoc', () => {
-    const root = fixture({
-      'src/App.js': `
-        import styled from 'styled-components';
-        import { Button } from '@starklab/stk-components';
-        const StyledButton = styled(Button)\`color: red;\`;
-      `,
-    });
-    const result = resolveReferences(root, { platform: 'web' });
-    const button = component(result, 'Button');
-    expect(button.counts.hoc).toBe(1);
-    expect(button.sites[0].confidence).toBe('high');
-  });
-
-  it('classifies a variable/ternary reference as indirect', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { Button } from '@starklab/stk-components';
-        const chosen = true ? Button : null;
-        const obj = { Comp: Button };
-      `,
-    });
-    const result = resolveReferences(root, { platform: 'web' });
-    const button = component(result, 'Button');
-    expect(button.counts.indirect).toBe(2);
-    expect(button.sites.every((s) => s.confidence === 'needs-review')).toBe(true);
-  });
-
-  it('classifies a forwarding export as reexport and excludes it from usage totals', () => {
-    const root = fixture({
-      'src/App.js': `
-        import { Button } from '@starklab/stk-components';
-        export { Button };
-      `,
-    });
-    const result = resolveReferences(root, { platform: 'web' });
-    const button = component(result, 'Button');
-    expect(button.counts.reexport).toBe(1);
-    expect(button.counts.jsx + button.counts.createElement + button.counts.hoc + button.counts.indirect).toBe(0);
-    // A reexport-only component still isn't "usage", so it shows up as zero-usage.
-    expect(result.zeroUsage).toContain('Button');
-  });
-});
-
-describe('resolveReferences — left-join over the catalog (blind spot 1)', () => {
-  it('reports every catalog component, including ones with no references at all', () => {
-    const root = fixture({
-      'src/App.jsx': `
-        import { Button } from '@starklab/stk-components';
-        export const App = () => <Button>Click</Button>;
-      `,
-    });
-    const result = resolveReferences(root, { platform: 'web' });
-    // Total catalog size, not just what was referenced.
-    expect(result.components.length).toBeGreaterThan(50);
-    const accordion = component(result, 'Accordion');
-    expect(accordion.counts).toEqual({ jsx: 0, createElement: 0, hoc: 0, indirect: 0, reexport: 0 });
-    expect(result.zeroUsage).toContain('Accordion');
-    expect(result.zeroUsage).not.toContain('Button');
-  });
-});
-
-describe('resolveReferences — transitive barrel resolution (blind spot 2)', () => {
-  it('resolves a component re-exported through two hops of the consumer’s own barrels', () => {
-    const root = fixture({
-      'src/ui/index.js': `export { Button } from '../components/ButtonLocal.js';`,
-      'src/components/ButtonLocal.js': `export { Button } from '@starklab/stk-components';`,
-      'src/App.jsx': `
-        import { Button } from './ui/index.js';
-        export const App = () => <Button>Click</Button>;
-      `,
-    });
-    const result = resolveReferences(root, { platform: 'web' });
-    const button = component(result, 'Button');
-    expect(button.counts.jsx).toBe(1);
-  });
-
-  it('does not resolve or crash on a circular local re-export chain', () => {
-    const root = fixture({
-      'src/a.js': `export { Button } from './b.js';`,
-      'src/b.js': `export { Button } from './a.js';`,
-      'src/App.jsx': `
-        import { Button } from './a.js';
-        export const App = () => <Button>Click</Button>;
-      `,
-    });
-    expect(() => resolveReferences(root, { platform: 'web' })).not.toThrow();
-    const result = resolveReferences(root, { platform: 'web' });
-    const button = component(result, 'Button');
-    // Never actually terminates at the real package, so it isn't counted.
-    expect(button.counts).toEqual({ jsx: 0, createElement: 0, hoc: 0, indirect: 0, reexport: 0 });
-  });
-});
-
-describe('resolveReferences — platform separation', () => {
-  it('never counts a stk-react-native import while scanning the web platform', () => {
-    const root = fixture({
-      'src/App.jsx': `
-        import { Button } from '@starklab/stk-react-native';
-        export const App = () => <Button>Click</Button>;
-      `,
-    });
-    const result = resolveReferences(root, { platform: 'web' });
-    const button = component(result, 'Button');
-    expect(button.counts).toEqual({ jsx: 0, createElement: 0, hoc: 0, indirect: 0, reexport: 0 });
-  });
-});
-
-describe('resolveReferences — resilience', () => {
-  it('records an unparseable file without failing the whole scan', () => {
-    const root = fixture({
-      'src/broken.js': `this is not { valid javascript at all +++`,
-      'src/App.jsx': `
-        import { Button } from '@starklab/stk-components';
-        export const App = () => <Button>Click</Button>;
-      `,
-    });
-    const result = resolveReferences(root, { platform: 'web' });
-    const button = component(result, 'Button');
-    expect(button.counts.jsx).toBe(1);
-  });
-
-  it('excludes files matched by the ignore option from the scan', () => {
-    const root = fixture({
-      'src/App.jsx': `
-        import { Button } from '@starklab/stk-components';
-        export const App = () => <Button>Click</Button>;
-      `,
-      'src/generated/Skip.jsx': `
-        import { BadgeStatus } from '@starklab/stk-components';
-        export const Skip = () => <BadgeStatus>Skip</BadgeStatus>;
-      `,
-    });
-    const result = resolveReferences(root, { platform: 'web', ignore: ['**/generated/**'] });
-    expect(result.scannedFiles).toBe(1);
-    const button = component(result, 'Button');
-    expect(button.counts.jsx).toBe(1);
-  });
-});

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);
-  });
-});