@reapit/elements 5.0.0-beta.71 → 5.0.0-beta.73

package/codemods/__tests__/codemods.test.ts

@@ -1,178 +0,0 @@
-import { writeFileSync } from 'node:fs'
-import { join, dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { listCodemods, getCodemodReadme, getCodemodDescription, validateCodemodName } from '../codemods'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-const codemodDir = join(__dirname, '..')
-
-describe('listCodemods', () => {
-  test('returns codemods from manifest', () => {
-    const result = listCodemods()
-
-    // Should return at least the codemods we know exist
-    expect(result).toContain('at-a-glance-article-card')
-    expect(Array.isArray(result)).toBe(true)
-  })
-
-  test('returns a copy to prevent external mutation', () => {
-    const result1 = listCodemods()
-    const result2 = listCodemods()
-
-    expect(result1).toEqual(result2)
-    expect(result1).not.toBe(result2) // Different array instances
-  })
-})
-
-describe('getCodemodReadme', () => {
-  test('returns README content when it exists', () => {
-    const result = getCodemodReadme('at-a-glance-article-card')
-
-    expect(result).not.toBeNull()
-    expect(typeof result).toBe('string')
-    expect(result!.length).toBeGreaterThan(0)
-  })
-
-  test('returns null when README does not exist', () => {
-    const result = getCodemodReadme('nonexistent-codemod' as any)
-
-    expect(result).toBeNull()
-  })
-
-  test('reads complete README with front matter and body', () => {
-    const result = getCodemodReadme('at-a-glance-article-card')
-
-    expect(result).not.toBeNull()
-    // Check for front matter markers
-    expect(result).toContain('---')
-    // Check for typical README content
-    expect(result).toMatch(/[#\s]/i)
-  })
-})
-
-describe('getCodemodDescription', () => {
-  test('returns description from manifest', () => {
-    const result = getCodemodDescription('at-a-glance-article-card')
-
-    expect(result).toBe('Migrates AtAGlance.Card to AtAGlance.ArticleCard')
-  })
-
-  test('returns null when codemod does not exist in manifest', () => {
-    const result = getCodemodDescription('nonexistent-codemod')
-
-    expect(result).toBeNull()
-  })
-
-  test('returns description for all codemods in manifest', () => {
-    const codemods = listCodemods()
-
-    for (const name of codemods) {
-      const description = getCodemodDescription(name)
-      // Description can be null or a string
-      expect(description === null || typeof description === 'string').toBe(true)
-    }
-  })
-})
-
-describe('validateCodemodName', () => {
-  test('returns name when codemod exists in manifest', () => {
-    const result = validateCodemodName('at-a-glance-article-card')
-
-    expect(result).toBe('at-a-glance-article-card')
-  })
-
-  test('returns null when codemod does not exist', () => {
-    const result = validateCodemodName('nonexistent-codemod')
-
-    expect(result).toBeNull()
-  })
-
-  test('prevents path traversal attacks with ../', () => {
-    const result = validateCodemodName('../../../etc/passwd')
-
-    expect(result).toBeNull()
-  })
-
-  test('prevents path traversal attacks with absolute paths', () => {
-    const result = validateCodemodName('/etc/passwd')
-
-    expect(result).toBeNull()
-  })
-
-  test('prevents path traversal with encoded characters', () => {
-    const result = validateCodemodName('..%2F..%2Fetc%2Fpasswd')
-
-    expect(result).toBeNull()
-  })
-
-  test('prevents path components in name', () => {
-    const result = validateCodemodName('at-a-glance-article-card/index.ts')
-
-    expect(result).toBeNull()
-  })
-
-  test('case-sensitive validation', () => {
-    const result = validateCodemodName('AT-A-GLANCE-ARTICLE-CARD')
-
-    expect(result).toBeNull()
-  })
-
-  test('validates all codemods from manifest correctly', () => {
-    const codemods = listCodemods()
-
-    for (const name of codemods) {
-      const validated = validateCodemodName(name)
-      expect(validated).toBe(name)
-    }
-  })
-})
-
-describe('integration tests', () => {
-  test('workflow: list codemods, validate, and get description', () => {
-    // List codemods
-    const codemods = listCodemods()
-    expect(codemods.length).toBeGreaterThan(0)
-    expect(codemods).toContain('at-a-glance-article-card')
-
-    // Validate a known codemod
-    const validated = validateCodemodName('at-a-glance-article-card')
-    expect(validated).toBe('at-a-glance-article-card')
-
-    // Get description
-    const description = getCodemodDescription(validated!)
-    expect(description).toBe('Migrates AtAGlance.Card to AtAGlance.ArticleCard')
-  })
-
-  test('workflow: attempt to access invalid codemod', () => {
-    // List shows only valid codemods
-    const codemods = listCodemods()
-    expect(codemods.length).toBeGreaterThan(0)
-
-    // Attempt to validate malicious input
-    const validated = validateCodemodName('../../etc/passwd')
-    expect(validated).toBeNull()
-
-    // No description accessible for invalid name
-    const description = getCodemodDescription('../../etc/passwd')
-    expect(description).toBeNull()
-  })
-
-  test('consistency: manifest and file system match', () => {
-    const codemods = listCodemods()
-
-    // All codemods in manifest should have their directories accessible
-    for (const name of codemods) {
-      const validated = validateCodemodName(name)
-      expect(validated).toBe(name)
-
-      // Should be able to get README (or null if missing, which is OK)
-      const readme = getCodemodReadme(name)
-      expect(readme === null || typeof readme === 'string').toBe(true)
-
-      // Should be able to get description from manifest
-      const description = getCodemodDescription(name)
-      expect(description === null || typeof description === 'string').toBe(true)
-    }
-  })
-})

package/codemods/__tests__/generate-manifest.test.ts

@@ -1,240 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync, rmSync } from 'node:fs'
-import { join } from 'node:path'
-import { tmpdir } from 'node:os'
-import { discoverCodemods, getCodemodMetadata } from '../generate-manifest'
-
-let testDir: string
-
-beforeEach(() => {
-  // Create a temporary test directory
-  testDir = join(tmpdir(), `codemods-test-${Date.now()}`)
-  mkdirSync(testDir, { recursive: true })
-})
-
-afterEach(() => {
-  // Clean up test directory
-  if (existsSync(testDir)) {
-    rmSync(testDir, { recursive: true, force: true })
-  }
-})
-
-describe('discoverCodemods', () => {
-  test('returns empty array when directory has no codemods', () => {
-    const result = discoverCodemods(testDir)
-    expect(result).toEqual([])
-  })
-
-  test('returns codemod names that have transform.ts files', () => {
-    // Create valid codemod directories
-    const codemod1Dir = join(testDir, 'codemod-1')
-    const codemod2Dir = join(testDir, 'codemod-2')
-
-    mkdirSync(codemod1Dir)
-    mkdirSync(codemod2Dir)
-
-    writeFileSync(join(codemod1Dir, 'transform.ts'), 'export default function() {}')
-    writeFileSync(join(codemod2Dir, 'transform.ts'), 'export default function() {}')
-
-    const result = discoverCodemods(testDir)
-
-    expect(result).toHaveLength(2)
-    expect(result).toContain('codemod-1')
-    expect(result).toContain('codemod-2')
-  })
-
-  test('ignores directories without transform.ts files', () => {
-    const validDir = join(testDir, 'valid-codemod')
-    const invalidDir = join(testDir, 'invalid-codemod')
-
-    mkdirSync(validDir)
-    mkdirSync(invalidDir)
-
-    writeFileSync(join(validDir, 'transform.ts'), 'export default function() {}')
-    writeFileSync(join(invalidDir, 'index.ts'), 'export default function() {}')
-
-    const result = discoverCodemods(testDir)
-
-    expect(result).toHaveLength(1)
-    expect(result).toContain('valid-codemod')
-    expect(result).not.toContain('invalid-codemod')
-  })
-
-  test('ignores files in the root directory', () => {
-    const validDir = join(testDir, 'valid-codemod')
-    mkdirSync(validDir)
-    writeFileSync(join(validDir, 'transform.ts'), 'export default function() {}')
-
-    // Create some files in root that should be ignored
-    writeFileSync(join(testDir, 'transform.ts'), 'export default function() {}')
-    writeFileSync(join(testDir, 'runner.ts'), 'export function run() {}')
-
-    const result = discoverCodemods(testDir)
-
-    expect(result).toHaveLength(1)
-    expect(result).toContain('valid-codemod')
-  })
-
-  test('returns codemods in consistent alphabetical order', () => {
-    const names = ['zebra', 'alpha', 'beta']
-
-    for (const name of names) {
-      const dir = join(testDir, name)
-      mkdirSync(dir)
-      writeFileSync(join(dir, 'transform.ts'), 'export default function() {}')
-    }
-
-    const result = discoverCodemods(testDir)
-
-    expect(result).toEqual(['alpha', 'beta', 'zebra'])
-  })
-
-  test('ignores special directories', () => {
-    const validDir = join(testDir, 'valid-codemod')
-    const nodeModulesDir = join(testDir, 'node_modules')
-    const testsDir = join(testDir, '__tests__')
-    const hiddenDir = join(testDir, '.hidden')
-
-    mkdirSync(validDir)
-    mkdirSync(nodeModulesDir)
-    mkdirSync(testsDir)
-    mkdirSync(hiddenDir)
-
-    writeFileSync(join(validDir, 'transform.ts'), 'export default function() {}')
-    writeFileSync(join(nodeModulesDir, 'transform.ts'), 'export default function() {}')
-    writeFileSync(join(testsDir, 'transform.ts'), 'export default function() {}')
-    writeFileSync(join(hiddenDir, 'transform.ts'), 'export default function() {}')
-
-    const result = discoverCodemods(testDir)
-
-    expect(result).toHaveLength(1)
-    expect(result).toContain('valid-codemod')
-  })
-
-  test('handles non-existent directory gracefully', () => {
-    const nonExistentDir = join(testDir, 'does-not-exist')
-    const result = discoverCodemods(nonExistentDir)
-
-    expect(result).toEqual([])
-  })
-})
-
-describe('getCodemodMetadata', () => {
-  test('extracts description from README front matter', () => {
-    const codemodDir = join(testDir, 'test-codemod')
-    mkdirSync(codemodDir)
-
-    const readmeContent = `---
-description: Transforms old API to new API
----
-# Documentation
-
-Body content.`
-
-    writeFileSync(join(codemodDir, 'README.md'), readmeContent)
-
-    const result = getCodemodMetadata(testDir, 'test-codemod')
-
-    expect(result).toEqual({
-      name: 'test-codemod',
-      description: 'Transforms old API to new API',
-    })
-  })
-
-  test('returns null description when README does not exist', () => {
-    const codemodDir = join(testDir, 'test-codemod')
-    mkdirSync(codemodDir)
-
-    const result = getCodemodMetadata(testDir, 'test-codemod')
-
-    expect(result).toEqual({
-      name: 'test-codemod',
-      description: null,
-    })
-  })
-
-  test('returns null description when README has no front matter', () => {
-    const codemodDir = join(testDir, 'test-codemod')
-    mkdirSync(codemodDir)
-
-    writeFileSync(join(codemodDir, 'README.md'), '# Test\n\nNo front matter.')
-
-    const result = getCodemodMetadata(testDir, 'test-codemod')
-
-    expect(result).toEqual({
-      name: 'test-codemod',
-      description: null,
-    })
-  })
-
-  test('returns null description when front matter has no description', () => {
-    const codemodDir = join(testDir, 'test-codemod')
-    mkdirSync(codemodDir)
-
-    const readmeContent = `---
-author: John Doe
----
-# Documentation`
-
-    writeFileSync(join(codemodDir, 'README.md'), readmeContent)
-
-    const result = getCodemodMetadata(testDir, 'test-codemod')
-
-    expect(result).toEqual({
-      name: 'test-codemod',
-      description: null,
-    })
-  })
-
-  test('extracts description with special characters', () => {
-    const codemodDir = join(testDir, 'test-codemod')
-    mkdirSync(codemodDir)
-
-    const readmeContent = `---
-description: Transforms @reapit/elements v4 -> v5
----
-# Documentation`
-
-    writeFileSync(join(codemodDir, 'README.md'), readmeContent)
-
-    const result = getCodemodMetadata(testDir, 'test-codemod')
-
-    expect(result).toEqual({
-      name: 'test-codemod',
-      description: 'Transforms @reapit/elements v4 -> v5',
-    })
-  })
-})
-
-describe('integration', () => {
-  test('workflow: discover codemods and extract metadata', () => {
-    // Create codemods
-    const codemod1Dir = join(testDir, 'my-codemod')
-    const codemod2Dir = join(testDir, 'another-codemod')
-
-    mkdirSync(codemod1Dir)
-    mkdirSync(codemod2Dir)
-
-    writeFileSync(join(codemod1Dir, 'transform.ts'), 'export default function() {}')
-    writeFileSync(
-      join(codemod1Dir, 'README.md'),
-      `---
-description: My awesome codemod
----
-# My Codemod`,
-    )
-
-    writeFileSync(join(codemod2Dir, 'transform.ts'), 'export default function() {}')
-
-    // Discover codemods
-    const codemods = discoverCodemods(testDir)
-    expect(codemods).toEqual(['another-codemod', 'my-codemod'])
-
-    // Get metadata for each
-    const metadata = codemods.map((name) => getCodemodMetadata(testDir, name))
-
-    expect(metadata).toEqual([
-      { name: 'another-codemod', description: null },
-      { name: 'my-codemod', description: 'My awesome codemod' },
-    ])
-  })
-})

package/codemods/__tests__/readme-parser.test.ts

@@ -1,218 +0,0 @@
-import { parseFrontMatter } from '../readme-parser'
-
-describe('parseFrontMatter', () => {
-  test('parses front matter with description', () => {
-    const content = `---
-description: My description
----
-# My Content
-
-Some body text.`
-
-    const result = parseFrontMatter(content)
-
-    expect(result).toEqual({
-      description: 'My description',
-      body: '# My Content\n\nSome body text.',
-    })
-  })
-
-  test('parses front matter with multiple fields, extracting only description', () => {
-    const content = `---
-description: Transform components
-author: John Doe
-version: 1.0.0
----
-# Documentation
-
-This is the body.`
-
-    const result = parseFrontMatter(content)
-
-    expect(result).toEqual({
-      description: 'Transform components',
-      body: '# Documentation\n\nThis is the body.',
-    })
-  })
-
-  test('returns body only when no front matter exists', () => {
-    const content = `# My Content
-
-This has no front matter.`
-
-    const result = parseFrontMatter(content)
-
-    expect(result).toEqual({
-      body: content,
-    })
-  })
-
-  test('returns body only when front matter has no description', () => {
-    const content = `---
-author: Jane Smith
----
-# Content
-
-Body text here.`
-
-    const result = parseFrontMatter(content)
-
-    expect(result).toEqual({
-      description: undefined,
-      body: '# Content\n\nBody text here.',
-    })
-  })
-
-  test('handles empty body after front matter', () => {
-    const content = `---
-description: Empty body
----
-`
-
-    const result = parseFrontMatter(content)
-
-    expect(result).toEqual({
-      description: 'Empty body',
-      body: '',
-    })
-  })
-
-  test('handles empty content', () => {
-    const content = ''
-
-    const result = parseFrontMatter(content)
-
-    expect(result).toEqual({
-      body: '',
-    })
-  })
-
-  test('trims whitespace from body', () => {
-    const content = `---
-description: Test
----
-
-
-# Header
-
-Content
-
-
-`
-
-    const result = parseFrontMatter(content)
-
-    expect(result.body).toBe('# Header\n\nContent')
-  })
-
-  test('handles description with special characters', () => {
-    const content = `---
-description: Transforms @reapit/elements v4 -> v5
----
-Body content`
-
-    const result = parseFrontMatter(content)
-
-    expect(result.description).toBe('Transforms @reapit/elements v4 -> v5')
-  })
-
-  test('handles description with quotes', () => {
-    const content = `---
-description: "Quoted description"
----
-Body`
-
-    const result = parseFrontMatter(content)
-
-    expect(result.description).toBe('"Quoted description"')
-  })
-
-  test('handles multiline content in body', () => {
-    const content = `---
-description: Short desc
----
-# Heading 1
-
-Paragraph 1
-
-## Heading 2
-
-Paragraph 2
-
-\`\`\`typescript
-code here
-\`\`\`
-
-Final paragraph.`
-
-    const result = parseFrontMatter(content)
-
-    expect(result.body).toContain('# Heading 1')
-    expect(result.body).toContain('## Heading 2')
-    expect(result.body).toContain('```typescript')
-    expect(result.body).toContain('Final paragraph.')
-  })
-
-  test('does not parse invalid front matter format', () => {
-    const content = `--
-description: Invalid
---
-Body`
-
-    const result = parseFrontMatter(content)
-
-    expect(result).toEqual({
-      body: content,
-    })
-  })
-
-  test('handles front matter without closing delimiter', () => {
-    const content = `---
-description: No closing
-Body content`
-
-    const result = parseFrontMatter(content)
-
-    expect(result).toEqual({
-      body: content,
-    })
-  })
-
-  test('extracts first description when multiple exist', () => {
-    const content = `---
-description: First description
-description: Second description
----
-Body`
-
-    const result = parseFrontMatter(content)
-
-    expect(result.description).toBe('First description')
-  })
-
-  test('handles description with colons in value', () => {
-    const content = `---
-description: Transform: Old API to New API
----
-Body`
-
-    const result = parseFrontMatter(content)
-
-    expect(result.description).toBe('Transform: Old API to New API')
-  })
-
-  test('preserves newlines in body', () => {
-    const content = `---
-description: Test
----
-Line 1
-
-Line 2
-
-Line 3`
-
-    const result = parseFrontMatter(content)
-
-    expect(result.body).toBe('Line 1\n\nLine 2\n\nLine 3')
-  })
-})