@astryxdesign/cli 0.7.2-canary.fe2c655 → 0.7.2

package/foundation/discovery/theme-imports.mjs

@@ -19,6 +19,7 @@ import {moduleExportsName} from './module-exports.mjs';
 import {inspectPackageExport} from './package-exports.mjs';
 import {themeImportPackage} from './theme-discovery.mjs';
 import {isLocalThemeOwner, projectPath} from '../config/theme-state.mjs';
+import {formatCliCommand} from '../env/package-manager.mjs';
 
 export class ThemeImportError extends Error {}
 
@@ -59,7 +60,7 @@ function resolveLocalTheme(theme, cwd) {
       path.relative(cwd, path.join(theme.sourceDir, theme.entry)),
     );
     throw new ThemeImportError(
-      `Local theme "${theme.slug}" is not built. Run \`astryx theme build ${source}\` and try again. Missing: ${missing
+      `Local theme "${theme.slug}" is not built. Run \`${formatCliCommand(`theme build ${source}`, cwd)}\` and try again. Missing: ${missing
         .map(file => projectPath(path.relative(cwd, file)))
         .join(', ')}.`,
     );
@@ -68,8 +69,11 @@ function resolveLocalTheme(theme, cwd) {
     throw new ThemeImportError(
       `Local theme "${theme.slug}" built module ${projectPath(
         path.relative(cwd, moduleFile),
-      )} does not export "${theme.exportName}". Rebuild it with \`astryx theme build ${projectPath(
-        path.relative(cwd, path.join(theme.sourceDir, theme.entry)),
+      )} does not export "${theme.exportName}". Rebuild it with \`${formatCliCommand(
+        `theme build ${projectPath(
+          path.relative(cwd, path.join(theme.sourceDir, theme.entry)),
+        )}`,
+        cwd,
       )}\`.`,
     );
   }
@@ -130,7 +134,7 @@ function resolvePackageTheme(theme, cwd, ownerThemeCount) {
     findInstalledPackage(cwd, importPackage);
   if (!packageDir) {
     throw new ThemeImportError(
-      `Theme package "${importPackage}" is not installed. Run \`npm install ${importPackage}\` (or yarn/pnpm/bun), then run \`astryx theme add ${theme.slug}\`.`,
+      `Theme package "${importPackage}" is not installed. Run \`npm install ${importPackage}\` (or yarn/pnpm/bun), then run \`${formatCliCommand(`theme add ${theme.slug}`, cwd)}\`.`,
     );
   }
   const pkg = readPackage(path.join(packageDir, 'package.json'));

package/foundation/discovery/theme-imports.test.mjs

@@ -148,7 +148,7 @@ describe('resolveThemeImports', () => {
     });
 
     expect(() => resolveThemeImports(theme, {cwd: dir})).toThrow(
-      /astryx theme build src\/themes\/ocean\/oceanTheme\.ts/i,
+      / theme build src\/themes\/ocean\/oceanTheme\.ts`/i,
     );
     fs.writeFileSync(
       path.join(sourceDir, 'ocean.js'),

package/foundation/discovery/type-match.d.mts

@@ -0,0 +1,53 @@
+// @generated by scripts/sync-api-types.mjs from the JSDoc in foundation/**/*.mjs.
+// DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
+
+/**
+ * Judge a documented type. A doc may name an alias and spell out what it
+ * stands for, as `Name = expansion` or `Name (expansion)` (text that is not a
+ * type by itself): both parts are judged, and a mismatch in either is one;
+ * with one value after it (`Size = 'md'`, `Size = Size.Md`), or after a
+ * keyword, that part may be a default, and only the name is judged.
+ * @param {string} docType
+ * @param {any[]} codeTypes the prop's type in each member of the props type
+ * @param {JudgeContext} ctx
+ * @returns {TypeVerdict}
+ */
+export function judgeType(docType: string, codeTypes: any[], ctx: JudgeContext): TypeVerdict;
+export type TypeVerdict = "match" | "mismatch" | "not_compared";
+export type JudgeContext = {
+    ts: any;
+    checker: any;
+    /**
+     * where names in the documented type resolve (the
+     * prop's declaration, else the component's source file)
+     */
+    location: any;
+    /**
+     * the prop is optional, so `undefined` is set
+     * aside on both sides
+     */
+    optional: boolean;
+    /**
+     * whether a source
+     * file is one of TypeScript's own libraries
+     */
+    isDefaultLibrary?: ((file: any) => boolean) | undefined;
+    /**
+     * the project checks without strict null
+     * checks, so the compiler drops `null` and `undefined` from every type and
+     * both are set aside on both sides
+     */
+    nullable?: boolean | undefined;
+    /**
+     * the project sets
+     * `exactOptionalPropertyTypes`: an optional prop takes `undefined` only when
+     * its type says so, and the compiler's mark for an absent prop is not a
+     * type the prop takes
+     */
+    exactOptional?: boolean | undefined;
+    /**
+     * the code's type as the source writes it and
+     * as the compiler prints it, each a list of union members
+     */
+    written: string[][];
+};