@astryxdesign/cli 0.6.4-canary.ed2e54e → 0.6.4

package/clients/cli/commands/component-batch.test.mjs

@@ -1,341 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file Multi-selector component lookup contract: one ordered batch envelope,
- * complete per-selector states, unchanged single-selector responses, and matching
- * text/JSON exit behavior.
- */
-
-import {describe, it, expect} from 'vitest';
-import * as path from 'node:path';
-import {
-  component,
-  COMPONENT_BATCH_SELECTOR_LIMIT,
-} from '../../../api/component/component.mjs';
-import {runCli} from '../../../test-utils/run-cli.mjs';
-
-const REPO_ROOT = path.resolve(import.meta.dirname, '../../../../..');
-const SLOW = 60_000;
-
-describe('component() batch lookup', () => {
-  it(
-    'keeps one found row per selector, in order, including duplicates',
-    async () => {
-      const result = await component(['Button', 'Badge', 'Button'], {
-        cwd: REPO_ROOT,
-        detail: 'brief',
-      });
-
-      expect(result.type).toBe('component.batch');
-      expect(result.data.count).toBe(3);
-      expect(result.data.results.map(row => row.selector)).toEqual([
-        'Button',
-        'Badge',
-        'Button',
-      ]);
-      expect(result.data.results.map(row => row.status)).toEqual([
-        'found',
-        'found',
-        'found',
-      ]);
-      expect(
-        result.data.results.map(row =>
-          row.status === 'found' ? row.result.type : null,
-        ),
-      ).toEqual(['component.detail', 'component.detail', 'component.detail']);
-    },
-    SLOW,
-  );
-
-  it(
-    'applies every focused projection to each found row',
-    async () => {
-      const projections = [
-        {options: {props: true}, expectedType: 'component.detail.props'},
-        {options: {source: true}, expectedType: 'component.detail.source'},
-        {options: {showcase: true}, expectedType: 'component.detail.showcase'},
-        {options: {blocks: true}, expectedType: 'component.detail.blocks'},
-      ];
-      for (const projection of projections) {
-        const result = await component(['Button', 'Card'], {
-          cwd: REPO_ROOT,
-          ...projection.options,
-        });
-        expect(result.type).toBe('component.batch');
-        expect(
-          result.data.results.map(row =>
-            row.status === 'found' ? row.result.type : null,
-          ),
-        ).toEqual([projection.expectedType, projection.expectedType]);
-      }
-    },
-    SLOW,
-  );
-
-  it(
-    'uses input shape to distinguish catalog, single, and batch calls',
-    async () => {
-      expect((await component(undefined, {cwd: REPO_ROOT})).type).toBe(
-        'component.list',
-      );
-      expect((await component('Button', {cwd: REPO_ROOT})).type).toBe(
-        'component.detail',
-      );
-
-      const emptyBatch = await component([], {cwd: REPO_ROOT});
-      expect(emptyBatch).toEqual({
-        type: 'component.batch',
-        data: {count: 0, results: []},
-      });
-      expect(
-        await component([], {
-          cwd: REPO_ROOT,
-          list: true,
-          category: 'Form',
-        }),
-      ).toEqual(emptyBatch);
-
-      const oneRowBatch = await component(['Button'], {
-        cwd: REPO_ROOT,
-        detail: 'brief',
-      });
-      expect(oneRowBatch).toMatchObject({
-        type: 'component.batch',
-        data: {
-          count: 1,
-          results: [
-            {
-              selector: 'Button',
-              status: 'found',
-              result: {type: 'component.detail'},
-            },
-          ],
-        },
-      });
-    },
-    SLOW,
-  );
-
-  it('rejects an oversized array before component resolution starts', async () => {
-    const selectors = Array.from(
-      {length: COMPONENT_BATCH_SELECTOR_LIMIT + 1},
-      () => 'Button',
-    );
-    await expect(
-      component(selectors, {
-        cwd: path.join(REPO_ROOT, 'missing-batch-cwd'),
-      }),
-    ).rejects.toMatchObject({
-      code: 'ERR_INVALID_ARGUMENT',
-      message: `Component batch accepts at most ${COMPONENT_BATCH_SELECTOR_LIMIT} selectors; received ${selectors.length}`,
-    });
-  });
-
-  it(
-    'keeps receipt invariants across a deterministic selector chaos matrix',
-    async () => {
-      const found = new Set(['Button', 'Card']);
-      const selectorCases = [
-        [],
-        ['Button'],
-        ['ZzzNope99'],
-        ['Button', 'Button'],
-        ['ZzzNope98', 'ZzzNope99'],
-        ['Button', 'ZzzNope99', 'Card'],
-        ['ZzzNope99', 'Button', 'ZzzNope99', 'Button'],
-        ['Card', 'Button', 'Card', 'ZzzNope98', 'Button'],
-      ];
-
-      for (const selectors of selectorCases) {
-        const result = await component(selectors, {
-          cwd: REPO_ROOT,
-          detail: 'brief',
-        });
-        expect(result.type).toBe('component.batch');
-        expect(result.data.count).toBe(selectors.length);
-        expect(result.data.results.map(row => row.selector)).toEqual(selectors);
-        expect(result.data.results.map(row => row.status)).toEqual(
-          selectors.map(selector =>
-            found.has(selector) ? 'found' : 'not_found',
-          ),
-        );
-        for (const row of result.data.results) {
-          if (row.status === 'found') {
-            expect(row.result.type).toBe('component.detail');
-          } else {
-            expect(row.code).toBe('ERR_UNKNOWN_COMPONENT');
-          }
-        }
-      }
-    },
-    SLOW,
-  );
-
-  it(
-    'composes every detail and language control over a batch',
-    async () => {
-      /** @type {Array<{detail?: 'full'|'compact'|'brief'; lang?: string; zh?: boolean; dense?: boolean}>} */
-      const controls = [
-        {detail: 'brief'},
-        {detail: 'compact'},
-        {detail: 'full'},
-        {lang: 'en'},
-        {lang: 'dense'},
-        {zh: true},
-        {dense: true},
-      ];
-      for (const control of controls) {
-        const result = await component(['Button', 'Card'], {
-          cwd: REPO_ROOT,
-          ...control,
-        });
-        expect(result.type).toBe('component.batch');
-        expect(result.data.results).toHaveLength(2);
-        expect(
-          result.data.results.every(
-            row =>
-              row.status === 'found' && row.result.type === 'component.detail',
-          ),
-        ).toBe(true);
-      }
-    },
-    SLOW,
-  );
-});
-
-describe('astryx component batch lookup', () => {
-  it('documents variadic selector grammar in --help', async () => {
-    const run = await runCli(['component', '--help'], REPO_ROOT);
-    expect(run.code).toBe(0);
-    expect(run.stdout).toContain(
-      'Usage: astryx component [options] [names...]',
-    );
-    expect(run.stdout).toContain('@scope/package@version/Name');
-    expect(run.stdout).toContain('Two or more return one ordered batch');
-    expect(run.stdout).toContain('At most 100 selectors');
-  });
-
-  it(
-    'keeps catalog and single-result CLI envelopes at zero and one selectors',
-    async () => {
-      const catalog = await runCli(['--json', 'component'], REPO_ROOT);
-      expect(catalog.code).toBe(0);
-      expect(JSON.parse(catalog.stdout).type).toBe('component.list');
-
-      const single = await runCli(
-        ['--json', '--detail', 'brief', 'component', 'Button'],
-        REPO_ROOT,
-      );
-      expect(single.code).toBe(0);
-      expect(JSON.parse(single.stdout).type).toBe('component.detail');
-    },
-    SLOW,
-  );
-
-  it(
-    'emits one component.batch JSON envelope for several found selectors',
-    async () => {
-      const run = await runCli(
-        ['--json', '--detail', 'brief', 'component', 'Button', 'Badge'],
-        REPO_ROOT,
-      );
-      expect(run.code).toBe(0);
-      const envelope = JSON.parse(run.stdout);
-      expect(envelope.type).toBe('component.batch');
-      expect(envelope.data.count).toBe(2);
-      expect(envelope.data.results.map(row => row.selector)).toEqual([
-        'Button',
-        'Badge',
-      ]);
-      expect(envelope.data.results.every(row => row.status === 'found')).toBe(
-        true,
-      );
-    },
-    SLOW,
-  );
-
-  it(
-    'rejects an oversized batch before emitting JSON or text results',
-    async () => {
-      const selectors = Array.from(
-        {length: COMPONENT_BATCH_SELECTOR_LIMIT + 1},
-        () => 'Button',
-      );
-      const json = await runCli(
-        ['--json', 'component', ...selectors],
-        REPO_ROOT,
-      );
-      expect(json.code).toBe(1);
-      expect(JSON.parse(json.stdout)).toMatchObject({
-        code: 'ERR_INVALID_ARGUMENT',
-        error: `Component batch accepts at most ${COMPONENT_BATCH_SELECTOR_LIMIT} selectors; received ${selectors.length}`,
-      });
-      expect(JSON.parse(json.stdout).type).toBeUndefined();
-
-      const text = await runCli(['component', ...selectors], REPO_ROOT);
-      expect(text.code).toBe(1);
-      expect(text.stdout + text.stderr).toContain(
-        `accepts at most ${COMPONENT_BATCH_SELECTOR_LIMIT} selectors`,
-      );
-    },
-    SLOW,
-  );
-
-  it(
-    'emits every row and exits 1 when one selector is not found',
-    async () => {
-      const run = await runCli(
-        ['--json', '--detail', 'brief', 'component', 'Button', 'ZzzNope99'],
-        REPO_ROOT,
-      );
-      expect(run.code).toBe(1);
-      const envelope = JSON.parse(run.stdout);
-      expect(envelope.type).toBe('component.batch');
-      expect(envelope.data.results).toMatchObject([
-        {selector: 'Button', status: 'found'},
-        {
-          selector: 'ZzzNope99',
-          status: 'not_found',
-          code: 'ERR_UNKNOWN_COMPONENT',
-        },
-      ]);
-    },
-    SLOW,
-  );
-
-  it(
-    'emits every failed row and exits 1 when no selector resolves',
-    async () => {
-      const run = await runCli(
-        ['--json', 'component', 'ZzzNope98', 'ZzzNope99'],
-        REPO_ROOT,
-      );
-      expect(run.code).toBe(1);
-      const envelope = JSON.parse(run.stdout);
-      expect(envelope.type).toBe('component.batch');
-      expect(envelope.data.count).toBe(2);
-      expect(envelope.data.results).toMatchObject([
-        {selector: 'ZzzNope98', status: 'not_found'},
-        {selector: 'ZzzNope99', status: 'not_found'},
-      ]);
-    },
-    SLOW,
-  );
-
-  it(
-    'projects every row in text and keeps the same failing exit status',
-    async () => {
-      const run = await runCli(
-        ['--detail', 'brief', 'component', 'Button', 'ZzzNope99'],
-        REPO_ROOT,
-      );
-      expect(run.code).toBe(1);
-      expect(run.stdout).toContain('count: 2');
-      expect(run.stdout).toMatch(/selector: Button\nstatus:\s+found/);
-      expect(run.stdout).toMatch(
-        /selector: ZzzNope99\nstatus:\s+not_found\ncode:\s+ERR_UNKNOWN_COMPONENT/,
-      );
-    },
-    SLOW,
-  );
-});

package/clients/cli/commands/discover.sources.test.mjs

@@ -1,267 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file `astryx discover` with a discover source: the list, a package page, a
- * search, and the refused option pair, driven through the real CLI against a
- * hermetic project whose astryx.config sets `discover`. Saved copies go to a
- * temp cache directory, never the project.
- */
-
-import {describe, it, expect, beforeEach, afterEach} from 'vitest';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as os from 'node:os';
-import {runCli} from '../../../test-utils/run-cli.mjs';
-
-const CONFIG = `
-const packages = [
-  {
-    package: '@test/kit',
-    integration: 'test-kit',
-    aliases: [],
-    latest: '3.2.0',
-    versions: [
-      {version: '3.2.0', publishedAt: '2026-09-29T00:00:00.000Z', prerelease: false, status: 'ok'},
-      {version: '3.1.4', publishedAt: '2026-09-01T00:00:00.000Z', prerelease: false, status: 'ok'},
-    ],
-    contributions: [{kind: 'component', name: 'Dial'}],
-  },
-  {
-    package: '@test/charts',
-    integration: 'test-charts',
-    aliases: [],
-    latest: '2.0.0',
-    versions: [
-      {version: '2.1.0-beta.1', publishedAt: '2026-09-25T00:00:00.000Z', prerelease: true, status: 'ok'},
-      {version: '2.0.0', publishedAt: '2026-09-20T00:00:00.000Z', prerelease: false, status: 'ok'},
-    ],
-    contributions: [
-      {kind: 'component', name: 'Chart'},
-      {kind: 'template', name: 'pages/Report'},
-    ],
-  },
-  {
-    package: '@test/boards',
-    integration: 'test-boards',
-    aliases: [],
-    latest: '1.0.0',
-    versions: [
-      {version: '1.0.0', publishedAt: '2026-09-10T00:00:00.000Z', prerelease: false, status: 'ok'},
-    ],
-    contributions: [{kind: 'template', name: 'pages/DialBoard'}],
-  },
-];
-
-export default {
-  integrations: ['@test/kit'],
-  async discover({package: name}) {
-    return {
-      schemaVersion: 1,
-      source: {name: 'Test catalog', generatedAt: '2026-09-30T00:00:00.000Z', complete: true},
-      packages: packages.filter(p => name == null || p.package === name),
-    };
-  },
-};
-`;
-
-let tmpDir;
-let project;
-/** @type {Record<string, string | undefined>} */
-let savedEnv;
-
-beforeEach(() => {
-  tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'astryx-discover-sources-'));
-  project = path.join(tmpDir, 'project');
-  const pkgDir = path.join(project, 'node_modules', '@test', 'kit');
-  fs.mkdirSync(path.join(pkgDir, 'components'), {recursive: true});
-  fs.writeFileSync(
-    path.join(project, 'package.json'),
-    JSON.stringify({
-      name: 'proj',
-      version: '1.0.0',
-      dependencies: {'@test/kit': '3.1.4'},
-    }),
-  );
-  fs.writeFileSync(path.join(project, 'astryx.config.mjs'), CONFIG);
-  fs.writeFileSync(
-    path.join(pkgDir, 'package.json'),
-    JSON.stringify({name: '@test/kit', version: '3.1.4'}),
-  );
-  fs.writeFileSync(
-    path.join(pkgDir, 'astryx.integration.mjs'),
-    `export default {components: './components'};\n`,
-  );
-  fs.writeFileSync(
-    path.join(pkgDir, 'components', 'Dial.doc.mjs'),
-    `export const docs = {name: 'Dial', usage: {description: 'A dial.'}};\n`,
-  );
-  fs.writeFileSync(
-    path.join(pkgDir, 'components', 'Dial.tsx'),
-    `export function Dial() { return null; }\n`,
-  );
-  // The saved copy lives in the per-user cache; point it at the temp dir.
-  savedEnv = {
-    HOME: process.env.HOME,
-    XDG_CACHE_HOME: process.env.XDG_CACHE_HOME,
-    LOCALAPPDATA: process.env.LOCALAPPDATA,
-  };
-  process.env.HOME = path.join(tmpDir, 'home');
-  process.env.XDG_CACHE_HOME = path.join(tmpDir, 'cache');
-  process.env.LOCALAPPDATA = path.join(tmpDir, 'localappdata');
-});
-
-afterEach(() => {
-  for (const [key, value] of Object.entries(savedEnv)) {
-    if (value === undefined) delete process.env[key];
-    else process.env[key] = value;
-  }
-  fs.rmSync(tmpDir, {recursive: true, force: true});
-});
-
-/** The per-user cache directory this platform uses under the redirected env. */
-function userCacheDir() {
-  if (process.platform === 'win32') {
-    return path.join(tmpDir, 'localappdata', 'astryx', 'Cache');
-  }
-  if (process.platform === 'darwin') {
-    return path.join(tmpDir, 'home', 'Library', 'Caches', 'astryx');
-  }
-  return path.join(tmpDir, 'cache', 'astryx');
-}
-
-describe('astryx discover with a discover source', () => {
-  it('lists what the project has and what it could add, in --json', async () => {
-    const {status, stdout} = await runCli(['discover', '--json'], {
-      cwd: project,
-    });
-
-    expect(status).toBe(0);
-    const {data, meta} = JSON.parse(stdout);
-    expect(data).toEqual([
-      expect.objectContaining({
-        name: '@test/kit',
-        components: ['Dial'],
-        version: '3.1.4',
-        latest: '3.2.0',
-      }),
-    ]);
-    expect(meta.available).toEqual([
-      {
-        name: '@test/charts',
-        components: ['Chart'],
-        version: '2.0.0',
-        templates: ['pages/Report'],
-        source: 'Test catalog',
-      },
-      {
-        name: '@test/boards',
-        components: [],
-        version: '1.0.0',
-        templates: ['pages/DialBoard'],
-        source: 'Test catalog',
-      },
-    ]);
-    expect(meta.sources).toEqual([
-      expect.objectContaining({
-        name: 'Test catalog',
-        from: 'astryx.config',
-        status: 'fresh',
-      }),
-    ]);
-  });
-
-  it('prints both sides as records', async () => {
-    const {status, stdout} = await runCli(['discover'], {cwd: project});
-
-    expect(status).toBe(0);
-    expect(stdout).toMatch(/^Installed$/m);
-    expect(stdout).toMatch(/^Available$/m);
-    expect(stdout).toMatch(/^name:\s+@test\/charts$/m);
-    expect(stdout).toMatch(/^latest:\s+3\.2\.0$/m);
-  });
-
-  it('shows a package it does not have with its releases and the command that adds it, and never runs it', async () => {
-    const {status, stdout} = await runCli(['discover', '@test/charts'], {
-      cwd: project,
-    });
-
-    expect(status).toBe(0);
-    expect(stdout).toMatch(/^installed:\s+false$/m);
-    expect(stdout).toContain('- 2.0.0  2026-09-20  latest');
-    expect(stdout).not.toContain('2.1.0-beta.1  ');
-    expect(stdout).toContain('1 prerelease is not listed.');
-    // The verb follows the detected package manager.
-    expect(stdout).toMatch(
-      /^(npm install|pnpm add|yarn add|bun add) @test\/charts$/m,
-    );
-    expect(
-      fs.existsSync(path.join(project, 'node_modules', '@test', 'charts')),
-    ).toBe(false);
-  });
-
-  it('says which item is missing from a package only a source lists', async () => {
-    const {status, stdout} = await runCli(
-      ['discover', '@test/charts/Nope', '--json'],
-      {cwd: project},
-    );
-
-    expect(status).toBe(1);
-    const {code, error} = JSON.parse(stdout);
-    expect(code).toBe('ERR_UNKNOWN_COMPONENT');
-    expect(error).toBe('"Nope" not found in @test/charts');
-  });
-
-  it('searches every kind in every source', async () => {
-    const {status, stdout} = await runCli(['discover', 'report', '--json'], {
-      cwd: project,
-    });
-
-    expect(status).toBe(0);
-    expect(JSON.parse(stdout).data.matches).toEqual([
-      {
-        package: '@test/charts',
-        component: 'pages/Report',
-        kind: 'template',
-        installed: false,
-      },
-    ]);
-  });
-
-  it('refuses --installed with --available', async () => {
-    const {status, stdout} = await runCli(
-      ['discover', '--installed', '--available', '--json'],
-      {cwd: project},
-    );
-
-    expect(status).toBe(1);
-    expect(JSON.parse(stdout).code).toBe('ERR_INVALID_OPTION');
-  });
-
-  it('lists every match for a free-text query, even an exact component name, and opens one by its package path', async () => {
-    const exact = await runCli(['discover', 'Dial', '--json'], {cwd: project});
-    const {type, data} = JSON.parse(exact.stdout);
-    expect(type).toBe('discover.search');
-    expect(data.matches.map(m => [m.component, m.installed])).toEqual([
-      ['Dial', true],
-      ['pages/DialBoard', false],
-    ]);
-
-    const opened = await runCli(['discover', '@test/kit/Dial', '--json'], {
-      cwd: project,
-    });
-    expect(JSON.parse(opened.stdout).type).toBe('discover.detail.doc');
-  });
-
-  it('saves the answer in the user cache and writes nothing into the project', async () => {
-    const before = fs.readdirSync(project).sort();
-    await runCli(['discover', '--json'], {cwd: project});
-
-    expect(fs.readdirSync(project).sort()).toEqual(before);
-    expect(fs.existsSync(path.join(project, 'node_modules', '.cache'))).toBe(
-      false,
-    );
-    expect(fs.readdirSync(path.join(userCacheDir(), 'discover'))).toHaveLength(
-      1,
-    );
-  });
-});

package/clients/cli/lib/parse-error-format.test.mjs

@@ -1,81 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file A parse failure reads like every other Astryx error in text mode.
- *
- * `astryx theme list --lang zh-Hans` printed Commander's own line —
- * `error: option '--lang <locale>' argument 'zh-Hans' is invalid…` — while
- * every other CLI error prints `Error: …`. `--json` was already correct
- * (ERR_INVALID_LANG), so text and JSON disagreed on everything except the exit
- * code. Commander writes that line before any Astryx code runs, so the shim is
- * the only place that can speak for it.
- */
-
-import {describe, it, expect} from 'vitest';
-import {Command} from 'commander';
-import {runCli} from '../../../test-utils/run-cli.mjs';
-import {installJsonShim} from './json-shim.mjs';
-
-describe('a parse error prints the Astryx error format', () => {
-  it.each([
-    ['invalid --lang value', ['theme', 'list', '--lang', 'zh-Hans'], 'ERR_INVALID_LANG'],
-    ['invalid --detail value', ['theme', 'list', '--detail', 'nope'], 'ERR_INVALID_DETAIL'],
-    ['unknown option', ['component', '--bogus-flag'], 'ERR_INVALID_OPTION'],
-    ['missing argument', ['theme', 'build'], 'ERR_MISSING_ARGUMENT'],
-  ])('%s', async (_label, args, code) => {
-    const human = await runCli(args);
-
-    expect(human.status).toBe(1);
-    expect(human.stderr).toContain('Error: ');
-    // Commander's own lowercase line must not reach the user.
-    expect(human.stderr).not.toMatch(/(^|\n)error: /);
-
-    // --json is unchanged, and the two modes agree on the exit code.
-    const json = await runCli(['--json', ...args]);
-    expect(json.status).toBe(human.status);
-    expect(JSON.parse(json.stdout).code).toBe(code);
-    expect(json.stderr).toBe('');
-  });
-
-  it('carries Commander\'s explanation, not just a generic line', async () => {
-    const {stderr} = await runCli(['theme', 'list', '--lang', 'zh-Hans']);
-    expect(stderr).toContain("'zh-Hans' is invalid");
-    expect(stderr).toContain('en, zh, dense');
-  });
-
-  it('leaves --help and --version at exit 0 with nothing on stderr', async () => {
-    for (const args of [['--help'], ['theme', '--help']]) {
-      const r = await runCli(args);
-      expect(r.status).toBe(0);
-      expect(r.stderr).toBe('');
-    }
-  });
-
-  // Commander writes help through the same stderr channel when it shows help
-  // BECAUSE the invocation failed, so suppressing that channel wholesale would
-  // have taken the help with it. Driven on a throwaway program rather than a
-  // real command, so the guard outlives whichever command happens to have a
-  // subcommand group today.
-  it('still lets help reach stderr when help IS the failure report', () => {
-    const program = new Command('probe');
-    const group = program.command('group');
-    group.command('leaf').action(() => {});
-    installJsonShim(program);
-
-    /** @type {string[]} */
-    const written = [];
-    const original = process.stderr.write;
-    // @ts-expect-error test double for the write signature
-    process.stderr.write = str => {
-      written.push(String(str));
-      return true;
-    };
-    try {
-      group.outputHelp({error: true});
-    } finally {
-      process.stderr.write = original;
-    }
-
-    expect(written.join('')).toMatch(/Usage: probe group/);
-  });
-});