@astryxdesign/cli 0.7.2-canary.fc12a18 → 0.7.2-canary.fdd384f

package/foundation/doc-compiler/links.mjs

@@ -47,10 +47,12 @@ const CODE_SPAN = /(`[^`]*`)/;
  * @typedef {object} DocLink
  * @property {string} target the target as written: `[<provider>:]<kind>:<name>`
  * @property {string} id the doc's identity (a DocId)
- * @property {string} route what `astryx docs <route>` opens
+ * @property {string | null} route what `astryx docs <route>` opens; null for a
+ *   component, page, or block doc, which no docs route opens
  * @property {string} title
  * @property {string} summary
- * @property {string} command the command that opens it, `astryx docs <route>`
+ * @property {string} command the command that opens it: `astryx docs <route>`,
+ *   or `astryx component` or `astryx template` for a component, page, or block
  */
 
 /**

package/foundation/integrations/contribution-inventory.mjs

@@ -248,11 +248,16 @@ export async function collectIdentities(loaded) {
   if (loaded.components && fs.existsSync(loaded.components)) {
     try {
       const records = discoverIntegrationComponents(loaded) ?? [];
+      // A family doc backs several records: load it, and report it, once.
+      const loads = new Map();
       for (const record of records) {
+        const first = !loads.has(record.docPath);
+        if (first) loads.set(record.docPath, loadComponentDoc(record.docPath));
         try {
-          await loadComponentDoc(record.docPath);
+          await loads.get(record.docPath);
           identities.components.push(record.name);
         } catch (err) {
+          if (!first) continue;
           errors.push({
             kind: 'components',
             message: `${path.relative(loaded.components, record.docPath)}: ${

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

@@ -332,7 +332,7 @@ export const doc = {
     {
       value: 'integration.validate',
       description:
-        'The validation result: validated (false when nothing was validated: with no package.json the issues list carries one no_package error so the command exits 1, and with a package.json but no integration manifest the issues list is empty and proves nothing), the package name and version (both null when validated is false) plus issues, an AstryxIntegrationIssue[] of {code, severity: warning | error, message}.',
+        'The validation result: validated (false when nothing was validated: with no package.json the issues list carries one no_package error so the command exits 1, and with a package.json but no integration manifest the issues list is empty and proves nothing), the package name and version (both null when validated is false) plus issues, an AstryxIntegrationIssue[] of {code, severity: warning | error, message}. When the manifest loads, docTypes checks each doc against its published authoring type: status (checked | skipped), reason, typescript, docs, findings (all warnings, each naming the field and a fix), unchecked, and fixtures (test fixture docs not checked).',
     },
     {
       value: 'integration.template-conflicts',
@@ -342,12 +342,17 @@ export const doc = {
     {
       value: 'integration.component-conflicts',
       description:
-        'validated (false when no integration manifest was found, so nothing was inspected), the integration identity, structural issues, and non-blocking conflicts where an integration component name is also owned by Core; each conflict includes the exact package-qualified command.',
+        'validated (false when no integration manifest was found, so nothing was inspected), the integration identity, structural issues, and non-blocking conflicts where an integration component name is also owned by Core; each conflict includes the exact package-qualified command. When the manifest loads and declares a components root, propDrift compares documented props with the TypeScript props: status (checked | skipped), reason, typescript, components, typesCompared, typesSkipped, findings (all warnings), unchecked, typesNotCompared, and propsNotChecked.',
     },
     {
       value: 'integration.doc-conflicts',
       description:
         'validated (false when no integration manifest was found, so nothing was inspected), the integration identity, structural issues, and Core doc overlaps. Each finding includes `severity` (`info` | `error`) and `relationship` (`replaces` | `extends` | `accidental`).',
     },
+    {
+      value: 'integration.check',
+      description:
+        'Every source check of an integration package in one result: validated (false when no integration manifest was found, so nothing was checked), the package name and version, strict, and checks, one entry per check (validate, components, templates, docs), each with check, errors, warnings, skipped, failed, and response, the envelope that check returns on its own. The totals are errors, warnings, and skipped; unchecked counts what the checks could not compare. With --strict, failures lists each warning and each piece of skipped work again as an error, in the issue format the checks use; it is empty without --strict. failed decides the exit code.',
+    },
   ],
 };

package/foundation/xle/registry.mjs

@@ -20,6 +20,7 @@ import path from 'node:path';
 import {findCoreDir} from '../fs/paths.mjs';
 import {
   discoverComponents,
+  familyMember,
   findComponentReadme,
   resolveImportPath,
 } from '../discovery/component-discovery.mjs';
@@ -126,6 +127,9 @@ export async function buildRegistry({cwd = process.cwd()} = {}) {
     } catch {
       continue; // a malformed doc must not take down the whole language
     }
+    // A member documented in its family's doc (VStack in Stack's doc) is
+    // registered by the family's own folder, with every other member.
+    if (familyMember(docs, dirName)) continue;
     const importPath = resolveImportPath(coreDir, dirName);
 
     const register = (/** @type {string} */ rawName, /** @type {import('./xle-ast').DocProp[]} */ props) => {

package/foundation/xle/registry.test.mjs

@@ -0,0 +1,28 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file The layout-language registry over the real @astryxdesign/core tree:
+ * the import path it emits for each component.
+ */
+
+import {describe, it, expect} from 'vitest';
+import * as path from 'node:path';
+import {fileURLToPath} from 'node:url';
+import {buildRegistry} from './registry.mjs';
+
+const REPO = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../../..');
+
+describe('buildRegistry import paths', () => {
+  it('keeps the Stack family on the paths it registers from Stack\'s folder', async () => {
+    // HStack and VStack are listed components whose docs live in Stack's doc.
+    // Listing them must not let their folders re-register the family under
+    // their own paths: a member's folder registers nothing, Stack's does.
+    const {components} = await buildRegistry({cwd: REPO});
+    const importOf = (/** @type {string} */ name) => components.get(name)?.importPath;
+    for (const name of ['Stack', 'StackItem', 'HStack', 'VStack']) {
+      expect(importOf(name), name).toBe('@astryxdesign/core/Stack');
+    }
+    expect(importOf('Heading')).toBe('@astryxdesign/core/Heading');
+    expect(importOf('Text')).toBe('@astryxdesign/core/Text');
+  }, 120_000);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/cli",
-  "version": "0.7.2-canary.fc12a18",
+  "version": "0.7.2-canary.fdd384f",
   "displayName": "CLI",
   "description": "Scaffold projects, browse templates, generate themes, and get agent-ready docs from the command line.",
   "author": "Meta Open Source",
@@ -96,15 +96,15 @@
     "jscodeshift": "^17.3.0",
     "node-diff3": "3.2.1",
     "postcss": "^8.5.23",
-    "postcss-selector-parser": "^7.1.5",
+    "postcss-selector-parser": "^7.1.6",
     "recast": "0.23.21",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@astryxdesign/charts": "0.7.2-canary.fc12a18",
-    "@astryxdesign/core": "0.7.2-canary.fc12a18",
-    "@astryxdesign/lab": "0.7.2-canary.fc12a18",
-    "@astryxdesign/theme-neutral": "0.7.2-canary.fc12a18"
+    "@astryxdesign/charts": "0.7.2-canary.fdd384f",
+    "@astryxdesign/core": "0.7.2-canary.fdd384f",
+    "@astryxdesign/lab": "0.7.2-canary.fdd384f",
+    "@astryxdesign/theme-neutral": "0.7.2-canary.fdd384f"
   },
   "peerDependenciesMeta": {
     "@astryxdesign/charts": {
@@ -121,10 +121,10 @@
     }
   },
   "devDependencies": {
-    "@astryxdesign/charts": "0.7.2-canary.fc12a18",
-    "@astryxdesign/core": "0.7.2-canary.fc12a18",
-    "@astryxdesign/lab": "0.7.2-canary.fc12a18",
-    "@astryxdesign/theme-neutral": "0.7.2-canary.fc12a18",
+    "@astryxdesign/charts": "0.7.2-canary.fdd384f",
+    "@astryxdesign/core": "0.7.2-canary.fdd384f",
+    "@astryxdesign/lab": "0.7.2-canary.fdd384f",
+    "@astryxdesign/theme-neutral": "0.7.2-canary.fdd384f",
     "@heroicons/react": "^2.2.0",
     "@stylexjs/stylex": "^0.19.0",
     "@types/babel__core": "^7.20.5",