kigumi 0.5.0 → 0.6.0

package/README.md

@@ -1,8 +1,10 @@
+![Kigumi logo](https://kigumi.style/og-image.png)
+
 # Kigumi
 
 > Build framework-agnostic UIs with ready-made web components. Same components, any stack.
 
-ℹ️ Available for React. Angular, Svelte and Vue are coming soon.
+ℹ️ Available for React and Vue. Angular and Svelte are coming soon.
 
 ## Quick Start
 
@@ -57,14 +59,23 @@ Initialize Kigumi in your project. Sets up theming and installs dependencies.
 npx kigumi init
 ```
 
-**Web Awesome Pro:** To unlock premium themes and Pro-only components, you need a Web Awesome Pro account. [Get your token](https://https://webawesome.com/login):
+**Own Web Awesome Pro license?**
+
+To unlock premium themes and Pro-only components, you need a Web Awesome Pro account. [Get your token](https://webawesome.com/login) and choose one of the following token setup methods:
 
 ```bash
-# Configure your token globally (once per machine)
+
+# Option 1: During `init` command (recommended)
+npx kigumi init --token YOUR_TOKEN
+
+# Option 2: Global
 npm config set //npm.cloudsmith.io/fortawesome/webawesome-pro/:_authToken YOUR_TOKEN
 
-# Then just run init - Pro tier is auto-detected
-npx kigumi init
+# Option 3: In .env file
+WEBAWESOME_NPM_TOKEN=your_token
+
+# Option 4: In .npmrc file
+//npm.cloudsmith.io/fortawesome/webawesome-pro/:_authToken YOUR_TOKEN
 ```
 
 ### `add`
@@ -77,24 +88,33 @@ npx kigumi add              # Interactive component selector
 npx kigumi add --all        # Add all 80+ components at once
 ```
 
-### `list`
+### `theme`
 
-View all available components:
+Change [theme](https://webawesome.com/docs/themes), [palette](https://webawesome.com/docs/color-palettes), or brand color:
 
 ```bash
-npx kigumi list
+npx kigumi theme [name]    # Change theme (shows selector if name omitted)
+npx kigumi palette [name]  # Change color palette
+npx kigumi brand [color]   # Change brand color
 ```
 
-Shows component name, description, and Pro badge for Pro-only components.
+### `doctor`
 
-### `theme`
+Diagnose and fix common issues in your project:
 
-Change [theme](https://webawesome.com/docs/themes), [palette](https://webawesome.com/docs/color-palettes), or brand color:
+```bash
+npx kigumi doctor           # Scan and fix import path issues
+npx kigumi doctor --dry-run # Report issues without fixing
+```
+
+The doctor command automatically detects your tier (Free/Pro) and ensures all component imports use the correct package. Useful when upgrading from Free to Pro or encountering import errors.
+
+## Agent Skills
+
+Kigumi provides AI agent skills for transforming Web Awesome HTML to Kigumi components and for working with design tokens.
 
 ```bash
-npx kigumi theme [name]    # Change theme (shows selector if name omitted)
-npx kigumi palette [name]  # Change color palette
-npx kigumi brand [color]   # Change brand color
+npx skills add https://kigumi.style/skills
 ```
 
 ## Utility Classes

package/dist/chunk-EAABDBX7.js

@@ -0,0 +1,216 @@
+// src/utils/tier.ts
+import fs2 from "fs-extra";
+import path2 from "path";
+
+// src/constants.ts
+var WEB_AWESOME_FREE_PACKAGE = "@awesome.me/webawesome";
+var WEB_AWESOME_PRO_PACKAGE = "@awesome.me/webawesome-pro";
+var WEB_AWESOME_SCOPE = "@awesome.me";
+var ENV_TOKEN_KEY = "WEBAWESOME_NPM_TOKEN";
+var MIN_TOKEN_LENGTH = 10;
+var ENV_FILE_NAME = ".env";
+var NPM_PUBLIC_REGISTRY = "https://registry.npmjs.org/";
+var NPM_PRO_REGISTRY = "https://npm.cloudsmith.io/fortawesome/webawesome-pro";
+var FREE_PACKAGE_REGEX = /@awesome\.me\/webawesome(?!-pro)/g;
+var PRO_PACKAGE_REGEX = /@awesome\.me\/webawesome-pro/g;
+var ENV_TOKEN_REGEX = /^\s*WEBAWESOME_NPM_TOKEN\s*=\s*(.+?)\s*$/m;
+
+// src/utils/token.ts
+import fs from "fs-extra";
+import os from "os";
+import path from "path";
+async function detectProToken(cwd) {
+  const result = await detectProTokenWithSource(cwd);
+  return result.token;
+}
+function detectProTokenSync(cwd) {
+  const result = detectProTokenWithSourceSync(cwd);
+  return result.token;
+}
+function getTokenSourceSync(cwd) {
+  const result = detectProTokenWithSourceSync(cwd);
+  return result.source;
+}
+async function detectProTokenWithSource(cwd) {
+  const envToken = getTokenFromEnvVar();
+  if (envToken) {
+    return { token: envToken, source: "env" };
+  }
+  if (!process.env.KIGUMI_SKIP_GLOBAL_NPMRC) {
+    const npmrcToken = await getTokenFromGlobalNpmrc();
+    if (npmrcToken) {
+      return { token: npmrcToken, source: "npmrc" };
+    }
+  }
+  const dotenvToken = await getTokenFromDotenv(cwd);
+  if (dotenvToken) {
+    return { token: dotenvToken, source: "dotenv" };
+  }
+  return { token: null, source: null };
+}
+function detectProTokenWithSourceSync(cwd) {
+  const envToken = getTokenFromEnvVar();
+  if (envToken) {
+    return { token: envToken, source: "env" };
+  }
+  if (!process.env.KIGUMI_SKIP_GLOBAL_NPMRC) {
+    const npmrcToken = getTokenFromGlobalNpmrcSync();
+    if (npmrcToken) {
+      return { token: npmrcToken, source: "npmrc" };
+    }
+  }
+  const dotenvToken = getTokenFromDotenvSync(cwd);
+  if (dotenvToken) {
+    return { token: dotenvToken, source: "dotenv" };
+  }
+  return { token: null, source: null };
+}
+function getTokenFromEnvVar() {
+  const token = process.env[ENV_TOKEN_KEY];
+  if (token && token.length >= MIN_TOKEN_LENGTH) {
+    return token.trim();
+  }
+  return null;
+}
+async function getTokenFromGlobalNpmrc() {
+  const npmrcPath = path.join(os.homedir(), ".npmrc");
+  if (!await fs.pathExists(npmrcPath)) {
+    return null;
+  }
+  const content = await fs.readFile(npmrcPath, "utf-8");
+  return extractTokenFromNpmrc(content);
+}
+function getTokenFromGlobalNpmrcSync() {
+  const npmrcPath = path.join(os.homedir(), ".npmrc");
+  if (!fs.existsSync(npmrcPath)) {
+    return null;
+  }
+  const content = fs.readFileSync(npmrcPath, "utf-8");
+  return extractTokenFromNpmrc(content);
+}
+function extractTokenFromNpmrc(content) {
+  const registryHost = NPM_PRO_REGISTRY.replace("https://", "");
+  const patterns = [
+    new RegExp(`//${registryHost}/?:_authToken=(.+)`, "m"),
+    new RegExp(`${registryHost}/?:_authToken=(.+)`, "m")
+  ];
+  for (const pattern of patterns) {
+    const match = content.match(pattern);
+    if (match && match[1]) {
+      const token = match[1].trim();
+      if (token.length >= MIN_TOKEN_LENGTH) {
+        return token;
+      }
+    }
+  }
+  return null;
+}
+async function getTokenFromDotenv(cwd) {
+  const envPath = path.join(cwd, ENV_FILE_NAME);
+  if (!await fs.pathExists(envPath)) {
+    return null;
+  }
+  const content = await fs.readFile(envPath, "utf-8");
+  return extractTokenFromDotenv(content);
+}
+function getTokenFromDotenvSync(cwd) {
+  const envPath = path.join(cwd, ENV_FILE_NAME);
+  if (!fs.existsSync(envPath)) {
+    return null;
+  }
+  const content = fs.readFileSync(envPath, "utf-8");
+  return extractTokenFromDotenv(content);
+}
+function extractTokenFromDotenv(content) {
+  const match = content.match(ENV_TOKEN_REGEX);
+  if (match && match[1]) {
+    const token = match[1].trim();
+    if (token.length >= MIN_TOKEN_LENGTH) {
+      return token;
+    }
+  }
+  return null;
+}
+function describeTokenSource(source) {
+  switch (source) {
+    case "env":
+      return `environment variable ($${ENV_TOKEN_KEY})`;
+    case "npmrc":
+      return "global ~/.npmrc";
+    case "dotenv":
+      return "project .env file";
+    default:
+      return "unknown";
+  }
+}
+
+// src/utils/tier.ts
+async function detectTier(cwd) {
+  const packageJsonPath = path2.join(cwd, "package.json");
+  if (await fs2.pathExists(packageJsonPath)) {
+    try {
+      const packageJson = await fs2.readJson(packageJsonPath);
+      const deps = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies
+      };
+      if (deps[WEB_AWESOME_PRO_PACKAGE]) {
+        return "pro";
+      }
+      if (deps[WEB_AWESOME_FREE_PACKAGE]) {
+        return "free";
+      }
+    } catch {
+    }
+  }
+  const token = await detectProToken(cwd);
+  return token ? "pro" : "free";
+}
+function detectTierSync(cwd) {
+  const packageJsonPath = path2.join(cwd, "package.json");
+  if (fs2.pathExistsSync(packageJsonPath)) {
+    try {
+      const packageJson = fs2.readJsonSync(packageJsonPath);
+      const deps = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies
+      };
+      if (deps[WEB_AWESOME_PRO_PACKAGE]) {
+        return "pro";
+      }
+      if (deps[WEB_AWESOME_FREE_PACKAGE]) {
+        return "free";
+      }
+    } catch {
+    }
+  }
+  const token = detectProTokenSync(cwd);
+  return token ? "pro" : "free";
+}
+async function getProToken(cwd) {
+  return detectProToken(cwd);
+}
+function getWebAwesomePackage(tier) {
+  return tier === "pro" ? WEB_AWESOME_PRO_PACKAGE : WEB_AWESOME_FREE_PACKAGE;
+}
+
+export {
+  WEB_AWESOME_FREE_PACKAGE,
+  WEB_AWESOME_PRO_PACKAGE,
+  WEB_AWESOME_SCOPE,
+  ENV_TOKEN_KEY,
+  MIN_TOKEN_LENGTH,
+  ENV_FILE_NAME,
+  NPM_PUBLIC_REGISTRY,
+  NPM_PRO_REGISTRY,
+  FREE_PACKAGE_REGEX,
+  PRO_PACKAGE_REGEX,
+  ENV_TOKEN_REGEX,
+  detectProTokenSync,
+  getTokenSourceSync,
+  describeTokenSource,
+  detectTier,
+  detectTierSync,
+  getProToken,
+  getWebAwesomePackage
+};

package/dist/chunk-FG4CIVPT.js

@@ -0,0 +1,52 @@
+// src/utils/tier.ts
+import fs from "fs-extra";
+import path from "path";
+async function detectTier(cwd) {
+  const envPath = path.join(cwd, ".env");
+  if (!await fs.pathExists(envPath)) {
+    return "free";
+  }
+  const envContent = await fs.readFile(envPath, "utf-8");
+  const tokenMatch = envContent.match(
+    /^\s*WEBAWESOME_NPM_TOKEN\s*=\s*(.+?)\s*$/m
+  );
+  if (tokenMatch && tokenMatch[1] && tokenMatch[1].length >= 10) {
+    return "pro";
+  }
+  return "free";
+}
+function detectTierSync(cwd) {
+  const envPath = path.join(cwd, ".env");
+  if (!fs.existsSync(envPath)) {
+    return "free";
+  }
+  const envContent = fs.readFileSync(envPath, "utf-8");
+  const tokenMatch = envContent.match(
+    /^\s*WEBAWESOME_NPM_TOKEN\s*=\s*(.+?)\s*$/m
+  );
+  if (tokenMatch && tokenMatch[1] && tokenMatch[1].length >= 10) {
+    return "pro";
+  }
+  return "free";
+}
+async function getProToken(cwd) {
+  const envPath = path.join(cwd, ".env");
+  if (!await fs.pathExists(envPath)) {
+    return null;
+  }
+  const envContent = await fs.readFile(envPath, "utf-8");
+  const tokenMatch = envContent.match(
+    /^\s*WEBAWESOME_NPM_TOKEN\s*=\s*(.+?)\s*$/m
+  );
+  return tokenMatch && tokenMatch[1] ? tokenMatch[1].trim() : null;
+}
+function getWebAwesomePackage(tier) {
+  return tier === "pro" ? "@awesome.me/webawesome-pro" : "@awesome.me/webawesome";
+}
+
+export {
+  detectTier,
+  detectTierSync,
+  getProToken,
+  getWebAwesomePackage
+};

package/dist/chunk-IRCCX2A2.js

@@ -0,0 +1,72 @@
+// src/utils/tier.ts
+import fs from "fs-extra";
+import path from "path";
+
+// src/constants.ts
+var WEB_AWESOME_FREE_PACKAGE = "@awesome.me/webawesome";
+var WEB_AWESOME_PRO_PACKAGE = "@awesome.me/webawesome-pro";
+var WEB_AWESOME_SCOPE = "@awesome.me";
+var ENV_TOKEN_KEY = "WEBAWESOME_NPM_TOKEN";
+var MIN_TOKEN_LENGTH = 10;
+var ENV_FILE_NAME = ".env";
+var NPM_PUBLIC_REGISTRY = "https://registry.npmjs.org/";
+var NPM_PRO_REGISTRY = "https://npm.cloudsmith.io/fortawesome/webawesome-pro";
+var FREE_PACKAGE_REGEX = /@awesome\.me\/webawesome(?!-pro)/g;
+var PRO_PACKAGE_REGEX = /@awesome\.me\/webawesome-pro/g;
+var ENV_TOKEN_REGEX = /^\s*WEBAWESOME_NPM_TOKEN\s*=\s*(.+?)\s*$/m;
+
+// src/utils/tier.ts
+async function detectTier(cwd) {
+  const envPath = path.join(cwd, ENV_FILE_NAME);
+  if (!await fs.pathExists(envPath)) {
+    return "free";
+  }
+  const envContent = await fs.readFile(envPath, "utf-8");
+  const tokenMatch = envContent.match(ENV_TOKEN_REGEX);
+  if (tokenMatch && tokenMatch[1] && tokenMatch[1].length >= MIN_TOKEN_LENGTH) {
+    return "pro";
+  }
+  return "free";
+}
+function detectTierSync(cwd) {
+  const envPath = path.join(cwd, ENV_FILE_NAME);
+  if (!fs.existsSync(envPath)) {
+    return "free";
+  }
+  const envContent = fs.readFileSync(envPath, "utf-8");
+  const tokenMatch = envContent.match(ENV_TOKEN_REGEX);
+  if (tokenMatch && tokenMatch[1] && tokenMatch[1].length >= MIN_TOKEN_LENGTH) {
+    return "pro";
+  }
+  return "free";
+}
+async function getProToken(cwd) {
+  const envPath = path.join(cwd, ENV_FILE_NAME);
+  if (!await fs.pathExists(envPath)) {
+    return null;
+  }
+  const envContent = await fs.readFile(envPath, "utf-8");
+  const tokenMatch = envContent.match(ENV_TOKEN_REGEX);
+  return tokenMatch && tokenMatch[1] ? tokenMatch[1].trim() : null;
+}
+function getWebAwesomePackage(tier) {
+  return tier === "pro" ? WEB_AWESOME_PRO_PACKAGE : WEB_AWESOME_FREE_PACKAGE;
+}
+
+export {
+  WEB_AWESOME_FREE_PACKAGE,
+  WEB_AWESOME_PRO_PACKAGE,
+  WEB_AWESOME_SCOPE,
+  ENV_TOKEN_KEY,
+  MIN_TOKEN_LENGTH,
+  ENV_FILE_NAME,
+  NPM_PUBLIC_REGISTRY,
+  NPM_PRO_REGISTRY,
+  FREE_PACKAGE_REGEX,
+  PRO_PACKAGE_REGEX,
+  ENV_TOKEN_REGEX,
+  detectTier,
+  detectTierSync,
+  getProToken,
+  getWebAwesomePackage
+};

package/dist/chunk-VLXYBBZR.js

@@ -0,0 +1,216 @@
+// src/utils/tier.ts
+import fs2 from "fs-extra";
+import path2 from "path";
+
+// src/constants.ts
+var WEB_AWESOME_FREE_PACKAGE = "@awesome.me/webawesome";
+var WEB_AWESOME_PRO_PACKAGE = "@awesome.me/webawesome-pro";
+var WEB_AWESOME_SCOPE = "@awesome.me";
+var ENV_TOKEN_KEY = "WEBAWESOME_NPM_TOKEN";
+var MIN_TOKEN_LENGTH = 10;
+var ENV_FILE_NAME = ".env";
+var NPM_PUBLIC_REGISTRY = "https://registry.npmjs.org/";
+var NPM_PRO_REGISTRY = "https://npm.cloudsmith.io/fortawesome/webawesome-pro";
+var FREE_PACKAGE_REGEX = /@awesome\.me\/webawesome(?!-pro)/g;
+var PRO_PACKAGE_REGEX = /@awesome\.me\/webawesome-pro/g;
+var ENV_TOKEN_REGEX = /^\s*WEBAWESOME_NPM_TOKEN\s*=\s*(.+?)\s*$/m;
+
+// src/utils/token.ts
+import fs from "fs-extra";
+import os from "os";
+import path from "path";
+async function detectProToken(cwd) {
+  const result = await detectProTokenWithSource(cwd);
+  return result.token;
+}
+function detectProTokenSync(cwd) {
+  const result = detectProTokenWithSourceSync(cwd);
+  return result.token;
+}
+function getTokenSourceSync(cwd) {
+  const result = detectProTokenWithSourceSync(cwd);
+  return result.source;
+}
+async function detectProTokenWithSource(cwd) {
+  const envToken = getTokenFromEnvVar();
+  if (envToken) {
+    return { token: envToken, source: "env" };
+  }
+  if (!process.env.KIGUMI_SKIP_GLOBAL_NPMRC) {
+    const npmrcToken = await getTokenFromGlobalNpmrc();
+    if (npmrcToken) {
+      return { token: npmrcToken, source: "npmrc" };
+    }
+  }
+  const dotenvToken = await getTokenFromDotenv(cwd);
+  if (dotenvToken) {
+    return { token: dotenvToken, source: "dotenv" };
+  }
+  return { token: null, source: null };
+}
+function detectProTokenWithSourceSync(cwd) {
+  const envToken = getTokenFromEnvVar();
+  if (envToken) {
+    return { token: envToken, source: "env" };
+  }
+  if (!process.env.KIGUMI_SKIP_GLOBAL_NPMRC) {
+    const npmrcToken = getTokenFromGlobalNpmrcSync();
+    if (npmrcToken) {
+      return { token: npmrcToken, source: "npmrc" };
+    }
+  }
+  const dotenvToken = getTokenFromDotenvSync(cwd);
+  if (dotenvToken) {
+    return { token: dotenvToken, source: "dotenv" };
+  }
+  return { token: null, source: null };
+}
+function getTokenFromEnvVar() {
+  const token = process.env[ENV_TOKEN_KEY];
+  if (token && token.length >= MIN_TOKEN_LENGTH) {
+    return token.trim();
+  }
+  return null;
+}
+async function getTokenFromGlobalNpmrc() {
+  const npmrcPath = path.join(os.homedir(), ".npmrc");
+  if (!await fs.pathExists(npmrcPath)) {
+    return null;
+  }
+  const content = await fs.readFile(npmrcPath, "utf-8");
+  return extractTokenFromNpmrc(content);
+}
+function getTokenFromGlobalNpmrcSync() {
+  const npmrcPath = path.join(os.homedir(), ".npmrc");
+  if (!fs.existsSync(npmrcPath)) {
+    return null;
+  }
+  const content = fs.readFileSync(npmrcPath, "utf-8");
+  return extractTokenFromNpmrc(content);
+}
+function extractTokenFromNpmrc(content) {
+  const registryHost = NPM_PRO_REGISTRY.replace("https://", "");
+  const patterns = [
+    new RegExp(`//${registryHost}/?:_authToken=(.+)`, "m"),
+    new RegExp(`${registryHost}/?:_authToken=(.+)`, "m")
+  ];
+  for (const pattern of patterns) {
+    const match = content.match(pattern);
+    if (match && match[1]) {
+      const token = match[1].trim();
+      if (token.length >= MIN_TOKEN_LENGTH) {
+        return token;
+      }
+    }
+  }
+  return null;
+}
+async function getTokenFromDotenv(cwd) {
+  const envPath = path.join(cwd, ENV_FILE_NAME);
+  if (!await fs.pathExists(envPath)) {
+    return null;
+  }
+  const content = await fs.readFile(envPath, "utf-8");
+  return extractTokenFromDotenv(content);
+}
+function getTokenFromDotenvSync(cwd) {
+  const envPath = path.join(cwd, ENV_FILE_NAME);
+  if (!fs.existsSync(envPath)) {
+    return null;
+  }
+  const content = fs.readFileSync(envPath, "utf-8");
+  return extractTokenFromDotenv(content);
+}
+function extractTokenFromDotenv(content) {
+  const match = content.match(ENV_TOKEN_REGEX);
+  if (match && match[1]) {
+    const token = match[1].trim();
+    if (token.length >= MIN_TOKEN_LENGTH) {
+      return token;
+    }
+  }
+  return null;
+}
+function describeTokenSource(source) {
+  switch (source) {
+    case "env":
+      return `environment variable ($${ENV_TOKEN_KEY})`;
+    case "npmrc":
+      return "global ~/.npmrc";
+    case "dotenv":
+      return "project .env file";
+    default:
+      return "unknown";
+  }
+}
+
+// src/utils/tier.ts
+async function detectTier(cwd) {
+  const packageJsonPath = path2.join(cwd, "package.json");
+  if (await fs2.pathExists(packageJsonPath)) {
+    try {
+      const packageJson = await fs2.readJson(packageJsonPath);
+      const deps = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies
+      };
+      if (deps[WEB_AWESOME_PRO_PACKAGE]) {
+        return "pro";
+      }
+      if (deps[WEB_AWESOME_FREE_PACKAGE]) {
+        return "free";
+      }
+    } catch (error) {
+    }
+  }
+  const token = await detectProToken(cwd);
+  return token ? "pro" : "free";
+}
+function detectTierSync(cwd) {
+  const packageJsonPath = path2.join(cwd, "package.json");
+  if (fs2.pathExistsSync(packageJsonPath)) {
+    try {
+      const packageJson = fs2.readJsonSync(packageJsonPath);
+      const deps = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies
+      };
+      if (deps[WEB_AWESOME_PRO_PACKAGE]) {
+        return "pro";
+      }
+      if (deps[WEB_AWESOME_FREE_PACKAGE]) {
+        return "free";
+      }
+    } catch (error) {
+    }
+  }
+  const token = detectProTokenSync(cwd);
+  return token ? "pro" : "free";
+}
+async function getProToken(cwd) {
+  return detectProToken(cwd);
+}
+function getWebAwesomePackage(tier) {
+  return tier === "pro" ? WEB_AWESOME_PRO_PACKAGE : WEB_AWESOME_FREE_PACKAGE;
+}
+
+export {
+  WEB_AWESOME_FREE_PACKAGE,
+  WEB_AWESOME_PRO_PACKAGE,
+  WEB_AWESOME_SCOPE,
+  ENV_TOKEN_KEY,
+  MIN_TOKEN_LENGTH,
+  ENV_FILE_NAME,
+  NPM_PUBLIC_REGISTRY,
+  NPM_PRO_REGISTRY,
+  FREE_PACKAGE_REGEX,
+  PRO_PACKAGE_REGEX,
+  ENV_TOKEN_REGEX,
+  detectProTokenSync,
+  getTokenSourceSync,
+  describeTokenSource,
+  detectTier,
+  detectTierSync,
+  getProToken,
+  getWebAwesomePackage
+};