@astryxdesign/cli 0.0.0-bootstrap.0 → 0.1.0-canary.0b5b49f

package/src/utils/paths.test.mjs

@@ -0,0 +1,211 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+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 {findCoreDir, findProjectRoot, listComponents, discoverExternalPackages} from './paths.mjs';
+
+let tmpDir;
+
+function makeTmpDir() {
+  return fs.mkdtempSync(path.join(os.tmpdir(), 'xds-paths-test-'));
+}
+
+beforeEach(() => {
+  tmpDir = makeTmpDir();
+});
+
+afterEach(() => {
+  fs.rmSync(tmpDir, {recursive: true, force: true});
+});
+
+describe('findCoreDir', () => {
+  it('finds packages/core walking up directories', () => {
+    const coreDir = path.join(tmpDir, 'packages', 'core');
+    fs.mkdirSync(coreDir, {recursive: true});
+
+    const nested = path.join(tmpDir, 'sub', 'deep');
+    fs.mkdirSync(nested, {recursive: true});
+
+    expect(findCoreDir(nested)).toBe(coreDir);
+  });
+
+  it('finds node_modules/@astryxdesign/core fallback', () => {
+    const nmCore = path.join(tmpDir, 'node_modules', '@astryxdesign', 'core');
+    fs.mkdirSync(nmCore, {recursive: true});
+
+    expect(findCoreDir(tmpDir)).toBe(nmCore);
+  });
+
+  it('returns null when nothing found', () => {
+    expect(findCoreDir(tmpDir)).toBeNull();
+  });
+});
+
+describe('findProjectRoot', () => {
+  it('finds root with workspaces in package.json', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({name: 'root', workspaces: ['packages/*']}),
+    );
+
+    const nested = path.join(tmpDir, 'packages', 'foo');
+    fs.mkdirSync(nested, {recursive: true});
+
+    expect(findProjectRoot(nested)).toBe(tmpDir);
+  });
+
+  it('returns null when no workspaces found', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({name: 'no-workspaces'}),
+    );
+
+    expect(findProjectRoot(tmpDir)).toBeNull();
+  });
+});
+
+describe('discoverExternalPackages', () => {
+  it('finds packages with an "astryx" field in package.json', () => {
+    const nm = path.join(tmpDir, 'node_modules');
+    const extDir = path.join(nm, 'xds-charts');
+    fs.mkdirSync(extDir, {recursive: true});
+    fs.writeFileSync(
+      path.join(extDir, 'package.json'),
+      JSON.stringify({
+        name: 'xds-charts',
+        astryx: {docs: './src', category: 'Data Viz'},
+      }),
+    );
+
+    const result = discoverExternalPackages(tmpDir);
+    expect(result).toEqual([
+      {
+        name: 'xds-charts',
+        category: 'Data Viz',
+        docsDir: path.join(extDir, 'src'),
+        blocksDir: null,
+      },
+    ]);
+  });
+
+  it('handles scoped packages (@org/pkg)', () => {
+    const nm = path.join(tmpDir, 'node_modules');
+    const scopedDir = path.join(nm, '@acme', 'xds-widgets');
+    fs.mkdirSync(scopedDir, {recursive: true});
+    fs.writeFileSync(
+      path.join(scopedDir, 'package.json'),
+      JSON.stringify({
+        name: '@acme/xds-widgets',
+        astryx: {docs: './lib', category: 'Widgets'},
+      }),
+    );
+
+    const result = discoverExternalPackages(tmpDir);
+    expect(result).toEqual([
+      {
+        name: '@acme/xds-widgets',
+        category: 'Widgets',
+        docsDir: path.join(scopedDir, 'lib'),
+        blocksDir: null,
+      },
+    ]);
+  });
+
+  it('skips @astryxdesign/core', () => {
+    const nm = path.join(tmpDir, 'node_modules');
+    const coreDir = path.join(nm, '@astryxdesign', 'core');
+    fs.mkdirSync(coreDir, {recursive: true});
+    fs.writeFileSync(
+      path.join(coreDir, 'package.json'),
+      JSON.stringify({
+        name: '@astryxdesign/core',
+        astryx: {docs: './src'},
+      }),
+    );
+
+    const result = discoverExternalPackages(tmpDir);
+    expect(result).toEqual([]);
+  });
+
+  it('skips packages without "astryx" field', () => {
+    const nm = path.join(tmpDir, 'node_modules');
+    const extDir = path.join(nm, 'some-lib');
+    fs.mkdirSync(extDir, {recursive: true});
+    fs.writeFileSync(
+      path.join(extDir, 'package.json'),
+      JSON.stringify({name: 'some-lib'}),
+    );
+
+    const result = discoverExternalPackages(tmpDir);
+    expect(result).toEqual([]);
+  });
+
+  it('defaults category to package name when not specified', () => {
+    const nm = path.join(tmpDir, 'node_modules');
+    const extDir = path.join(nm, 'my-components');
+    fs.mkdirSync(extDir, {recursive: true});
+    fs.writeFileSync(
+      path.join(extDir, 'package.json'),
+      JSON.stringify({
+        name: 'my-components',
+        astryx: {docs: './docs'},
+      }),
+    );
+
+    const result = discoverExternalPackages(tmpDir);
+    expect(result[0].category).toBe('my-components');
+  });
+
+  it('returns empty array when no node_modules found', () => {
+    const result = discoverExternalPackages(tmpDir);
+    expect(result).toEqual([]);
+  });
+
+  it('walks up directories to find node_modules', () => {
+    const nm = path.join(tmpDir, 'node_modules');
+    const extDir = path.join(nm, 'xds-ext');
+    fs.mkdirSync(extDir, {recursive: true});
+    fs.writeFileSync(
+      path.join(extDir, 'package.json'),
+      JSON.stringify({
+        name: 'xds-ext',
+        astryx: {docs: './src'},
+      }),
+    );
+
+    const nested = path.join(tmpDir, 'packages', 'app');
+    fs.mkdirSync(nested, {recursive: true});
+
+    const result = discoverExternalPackages(nested);
+    expect(result).toHaveLength(1);
+    expect(result[0].name).toBe('xds-ext');
+  });
+
+  it('handles invalid JSON in package.json gracefully', () => {
+    const nm = path.join(tmpDir, 'node_modules');
+    const extDir = path.join(nm, 'bad-json');
+    fs.mkdirSync(extDir, {recursive: true});
+    fs.writeFileSync(path.join(extDir, 'package.json'), '{not valid json!!!');
+
+    const result = discoverExternalPackages(tmpDir);
+    expect(result).toEqual([]);
+  });
+});
+
+describe('listComponents', () => {
+  it('returns sorted component directory names, skipping hooks/theme/utils', () => {
+    const srcDir = path.join(tmpDir, 'src');
+    for (const dir of ['Button', 'Avatar', 'hooks', 'theme', 'utils', 'Zebra']) {
+      fs.mkdirSync(path.join(srcDir, dir), {recursive: true});
+    }
+
+    const result = listComponents(tmpDir);
+    expect(result).toEqual(['Avatar', 'Button', 'Zebra']);
+  });
+
+  it('returns empty array when src dir is missing', () => {
+    expect(listComponents(tmpDir)).toEqual([]);
+  });
+});

package/src/utils/semver.mjs

@@ -0,0 +1,72 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file Minimal semver utilities for the CLI.
+ *
+ * We deliberately avoid pulling in `semver` from npm — Astryx releases follow a
+ * strict `MAJOR.MINOR.PATCH[-prerelease]` shape and the CLI runs in consumer
+ * sandboxes where a smaller dependency surface is preferred.
+ */
+
+const SEMVER_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+
+/**
+ * True if `value` looks like a valid semver string (MAJOR.MINOR.PATCH with
+ * optional prerelease/build metadata).
+ *
+ * @param {unknown} value
+ * @returns {boolean}
+ */
+export function isValidSemver(value) {
+  return typeof value === 'string' && SEMVER_RE.test(value);
+}
+
+/**
+ * Compare two semver strings numerically.
+ *
+ * Returns a negative number if `a < b`, positive if `a > b`, 0 if equal.
+ * Prerelease tags are stripped — `0.0.5-beta.1` compares equal to `0.0.5`.
+ * That's adequate for the upgrade gate, which only cares about ordering of
+ * released versions.
+ *
+ * @param {string} a
+ * @param {string} b
+ * @returns {number}
+ */
+export function semverCompare(a, b) {
+  const pa = String(a).split('-')[0].split('.').map(Number);
+  const pb = String(b).split('-')[0].split('.').map(Number);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const na = pa[i] ?? 0;
+    const nb = pb[i] ?? 0;
+    if (Number.isNaN(na) || Number.isNaN(nb)) {
+      // Fall back to lexicographic compare on garbage input rather than
+      // returning NaN, which would silently break sort/filter callers.
+      return String(a).localeCompare(String(b));
+    }
+    if (na !== nb) return na - nb;
+  }
+  return 0;
+}
+
+/**
+ * `true` if `a` is greater than or equal to `b` in semver order.
+ *
+ * @param {string} a
+ * @param {string} b
+ * @returns {boolean}
+ */
+export function semverGte(a, b) {
+  return semverCompare(a, b) >= 0;
+}
+
+/**
+ * `true` if `a` is strictly greater than `b` in semver order.
+ *
+ * @param {string} a
+ * @param {string} b
+ * @returns {boolean}
+ */
+export function semverGt(a, b) {
+  return semverCompare(a, b) > 0;
+}

package/src/utils/semver.test.mjs

@@ -0,0 +1,67 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+import {describe, it, expect} from 'vitest';
+import {isValidSemver, semverCompare, semverGt, semverGte} from './semver.mjs';
+
+describe('semverCompare', () => {
+  it('orders patch versions numerically (not lexicographically)', () => {
+    // The bug fix that motivated this util: '0.0.10' < '0.0.9' under
+    // string comparison, but '0.0.10' > '0.0.9' under semver.
+    expect(semverCompare('0.0.10', '0.0.9')).toBeGreaterThan(0);
+    expect(semverCompare('0.0.9', '0.0.10')).toBeLessThan(0);
+    expect(semverCompare('0.0.20', '0.0.5')).toBeGreaterThan(0);
+  });
+
+  it('returns 0 for equal versions', () => {
+    expect(semverCompare('1.2.3', '1.2.3')).toBe(0);
+  });
+
+  it('orders by major, then minor, then patch', () => {
+    expect(semverCompare('2.0.0', '1.99.99')).toBeGreaterThan(0);
+    expect(semverCompare('1.2.0', '1.1.99')).toBeGreaterThan(0);
+  });
+
+  it('strips prerelease tags before comparing', () => {
+    expect(semverCompare('0.0.5-beta.1', '0.0.5')).toBe(0);
+  });
+
+  it('treats missing components as zero', () => {
+    expect(semverCompare('1.0', '1.0.0')).toBe(0);
+  });
+});
+
+describe('semverGt / semverGte', () => {
+  it('semverGte is true for equal versions', () => {
+    expect(semverGte('0.0.5', '0.0.5')).toBe(true);
+    expect(semverGt('0.0.5', '0.0.5')).toBe(false);
+  });
+
+  it('semverGte handles double-digit patches correctly', () => {
+    // The original upgrade-gate bug: string compare said 0.0.9 >= 0.0.10.
+    expect(semverGte('0.0.9', '0.0.10')).toBe(false);
+    expect(semverGte('0.0.10', '0.0.9')).toBe(true);
+  });
+});
+
+describe('isValidSemver', () => {
+  it('accepts MAJOR.MINOR.PATCH', () => {
+    expect(isValidSemver('0.0.5')).toBe(true);
+    expect(isValidSemver('1.2.3')).toBe(true);
+    expect(isValidSemver('10.20.30')).toBe(true);
+  });
+
+  it('accepts prerelease and build metadata', () => {
+    expect(isValidSemver('1.0.0-beta.1')).toBe(true);
+    expect(isValidSemver('1.0.0+build.5')).toBe(true);
+  });
+
+  it('rejects bogus values', () => {
+    expect(isValidSemver('bogus')).toBe(false);
+    expect(isValidSemver('1.0')).toBe(false);
+    expect(isValidSemver('v1.0.0')).toBe(false);
+    expect(isValidSemver('')).toBe(false);
+    expect(isValidSemver(null)).toBe(false);
+    expect(isValidSemver(undefined)).toBe(false);
+    expect(isValidSemver(123)).toBe(false);
+  });
+});

package/src/utils/update-check.mjs

@@ -0,0 +1,104 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file Check for newer @astryxdesign/core versions via local signals.
+ *
+ * Resolution order:
+ * 1. $ASTRYX_LATEST_VERSION env var (set by previous CLI invocation)
+ * 2. xds.versionFile in consumer's package.json (e.g. ../../libs/xds-common/LATEST_VERSION)
+ * 3. If neither: no hint (no network calls from this module)
+ *
+ * When a newer version is detected, returns a hint string for CLI output.
+ * Also sets $ASTRYX_LATEST_VERSION for subsequent commands in the same shell.
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import {semverGt} from './semver.mjs';
+
+/**
+ * Read the latest available version from local signals.
+ * No network calls — purely filesystem and env var checks.
+ *
+ * @param {string} [cwd] - Project directory (default: process.cwd())
+ * @returns {string|null} Latest version string, or null if unknown
+ */
+export function getLatestVersion(cwd = process.cwd()) {
+  // 1. Check env var (fastest — set by previous CLI run)
+  const envVersion = process.env.ASTRYX_LATEST_VERSION;
+  if (envVersion && /^\d+\.\d+\.\d+/.test(envVersion)) {
+    return envVersion;
+  }
+
+  // 2. Check versionFile from package.json config
+  try {
+    const pkgPath = path.resolve(cwd, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+      const versionFile = pkg.astryx?.versionFile;
+
+      if (versionFile) {
+        const filePath = path.resolve(cwd, versionFile);
+        if (fs.existsSync(filePath)) {
+          const version = fs.readFileSync(filePath, 'utf-8').trim();
+          if (/^\d+\.\d+\.\d+/.test(version)) {
+            return version;
+          }
+        }
+      }
+    }
+  } catch {
+    // Silently fail — version check should never break the CLI
+  }
+
+  return null;
+}
+
+/**
+ * Get the currently installed @astryxdesign/core version from the consumer's package.json.
+ *
+ * @param {string} [cwd] - Project directory
+ * @returns {string|null} Installed version, or null
+ */
+export function getInstalledVersion(cwd = process.cwd()) {
+  try {
+    const pkgPath = path.resolve(cwd, 'package.json');
+    if (!fs.existsSync(pkgPath)) return null;
+
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    const deps = {...pkg.dependencies, ...pkg.devDependencies};
+    const version = deps['@astryxdesign/core'];
+    if (!version) return null;
+
+    // Strip semver range prefix
+    return version.replace(/^[^\d]*/, '');
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Check for available updates and return a hint string if one exists.
+ * Also sets $ASTRYX_LATEST_VERSION env var for subsequent commands.
+ *
+ * @param {string} [cwd] - Project directory
+ * @returns {string|null} FYI hint string, or null if up to date / unknown
+ */
+export function checkForUpdate(cwd = process.cwd()) {
+  const latest = getLatestVersion(cwd);
+  if (!latest) return null;
+
+  // Persist for subsequent commands in this shell session
+  process.env.ASTRYX_LATEST_VERSION = latest;
+
+  const installed = getInstalledVersion(cwd);
+  if (!installed) return null;
+
+  // Use semver-aware comparison so '0.0.20' is correctly treated as greater
+  // than '0.0.5' (lexicographic compare gets that backwards).
+  if (semverGt(latest, installed)) {
+    return `FYI: A newer version of @astryxdesign/core (${latest}) is available. You can upgrade with: astryx upgrade --apply --to ${latest}`;
+  }
+
+  return null;
+}

package/src/utils/update-check.test.mjs

@@ -0,0 +1,199 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+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 {
+  getLatestVersion,
+  getInstalledVersion,
+  checkForUpdate,
+} from './update-check.mjs';
+
+let tmpDir;
+const originalEnv = {};
+
+beforeEach(() => {
+  tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'xds-update-check-'));
+  // Save and clear env
+  originalEnv.ASTRYX_LATEST_VERSION = process.env.ASTRYX_LATEST_VERSION;
+  delete process.env.ASTRYX_LATEST_VERSION;
+});
+
+afterEach(() => {
+  fs.rmSync(tmpDir, {recursive: true, force: true});
+  // Restore env
+  if (originalEnv.ASTRYX_LATEST_VERSION !== undefined) {
+    process.env.ASTRYX_LATEST_VERSION = originalEnv.ASTRYX_LATEST_VERSION;
+  } else {
+    delete process.env.ASTRYX_LATEST_VERSION;
+  }
+});
+
+describe('getLatestVersion', () => {
+  it('reads from ASTRYX_LATEST_VERSION env var', () => {
+    process.env.ASTRYX_LATEST_VERSION = '0.0.8';
+    expect(getLatestVersion(tmpDir)).toBe('0.0.8');
+  });
+
+  it('ignores invalid env var values', () => {
+    process.env.ASTRYX_LATEST_VERSION = 'not-a-version';
+    expect(getLatestVersion(tmpDir)).toBeNull();
+  });
+
+  it('reads from versionFile in package.json', () => {
+    const versionFilePath = path.join(tmpDir, 'LATEST_VERSION');
+    fs.writeFileSync(versionFilePath, '0.0.9\n');
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({astryx: {versionFile: './LATEST_VERSION'}}),
+    );
+
+    expect(getLatestVersion(tmpDir)).toBe('0.0.9');
+  });
+
+  it('returns null when no signals exist', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({name: 'test'}),
+    );
+    expect(getLatestVersion(tmpDir)).toBeNull();
+  });
+
+  it('returns null when versionFile path does not exist', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({astryx: {versionFile: './missing/LATEST_VERSION'}}),
+    );
+    expect(getLatestVersion(tmpDir)).toBeNull();
+  });
+
+  it('env var takes priority over versionFile', () => {
+    process.env.ASTRYX_LATEST_VERSION = '1.0.0';
+    const versionFilePath = path.join(tmpDir, 'LATEST_VERSION');
+    fs.writeFileSync(versionFilePath, '0.0.9\n');
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({astryx: {versionFile: './LATEST_VERSION'}}),
+    );
+
+    expect(getLatestVersion(tmpDir)).toBe('1.0.0');
+  });
+});
+
+describe('getInstalledVersion', () => {
+  it('reads @astryxdesign/core version from dependencies', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({dependencies: {'@astryxdesign/core': '^0.0.7'}}),
+    );
+    expect(getInstalledVersion(tmpDir)).toBe('0.0.7');
+  });
+
+  it('strips semver range prefix', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({dependencies: {'@astryxdesign/core': '~0.0.5'}}),
+    );
+    expect(getInstalledVersion(tmpDir)).toBe('0.0.5');
+  });
+
+  it('returns null when @astryxdesign/core is not a dependency', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({dependencies: {react: '^19.0.0'}}),
+    );
+    expect(getInstalledVersion(tmpDir)).toBeNull();
+  });
+});
+
+describe('checkForUpdate', () => {
+  it('returns hint when newer version is available', () => {
+    process.env.ASTRYX_LATEST_VERSION = '0.0.8';
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({dependencies: {'@astryxdesign/core': '^0.0.7'}}),
+    );
+
+    const hint = checkForUpdate(tmpDir);
+    expect(hint).toContain('0.0.8');
+    expect(hint).toContain('astryx upgrade --apply --to 0.0.8');
+    expect(hint).toContain('FYI');
+  });
+
+  it('returns null when up to date', () => {
+    process.env.ASTRYX_LATEST_VERSION = '0.0.7';
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({dependencies: {'@astryxdesign/core': '^0.0.7'}}),
+    );
+
+    expect(checkForUpdate(tmpDir)).toBeNull();
+  });
+
+  it('returns null when no latest version is known', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({dependencies: {'@astryxdesign/core': '^0.0.7'}}),
+    );
+
+    expect(checkForUpdate(tmpDir)).toBeNull();
+  });
+
+  it('sets env var for subsequent calls', () => {
+    const versionFilePath = path.join(tmpDir, 'LATEST_VERSION');
+    fs.writeFileSync(versionFilePath, '0.0.8\n');
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({
+        dependencies: {'@astryxdesign/core': '^0.0.7'},
+        astryx: {versionFile: './LATEST_VERSION'},
+      }),
+    );
+
+    checkForUpdate(tmpDir);
+    expect(process.env.ASTRYX_LATEST_VERSION).toBe('0.0.8');
+  });
+
+  it('reads from versionFile and produces hint', () => {
+    const versionFilePath = path.join(tmpDir, 'LATEST_VERSION');
+    fs.writeFileSync(versionFilePath, '0.0.9\n');
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({
+        dependencies: {'@astryxdesign/core': '^0.0.7'},
+        astryx: {versionFile: './LATEST_VERSION'},
+      }),
+    );
+
+    const hint = checkForUpdate(tmpDir);
+    expect(hint).toContain('0.0.9');
+    expect(hint).toContain('FYI');
+  });
+
+  it('uses semver (not lexicographic) comparison for double-digit patches', () => {
+    // Regression: with string compare, '0.0.20' > '0.0.5' is false because
+    // '2' < '5' lexicographically. Users on 0.0.5 would never be told that
+    // 0.0.20 is available.
+    process.env.ASTRYX_LATEST_VERSION = '0.0.20';
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({dependencies: {'@astryxdesign/core': '^0.0.5'}}),
+    );
+
+    const hint = checkForUpdate(tmpDir);
+    expect(hint).toContain('0.0.20');
+  });
+
+  it('does not suggest an upgrade when latest < installed (semver)', () => {
+    // The mirror-image bug: '0.0.9' > '0.0.10' is true under string compare,
+    // so a stale env hint of 0.0.9 would falsely claim it's "newer" than 0.0.10.
+    process.env.ASTRYX_LATEST_VERSION = '0.0.9';
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({dependencies: {'@astryxdesign/core': '^0.0.10'}}),
+    );
+
+    expect(checkForUpdate(tmpDir)).toBeNull();
+  });
+});

package/templates/blocks/components/AlertDialog/AlertDialogAsyncAction.doc.mjs

@@ -0,0 +1,14 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+  type: 'block',
+  exampleFor: 'AlertDialog',
+  name: 'AlertDialog — Loading',
+  displayName: 'AlertDialog — Loading',
+  description:
+    'A confirmation dialog that shows a spinner while the action runs.',
+  isReady: true,
+  aspectRatio: 4 / 3,
+  componentsUsed: ['AlertDialog'],
+};

package/templates/blocks/components/AlertDialog/AlertDialogAsyncAction.tsx

@@ -0,0 +1,27 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+import {useState} from 'react';
+import {AlertDialog} from '@astryxdesign/core/AlertDialog';
+
+export default function AlertDialogAsyncAction() {
+  const [isLoading, setIsLoading] = useState(false);
+
+  return (
+    <AlertDialog
+      isOpen
+      isInline
+      onOpenChange={() => {}}
+      title="Revoke access?"
+      description="This user will immediately lose access to all shared resources."
+      actionLabel="Revoke"
+      isActionLoading={isLoading}
+      onAction={async () => {
+        setIsLoading(true);
+        await new Promise(r => setTimeout(r, 2000));
+        setIsLoading(false);
+      }}
+    />
+  );
+}