@codecademy/gamut 68.6.1-alpha.edab62.0 → 68.6.1

package/bin/gamut.mjs

@@ -1,92 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Gamut CLI
- *
- * Usage:
- *   gamut plugin install [cursor|claude|figma] [--scope all|skills|rules|commands|agents]
- *   gamut plugin remove  [cursor|claude|figma]
- *   gamut plugin update  [cursor|claude|figma] [--scope all|skills|rules|commands|agents]
- *   gamut plugin list
- */
-
-const args = process.argv.slice(2);
-const [noun, verb, ...rest] = args;
-
-if (!noun || noun === '--help' || noun === '-h') {
-  printHelp();
-  process.exit(noun ? 0 : 1);
-}
-
-if (noun !== 'plugin') {
-  console.error(`Unknown command: "${noun}"`);
-  printHelp();
-  process.exit(1);
-}
-
-if (!verb || verb === '--help' || verb === '-h') {
-  printPluginHelp();
-  process.exit(verb ? 0 : 1);
-}
-
-let cmd;
-try {
-  cmd = await import(`./commands/plugin/${verb}.mjs`);
-} catch {
-  console.error(`Unknown plugin subcommand: "${verb}"`);
-  printPluginHelp();
-  process.exit(1);
-}
-
-if (rest.includes('--help') || rest.includes('-h')) {
-  cmd.help();
-  process.exit(0);
-}
-
-try {
-  await cmd.default(rest);
-} catch (/** @type {any} */ err) {
-  console.error(`Error: ${err.message}`);
-  process.exit(1);
-}
-
-// ---------------------------------------------------------------------------
-// Help
-// ---------------------------------------------------------------------------
-
-function printHelp() {
-  console.log(`
-gamut — Gamut design system CLI
-
-Usage:
-  gamut <command> [subcommand] [options]
-
-Commands:
-  plugin    Manage the Gamut plugin in your AI/design tools
-
-Run "gamut plugin --help" for plugin subcommands.
-`);
-}
-
-function printPluginHelp() {
-  console.log(`
-gamut plugin — Manage the Gamut plugin
-
-Subcommands:
-  install [target] [--scope <scope>]    Install the plugin into a tool
-  remove  [target]                      Remove an installed plugin
-  update  [target] [--scope <scope>]    Update an already-installed plugin
-  list                                  Show installation status for all targets
-
-Targets:   cursor (default)  |  claude  |  figma
-Scopes:    all (default)     |  skills  |  rules  |  commands  |  agents
-
-Examples:
-  gamut plugin install
-  gamut plugin install claude
-  gamut plugin install cursor --scope skills
-  gamut plugin remove claude
-  gamut plugin update
-  gamut plugin list
-`);
-}

package/bin/lib/claude.mjs

@@ -1,52 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-
-/**
- * Reads .claude-plugin/marketplace.json and returns a "name@marketplace" plugin spec.
- *
- * @param {string} sourceRoot
- * @returns {Promise<string>}
- */
-export async function claudePluginSpec(sourceRoot) {
-  const mp = join(sourceRoot, '.claude-plugin', 'marketplace.json');
-  let text;
-  try {
-    text = await readFile(mp, 'utf8');
-  } catch {
-    throw new Error(
-      `Missing ${mp}.\n` +
-        `A .claude-plugin/marketplace.json is required for Claude Code installation.`,
-    );
-  }
-
-  const json =
-    /** @type {{ name?: string; plugins?: Array<{ name?: string; source?: string }> }} */ (
-      JSON.parse(text)
-    );
-  const { name: marketplaceName, plugins } = json;
-
-  if (!marketplaceName || !Array.isArray(plugins) || plugins.length === 0) {
-    throw new Error(`Invalid marketplace.json — needs "name" and "plugins[]": ${mp}`);
-  }
-
-  const entry =
-    plugins.find((p) => p.source === './' || p.source === '.' || p.source == null) ?? plugins[0];
-
-  if (!entry?.name) {
-    throw new Error(`No plugin name found in marketplace.json plugins[]: ${mp}`);
-  }
-
-  return `${entry.name}@${marketplaceName}`;
-}
-
-/**
- * Returns just the marketplace name portion of a plugin spec ("name@marketplace").
- *
- * @param {string} spec
- * @returns {string}
- */
-export function marketplaceName(spec) {
-  const name = spec.split('@')[1];
-  if (!name) throw new Error(`Could not parse marketplace name from plugin spec: ${spec}`);
-  return name;
-}

package/bin/lib/cursor.mjs

@@ -1,40 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-
-/** @returns {string} */
-export function cursorPluginsRoot() {
-  return process.env.CURSOR_PLUGINS_LOCAL ?? join(homedir(), '.cursor', 'plugins', 'local');
-}
-
-/**
- * Reads the .cursor-plugin/plugin.json manifest and derives a folder name.
- * Falls back to "gamut-agent-tools" if no manifest is found.
- *
- * @param {string} sourceRoot
- * @returns {Promise<string>}
- */
-export async function cursorFolderName(sourceRoot) {
-  const manifest = join(sourceRoot, '.cursor-plugin', 'plugin.json');
-  try {
-    const text = await readFile(manifest, 'utf8');
-    const json = /** @type {{ name?: string }} */ (JSON.parse(text));
-    if (json.name && typeof json.name === 'string') {
-      return json.name.replace(/^@/, '').replace(/\//g, '-');
-    }
-  } catch {
-    // no manifest — use default
-  }
-  return 'gamut-agent-tools';
-}
-
-/**
- * Returns the absolute path where the plugin is/should be installed for Cursor.
- *
- * @param {string} sourceRoot
- * @returns {Promise<string>}
- */
-export async function cursorDestPath(sourceRoot) {
-  const folderName = await cursorFolderName(sourceRoot);
-  return join(cursorPluginsRoot(), folderName);
-}

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`,
-  );
-}

package/bin/lib/resolve-plugin-dir.mjs

@@ -1,38 +0,0 @@
-import { stat } from 'node:fs/promises';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-/**
- * Returns the absolute path to the bundled agent-tools directory, or the
- * value of --plugin-dir if provided.
- *
- * @param {string[]} args
- * @returns {Promise<string>}
- */
-export async function resolvePluginDir(args) {
-  const override = getFlag(args, '--plugin-dir');
-  if (override) {
-    const abs = resolve(override);
-    const st = await stat(abs).catch(() => null);
-    if (!st?.isDirectory()) {
-      throw new Error(`--plugin-dir path not found: ${abs}`);
-    }
-    return abs;
-  }
-
-  // agent-tools/ is bundled at <package-root>/agent-tools/ relative to bin/lib/
-  return resolve(__dirname, '..', '..', 'agent-tools');
-}
-
-/**
- * @param {string[]} argv
- * @param {string} flag
- * @param {string} [fallback]
- * @returns {string | undefined}
- */
-export function getFlag(argv, flag, fallback) {
-  const idx = argv.indexOf(flag);
-  return idx !== -1 ? argv[idx + 1] : fallback;
-}

package/bin/lib/run-command.mjs

@@ -1,22 +0,0 @@
-import { spawn } from 'node:child_process';
-
-/**
- * Spawns an external command and returns its exit code.
- *
- * @param {string} command
- * @param {string[]} args
- * @returns {Promise<number>}
- */
-export function runCommand(command, args) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(command, args, { stdio: 'inherit', shell: false });
-    child.on('error', (/** @type {NodeJS.ErrnoException} */ err) => {
-      if (err.code === 'ENOENT') {
-        reject(new Error(`"${command}" not found on PATH. Is it installed?`));
-      } else {
-        reject(err);
-      }
-    });
-    child.on('close', (code) => resolve(code ?? 1));
-  });
-}

package/dist/InternalFloatingCard/InternalFloatingCard.js

@@ -1,98 +0,0 @@
-import _styled from "@emotion/styled/base";
-function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
-import { CheckerDense } from '@codecademy/gamut-patterns';
-import { styledOptions, system } from '@codecademy/gamut-styles';
-import { variance } from '@codecademy/variance';
-import { forwardRef } from 'react';
-import * as React from 'react';
-import { Box } from '../Box';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-const cardProps = variance.compose(system.layout, system.padding);
-const beakVariants = system.variant({
-  prop: 'beak',
-  base: {
-    p: 12,
-    '&:after': {
-      content: '""',
-      width: '1.25rem',
-      height: '1.25rem',
-      bg: 'inherit',
-      transform: 'rotate(45deg)',
-      position: 'absolute',
-      border: 1,
-      borderStyleRight: 'none',
-      borderStyleBottom: 'none'
-    }
-  },
-  variants: {
-    'bottom-left': {
-      '&:after': {
-        bottom: 'calc(-0.625rem - 1px)',
-        left: '1.5rem',
-        transform: 'rotate(225deg)'
-      }
-    },
-    'bottom-right': {
-      '&:after': {
-        bottom: 'calc(-0.625rem - 1px)',
-        right: '1.5rem',
-        transform: 'rotate(225deg)'
-      }
-    },
-    'top-left': {
-      '&:after': {
-        top: 'calc(-0.625rem - 1px)',
-        left: '1.5rem',
-        transform: 'rotate(45deg)'
-      }
-    },
-    'top-right': {
-      '&:after': {
-        top: 'calc(-0.625rem - 1px)',
-        right: '1.5rem',
-        transform: 'rotate(45deg)'
-      }
-    }
-  }
-});
-const CardBody = /*#__PURE__*/_styled('div', _extends({}, {
-  target: "e14ubxlw0",
-  label: "CardBody"
-}, styledOptions))(system.css({
-  p: 12,
-  zIndex: 1,
-  position: 'relative',
-  bg: 'background',
-  border: 1,
-  maxWidth: 1
-}), beakVariants, cardProps, process.env.NODE_ENV === "production" ? "" : "/*# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9JbnRlcm5hbEZsb2F0aW5nQ2FyZC9JbnRlcm5hbEZsb2F0aW5nQ2FyZC50c3giXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBNERpQiIsImZpbGUiOiIuLi8uLi9zcmMvSW50ZXJuYWxGbG9hdGluZ0NhcmQvSW50ZXJuYWxGbG9hdGluZ0NhcmQudHN4Iiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgQ2hlY2tlckRlbnNlLCBQYXR0ZXJuUHJvcHMgfSBmcm9tICdAY29kZWNhZGVteS9nYW11dC1wYXR0ZXJucyc7XG5pbXBvcnQgeyBzdHlsZWRPcHRpb25zLCBzeXN0ZW0gfSBmcm9tICdAY29kZWNhZGVteS9nYW11dC1zdHlsZXMnO1xuaW1wb3J0IHsgU3R5bGVQcm9wcywgdmFyaWFuY2UgfSBmcm9tICdAY29kZWNhZGVteS92YXJpYW5jZSc7XG5pbXBvcnQgc3R5bGVkIGZyb20gJ0BlbW90aW9uL3N0eWxlZCc7XG5pbXBvcnQgeyBQcm9wZXJ0aWVzIH0gZnJvbSAnY3NzdHlwZSc7XG5pbXBvcnQgeyBDb21wb25lbnRQcm9wcywgZm9yd2FyZFJlZiB9IGZyb20gJ3JlYWN0JztcbmltcG9ydCAqIGFzIFJlYWN0IGZyb20gJ3JlYWN0JztcblxuaW1wb3J0IHsgQm94IH0gZnJvbSAnLi4vQm94JztcblxuY29uc3QgY2FyZFByb3BzID0gdmFyaWFuY2UuY29tcG9zZShzeXN0ZW0ubGF5b3V0LCBzeXN0ZW0ucGFkZGluZyk7XG5cbmNvbnN0IGJlYWtWYXJpYW50cyA9IHN5c3RlbS52YXJpYW50KHtcbiAgcHJvcDogJ2JlYWsnLFxuICBiYXNlOiB7XG4gICAgcDogMTIsXG4gICAgJyY6YWZ0ZXInOiB7XG4gICAgICBjb250ZW50OiAnXCJcIicsXG4gICAgICB3aWR0aDogJzEuMjVyZW0nLFxuICAgICAgaGVpZ2h0OiAnMS4yNXJlbScsXG4gICAgICBiZzogJ2luaGVyaXQnLFxuICAgICAgdHJhbnNmb3JtOiAncm90YXRlKDQ1ZGVnKScsXG4gICAgICBwb3NpdGlvbjogJ2Fic29sdXRlJyxcbiAgICAgIGJvcmRlcjogMSxcbiAgICAgIGJvcmRlclN0eWxlUmlnaHQ6ICdub25lJyxcbiAgICAgIGJvcmRlclN0eWxlQm90dG9tOiAnbm9uZScsXG4gICAgfSxcbiAgfSxcbiAgdmFyaWFudHM6IHtcbiAgICAnYm90dG9tLWxlZnQnOiB7XG4gICAgICAnJjphZnRlcic6IHtcbiAgICAgICAgYm90dG9tOiAnY2FsYygtMC42MjVyZW0gLSAxcHgpJyxcbiAgICAgICAgbGVmdDogJzEuNXJlbScsXG4gICAgICAgIHRyYW5zZm9ybTogJ3JvdGF0ZSgyMjVkZWcpJyxcbiAgICAgIH0sXG4gICAgfSxcbiAgICAnYm90dG9tLXJpZ2h0Jzoge1xuICAgICAgJyY6YWZ0ZXInOiB7XG4gICAgICAgIGJvdHRvbTogJ2NhbGMoLTAuNjI1cmVtIC0gMXB4KScsXG4gICAgICAgIHJpZ2h0OiAnMS41cmVtJyxcbiAgICAgICAgdHJhbnNmb3JtOiAncm90YXRlKDIyNWRlZyknLFxuICAgICAgfSxcbiAgICB9LFxuICAgICd0b3AtbGVmdCc6IHtcbiAgICAgICcmOmFmdGVyJzoge1xuICAgICAgICB0b3A6ICdjYWxjKC0wLjYyNXJlbSAtIDFweCknLFxuICAgICAgICBsZWZ0OiAnMS41cmVtJyxcbiAgICAgICAgdHJhbnNmb3JtOiAncm90YXRlKDQ1ZGVnKScsXG4gICAgICB9LFxuICAgIH0sXG4gICAgJ3RvcC1yaWdodCc6IHtcbiAgICAgICcmOmFmdGVyJzoge1xuICAgICAgICB0b3A6ICdjYWxjKC0wLjYyNXJlbSAtIDFweCknLFxuICAgICAgICByaWdodDogJzEuNXJlbScsXG4gICAgICAgIHRyYW5zZm9ybTogJ3JvdGF0ZSg0NWRlZyknLFxuICAgICAgfSxcbiAgICB9LFxuICB9LFxufSk7XG5cbmNvbnN0IENhcmRCb2R5ID0gc3R5bGVkKCdkaXYnLCBzdHlsZWRPcHRpb25zKTxcbiAgU3R5bGVQcm9wczx0eXBlb2YgYmVha1ZhcmlhbnRzPiAmIFN0eWxlUHJvcHM8dHlwZW9mIGNhcmRQcm9wcz5cbj4oXG4gIHN5c3RlbS5jc3Moe1xuICAgIHA6IDEyLFxuICAgIHpJbmRleDogMSxcbiAgICBwb3NpdGlvbjogJ3JlbGF0aXZlJyxcbiAgICBiZzogJ2JhY2tncm91bmQnLFxuICAgIGJvcmRlcjogMSxcbiAgICBtYXhXaWR0aDogMSxcbiAgfSksXG4gIGJlYWtWYXJpYW50cyxcbiAgY2FyZFByb3BzXG4pO1xuXG50eXBlIEludGVybmFsRmxvYXRpbmdDYXJkV3JhcHBlciA9IHtcbiAgY29udGFpbmVyRGlzcGxheT86IFByb3BlcnRpZXNbJ2Rpc3BsYXknXTtcbn07XG5cbmV4cG9ydCB0eXBlIEludGVybmFsRmxvYXRpbmdDYXJkUHJvcHMgPSB7XG4gIGNsYXNzTmFtZT86IHN0cmluZztcbiAgcGF0dGVybj86IFJlYWN0LkNvbXBvbmVudFR5cGU8UGF0dGVyblByb3BzPjtcbiAgc2hhZG93PzogJ2JvdHRvbUxlZnQnIHwgJ2JvdHRvbVJpZ2h0Jztcbn0gJiBDb21wb25lbnRQcm9wczx0eXBlb2YgQ2FyZEJvZHk+O1xuXG5leHBvcnQgdHlwZSBJbnRlcm5hbEZsb2F0aW5nQ2FyZFdpdGhXcmFwcGVyID0gSW50ZXJuYWxGbG9hdGluZ0NhcmRQcm9wcyAmXG4gIEludGVybmFsRmxvYXRpbmdDYXJkV3JhcHBlcjtcblxuLyoqXG4gKiBAZGVwcmVjYXRlZFxuICogVGhpcyBjb21wb25lbnQgaXMgc3RyaWN0bHkgZm9yIGludGVybmFsIEdhbXV0IHVzYWdlLlxuICogUGxlYXNlIHVzZSB0aGUgYENhcmRgIGNvbXBvbmVudCBpbnN0ZWFkLlxuICovXG5leHBvcnQgY29uc3QgSW50ZXJuYWxGbG9hdGluZ0NhcmQgPSBmb3J3YXJkUmVmPFxuICBIVE1MRGl2RWxlbWVudCxcbiAgSW50ZXJuYWxGbG9hdGluZ0NhcmRXaXRoV3JhcHBlclxuPihcbiAgKFxuICAgIHtcbiAgICAgIGNoaWxkcmVuLFxuICAgICAgY2xhc3NOYW1lLFxuICAgICAgcGF0dGVybjogUGF0dGVybiA9IENoZWNrZXJEZW5zZSxcbiAgICAgIHNoYWRvdyA9ICdib3R0b21MZWZ0JyxcbiAgICAgIGNvbnRhaW5lckRpc3BsYXkgPSAnaW5saW5lLWJsb2NrJyxcbiAgICAgIC4uLnJlc3RcbiAgICB9LFxuICAgIHJlZlxuICApID0+IChcbiAgICA8Qm94XG4gICAgICBkaXNwbGF5PXtjb250YWluZXJEaXNwbGF5fVxuICAgICAgbWF4V2lkdGg9XCIxMDAlXCJcbiAgICAgIHBvc2l0aW9uPVwicmVsYXRpdmVcIlxuICAgICAgekluZGV4PXsxfVxuICAgID5cbiAgICAgIDxQYXR0ZXJuXG4gICAgICAgIGRpbWVuc2lvbnM9ezF9XG4gICAgICAgIGxlZnQ9e3NoYWRvdyA9PT0gJ2JvdHRvbUxlZnQnID8gJy0wLjVyZW0nIDogdW5kZWZpbmVkfVxuICAgICAgICBwb3NpdGlvbj1cImFic29sdXRlXCJcbiAgICAgICAgcmlnaHQ9e3NoYWRvdyA9PT0gJ2JvdHRvbVJpZ2h0JyA/ICctMC41cmVtJyA6IHVuZGVmaW5lZH1cbiAgICAgICAgdG9wPVwiMC41cmVtXCJcbiAgICAgIC8+XG4gICAgICA8Q2FyZEJvZHkgY2xhc3NOYW1lPXtjbGFzc05hbWV9IHsuLi5yZXN0fSByZWY9e3JlZn0+XG4gICAgICAgIHtjaGlsZHJlbn1cbiAgICAgIDwvQ2FyZEJvZHk+XG4gICAgPC9Cb3g+XG4gIClcbik7XG4iXX0= */");
-/**
- * @deprecated
- * This component is strictly for internal Gamut usage.
- * Please use the `Card` component instead.
- */
-export const InternalFloatingCard = /*#__PURE__*/forwardRef(({
-  children,
-  className,
-  pattern: Pattern = CheckerDense,
-  shadow = 'bottomLeft',
-  containerDisplay = 'inline-block',
-  ...rest
-}, ref) => /*#__PURE__*/_jsxs(Box, {
-  display: containerDisplay,
-  maxWidth: "100%",
-  position: "relative",
-  zIndex: 1,
-  children: [/*#__PURE__*/_jsx(Pattern, {
-    dimensions: 1,
-    left: shadow === 'bottomLeft' ? '-0.5rem' : undefined,
-    position: "absolute",
-    right: shadow === 'bottomRight' ? '-0.5rem' : undefined,
-    top: "0.5rem"
-  }), /*#__PURE__*/_jsx(CardBody, {
-    className: className,
-    ...rest,
-    ref: ref,
-    children: children
-  })]
-}));