@astryxdesign/cli 0.1.7 → 0.1.8-canary.07362a9

package/src/commands/swizzle.mjs

@@ -1,440 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file swizzle command — Copy component source for customization
- *
- * Resolves a component's owning package (core or a configured integration),
- * copies its non-test/non-doc source files to the output directory, and
- * rewrites escaping relative imports to use the OWNER package's subpaths.
- *
- * After swizzling, prints a short maintainer feedback note pointing users at
- * the owner's issue tracker so they can let the team know what gap led them to
- * customize the component. The core feedback URL is routed through app config
- * (`config.issuesUrl`); integration components use their manifest `issuesUrl`.
- */
-
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as p from '@clack/prompts';
-import {findCoreDir, listComponents} from '../utils/paths.mjs';
-import {
-  assertWithin,
-  PathSafetyError,
-  isNonInteractive,
-} from '../utils/path-safety.mjs';
-import {jsonOut, humanLog} from '../lib/json.mjs';
-import {cliError} from '../lib/cli-error.mjs';
-import {ERROR_CODES} from '../lib/error-codes.mjs';
-import {checkGhCli} from '../utils/github.mjs';
-import {getRunPrefix} from '../utils/package-manager.mjs';
-import {Project} from '../lib/project.mjs';
-import {
-  CORE_PACKAGE,
-  findIntegrationComponentDoc,
-  findIntegrationComponentSource,
-} from '../lib/component-discovery.mjs';
-
-/** Default issue tracker for maintainer feedback after swizzling. */
-const DEFAULT_ISSUES_URL = 'https://github.com/facebook/astryx/issues/new';
-
-/**
- * Rewrite relative imports that point outside the component directory to use
- * the OWNER package's subpaths. Imports within the copied directory (./x) are
- * left untouched.
- *
- * e.g. with ownerPackage '@astryxdesign/core':
- *      '../theme/tokens.stylex' -> '@astryxdesign/core/theme'
- *      '../utils/mergeProps'     -> '@astryxdesign/core/utils'
- *
- * `ownerPackage` defaults to '@astryxdesign/core' so existing core behavior is
- * unchanged; integration components pass their own owning package.
- *
- * @param {string} content
- * @param {string} [ownerPackage]
- */
-export function rewriteImports(content, ownerPackage = CORE_PACKAGE) {
-  // Match import/export from statements with relative paths going up
-  return content.replace(
-    /(from\s+['"])(\.\.\/.+?)(['"])/g,
-    (match, prefix, importPath, suffix) => {
-      // Extract the top-level directory from the relative path
-      // e.g. '../theme/tokens.stylex' -> 'theme'
-      // e.g. '../utils/mergeProps' -> 'utils'
-      const parts = importPath.replace(/^\.\.\//, '').split('/');
-      const topDir = parts[0];
-
-      // Map to the owner package subpath
-      return `${prefix}${ownerPackage}/${topDir}${suffix}`;
-    },
-  );
-}
-
-/**
- * Build the maintainer feedback note for a swizzled component.
- *
- * Returns { issuesUrl, ghCommand? } or null when no issues URL is available
- * (an integration that ships no `issuesUrl`). When the issues URL is a GitHub
- * issues URL and the `gh` CLI is available, a ready-to-run `gh issue create`
- * command is included so the user can file feedback without leaving the
- * terminal.
- *
- * @param {string} component bare component name (used in the issue title)
- * @param {string|undefined} issuesUrl owner's issue tracker URL
- * @returns {{issuesUrl: string, ghCommand?: string} | null}
- */
-function buildFeedback(component, issuesUrl) {
-  if (!issuesUrl) return null;
-
-  const feedback = {issuesUrl};
-
-  // Accept any github.com/<owner>/<repo>/issues(/new)? form.
-  const match = issuesUrl.match(
-    /^https:\/\/github\.com\/([^/]+)\/([^/]+)\/issues(?:\/new)?\/?$/,
-  );
-  if (match && checkGhCli()) {
-    const [, owner, repo] = match;
-    feedback.ghCommand = `gh issue create --repo ${owner}/${repo} --title "[${component}] Swizzle feedback"`;
-  }
-
-  return feedback;
-}
-
-function isCancel(value) {
-  if (p.isCancel(value)) {
-    p.cancel('Cancelled.');
-    process.exit(0);
-  }
-  return value;
-}
-
-/**
- * Load the configured integrations + core issues URL for `cwd`, swallowing any
- * config errors so swizzle never hard-fails on a malformed/absent config. An
- * empty list means "core only". The core issues URL is routed through the
- * Project (config.issuesUrl, falling back to the default core tracker).
- * @param {string} cwd
- * @returns {Promise<{loadedIntegrations: Array<object>, issuesUrl: string|undefined, project: Project|null}>}
- */
-async function loadConfigSafely(cwd) {
-  try {
-    const project = await Project.load(cwd);
-    return {
-      loadedIntegrations: project.loadedIntegrations,
-      issuesUrl: project.config.issuesUrl,
-      project,
-    };
-  } catch {
-    return {loadedIntegrations: [], issuesUrl: undefined, project: null};
-  }
-}
-
-/**
- * Build the set of OWNER packages that provide a component with `name` across
- * core + every loaded integration.
- *
- * Core ownership is determined by the source directory existing on disk
- * (`coreDir/src/<name>`) so plain core components without a `.doc.mjs` still
- * resolve as today. Integration ownership is determined by a same-stem doc file
- * (`<name>.doc.{ts,mjs,js}`) via findIntegrationComponentDoc.
- *
- * @param {string} coreDir
- * @param {Array<{name: string, components?: string, issuesUrl?: string}>} loadedIntegrations
- * @param {string} name bare component name (no XDS/Astryx prefix)
- * @param {string|undefined} coreIssuesUrl
- * @returns {Array<{package: string, sourceDir: string|null, ownerPackage: string, issuesUrl: string|undefined}>}
- */
-function resolveOwners(coreDir, loadedIntegrations, name, coreIssuesUrl) {
-  const owners = [];
-
-  const coreComponentDir = path.join(coreDir, 'src', name);
-  if (fs.existsSync(coreComponentDir)) {
-    owners.push({
-      package: CORE_PACKAGE,
-      sourceDir: coreComponentDir,
-      ownerPackage: CORE_PACKAGE,
-      issuesUrl: coreIssuesUrl || DEFAULT_ISSUES_URL,
-    });
-  }
-
-  for (const integration of loadedIntegrations) {
-    const docPath = findIntegrationComponentDoc(integration, name);
-    if (!docPath) continue;
-    const sourcePath = findIntegrationComponentSource(integration, name);
-    owners.push({
-      package: integration.name,
-      // The component's own folder — the directory containing its source.
-      sourceDir: sourcePath ? path.dirname(sourcePath) : null,
-      ownerPackage: integration.name,
-      issuesUrl: integration.issuesUrl,
-    });
-  }
-
-  return owners;
-}
-
-/** Whether a filename should be excluded from the swizzle copy. */
-function isExcludedFromCopy(file) {
-  return (
-    file.includes('.test.') || file.includes('.doc.') || file === 'README.md'
-  );
-}
-
-export function registerSwizzle(program) {
-  program
-    .command('swizzle [component]')
-    .description('Copy component source for customization')
-    .option('--output <dir>', 'Output directory', './components/astryx')
-    .option('--package <pkg>', 'Scope to a specific owning package')
-    .option('--list', 'List available components')
-    .option('-f, --overwrite', 'Overwrite existing files without prompting')
-    .action(async (component, options) => {
-      const coreDir = findCoreDir(process.cwd());
-      const json = program.opts().json || false;
-
-      if (!coreDir) {
-        cliError(
-          'Could not find @astryxdesign/core package. Make sure you are inside the design system monorepo or have @astryxdesign/core installed.',
-          {code: ERROR_CODES.ERR_CORE_NOT_FOUND},
-        );
-        return;
-      }
-
-      const components = listComponents(coreDir);
-
-      if (options.list || !component) {
-        if (json) return jsonOut('swizzle.list', components);
-        humanLog('\nAvailable components:\n');
-        for (const name of components) {
-          humanLog(`  ${name}`);
-        }
-        humanLog(`\nUsage: astryx swizzle <component>\n`);
-        humanLog('Example: astryx swizzle Button');
-        humanLog(
-          '         astryx swizzle XDSButton  (XDS prefix also works)\n',
-        );
-        return;
-      }
-
-      const dirName = component.replace(/^XDS/, '');
-
-      // Resolve the component's owning package(s) across core + integrations.
-      const {loadedIntegrations, project} = await loadConfigSafely(
-        process.cwd(),
-      );
-      // Core feedback URL is routed through the Project (config.issuesUrl,
-      // falling back to the default core tracker). When config load failed,
-      // resolveOwners applies the same default fallback.
-      const coreIssuesUrl = project
-        ? project.issuesUrl({package: CORE_PACKAGE})
-        : undefined;
-      const allOwners = resolveOwners(
-        coreDir,
-        loadedIntegrations,
-        dirName,
-        coreIssuesUrl,
-      );
-
-      if (allOwners.length === 0) {
-        cliError(`Component "${component}" not found.`, {
-          suggestions: components.slice(0, 10).map(n => ({name: n})),
-          code: ERROR_CODES.ERR_UNKNOWN_COMPONENT,
-        });
-        return;
-      }
-
-      let owner;
-      if (options.package) {
-        owner = allOwners.find(o => o.package === options.package);
-        if (!owner) {
-          cliError(
-            `Component "${dirName}" is not provided by package "${options.package}".`,
-            {
-              suggestions: allOwners.map(o => ({
-                name: o.package,
-                reason: 'provides this component',
-              })),
-              code: ERROR_CODES.ERR_UNKNOWN_COMPONENT,
-            },
-          );
-          return;
-        }
-      } else if (allOwners.length > 1) {
-        cliError(
-          `Component "${dirName}" is provided by multiple packages. Re-run with --package <pkg> to choose one.`,
-          {
-            suggestions: allOwners.map(o => ({
-              name: o.package,
-              reason: 'provides this component',
-            })),
-            code: ERROR_CODES.ERR_AMBIGUOUS_COMPONENT,
-          },
-        );
-        return;
-      } else {
-        owner = allOwners[0];
-      }
-
-      if (!owner.sourceDir || !fs.existsSync(owner.sourceDir)) {
-        cliError(
-          `No source found for "${dirName}" in package "${owner.package}".`,
-          {code: ERROR_CODES.ERR_NO_SOURCE},
-        );
-        return;
-      }
-
-      const componentDir = owner.sourceDir;
-
-      // Path-safety: --output must resolve inside cwd. Reject absolute
-      // paths and `..` traversal up front, before any directory is created.
-      let outputBase;
-      try {
-        outputBase = assertWithin(options.output, process.cwd(), {
-          label: 'output directory',
-        });
-      } catch (err) {
-        if (err instanceof PathSafetyError) {
-          cliError(err.message, {code: ERROR_CODES.ERR_PATH_TRAVERSAL});
-          return;
-        }
-        throw err;
-      }
-      const outputDir = path.join(outputBase, dirName);
-
-      // Pre-flight overwrite check: collect files we'd write and detect
-      // collisions before mkdir/writeFile so we never half-clobber.
-      const sourceFiles = fs.readdirSync(componentDir).filter(file => {
-        if (isExcludedFromCopy(file)) return false;
-        const stat = fs.statSync(path.join(componentDir, file));
-        return stat.isFile();
-      });
-
-      const existingFiles = sourceFiles.filter(f =>
-        fs.existsSync(path.join(outputDir, f)),
-      );
-
-      if (existingFiles.length > 0 && !options.overwrite) {
-        const relOutputForMsg = path.relative(process.cwd(), outputDir) || '.';
-        if (json || isNonInteractive({json})) {
-          const msg =
-            `Refusing to overwrite ${existingFiles.length} existing file(s) in ${relOutputForMsg}/. ` +
-            `Re-run with --overwrite (or -f) to replace them.`;
-          cliError(msg, {code: ERROR_CODES.ERR_FILE_EXISTS});
-          return;
-        }
-        const confirmed = isCancel(
-          await p.confirm({
-            message:
-              `Overwrite ${existingFiles.length} existing file(s) in ${relOutputForMsg}/? ` +
-              `(${existingFiles.slice(0, 3).join(', ')}${existingFiles.length > 3 ? ', …' : ''})`,
-            initialValue: false,
-          }),
-        );
-        if (!confirmed) {
-          humanLog('Aborted. Re-run with --overwrite to replace files.');
-          return;
-        }
-      }
-
-      fs.mkdirSync(outputDir, {recursive: true});
-
-      // Copy all non-test, non-doc, non-README files
-      const files = fs.readdirSync(componentDir);
-      let copied = 0;
-      // Track whether any copied source uses StyleX. Swizzled StyleX source
-      // needs a build-time StyleX compiler in the consumer's app or it renders
-      // unstyled with no error — so we surface a setup note after copying.
-      let usesStyleX = false;
-
-      for (const file of files) {
-        // Skip test files, doc files, and README
-        if (isExcludedFromCopy(file)) continue;
-
-        const srcPath = path.join(componentDir, file);
-        const stat = fs.statSync(srcPath);
-        if (!stat.isFile()) continue;
-
-        let content = fs.readFileSync(srcPath, 'utf-8');
-
-        // Rewrite escaping imports for .ts/.tsx files to the owner package.
-        if (file.endsWith('.ts') || file.endsWith('.tsx')) {
-          content = rewriteImports(content, owner.ownerPackage);
-        }
-
-        if (
-          (file.endsWith('.ts') || file.endsWith('.tsx')) &&
-          content.includes('@stylexjs/stylex')
-        ) {
-          usesStyleX = true;
-        }
-
-        fs.writeFileSync(path.join(outputDir, file), content);
-        copied++;
-      }
-
-      const relOutput = path.relative(process.cwd(), outputDir);
-      const copiedFiles = files.filter(
-        f =>
-          !isExcludedFromCopy(f) &&
-          fs.statSync(path.join(componentDir, f)).isFile(),
-      );
-
-      const feedback = buildFeedback(dirName, owner.issuesUrl);
-
-      if (json) {
-        /** @type {Record<string, unknown>} */
-        const payload = {
-          component: dirName,
-          package: owner.package,
-          outputDir: relOutput,
-          filesCopied: copied,
-          files: copiedFiles.map(f => f),
-          usesStyleX,
-        };
-        if (feedback) payload.feedback = feedback;
-        return jsonOut('swizzle.copy', payload);
-      }
-
-      humanLog(`\n✓ Copied ${copied} files to ${relOutput}/\n`);
-      humanLog(
-        `Relative imports have been rewritten to use ${owner.ownerPackage}.`,
-      );
-      humanLog('You can now customize the component source freely.\n');
-
-      // StyleX build requirement. Swizzled components ship raw StyleX source,
-      // which needs a build-time StyleX compiler in the consumer's app to
-      // produce atomic CSS. Without it the component compiles but renders
-      // unstyled, with no error — a confusing silent failure, so call it out.
-      if (usesStyleX) {
-        humanLog(
-          '⚠ These components use StyleX and require a StyleX compiler in your build.',
-        );
-        humanLog(
-          '  Without one they render unstyled (no error). See setup per framework:',
-        );
-        humanLog(`  ${getRunPrefix()} astryx docs styling`);
-        humanLog(
-          '  Next.js note: the StyleX Babel plugin disables SWC and breaks next/font —',
-        );
-        humanLog(
-          '  use an SWC-based StyleX transform instead (covered in the guide).',
-        );
-        humanLog('');
-      }
-
-      // Maintainer feedback note. If we couldn't swizzle cleanly, the team
-      // wants to know — point users at the issue tracker. Skipped when the
-      // owning package ships no issues URL.
-      if (feedback) {
-        humanLog(
-          'Customizing a component often signals a gap in the design system.',
-        );
-        humanLog('Let the maintainers know what you needed:');
-        if (feedback.ghCommand) {
-          humanLog(`  ${feedback.ghCommand}`);
-        } else {
-          humanLog(`  ${feedback.issuesUrl}`);
-        }
-        humanLog('');
-      }
-    });
-}

package/src/commands/upgrade.test.mjs

@@ -1,160 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-import {describe, it, expect, beforeEach, afterEach, vi} from 'vitest';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as os from 'node:os';
-import {Command} from 'commander';
-import {registerUpgrade} from './upgrade.mjs';
-
-let tmpDir;
-let originalCwd;
-let logCalls;
-let stdoutCalls;
-let exitCode;
-
-beforeEach(() => {
-  tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'astryx-upgrade-test-'));
-  originalCwd = process.cwd();
-  process.chdir(tmpDir);
-  logCalls = [];
-  stdoutCalls = [];
-  exitCode = undefined;
-  vi.spyOn(console, 'log').mockImplementation((...args) => {
-    logCalls.push(args.join(' '));
-  });
-  vi.spyOn(console, 'error').mockImplementation(() => {});
-  // @clack/prompts writes directly to process.stdout — capture that too.
-  vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
-    stdoutCalls.push(typeof chunk === 'string' ? chunk : chunk.toString());
-    return true;
-  });
-  // jsonError() calls process.exit(1) directly. Trap it so tests can assert.
-  vi.spyOn(process, 'exit').mockImplementation((code) => {
-    exitCode = code;
-    throw new Error(`__exit ${code}`);
-  });
-});
-
-afterEach(() => {
-  process.chdir(originalCwd);
-  fs.rmSync(tmpDir, {recursive: true, force: true});
-  vi.restoreAllMocks();
-});
-
-function createProgram() {
-  const program = new Command();
-  program.exitOverride();
-  // Mirror the global --json flag from src/index.mjs so program.opts().json
-  // resolves the same way in tests.
-  program.option('--json', 'Output as typed JSON');
-  registerUpgrade(program);
-  return program;
-}
-
-function writePkg(deps = {}) {
-  fs.writeFileSync(
-    path.join(tmpDir, 'package.json'),
-    JSON.stringify({name: 'fixture', dependencies: deps}, null, 2),
-  );
-}
-
-function writeInstalledCore(version, packageName = '@astryxdesign/core') {
-  const parts = packageName.split('/');
-  const dir = path.join(tmpDir, 'node_modules', ...parts);
-  fs.mkdirSync(dir, {recursive: true});
-  fs.writeFileSync(
-    path.join(dir, 'package.json'),
-    JSON.stringify({name: packageName, version}, null, 2),
-  );
-}
-
-function writeSourceFile() {
-  fs.mkdirSync(path.join(tmpDir, 'src'), {recursive: true});
-  fs.writeFileSync(path.join(tmpDir, 'src', 'index.ts'), 'const x = 1;\n');
-}
-
-/** Run a command and capture the parsed JSON response (last printed JSON line). */
-async function runJson(args) {
-  const program = createProgram();
-  try {
-    await program.parseAsync(['node', 'astryx', ...args]);
-  } catch (err) {
-    if (!String(err?.message || '').startsWith('__exit')) throw err;
-  }
-  // Find the most recent stringified JSON envelope in console.log output.
-  for (let i = logCalls.length - 1; i >= 0; i--) {
-    const line = logCalls[i];
-    if (line.startsWith('{')) {
-      try {
-        return JSON.parse(line);
-      } catch {
-        // not JSON, keep looking
-      }
-    }
-  }
-  return null;
-}
-
-describe('upgrade gate (semver comparison)', () => {
-  it('does NOT block an upgrade from 0.0.9 to installed 0.0.10 (regression)', async () => {
-    // The original bug: string compare said '0.0.9' >= '0.0.10', so the
-    // gate told users "Already up to date" without --force.
-    writePkg();
-    writeInstalledCore('0.0.10');
-    writeSourceFile();
-
-    const result = await runJson(['--json', 'upgrade', '--from', '0.0.9', '--path', 'src']);
-    expect(result).not.toBeNull();
-    expect(result.type === 'upgrade.run' || result.error || logCalls.some(l => l.includes('No codemods'))).toBeTruthy();
-  });
-
-  it('blocks when --from >= installed target by semver (e.g. 0.0.10 → 0.0.9)', async () => {
-    writePkg();
-    writeInstalledCore('0.0.9');
-    const program = createProgram();
-    await program.parseAsync(['node', 'astryx', 'upgrade', '--from', '0.0.10']);
-    const output = stdoutCalls.join('') + logCalls.join('\n');
-    expect(output).toMatch(/up to date|Already/i);
-  });
-});
-
-describe('upgrade argument validation', () => {
-  it('requires --from for upgrade runs', async () => {
-    writePkg();
-    writeInstalledCore('0.0.15');
-    const result = await runJson(['--json', 'upgrade']);
-    expect(result).not.toBeNull();
-    expect(result.error).toMatch(/Missing required --from/);
-    expect(exitCode).toBe(1);
-  });
-
-  it('rejects bogus --from values', async () => {
-    writePkg();
-    writeInstalledCore('0.0.15');
-    const result = await runJson(['--json', 'upgrade', '--from', 'not-a-version']);
-    expect(result).not.toBeNull();
-    expect(result.error).toMatch(/Invalid --from/);
-    expect(exitCode).toBe(1);
-  });
-
-  it('detects the installed target version from @astryxdesign/core', async () => {
-    writePkg();
-    writeInstalledCore('0.0.15');
-    writeSourceFile();
-    const result = await runJson(['--json', 'upgrade', '--from', '0.0.14', '--path', 'src']);
-    expect(result?.error || '').not.toMatch(/Could not find installed/);
-  });
-});
-
-describe('upgrade --list dedup', () => {
-  it('lists each codemod exactly once', async () => {
-    const result = await runJson(['--json', 'upgrade', '--list']);
-    expect(result).not.toBeNull();
-    expect(result.type).toBe('upgrade.list');
-    const names = result.data.map((c) => c.name);
-    const unique = new Set(names);
-    // The bug: 31 unique codemods printed 9× → 201 entries.
-    expect(names.length).toBe(unique.size);
-  });
-});

package/src/types/codemod.d.ts

@@ -1,81 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * Public type surface for the file-based codemod-authoring API exported from
- * `@astryxdesign/cli/codemod`.
- */
-
-/** A single source file presented to a codemod's transform. */
-export interface AstryxCodemodFile {
-  /** Absolute path to the file being transformed. */
-  path: string;
-  /** The current source contents of the file. */
-  source: string;
-}
-
-/** Helpers and context passed to a codemod's transform as the second argument. */
-export interface AstryxCodemodApi {
-  /** A jscodeshift instance configured with a parser for the file. */
-  jscodeshift: unknown;
-  /** Report a statistic (no-op-friendly; provided for jscodeshift parity). */
-  stats: (...args: unknown[]) => void;
-  /** Report progress (no-op-friendly; provided for jscodeshift parity). */
-  report: (...args: unknown[]) => void;
-}
-
-/**
- * A codemod's transform. Return the new source to rewrite the file, or
- * `null`/`undefined` to leave the file unchanged.
- */
-export type AstryxCodemodTransform = (
-  file: AstryxCodemodFile,
-  api: AstryxCodemodApi,
-) => string | null | undefined;
-
-/** Definition accepted by {@link createCodemod}. */
-export interface AstryxCodemodDef {
-  /** Short, human-readable title shown in upgrade output. */
-  title: string;
-  /** Optional longer description. */
-  description?: string;
-  /** When true, the codemod runs only when explicitly requested. */
-  isOptional?: boolean;
-  /** File extensions this codemod applies to (e.g. ['.tsx', '.ts']). */
-  fileExtensions?: string[];
-  /** The transform function. */
-  transform: AstryxCodemodTransform;
-}
-
-/** Result of {@link createCodemod}. */
-export interface AstryxCodemod extends AstryxCodemodDef {
-  isOptional: boolean;
-  type: 'code';
-}
-
-/** Definition accepted by {@link createConfigCodemod}. */
-export interface AstryxConfigCodemodDef {
-  /** Short, human-readable title shown in upgrade output. */
-  title: string;
-  /** Optional longer description. */
-  description?: string;
-  /** When true, the codemod runs only when explicitly requested. */
-  isOptional?: boolean;
-  /** The transform function applied to the astryx.config.* file. */
-  transform: AstryxCodemodTransform;
-}
-
-/** Result of {@link createConfigCodemod}. */
-export interface AstryxConfigCodemod extends AstryxConfigCodemodDef {
-  isOptional: boolean;
-  type: 'config';
-}
-
-/** Define a file-transforming codemod. */
-export declare function createCodemod<T extends AstryxCodemodDef>(
-  def: T,
-): AstryxCodemod;
-
-/** Define a codemod that targets the consumer's astryx.config.* file. */
-export declare function createConfigCodemod<T extends AstryxConfigCodemodDef>(
-  def: T,
-): AstryxConfigCodemod;