@codecademy/gamut 68.6.1-alpha.e6c390.0 → 68.6.1-alpha.f6b2ce.0

package/bin/lib/design.mjs

@@ -0,0 +1,71 @@
+import { copyFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+
+/** @type {Record<string, { sourceFile: string, label: string }>} */
+const THEME_ALIASES = {
+  core: { sourceFile: 'DESIGN.Codecademy.md', label: 'Codecademy (Core)' },
+  codecademy: {
+    sourceFile: 'DESIGN.Codecademy.md',
+    label: 'Codecademy (Core)',
+  },
+  cc: { sourceFile: 'DESIGN.Codecademy.md', label: 'Codecademy (Core)' },
+  admin: { sourceFile: 'DESIGN.Codecademy.md', label: 'Codecademy (Admin)' },
+  platform: {
+    sourceFile: 'DESIGN.Codecademy.md',
+    label: 'Codecademy (Platform)',
+  },
+  percipio: { sourceFile: 'DESIGN.Percipio.md', label: 'Percipio' },
+  lxstudio: { sourceFile: 'DESIGN.LXStudio.md', label: 'LX Studio' },
+  'lx-studio': { sourceFile: 'DESIGN.LXStudio.md', label: 'LX Studio' },
+};
+
+const CANONICAL_THEMES = ['core', 'admin', 'platform', 'percipio', 'lxstudio'];
+
+/**
+ * @param {string} name
+ * @returns {{ sourceFile: string, label: string, alias: string }}
+ */
+export function resolveTheme(name) {
+  const alias = name.trim().toLowerCase();
+  const entry = THEME_ALIASES[alias];
+  if (!entry) {
+    throw new Error(
+      `Unknown theme: "${name}". Choose from: ${CANONICAL_THEMES.join(', ')} ` +
+        `(aliases: codecademy, cc, lx-studio, …).`
+    );
+  }
+  return { ...entry, alias };
+}
+
+/** @returns {string[]} */
+export function listCanonicalThemes() {
+  return [...CANONICAL_THEMES];
+}
+
+/**
+ * @param {string} sourceRoot agent-tools directory
+ * @param {string} cwd destination directory (app repo root)
+ * @param {string} theme
+ * @param {{ force?: boolean }} [options]
+ * @returns {Promise<{ dest: string, label: string }>}
+ */
+export async function installDesignMd(sourceRoot, cwd, theme, options = {}) {
+  const { sourceFile, label } = resolveTheme(theme);
+  const src = join(sourceRoot, sourceFile);
+  const dest = join(cwd, 'DESIGN.md');
+
+  const srcStat = await stat(src).catch(() => null);
+  if (!srcStat?.isFile()) {
+    throw new Error(`DESIGN source not found: ${src}`);
+  }
+
+  const destStat = await stat(dest).catch(() => null);
+  if (destStat?.isFile() && !options.force) {
+    throw new Error(
+      `DESIGN.md already exists at ${dest}. Use --force to overwrite, or remove it first.`
+    );
+  }
+
+  await copyFile(src, dest);
+  return { dest, label };
+}

package/bin/lib/io.mjs

@@ -0,0 +1,14 @@
+/** @param {string} message */
+export function log(message) {
+  process.stdout.write(message.endsWith('\n') ? message : `${message}\n`);
+}
+
+/** @param {string} message */
+export function warn(message) {
+  process.stderr.write(message.endsWith('\n') ? message : `${message}\n`);
+}
+
+/** @param {string} message */
+export function error(message) {
+  process.stderr.write(message.endsWith('\n') ? message : `${message}\n`);
+}

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@codecademy/gamut",
   "description": "Styleguide & Component library for Codecademy",
-  "version": "68.6.1-alpha.e6c390.0",
+  "version": "68.6.1-alpha.f6b2ce.0",
   "author": "Codecademy Engineering <dev@codecademy.com>",
   "bin": "./bin/gamut.mjs",
   "dependencies": {
-    "@codecademy/gamut-icons": "9.57.6-alpha.e6c390.0",
-    "@codecademy/gamut-illustrations": "0.58.12-alpha.e6c390.0",
-    "@codecademy/gamut-patterns": "0.10.31-alpha.e6c390.0",
-    "@codecademy/gamut-styles": "18.0.1-alpha.e6c390.0",
-    "@codecademy/variance": "0.26.2-alpha.e6c390.0",
+    "@codecademy/gamut-icons": "9.57.6-alpha.f6b2ce.0",
+    "@codecademy/gamut-illustrations": "0.58.12-alpha.f6b2ce.0",
+    "@codecademy/gamut-patterns": "0.10.31-alpha.f6b2ce.0",
+    "@codecademy/gamut-styles": "18.0.1-alpha.f6b2ce.0",
+    "@codecademy/variance": "0.26.2-alpha.f6b2ce.0",
     "@formatjs/intl-locale": "5.3.1",
     "@react-aria/interactions": "3.25.0",
     "@types/marked": "^4.0.8",

package/bin/lib/figma.mjs

@@ -1,49 +0,0 @@
-import { stat } from 'node:fs/promises';
-import { dirname, join, resolve } from 'node:path';
-
-/**
- * Walk up from `startDir` looking for a `figma.config.json` file.
- * Returns the directory containing it, or null if not found before the filesystem root.
- *
- * @param {string} startDir
- * @returns {Promise<string | null>}
- */
-export async function findFigmaConfigDir(startDir) {
-  let dir = startDir;
-  while (true) {
-    const st = await stat(join(dir, 'figma.config.json')).catch(() => null);
-    if (st?.isFile()) return dir;
-    const parent = dirname(dir);
-    if (parent === dir) return null;
-    dir = parent;
-  }
-}
-
-/**
- * Resolves the destination directory for the guidelines/ folder.
- *
- * Priority:
- *   1. --output <path> if provided (treated as the parent directory)
- *   2. Directory containing the nearest figma.config.json (walking up from cwd)
- *
- * Throws with actionable guidance if neither resolves.
- *
- * @param {string | undefined} outputArg
- * @returns {Promise<{ path: string; discovered: boolean }>}
- */
-export async function resolveFigmaOutput(outputArg) {
-  if (outputArg) {
-    return { path: resolve(outputArg), discovered: false };
-  }
-
-  const dir = await findFigmaConfigDir(process.cwd());
-  if (dir) {
-    return { path: join(dir, 'guidelines'), discovered: true };
-  }
-
-  throw new Error(
-    `Could not find figma.config.json in ${process.cwd()} or any parent directory.\n` +
-      `Provide the destination explicitly with --output:\n` +
-      `  gamut plugin install figma --output /path/to/your/project/guidelines`,
-  );
-}