@astryxdesign/cli 0.6.3-canary.db4e378 → 0.6.3-canary.db7b338

package/foundation/response/error-codes.mjs

@@ -64,6 +64,8 @@
  *   | 'ERR_UNKNOWN_FEATURE'
  *   | 'ERR_UNKNOWN_CODEMOD'
  *   | 'ERR_CODEMOD_FAILED'
+ *   | 'ERR_CODEMOD_PROTECTED'
+ *   | 'ERR_CODEMOD_PROTECTION_SOURCE'
  *   | 'ERR_NOT_FOUND'
  *   | 'ERR_NO_DOC'
  *   | 'ERR_NO_SHOWCASE'
@@ -161,6 +163,10 @@ export const ERROR_CODES = Object.freeze({
   ERR_UNKNOWN_CODEMOD: 'ERR_UNKNOWN_CODEMOD',
   /** One or more codemods failed during an upgrade run. */
   ERR_CODEMOD_FAILED: 'ERR_CODEMOD_FAILED',
+  /** A required codemod change remains blocked by a protected consumer file. */
+  ERR_CODEMOD_PROTECTED: 'ERR_CODEMOD_PROTECTED',
+  /** A working-tree protection declaration could not be read or parsed. */
+  ERR_CODEMOD_PROTECTION_SOURCE: 'ERR_CODEMOD_PROTECTION_SOURCE',
   /** A generic discover/lookup query matched nothing in any package. */
   ERR_NOT_FOUND: 'ERR_NOT_FOUND',
 
@@ -185,7 +191,7 @@ export const ERROR_CODES = Object.freeze({
   ERR_WRITE_FAILED: 'ERR_WRITE_FAILED',
 
   // ── Theme build ──────────────────────────────────────────────────
-  /** A theme definition or contributed theme catalog is invalid. */
+  /** A theme definition or contributed theme descriptor is invalid. */
   ERR_THEME_INVALID: 'ERR_THEME_INVALID',
   /** A theme file could not be loaded / parsed into a defineTheme result. */
   ERR_THEME_LOAD: 'ERR_THEME_LOAD',

package/foundation/response/error-codes.test.mjs

@@ -86,6 +86,8 @@ describe('error codes: shipped set', () => {
     'ERR_AMBIGUOUS_TEMPLATE',
     'ERR_AMBIGUOUS_THEME',
     'ERR_CODEMOD_FAILED',
+    'ERR_CODEMOD_PROTECTED',
+    'ERR_CODEMOD_PROTECTION_SOURCE',
     'ERR_CORE_INCOMPATIBLE',
     'ERR_CORE_NOT_FOUND',
     'ERR_DEP_MISSING',
@@ -135,25 +137,67 @@ describe('error codes: shipped set', () => {
   ];
 
   it('still carries every shipped code, spelled the same', () => {
-    const missing = SHIPPED.filter(code => !isErrorCode(code) || ERROR_CODES[code] !== code);
+    const missing = SHIPPED.filter(
+      code => !isErrorCode(code) || ERROR_CODES[code] !== code,
+    );
     expect(missing, 'shipped codes removed or respelled').toEqual([]);
   });
 });
 
 describe('error codes: end-to-end JSON envelopes', () => {
   const cases = [
-    {name: 'unknown component', args: ['component', 'Bogus', '--json'], code: 'ERR_UNKNOWN_COMPONENT'},
-    {name: 'unknown hook', args: ['hook', 'bogusHook', '--json'], code: 'ERR_UNKNOWN_HOOK'},
-    {name: 'unknown topic', args: ['docs', 'bogusTopic', '--json'], code: 'ERR_UNKNOWN_TOPIC'},
-    {name: 'unknown template', args: ['template', 'bogusTemplate', '--json'], code: 'ERR_UNKNOWN_TEMPLATE'},
-    {name: 'unknown command', args: ['bogus-cmd', '--json'], code: 'ERR_UNKNOWN_COMMAND'},
-    {name: 'invalid --lang', args: ['docs', 'color', '--lang', 'fr', '--json'], code: 'ERR_INVALID_LANG'},
-    {name: 'invalid --detail', args: ['docs', 'color', '--detail', 'bogus', '--json'], code: 'ERR_INVALID_DETAIL'},
-    {name: 'unknown option', args: ['component', 'Button', '--bogus-flag', '--json'], code: 'ERR_INVALID_OPTION'},
-    {name: 'missing argument', args: ['theme', 'build', '--json'], code: 'ERR_MISSING_ARGUMENT'},
+    {
+      name: 'unknown component',
+      args: ['component', 'Bogus', '--json'],
+      code: 'ERR_UNKNOWN_COMPONENT',
+    },
+    {
+      name: 'unknown hook',
+      args: ['hook', 'bogusHook', '--json'],
+      code: 'ERR_UNKNOWN_HOOK',
+    },
+    {
+      name: 'unknown topic',
+      args: ['docs', 'bogusTopic', '--json'],
+      code: 'ERR_UNKNOWN_TOPIC',
+    },
+    {
+      name: 'unknown template',
+      args: ['template', 'bogusTemplate', '--json'],
+      code: 'ERR_UNKNOWN_TEMPLATE',
+    },
+    {
+      name: 'unknown command',
+      args: ['bogus-cmd', '--json'],
+      code: 'ERR_UNKNOWN_COMMAND',
+    },
+    {
+      name: 'invalid --lang',
+      args: ['docs', 'color', '--lang', 'fr', '--json'],
+      code: 'ERR_INVALID_LANG',
+    },
+    {
+      name: 'invalid --detail',
+      args: ['docs', 'color', '--detail', 'bogus', '--json'],
+      code: 'ERR_INVALID_DETAIL',
+    },
+    {
+      name: 'unknown option',
+      args: ['component', 'Button', '--bogus-flag', '--json'],
+      code: 'ERR_INVALID_OPTION',
+    },
+    {
+      name: 'missing argument',
+      args: ['theme', 'build', '--json'],
+      code: 'ERR_MISSING_ARGUMENT',
+    },
     // `theme` is not on the --json allowlist, so --json on any theme subcommand
     // is rejected at the preAction gate with a stable invalid-option code.
-    {name: 'json not supported', args: ['theme', 'bogus-sub', '--json'], code: 'ERR_INVALID_OPTION'},
+    {
+      name: 'json not supported',
+      args: ['theme', 'bogus-sub', '--json'],
+      code: 'ERR_INVALID_OPTION',
+    },
   ];
 
   for (const {name, args, code} of cases) {

package/foundation/response/response-types.doc.mjs

@@ -13,7 +13,7 @@ export const doc = {
   type: 'enum',
   name: 'response-types',
   displayName: 'Response Types',
-  namespace: 'cli',
+  namespace: 'cli/api',
   description:
     'The `type` discriminant present on every --json success envelope. Consumers switch on it to narrow `data`.',
   members: [

package/foundation/response/response.doc.mjs

@@ -12,7 +12,7 @@ export const doc = {
   type: 'schema',
   name: 'output',
   displayName: 'Output Envelope',
-  namespace: 'cli',
+  namespace: 'cli/api',
   description:
     'The single JSON envelope every command emits under --json. Success is ' +
     '{ apiVersion, type, data, meta? }; failure is { apiVersion, error, code, ' +

package/foundation/text/string-utils.mjs

@@ -56,7 +56,7 @@ export function findClosestComponents(name, components, maxDistance = 3) {
  * @returns {Promise<{name: string, score: number, reason: string}[]>}
  */
 export async function searchComponents(needle, coreDir, components) {
-  const {pathToFileURL} = await import('node:url');
+  const {readDocView} = await import('../doc-compiler/read.mjs');
   const fs = await import('node:fs');
   const path = await import('node:path');
 
@@ -100,8 +100,10 @@ export async function searchComponents(needle, coreDir, components) {
     // Levenshtein on name
     const dist = levenshteinDistance(term, compLower);
     if (dist === 1) addMatch(comp, 80, 'similar name (distance ' + dist + ')');
-    else if (dist === 2) addMatch(comp, 40, 'similar name (distance ' + dist + ')');
-    else if (dist === 3) addMatch(comp, 20, 'similar name (distance ' + dist + ')');
+    else if (dist === 2)
+      addMatch(comp, 40, 'similar name (distance ' + dist + ')');
+    else if (dist === 3)
+      addMatch(comp, 20, 'similar name (distance ' + dist + ')');
   }
 
   // --- Pass 2: Keyword + description matching (async, reads doc files) ---
@@ -124,15 +126,22 @@ export async function searchComponents(needle, coreDir, components) {
       for (const entry of entries) {
         if (!entry.isDirectory()) continue;
         const nested = path.join(srcDir, entry.name, comp, comp + '.doc.mjs');
-        if (fs.existsSync(nested)) { docPath = nested; break; }
+        if (fs.existsSync(nested)) {
+          docPath = nested;
+          break;
+        }
       }
     }
 
     if (!docPath) continue;
 
     try {
-      const mod = await import(pathToFileURL(docPath).href);
-      const docs = mod.docs;
+      // Only the legacy `docs` export has ever been indexed here.
+      const docs = await readDocView(docPath, {
+        root: 'components',
+        loader: 'native',
+        exports: ['docs'],
+      });
       if (!docs) continue;
 
       // Keyword matching
@@ -157,8 +166,10 @@ export async function searchComponents(needle, coreDir, components) {
           }
 
           const dist = levenshteinDistance(term, kwLower);
-          if (dist === 1) addMatch(comp, 70, 'keyword "' + kw + '" (distance ' + dist + ')');
-          else if (dist === 2) addMatch(comp, 30, 'keyword "' + kw + '" (distance ' + dist + ')');
+          if (dist === 1)
+            addMatch(comp, 70, 'keyword "' + kw + '" (distance ' + dist + ')');
+          else if (dist === 2)
+            addMatch(comp, 30, 'keyword "' + kw + '" (distance ' + dist + ')');
         }
       }
 
@@ -191,8 +202,9 @@ export async function searchComponents(needle, coreDir, components) {
     }
   }
 
-  const results = Array.from(scored.values())
-    .sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
+  const results = Array.from(scored.values()).sort(
+    (a, b) => b.score - a.score || a.name.localeCompare(b.name),
+  );
 
   return results;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/cli",
-  "version": "0.6.3-canary.db4e378",
+  "version": "0.6.3-canary.db7b338",
   "displayName": "CLI",
   "description": "Scaffold projects, browse templates, generate themes, and get agent-ready docs from the command line.",
   "author": "Meta Open Source",
@@ -91,6 +91,7 @@
     "@babel/types": "7.29.8",
     "ast-types": "0.16.3",
     "commander": "^12.1.0",
+    "ignore": "^7.0.5",
     "jiti": "^2.7.0",
     "jscodeshift": "^17.3.0",
     "node-diff3": "3.2.1",
@@ -100,10 +101,10 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@astryxdesign/charts": "0.6.3-canary.db4e378",
-    "@astryxdesign/core": "0.6.3-canary.db4e378",
-    "@astryxdesign/lab": "0.6.3-canary.db4e378",
-    "@astryxdesign/theme-neutral": "0.6.3-canary.db4e378"
+    "@astryxdesign/charts": "0.6.3-canary.db7b338",
+    "@astryxdesign/core": "0.6.3-canary.db7b338",
+    "@astryxdesign/lab": "0.6.3-canary.db7b338",
+    "@astryxdesign/theme-neutral": "0.6.3-canary.db7b338"
   },
   "peerDependenciesMeta": {
     "@astryxdesign/charts": {
@@ -120,10 +121,10 @@
     }
   },
   "devDependencies": {
-    "@astryxdesign/charts": "0.6.3-canary.db4e378",
-    "@astryxdesign/core": "0.6.3-canary.db4e378",
-    "@astryxdesign/lab": "0.6.3-canary.db4e378",
-    "@astryxdesign/theme-neutral": "0.6.3-canary.db4e378",
+    "@astryxdesign/charts": "0.6.3-canary.db7b338",
+    "@astryxdesign/core": "0.6.3-canary.db7b338",
+    "@astryxdesign/lab": "0.6.3-canary.db7b338",
+    "@astryxdesign/theme-neutral": "0.6.3-canary.db7b338",
     "@heroicons/react": "^2.2.0",
     "@stylexjs/stylex": "^0.19.0",
     "@types/babel__core": "^7.20.5",

package/assets/templates/themes/manifest.json

@@ -1,95 +0,0 @@
-{
-  "version": 1,
-  "generatedBy": "scripts/generate-cli-themes.mjs",
-  "themes": [
-    {
-      "slug": "butter",
-      "displayName": "Butter",
-      "description": "Warm, creamy yellows with a friendly blue accent. Playful enough for consumer surfaces, soft enough to stay readable.",
-      "maintained": false,
-      "entry": "butterTheme.ts",
-      "exportName": "butterTheme",
-      "files": [
-        "butterTheme.ts",
-        "icons.tsx"
-      ]
-    },
-    {
-      "slug": "chocolate",
-      "displayName": "Chocolate",
-      "description": "Warm chocolate theme for Astryx — rich brown palette with Fraunces headings, Albert Sans body, and Lucide icons",
-      "maintained": false,
-      "entry": "chocolateTheme.ts",
-      "exportName": "chocolateTheme",
-      "files": [
-        "chocolateTheme.ts",
-        "icons.tsx"
-      ]
-    },
-    {
-      "slug": "gothic",
-      "displayName": "Gothic",
-      "description": "Deep blue-grays and a signature display serif. Dramatic and editorial, for surfaces that want to be remembered.",
-      "maintained": false,
-      "entry": "gothicTheme.ts",
-      "exportName": "gothicTheme",
-      "files": [
-        "gothicTheme.ts",
-        "icons.tsx"
-      ]
-    },
-    {
-      "slug": "matcha",
-      "displayName": "Matcha",
-      "description": "Earthy greens with a calm, organic feel. Naturalistic and grounded, great for wellness or content-first apps.",
-      "maintained": false,
-      "entry": "matchaTheme.ts",
-      "exportName": "matchaTheme",
-      "files": [
-        "matchaTheme.ts",
-        "icons.tsx"
-      ]
-    },
-    {
-      "slug": "neutral",
-      "displayName": "Neutral",
-      "description": "Restrained warm grays. Minimal and quiet, so the content stays the focus.",
-      "maintained": true,
-      "entry": "neutralTheme.ts",
-      "exportName": "neutralTheme",
-      "files": [
-        "neutralTheme.ts",
-        "icons.tsx",
-        "neutralPalettes.ts",
-        "neutralPalettes.generated.ts",
-        "neutralPaletteRefs.generated.ts",
-        "neutralPalettes.generated.receipt.json",
-        "palette.config.json"
-      ]
-    },
-    {
-      "slug": "stone",
-      "displayName": "Stone",
-      "description": "Warm stone and slate, earthy and understated, with just enough character to feel handcrafted.",
-      "maintained": false,
-      "entry": "stoneTheme.ts",
-      "exportName": "stoneTheme",
-      "files": [
-        "stoneTheme.ts",
-        "icons.tsx"
-      ]
-    },
-    {
-      "slug": "y2k",
-      "displayName": "Y2K",
-      "description": "Hot pinks, lime greens, and Poppins. Bubbly, playful, and unmistakably retro.",
-      "maintained": false,
-      "entry": "y2kTheme.ts",
-      "exportName": "y2kTheme",
-      "files": [
-        "y2kTheme.ts",
-        "icons.tsx"
-      ]
-    }
-  ]
-}