@astryxdesign/cli 0.6.4-canary.f0355e3 → 0.6.4

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/commands/integration-verify.doc.mjs

@@ -1,22 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/** @type {import('@astryxdesign/cli/authoring').CommandDoc} */
-export const doc = {
-  type: 'command',
-  name: 'integration verify',
-  displayName: 'astryx integration verify',
-  namespace: 'cli/commands',
-  summary: 'Check the package the way npm will publish it, before you publish',
-  description:
-    'Packs the package with npm, unpacks the tarball into a temporary app without installing its dependencies, and checks that the app sees the same components, templates, themes, docs, and codemods as the package, that every public import resolves, and that the package declares a CLI new enough to read it. It publishes nothing and leaves no tarball behind. It runs the package\'s own pack lifecycle scripts, as `npm pack` does.',
-  fn: 'integrationPackCheck',
-  examples: [
-    {label: 'Check before publishing', cli: 'astryx integration verify'},
-    {label: 'Machine-readable result', cli: 'astryx integration verify --json'},
-  ],
-  exitCodes: [
-    {code: 0, when: 'the packed package exposes the same valid contributions'},
-    {code: 1, when: 'the tarball is incomplete or invalid'},
-  ],
-  related: ['integration add', 'doctor integration validate'],
-};

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

package/foundation/response/batch.type.d.mts

@@ -1,33 +0,0 @@
-// @generated by scripts/sync-api-types.mjs from the JSDoc in foundation/**/*.mjs.
-// DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
-
-/**
- * One complete row for an accepted selector.
- */
-export type BatchRow<TResult, TCandidate> = ({
-    selector: string;
-    status: "found";
-    result: TResult;
-} | {
-    selector: string;
-    status: "ambiguous";
-    code: string;
-    error: string;
-    candidates: TCandidate[];
-} | {
-    selector: string;
-    status: "not_found" | "error";
-    code: string;
-    error: string;
-    suggestions?: import("./base").Suggestion[];
-});
-/**
- * One ordered batch receipt inside the shared `{type, data}` success envelope.
- */
-export type BatchResponse<TType extends string, TResult, TCandidate> = {
-    type: TType;
-    data: {
-        count: number;
-        results: BatchRow<TResult, TCandidate>[];
-    };
-};

package/foundation/response/batch.type.mjs

@@ -1,34 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file Shared published types for complete multi-selector lookup receipts.
- * Adopting API subjects specialize these types with their single-result and
- * ambiguity-candidate types instead of defining command-specific row shapes.
- *
- * @input One exact selector, its single-result response, and its candidate shape.
- * @output BatchRow and BatchResponse for every AST-053 lookup adopter.
- * @position packages/cli/foundation/response — shared JSON response types
- */
-
-/**
- * One complete row for an accepted selector.
- * @template TResult
- * @template TCandidate
- * @typedef {(
- *   | {selector: string; status: 'found'; result: TResult}
- *   | {selector: string; status: 'ambiguous'; code: string; error: string; candidates: TCandidate[]}
- *   | {selector: string; status: 'not_found' | 'error'; code: string; error: string; suggestions?: import('./base').Suggestion[]}
- * )} BatchRow
- */
-
-/**
- * One ordered batch receipt inside the shared `{type, data}` success envelope.
- * @template {string} TType
- * @template TResult
- * @template TCandidate
- * @typedef {object} BatchResponse
- * @property {TType} type
- * @property {{count: number; results: BatchRow<TResult, TCandidate>[]}} data
- */
-
-export {};