@dsai-io/tools 0.0.1 → 1.1.0

package/dist/utils/circuit-breaker.d.ts

@@ -0,0 +1,123 @@
+/**
+ * @fileoverview Circuit Breaker pattern implementation
+ * Prevents cascade failures by tracking error rates and temporarily blocking requests
+ */
+/**
+ * Circuit breaker states
+ */
+declare enum CircuitState {
+    /** Normal operation - requests are allowed */
+    CLOSED = "CLOSED",
+    /** Failing - all requests are rejected immediately */
+    OPEN = "OPEN",
+    /** Testing recovery - limited requests are allowed */
+    HALF_OPEN = "HALF_OPEN"
+}
+/**
+ * Circuit breaker configuration
+ */
+interface CircuitBreakerConfig {
+    /** Number of failures before opening circuit */
+    failureThreshold?: number;
+    /** Time in ms before attempting to close circuit */
+    cooldownMs?: number;
+    /** Request timeout in ms */
+    timeout?: number;
+    /** Name for logging */
+    name?: string;
+}
+/**
+ * Circuit breaker statistics
+ */
+interface CircuitBreakerStats {
+    /** Current state */
+    state: CircuitState;
+    /** Total failures */
+    failures: number;
+    /** Total successes */
+    successes: number;
+    /** Total calls */
+    totalCalls: number;
+    /** Time circuit opened (if open) */
+    openedAt?: Date;
+    /** Time circuit will attempt to close */
+    resetAt?: Date;
+    /** Last error */
+    lastError?: string;
+}
+/**
+ * Circuit breaker error thrown when circuit is open
+ */
+declare class CircuitBreakerOpenError extends Error {
+    readonly circuitName: string;
+    readonly resetAt: Date;
+    constructor(circuitName: string, resetAt: Date);
+}
+/**
+ * Circuit breaker implementation
+ * Tracks failures and opens circuit to prevent cascade failures
+ */
+declare class CircuitBreaker {
+    private state;
+    private failures;
+    private successes;
+    private totalCalls;
+    private openedAt?;
+    private resetAt?;
+    private lastError?;
+    private readonly failureThreshold;
+    private readonly cooldownMs;
+    private readonly timeout;
+    private readonly name;
+    constructor(config?: CircuitBreakerConfig);
+    /**
+     * Execute a function with circuit breaker protection
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute function with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Handle successful execution
+     */
+    private onSuccess;
+    /**
+     * Handle failed execution
+     */
+    private onFailure;
+    /**
+     * Open the circuit
+     */
+    private openCircuit;
+    /**
+     * Check if circuit can attempt reset
+     */
+    private canAttemptReset;
+    /**
+     * Get current circuit breaker state
+     */
+    getState(): CircuitState;
+    /**
+     * Get circuit breaker statistics
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * Manually reset circuit breaker
+     */
+    reset(): void;
+    /**
+     * Check if circuit is open
+     */
+    isOpen(): boolean;
+    /**
+     * Check if circuit is closed
+     */
+    isClosed(): boolean;
+    /**
+     * Check if circuit is half-open
+     */
+    isHalfOpen(): boolean;
+}
+
+export { CircuitBreaker, type CircuitBreakerConfig, CircuitBreakerOpenError, type CircuitBreakerStats, CircuitState };

package/dist/utils/circuit-breaker.js

@@ -0,0 +1,169 @@
+/* @dsai-io/tools - DSAi Design System Build Tools */
+
+// src/utils/circuit-breaker.ts
+var CircuitState = /* @__PURE__ */ ((CircuitState2) => {
+  CircuitState2["CLOSED"] = "CLOSED";
+  CircuitState2["OPEN"] = "OPEN";
+  CircuitState2["HALF_OPEN"] = "HALF_OPEN";
+  return CircuitState2;
+})(CircuitState || {});
+var CircuitBreakerOpenError = class extends Error {
+  constructor(circuitName, resetAt) {
+    super(`Circuit breaker "${circuitName}" is open. Will retry at ${resetAt.toISOString()}`);
+    this.circuitName = circuitName;
+    this.resetAt = resetAt;
+    this.name = "CircuitBreakerOpenError";
+  }
+};
+var CircuitBreaker = class {
+  state = "CLOSED" /* CLOSED */;
+  failures = 0;
+  successes = 0;
+  totalCalls = 0;
+  openedAt;
+  resetAt;
+  lastError;
+  failureThreshold;
+  cooldownMs;
+  timeout;
+  name;
+  constructor(config = {}) {
+    this.failureThreshold = config.failureThreshold ?? 5;
+    this.cooldownMs = config.cooldownMs ?? 3e4;
+    this.timeout = config.timeout ?? 1e4;
+    this.name = config.name ?? "CircuitBreaker";
+  }
+  /**
+   * Execute a function with circuit breaker protection
+   */
+  async execute(fn) {
+    this.totalCalls++;
+    if (this.state === "OPEN" /* OPEN */ && this.canAttemptReset()) {
+      this.state = "HALF_OPEN" /* HALF_OPEN */;
+      this.failures = 0;
+    }
+    if (this.state === "OPEN" /* OPEN */) {
+      if (!this.resetAt) {
+        throw new Error(`Circuit breaker "${this.name}" is open but has no reset time`);
+      }
+      throw new CircuitBreakerOpenError(this.name, this.resetAt);
+    }
+    try {
+      const result = await this.executeWithTimeout(fn);
+      this.onSuccess();
+      return result;
+    } catch (error) {
+      this.onFailure(error);
+      throw error;
+    }
+  }
+  /**
+   * Execute function with timeout
+   */
+  async executeWithTimeout(fn) {
+    return Promise.race([
+      fn(),
+      new Promise((_, reject) => {
+        setTimeout(() => {
+          reject(new Error(`Circuit breaker timeout after ${this.timeout}ms`));
+        }, this.timeout);
+      })
+    ]);
+  }
+  /**
+   * Handle successful execution
+   */
+  onSuccess() {
+    this.successes++;
+    if (this.state === "HALF_OPEN" /* HALF_OPEN */) {
+      this.state = "CLOSED" /* CLOSED */;
+      this.failures = 0;
+      this.openedAt = void 0;
+      this.resetAt = void 0;
+      this.lastError = void 0;
+    }
+  }
+  /**
+   * Handle failed execution
+   */
+  onFailure(error) {
+    this.failures++;
+    this.lastError = error instanceof Error ? error.message : String(error);
+    if (this.state === "HALF_OPEN" /* HALF_OPEN */) {
+      this.openCircuit();
+    } else if (this.failures >= this.failureThreshold) {
+      this.openCircuit();
+    }
+  }
+  /**
+   * Open the circuit
+   */
+  openCircuit() {
+    this.state = "OPEN" /* OPEN */;
+    this.openedAt = /* @__PURE__ */ new Date();
+    this.resetAt = new Date(Date.now() + this.cooldownMs);
+  }
+  /**
+   * Check if circuit can attempt reset
+   */
+  canAttemptReset() {
+    if (!this.resetAt) {
+      return false;
+    }
+    return Date.now() >= this.resetAt.getTime();
+  }
+  /**
+   * Get current circuit breaker state
+   */
+  getState() {
+    return this.state;
+  }
+  /**
+   * Get circuit breaker statistics
+   */
+  getStats() {
+    return {
+      state: this.state,
+      failures: this.failures,
+      successes: this.successes,
+      totalCalls: this.totalCalls,
+      openedAt: this.openedAt,
+      resetAt: this.resetAt,
+      lastError: this.lastError
+    };
+  }
+  /**
+   * Manually reset circuit breaker
+   */
+  reset() {
+    this.state = "CLOSED" /* CLOSED */;
+    this.failures = 0;
+    this.successes = 0;
+    this.totalCalls = 0;
+    this.openedAt = void 0;
+    this.resetAt = void 0;
+    this.lastError = void 0;
+  }
+  /**
+   * Check if circuit is open
+   */
+  isOpen() {
+    return this.state === "OPEN" /* OPEN */;
+  }
+  /**
+   * Check if circuit is closed
+   */
+  isClosed() {
+    return this.state === "CLOSED" /* CLOSED */;
+  }
+  /**
+   * Check if circuit is half-open
+   */
+  isHalfOpen() {
+    return this.state === "HALF_OPEN" /* HALF_OPEN */;
+  }
+};
+
+export { CircuitBreaker, CircuitBreakerOpenError, CircuitState };
+//# sourceMappingURL=circuit-breaker.js.map
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/utils/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/circuit-breaker.ts"],"names":["CircuitState"],"mappings":"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","file":"circuit-breaker.js","sourcesContent":["/**\r\n * @fileoverview Circuit Breaker pattern implementation\r\n * Prevents cascade failures by tracking error rates and temporarily blocking requests\r\n */\r\n\r\n/**\r\n * Circuit breaker states\r\n */\r\nexport enum CircuitState {\r\n  /** Normal operation - requests are allowed */\r\n  CLOSED = 'CLOSED',\r\n  /** Failing - all requests are rejected immediately */\r\n  OPEN = 'OPEN',\r\n  /** Testing recovery - limited requests are allowed */\r\n  HALF_OPEN = 'HALF_OPEN',\r\n}\r\n\r\n/**\r\n * Circuit breaker configuration\r\n */\r\nexport interface CircuitBreakerConfig {\r\n  /** Number of failures before opening circuit */\r\n  failureThreshold?: number;\r\n  /** Time in ms before attempting to close circuit */\r\n  cooldownMs?: number;\r\n  /** Request timeout in ms */\r\n  timeout?: number;\r\n  /** Name for logging */\r\n  name?: string;\r\n}\r\n\r\n/**\r\n * Circuit breaker statistics\r\n */\r\nexport interface CircuitBreakerStats {\r\n  /** Current state */\r\n  state: CircuitState;\r\n  /** Total failures */\r\n  failures: number;\r\n  /** Total successes */\r\n  successes: number;\r\n  /** Total calls */\r\n  totalCalls: number;\r\n  /** Time circuit opened (if open) */\r\n  openedAt?: Date;\r\n  /** Time circuit will attempt to close */\r\n  resetAt?: Date;\r\n  /** Last error */\r\n  lastError?: string;\r\n}\r\n\r\n/**\r\n * Circuit breaker error thrown when circuit is open\r\n */\r\nexport class CircuitBreakerOpenError extends Error {\r\n  constructor(\r\n    public readonly circuitName: string,\r\n    public readonly resetAt: Date\r\n  ) {\r\n    super(`Circuit breaker \"${circuitName}\" is open. Will retry at ${resetAt.toISOString()}`);\r\n    this.name = 'CircuitBreakerOpenError';\r\n  }\r\n}\r\n\r\n/**\r\n * Circuit breaker implementation\r\n * Tracks failures and opens circuit to prevent cascade failures\r\n */\r\nexport class CircuitBreaker {\r\n  private state: CircuitState = CircuitState.CLOSED;\r\n  private failures = 0;\r\n  private successes = 0;\r\n  private totalCalls = 0;\r\n  private openedAt?: Date;\r\n  private resetAt?: Date;\r\n  private lastError?: string;\r\n\r\n  private readonly failureThreshold: number;\r\n  private readonly cooldownMs: number;\r\n  private readonly timeout: number;\r\n  private readonly name: string;\r\n\r\n  constructor(config: CircuitBreakerConfig = {}) {\r\n    this.failureThreshold = config.failureThreshold ?? 5;\r\n    this.cooldownMs = config.cooldownMs ?? 30000; // 30 seconds\r\n    this.timeout = config.timeout ?? 10000; // 10 seconds\r\n    this.name = config.name ?? 'CircuitBreaker';\r\n  }\r\n\r\n  /**\r\n   * Execute a function with circuit breaker protection\r\n   */\r\n  async execute<T>(fn: () => Promise<T>): Promise<T> {\r\n    this.totalCalls++;\r\n\r\n    // Check if circuit should transition from OPEN to HALF_OPEN\r\n    if (this.state === CircuitState.OPEN && this.canAttemptReset()) {\r\n      this.state = CircuitState.HALF_OPEN;\r\n      this.failures = 0; // Reset failure count for half-open state\r\n    }\r\n\r\n    // Reject immediately if circuit is open\r\n    if (this.state === CircuitState.OPEN) {\r\n      if (!this.resetAt) {\r\n        throw new Error(`Circuit breaker \"${this.name}\" is open but has no reset time`);\r\n      }\r\n      throw new CircuitBreakerOpenError(this.name, this.resetAt);\r\n    }\r\n\r\n    try {\r\n      // Execute with timeout\r\n      const result = await this.executeWithTimeout(fn);\r\n\r\n      // Record success\r\n      this.onSuccess();\r\n\r\n      return result;\r\n    } catch (error) {\r\n      // Record failure\r\n      this.onFailure(error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Execute function with timeout\r\n   */\r\n  private async executeWithTimeout<T>(fn: () => Promise<T>): Promise<T> {\r\n    return Promise.race([\r\n      fn(),\r\n      new Promise<T>((_, reject) => {\r\n        setTimeout(() => {\r\n          reject(new Error(`Circuit breaker timeout after ${this.timeout}ms`));\r\n        }, this.timeout);\r\n      }),\r\n    ]);\r\n  }\r\n\r\n  /**\r\n   * Handle successful execution\r\n   */\r\n  private onSuccess(): void {\r\n    this.successes++;\r\n\r\n    if (this.state === CircuitState.HALF_OPEN) {\r\n      // Successful call in HALF_OPEN state closes the circuit\r\n      this.state = CircuitState.CLOSED;\r\n      this.failures = 0;\r\n      this.openedAt = undefined;\r\n      this.resetAt = undefined;\r\n      this.lastError = undefined;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Handle failed execution\r\n   */\r\n  private onFailure(error: unknown): void {\r\n    this.failures++;\r\n    this.lastError = error instanceof Error ? error.message : String(error);\r\n\r\n    if (this.state === CircuitState.HALF_OPEN) {\r\n      // Failure in HALF_OPEN state immediately reopens circuit\r\n      this.openCircuit();\r\n    } else if (this.failures >= this.failureThreshold) {\r\n      // Threshold reached, open circuit\r\n      this.openCircuit();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Open the circuit\r\n   */\r\n  private openCircuit(): void {\r\n    this.state = CircuitState.OPEN;\r\n    this.openedAt = new Date();\r\n    this.resetAt = new Date(Date.now() + this.cooldownMs);\r\n  }\r\n\r\n  /**\r\n   * Check if circuit can attempt reset\r\n   */\r\n  private canAttemptReset(): boolean {\r\n    if (!this.resetAt) {\r\n      return false;\r\n    }\r\n    return Date.now() >= this.resetAt.getTime();\r\n  }\r\n\r\n  /**\r\n   * Get current circuit breaker state\r\n   */\r\n  getState(): CircuitState {\r\n    return this.state;\r\n  }\r\n\r\n  /**\r\n   * Get circuit breaker statistics\r\n   */\r\n  getStats(): CircuitBreakerStats {\r\n    return {\r\n      state: this.state,\r\n      failures: this.failures,\r\n      successes: this.successes,\r\n      totalCalls: this.totalCalls,\r\n      openedAt: this.openedAt,\r\n      resetAt: this.resetAt,\r\n      lastError: this.lastError,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Manually reset circuit breaker\r\n   */\r\n  reset(): void {\r\n    this.state = CircuitState.CLOSED;\r\n    this.failures = 0;\r\n    this.successes = 0;\r\n    this.totalCalls = 0;\r\n    this.openedAt = undefined;\r\n    this.resetAt = undefined;\r\n    this.lastError = undefined;\r\n  }\r\n\r\n  /**\r\n   * Check if circuit is open\r\n   */\r\n  isOpen(): boolean {\r\n    return this.state === CircuitState.OPEN;\r\n  }\r\n\r\n  /**\r\n   * Check if circuit is closed\r\n   */\r\n  isClosed(): boolean {\r\n    return this.state === CircuitState.CLOSED;\r\n  }\r\n\r\n  /**\r\n   * Check if circuit is half-open\r\n   */\r\n  isHalfOpen(): boolean {\r\n    return this.state === CircuitState.HALF_OPEN;\r\n  }\r\n}\r\n"]}

package/package.json

@@ -1,97 +1,102 @@
-{
-  "name": "@dsai-io/tools",
-  "version": "0.0.1",
-  "description": "Build tooling and CLI for DSAi Design System",
-  "type": "module",
-  "main": "dist/index.cjs",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "dsai": "./bin/dsai-tools.mjs",
-    "dsai-tools": "./bin/dsai-tools.mjs"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./config": {
-      "types": "./dist/config/index.d.ts",
-      "import": "./dist/config/index.js",
-      "require": "./dist/config/index.cjs"
-    },
-    "./tokens": {
-      "types": "./dist/tokens/index.d.ts",
-      "import": "./dist/tokens/index.js",
-      "require": "./dist/tokens/index.cjs"
-    },
-    "./icons": {
-      "types": "./dist/icons/index.d.ts",
-      "import": "./dist/icons/index.js",
-      "require": "./dist/icons/index.cjs"
-    },
-    "./cli": {
-      "types": "./dist/cli/index.d.ts",
-      "import": "./dist/cli/index.js",
-      "require": "./dist/cli/index.cjs"
-    }
-  },
-  "files": [
-    "dist",
-    "bin",
-    "templates"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "build:watch": "tsup --watch",
-    "dev": "tsup --watch",
-    "test": "jest",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
-    "typecheck": "tsc --noEmit",
-    "generate-schema": "node scripts/generate-schema.mjs"
-  },
-  "keywords": [
-    "design-tokens",
-    "design-system",
-    "cli",
-    "style-dictionary",
-    "build-tools",
-    "dsai"
-  ],
-  "license": "UNLICENSED",
-  "engines": {
-    "node": ">=22.0.0"
-  },
-  "dependencies": {
-    "commander": "^14.0.2",
-    "cosmiconfig": "^9.0.0",
-    "deepmerge": "^4.3.1",
-    "fast-glob": "^3.3.3",
-    "ora": "^9.0.0",
-    "picocolors": "^1.1.1",
-    "svgo": "^4.0.0",
-    "zod": "^3.25.0"
-  },
-  "devDependencies": {
-    "@clack/prompts": "^0.11.0",
-    "@types/node": "^22.15.30",
-    "@types/prompts": "^2.4.9",
-    "style-dictionary": "^5.1.1",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "zod-to-json-schema": "^3.25.0"
-  },
-  "peerDependencies": {
-    "style-dictionary": "^5.1.1"
-  },
-  "peerDependenciesMeta": {
-    "style-dictionary": {
-      "optional": true
-    }
-  },
-  "publishConfig": {
-    "access": "restricted"
-  }
-}
+{
+  "name": "@dsai-io/tools",
+  "version": "1.1.0",
+  "description": "Build tooling and CLI for DSAi Design System",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "dsai": "./bin/dsai-tools.mjs",
+    "dsai-tools": "./bin/dsai-tools.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js",
+      "require": "./dist/config/index.cjs"
+    },
+    "./tokens": {
+      "types": "./dist/tokens/index.d.ts",
+      "import": "./dist/tokens/index.js",
+      "require": "./dist/tokens/index.cjs"
+    },
+    "./icons": {
+      "types": "./dist/icons/index.d.ts",
+      "import": "./dist/icons/index.js",
+      "require": "./dist/icons/index.cjs"
+    },
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./dist/cli/index.js",
+      "require": "./dist/cli/index.cjs"
+    },
+    "./utils/circuit-breaker": {
+      "types": "./dist/utils/circuit-breaker.d.ts",
+      "import": "./dist/utils/circuit-breaker.js",
+      "require": "./dist/utils/circuit-breaker.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "dev": "tsup --watch",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "typecheck": "tsc --noEmit",
+    "generate-schema": "node scripts/generate-schema.mjs"
+  },
+  "keywords": [
+    "design-tokens",
+    "design-system",
+    "cli",
+    "style-dictionary",
+    "build-tools",
+    "dsai"
+  ],
+  "license": "AGPL-3.0-or-later",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "commander": "^14.0.2",
+    "cosmiconfig": "^9.0.0",
+    "deepmerge": "^4.3.1",
+    "fast-glob": "^3.3.3",
+    "ora": "^9.0.0",
+    "picocolors": "^1.1.1",
+    "svgo": "^4.0.0",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@clack/prompts": "^0.11.0",
+    "@types/node": "^22.15.30",
+    "@types/prompts": "^2.4.9",
+    "style-dictionary": "^5.1.4",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "zod-to-json-schema": "^3.25.1"
+  },
+  "peerDependencies": {
+    "style-dictionary": "^5.1.4"
+  },
+  "peerDependenciesMeta": {
+    "style-dictionary": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/.dsairc.json

@@ -1,37 +1,37 @@
-{
-  "$schema": "./dsai-config.schema.json",
-  "tokens": {
-    "source": "theme",
-    "sourceDir": "figma-exports",
-    "sourcePatterns": ["theme.json", "tokens.json", "*.tokens.json"],
-    "outputDir": "dist",
-    "formats": ["css", "scss", "js", "ts", "json"],
-    "prefix": "--dsai-",
-    "themes": {
-      "autoDetect": true,
-      "default": "Light",
-      "selectorPattern": {
-        "default": ":root",
-        "others": "[data-dsai-theme=\"{mode}\"]"
-      }
-    },
-    "outputReferences": true,
-    "baseFontSize": 16,
-    "separateThemeFiles": false,
-    "watch": false
-  },
-  "icons": {
-    "sourceDir": "icons",
-    "outputDir": "src/components/icons",
-    "framework": "react",
-    "typescript": true,
-    "optimize": true,
-    "prefix": "Icon",
-    "exportIndex": true,
-    "generateSprite": false
-  },
-  "global": {
-    "debug": false,
-    "logLevel": "info"
-  }
-}
+{
+  "$schema": "./dsai-config.schema.json",
+  "tokens": {
+    "source": "theme",
+    "sourceDir": "figma-exports",
+    "sourcePatterns": ["theme.json", "tokens.json", "*.tokens.json"],
+    "outputDir": "dist",
+    "formats": ["css", "scss", "js", "ts", "json"],
+    "prefix": "--dsai-",
+    "themes": {
+      "autoDetect": true,
+      "default": "Light",
+      "selectorPattern": {
+        "default": ":root",
+        "others": "[data-dsai-theme=\"{mode}\"]"
+      }
+    },
+    "outputReferences": true,
+    "baseFontSize": 16,
+    "separateThemeFiles": false,
+    "watch": false
+  },
+  "icons": {
+    "sourceDir": "icons",
+    "outputDir": "src/components/icons",
+    "framework": "react",
+    "typescript": true,
+    "optimize": true,
+    "prefix": "Icon",
+    "exportIndex": true,
+    "generateSprite": false
+  },
+  "global": {
+    "debug": false,
+    "logLevel": "info"
+  }
+}