@el-j/magic-helix-core 4.0.0-beta.1

package/README.md

@@ -0,0 +1,192 @@
+# MagicHelix Core
+
+The core library for MagicAgentHelix. Provides project analysis, configuration merging, and tag detection logic.
+
+## 📦 Installation
+
+```bash
+npm install @el-j/magic-helix-core
+```
+
+## 🎯 Purpose
+
+This package is the brain of MagicAgentHelix. It:
+
+1. **Analyzes projects** to detect frameworks, libraries, and conventions
+2. **Merges configurations** (built-in + user custom)
+3. **Tags files** based on dependencies, config files, and file patterns
+4. **Provides built-in templates** for common frameworks
+
+## 🔧 Usage
+
+### Basic Analysis
+
+```typescript
+import { analyzeProjectTags, mergeConfigs } from '@el-j/magic-helix-core';
+
+// Load and merge configuration
+const config = mergeConfigs(userConfig);
+
+// Analyze a project
+const analysisData = {
+  dependencies: {
+    'vue': '^3.4.0',
+    'tailwindcss': '^3.4.0',
+    'vitest': '^2.0.0'
+  },
+  configFiles: ['tsconfig.json', 'vite.config.ts'],
+  projectFiles: ['src/App.vue', 'src/main.ts']
+};
+
+const tags = analyzeProjectTags(
+  analysisData,
+  config.dependencyTagMap,
+  config.configFileTagMap,
+  config.fileGlobTagMap
+);
+
+console.log(tags);
+// Set { 'framework-vue', 'style-tailwind', 'test-vitest', 'lang-typescript' }
+```
+
+### Configuration Merging
+
+```typescript
+import { loadUserConfig, mergeConfigs } from '@el-j/magic-helix-core';
+
+// Load user config from file (or pass custom config)
+const userConfig = loadUserConfig('./custom-config.json');
+
+// Merge with built-in configuration
+const mergedConfig = mergeConfigs(userConfig);
+
+// Access the merged configuration
+console.log(mergedConfig.dependencyTagMap);
+console.log(mergedConfig.tagTemplateMap);
+```
+
+## 📚 API Reference
+
+### `analyzeProjectTags(analysisData, dependencyTagMap, configFileTagMap, fileGlobTagMap)`
+
+Analyzes project data and returns a set of applicable tags.
+
+**Parameters:**
+- `analysisData: ProjectAnalysisData` - Project information
+  - `dependencies: Record<string, string>` - Package dependencies
+  - `configFiles: string[]` - Configuration files found
+  - `projectFiles: string[]` - All project files
+- `dependencyTagMap: DependencyTagMap` - Maps package names to tags
+- `configFileTagMap: ConfigFileTagMap` - Maps config files to tags
+- `fileGlobTagMap: FileGlobTagMap` - Maps file patterns to tags
+
+**Returns:** `Set<string>` - Set of applicable tags
+
+### `mergeConfigs(userConfig)`
+
+Merges user configuration with built-in defaults.
+
+**Parameters:**
+- `userConfig: Partial<Config>` - Optional user configuration
+
+**Returns:** `MergedConfig` - Complete merged configuration
+
+### `loadUserConfig(configPath?)`
+
+Loads user configuration from a file.
+
+**Parameters:**
+- `configPath?: string` - Optional path to config file (defaults to `magic-helix.config.json`, with legacy support for `ai-aligner.config.json`)
+
+**Returns:** `Partial<Config>` - Loaded user configuration or empty object
+
+## 🏗️ Built-in Configuration
+
+The core includes comprehensive built-in detection for:
+
+### Frameworks
+- Vue.js (`vue`)
+- React (`react`)
+- Angular (`@angular/core`)
+- NestJS (`@nestjs/core`)
+
+### Styling
+- Tailwind CSS (`tailwindcss`)
+- PrimeVue (`primevue`)
+- Material-UI (`@mui/material`)
+- Quasar (`quasar`)
+
+### Testing
+- Vitest (`vitest`)
+- Jest (`jest`)
+- Cypress (`cypress`)
+- Playwright (`playwright`)
+
+### State Management
+- RxJS (`rxjs`)
+- Pinia (`pinia`)
+- Redux (`redux`)
+- Zustand (`zustand`)
+
+### Languages
+- TypeScript (`tsconfig.json`, `*.ts`, `*.tsx`)
+- JavaScript (`*.js`, `*.jsx`)
+- Go (`*.go`)
+- Python (`*.py`)
+
+## 🔌 Browser Support
+
+The core library is isomorphic and works in both Node.js and browser environments.
+
+For browser usage, all Node.js-specific APIs (like `fs`) should be handled by the consuming application.
+
+## 📖 Type Definitions
+
+```typescript
+interface ProjectAnalysisData {
+  dependencies: Record<string, string>;
+  configFiles: string[];
+  projectFiles: string[];
+}
+
+interface Config {
+  target: string;
+  templateDirectory: string;
+  outputDirectory: string;
+  dependencyTagMap: DependencyTagMap;
+  configFileTagMap: ConfigFileTagMap;
+  fileGlobTagMap: FileGlobTagMap;
+  tagTemplateMap: TagTemplateMap;
+}
+
+type DependencyTagMap = Record<string, string>;
+type ConfigFileTagMap = Record<string, string>;
+type FileGlobTagMap = Record<string, string>;
+type TagTemplateMap = Record<string, Array<{ template: string; suffix: string }>>;
+```
+
+## 🧪 Testing
+
+```bash
+npm test                # Run tests
+npm run test:watch      # Watch mode
+npm run test:coverage   # With coverage
+```
+
+## 📦 Package Structure
+
+```
+dist/
+  ├── index.mjs          # ESM bundle
+  ├── index.cjs          # CommonJS bundle
+  ├── index.d.ts         # TypeScript declarations
+  └── default_templates/ # Built-in templates
+```
+
+## 📚 More Information
+
+See the [monorepo root README.md](../../README.md) for full development instructions.
+
+## 📄 License
+
+MIT

package/dist/BasePlugin-6wv0hYJ9.js

@@ -0,0 +1,98 @@
+import * as s from "node:fs";
+import * as a from "node:path";
+class l {
+  // Helper methods for common operations
+  /**
+   * Check if a file exists in the project
+   */
+  fileExists(e, r) {
+    return s.existsSync(a.join(e, r));
+  }
+  /**
+   * Read a file from the project
+   */
+  readFile(e, r) {
+    try {
+      const t = a.join(e, r);
+      if (s.existsSync(t))
+        return s.readFileSync(t, "utf-8");
+    } catch {
+    }
+    return null;
+  }
+  /**
+   * Parse JSON file from the project
+   */
+  readJSON(e, r) {
+    try {
+      const t = this.readFile(e, r);
+      if (t)
+        return JSON.parse(t);
+    } catch {
+    }
+    return null;
+  }
+  /**
+   * Get project name from path
+   */
+  getProjectName(e) {
+    return a.basename(e);
+  }
+  /**
+   * Load template from file
+   */
+  async loadTemplateFromFile(e) {
+    try {
+      if (s.existsSync(e))
+        return s.readFileSync(e, "utf-8");
+    } catch {
+    }
+    return null;
+  }
+  /**
+   * Create a template definition with lazy loading
+   */
+  createTemplate(e, r, t, n = {}) {
+    return {
+      name: e,
+      tags: r,
+      content: t,
+      ...n
+    };
+  }
+  /**
+   * Parse dependencies from package-like files
+   */
+  parseDependencies(e, ...r) {
+    const t = {};
+    for (const n of r) {
+      const i = e[n];
+      i && typeof i == "object" && Object.assign(t, i);
+    }
+    return t;
+  }
+  /**
+   * Find files matching a pattern
+   */
+  async findFiles(e, r) {
+    try {
+      const { glob: t } = await import("glob");
+      return await t(r, {
+        cwd: e,
+        absolute: !1
+      });
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Check if any files exist matching a pattern
+   */
+  async hasFiles(e, r) {
+    return (await this.findFiles(e, r)).length > 0;
+  }
+}
+export {
+  l as B
+};
+//# sourceMappingURL=BasePlugin-6wv0hYJ9.js.map

package/dist/BasePlugin-6wv0hYJ9.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePlugin-6wv0hYJ9.js","sources":["../src/builtin-plugins/base/BasePlugin.ts"],"sourcesContent":["/**\n * Base Plugin Class\n *\n * Abstract base class providing common functionality for all language plugins.\n * Plugins should extend this class and implement the abstract methods.\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type {\n  ConfigFileTagMap,\n  DependencyTagMap,\n  FileGlobTagMap,\n  LanguagePlugin,\n  ProjectMetadata,\n  TemplateDefinition,\n} from '../../types';\n\nexport abstract class BasePlugin implements LanguagePlugin {\n  abstract name: string;\n  abstract displayName: string;\n  abstract version: string;\n  abstract priority: number;\n\n  /**\n   * Abstract method: Detect if this plugin applies to the project\n   */\n  abstract detect(projectPath: string): Promise<ProjectMetadata | null>;\n\n  /**\n   * Abstract method: Get templates provided by this plugin\n   */\n  abstract getTemplates(): TemplateDefinition[] | Promise<TemplateDefinition[]>;\n\n  /**\n   * Optional: Get dependency-to-tag mapping\n   */\n  getDependencyTagMap?(): DependencyTagMap;\n\n  /**\n   * Optional: Get config file-to-tag mapping\n   */\n  getConfigFileTagMap?(): ConfigFileTagMap;\n\n  /**\n   * Optional: Get file glob-to-tag mapping\n   */\n  getFileGlobTagMap?(): FileGlobTagMap;\n\n  // Helper methods for common operations\n\n  /**\n   * Check if a file exists in the project\n   */\n  protected fileExists(projectPath: string, filename: string): boolean {\n    return fs.existsSync(path.join(projectPath, filename));\n  }\n\n  /**\n   * Read a file from the project\n   */\n  protected readFile(projectPath: string, filename: string): string | null {\n    try {\n      const filePath = path.join(projectPath, filename);\n      if (fs.existsSync(filePath)) {\n        return fs.readFileSync(filePath, 'utf-8');\n      }\n    } catch {\n      // Ignore errors\n    }\n    return null;\n  }\n\n  /**\n   * Parse JSON file from the project\n   */\n  protected readJSON<T = Record<string, unknown>>(\n    projectPath: string,\n    filename: string,\n  ): T | null {\n    try {\n      const content = this.readFile(projectPath, filename);\n      if (content) {\n        return JSON.parse(content) as T;\n      }\n    } catch {\n      // Ignore parse errors\n    }\n    return null;\n  }\n\n  /**\n   * Get project name from path\n   */\n  protected getProjectName(projectPath: string): string {\n    return path.basename(projectPath);\n  }\n\n  /**\n   * Load template from file\n   */\n  protected async loadTemplateFromFile(\n    templatePath: string,\n  ): Promise<string | null> {\n    try {\n      if (fs.existsSync(templatePath)) {\n        return fs.readFileSync(templatePath, 'utf-8');\n      }\n    } catch {\n      // Ignore errors\n    }\n    return null;\n  }\n\n  /**\n   * Create a template definition with lazy loading\n   */\n  protected createTemplate(\n    name: string,\n    tags: string[],\n    contentOrPath: string | (() => string | Promise<string>),\n    options: Partial<TemplateDefinition> = {},\n  ): TemplateDefinition {\n    return {\n      name,\n      tags,\n      content:\n        typeof contentOrPath === 'string' ? contentOrPath : contentOrPath,\n      ...options,\n    };\n  }\n\n  /**\n   * Parse dependencies from package-like files\n   */\n  protected parseDependencies(\n    obj: Record<string, unknown>,\n    ...keys: string[]\n  ): Record<string, string> {\n    const deps: Record<string, string> = {};\n\n    for (const key of keys) {\n      const value = obj[key];\n      if (value && typeof value === 'object') {\n        Object.assign(deps, value);\n      }\n    }\n\n    return deps;\n  }\n\n  /**\n   * Find files matching a pattern\n   */\n  protected async findFiles(\n    projectPath: string,\n    pattern: string,\n  ): Promise<string[]> {\n    try {\n      const { glob } = await import('glob');\n      return await glob(pattern, {\n        cwd: projectPath,\n        absolute: false,\n      });\n    } catch {\n      return [];\n    }\n  }\n\n  /**\n   * Check if any files exist matching a pattern\n   */\n  protected async hasFiles(\n    projectPath: string,\n    pattern: string,\n  ): Promise<boolean> {\n    const files = await this.findFiles(projectPath, pattern);\n    return files.length > 0;\n  }\n}\n"],"names":["BasePlugin","projectPath","filename","fs","path","filePath","content","templatePath","name","tags","contentOrPath","options","obj","keys","deps","key","value","pattern","glob"],"mappings":";;AAkBO,MAAeA,EAAqC;AAAA;AAAA;AAAA;AAAA;AAAA,EAoC/C,WAAWC,GAAqBC,GAA2B;AACnE,WAAOC,EAAG,WAAWC,EAAK,KAAKH,GAAaC,CAAQ,CAAC;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA,EAKU,SAASD,GAAqBC,GAAiC;AACvE,QAAI;AACF,YAAMG,IAAWD,EAAK,KAAKH,GAAaC,CAAQ;AAChD,UAAIC,EAAG,WAAWE,CAAQ;AACxB,eAAOF,EAAG,aAAaE,GAAU,OAAO;AAAA,IAE5C,QAAQ;AAAA,IAER;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKU,SACRJ,GACAC,GACU;AACV,QAAI;AACF,YAAMI,IAAU,KAAK,SAASL,GAAaC,CAAQ;AACnD,UAAII;AACF,eAAO,KAAK,MAAMA,CAAO;AAAA,IAE7B,QAAQ;AAAA,IAER;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKU,eAAeL,GAA6B;AACpD,WAAOG,EAAK,SAASH,CAAW;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,qBACdM,GACwB;AACxB,QAAI;AACF,UAAIJ,EAAG,WAAWI,CAAY;AAC5B,eAAOJ,EAAG,aAAaI,GAAc,OAAO;AAAA,IAEhD,QAAQ;AAAA,IAER;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKU,eACRC,GACAC,GACAC,GACAC,IAAuC,CAAA,GACnB;AACpB,WAAO;AAAA,MACL,MAAAH;AAAA,MACA,MAAAC;AAAA,MACA,SACsCC;AAAA,MACtC,GAAGC;AAAA,IAAA;AAAA,EAEP;AAAA;AAAA;AAAA;AAAA,EAKU,kBACRC,MACGC,GACqB;AACxB,UAAMC,IAA+B,CAAA;AAErC,eAAWC,KAAOF,GAAM;AACtB,YAAMG,IAAQJ,EAAIG,CAAG;AACrB,MAAIC,KAAS,OAAOA,KAAU,YAC5B,OAAO,OAAOF,GAAME,CAAK;AAAA,IAE7B;AAEA,WAAOF;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,UACdb,GACAgB,GACmB;AACnB,QAAI;AACF,YAAM,EAAE,MAAAC,EAAA,IAAS,MAAM,OAAO,MAAM;AACpC,aAAO,MAAMA,EAAKD,GAAS;AAAA,QACzB,KAAKhB;AAAA,QACL,UAAU;AAAA,MAAA,CACX;AAAA,IACH,QAAQ;AACN,aAAO,CAAA;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,SACdA,GACAgB,GACkB;AAElB,YADc,MAAM,KAAK,UAAUhB,GAAagB,CAAO,GAC1C,SAAS;AAAA,EACxB;AACF;"}

package/dist/BasePlugin-odQJAKA-.cjs

@@ -0,0 +1,2 @@
+"use strict";var u=Object.create;var l=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var p=Object.getPrototypeOf,d=Object.prototype.hasOwnProperty;var g=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of y(e))!d.call(r,s)&&s!==t&&l(r,s,{get:()=>e[s],enumerable:!(n=f(e,s))||n.enumerable});return r};var b=(r,e,t)=>(t=r!=null?u(p(r)):{},g(e||!r||!r.__esModule?l(t,"default",{value:r,enumerable:!0}):t,r));const m=require("node:fs"),j=require("node:path");function o(r){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(r){for(const t in r)if(t!=="default"){const n=Object.getOwnPropertyDescriptor(r,t);Object.defineProperty(e,t,n.get?n:{enumerable:!0,get:()=>r[t]})}}return e.default=r,Object.freeze(e)}const c=o(m),i=o(j);class F{fileExists(e,t){return c.existsSync(i.join(e,t))}readFile(e,t){try{const n=i.join(e,t);if(c.existsSync(n))return c.readFileSync(n,"utf-8")}catch{}return null}readJSON(e,t){try{const n=this.readFile(e,t);if(n)return JSON.parse(n)}catch{}return null}getProjectName(e){return i.basename(e)}async loadTemplateFromFile(e){try{if(c.existsSync(e))return c.readFileSync(e,"utf-8")}catch{}return null}createTemplate(e,t,n,s={}){return{name:e,tags:t,content:n,...s}}parseDependencies(e,...t){const n={};for(const s of t){const a=e[s];a&&typeof a=="object"&&Object.assign(n,a)}return n}async findFiles(e,t){try{const{glob:n}=await import("glob");return await n(t,{cwd:e,absolute:!1})}catch{return[]}}async hasFiles(e,t){return(await this.findFiles(e,t)).length>0}}exports.BasePlugin=F;
+//# sourceMappingURL=BasePlugin-odQJAKA-.cjs.map

package/dist/BasePlugin-odQJAKA-.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePlugin-odQJAKA-.cjs","sources":["../src/builtin-plugins/base/BasePlugin.ts"],"sourcesContent":["/**\n * Base Plugin Class\n *\n * Abstract base class providing common functionality for all language plugins.\n * Plugins should extend this class and implement the abstract methods.\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type {\n  ConfigFileTagMap,\n  DependencyTagMap,\n  FileGlobTagMap,\n  LanguagePlugin,\n  ProjectMetadata,\n  TemplateDefinition,\n} from '../../types';\n\nexport abstract class BasePlugin implements LanguagePlugin {\n  abstract name: string;\n  abstract displayName: string;\n  abstract version: string;\n  abstract priority: number;\n\n  /**\n   * Abstract method: Detect if this plugin applies to the project\n   */\n  abstract detect(projectPath: string): Promise<ProjectMetadata | null>;\n\n  /**\n   * Abstract method: Get templates provided by this plugin\n   */\n  abstract getTemplates(): TemplateDefinition[] | Promise<TemplateDefinition[]>;\n\n  /**\n   * Optional: Get dependency-to-tag mapping\n   */\n  getDependencyTagMap?(): DependencyTagMap;\n\n  /**\n   * Optional: Get config file-to-tag mapping\n   */\n  getConfigFileTagMap?(): ConfigFileTagMap;\n\n  /**\n   * Optional: Get file glob-to-tag mapping\n   */\n  getFileGlobTagMap?(): FileGlobTagMap;\n\n  // Helper methods for common operations\n\n  /**\n   * Check if a file exists in the project\n   */\n  protected fileExists(projectPath: string, filename: string): boolean {\n    return fs.existsSync(path.join(projectPath, filename));\n  }\n\n  /**\n   * Read a file from the project\n   */\n  protected readFile(projectPath: string, filename: string): string | null {\n    try {\n      const filePath = path.join(projectPath, filename);\n      if (fs.existsSync(filePath)) {\n        return fs.readFileSync(filePath, 'utf-8');\n      }\n    } catch {\n      // Ignore errors\n    }\n    return null;\n  }\n\n  /**\n   * Parse JSON file from the project\n   */\n  protected readJSON<T = Record<string, unknown>>(\n    projectPath: string,\n    filename: string,\n  ): T | null {\n    try {\n      const content = this.readFile(projectPath, filename);\n      if (content) {\n        return JSON.parse(content) as T;\n      }\n    } catch {\n      // Ignore parse errors\n    }\n    return null;\n  }\n\n  /**\n   * Get project name from path\n   */\n  protected getProjectName(projectPath: string): string {\n    return path.basename(projectPath);\n  }\n\n  /**\n   * Load template from file\n   */\n  protected async loadTemplateFromFile(\n    templatePath: string,\n  ): Promise<string | null> {\n    try {\n      if (fs.existsSync(templatePath)) {\n        return fs.readFileSync(templatePath, 'utf-8');\n      }\n    } catch {\n      // Ignore errors\n    }\n    return null;\n  }\n\n  /**\n   * Create a template definition with lazy loading\n   */\n  protected createTemplate(\n    name: string,\n    tags: string[],\n    contentOrPath: string | (() => string | Promise<string>),\n    options: Partial<TemplateDefinition> = {},\n  ): TemplateDefinition {\n    return {\n      name,\n      tags,\n      content:\n        typeof contentOrPath === 'string' ? contentOrPath : contentOrPath,\n      ...options,\n    };\n  }\n\n  /**\n   * Parse dependencies from package-like files\n   */\n  protected parseDependencies(\n    obj: Record<string, unknown>,\n    ...keys: string[]\n  ): Record<string, string> {\n    const deps: Record<string, string> = {};\n\n    for (const key of keys) {\n      const value = obj[key];\n      if (value && typeof value === 'object') {\n        Object.assign(deps, value);\n      }\n    }\n\n    return deps;\n  }\n\n  /**\n   * Find files matching a pattern\n   */\n  protected async findFiles(\n    projectPath: string,\n    pattern: string,\n  ): Promise<string[]> {\n    try {\n      const { glob } = await import('glob');\n      return await glob(pattern, {\n        cwd: projectPath,\n        absolute: false,\n      });\n    } catch {\n      return [];\n    }\n  }\n\n  /**\n   * Check if any files exist matching a pattern\n   */\n  protected async hasFiles(\n    projectPath: string,\n    pattern: string,\n  ): Promise<boolean> {\n    const files = await this.findFiles(projectPath, pattern);\n    return files.length > 0;\n  }\n}\n"],"names":["BasePlugin","projectPath","filename","fs","path","filePath","content","templatePath","name","tags","contentOrPath","options","obj","keys","deps","key","value","pattern","glob"],"mappings":"2yBAkBO,MAAeA,CAAqC,CAoC/C,WAAWC,EAAqBC,EAA2B,CACnE,OAAOC,EAAG,WAAWC,EAAK,KAAKH,EAAaC,CAAQ,CAAC,CACvD,CAKU,SAASD,EAAqBC,EAAiC,CACvE,GAAI,CACF,MAAMG,EAAWD,EAAK,KAAKH,EAAaC,CAAQ,EAChD,GAAIC,EAAG,WAAWE,CAAQ,EACxB,OAAOF,EAAG,aAAaE,EAAU,OAAO,CAE5C,MAAQ,CAER,CACA,OAAO,IACT,CAKU,SACRJ,EACAC,EACU,CACV,GAAI,CACF,MAAMI,EAAU,KAAK,SAASL,EAAaC,CAAQ,EACnD,GAAII,EACF,OAAO,KAAK,MAAMA,CAAO,CAE7B,MAAQ,CAER,CACA,OAAO,IACT,CAKU,eAAeL,EAA6B,CACpD,OAAOG,EAAK,SAASH,CAAW,CAClC,CAKA,MAAgB,qBACdM,EACwB,CACxB,GAAI,CACF,GAAIJ,EAAG,WAAWI,CAAY,EAC5B,OAAOJ,EAAG,aAAaI,EAAc,OAAO,CAEhD,MAAQ,CAER,CACA,OAAO,IACT,CAKU,eACRC,EACAC,EACAC,EACAC,EAAuC,CAAA,EACnB,CACpB,MAAO,CACL,KAAAH,EACA,KAAAC,EACA,QACsCC,EACtC,GAAGC,CAAA,CAEP,CAKU,kBACRC,KACGC,EACqB,CACxB,MAAMC,EAA+B,CAAA,EAErC,UAAWC,KAAOF,EAAM,CACtB,MAAMG,EAAQJ,EAAIG,CAAG,EACjBC,GAAS,OAAOA,GAAU,UAC5B,OAAO,OAAOF,EAAME,CAAK,CAE7B,CAEA,OAAOF,CACT,CAKA,MAAgB,UACdb,EACAgB,EACmB,CACnB,GAAI,CACF,KAAM,CAAE,KAAAC,CAAA,EAAS,KAAM,QAAO,MAAM,EACpC,OAAO,MAAMA,EAAKD,EAAS,CACzB,IAAKhB,EACL,SAAU,EAAA,CACX,CACH,MAAQ,CACN,MAAO,CAAA,CACT,CACF,CAKA,MAAgB,SACdA,EACAgB,EACkB,CAElB,OADc,MAAM,KAAK,UAAUhB,EAAagB,CAAO,GAC1C,OAAS,CACxB,CACF"}

package/dist/ab-testing.d.ts

@@ -0,0 +1,28 @@
+import type { PatternContext } from './pattern-combiner';
+import type { TelemetryClient } from './telemetry';
+export interface ABVariant {
+    name: string;
+    context: PatternContext;
+    description?: string;
+}
+export interface ABTestResult {
+    variant: string;
+    instructions: string;
+    score: number;
+    structureScore: number;
+    clarityScore: number;
+    completenessScore: number;
+    missingCount: number;
+}
+/**
+ * Generate instructions for multiple A/B test variants
+ */
+export declare function generateABVariants(variants: ABVariant[]): ABTestResult[];
+/**
+ * Compare AB test results and return best variant
+ */
+export declare function analyzeBestVariant(results: ABTestResult[]): ABTestResult;
+/**
+ * Track A/B test results via telemetry (optional)
+ */
+export declare function trackABTest(results: ABTestResult[], telemetry?: TelemetryClient): void;

package/dist/ai-refinement.d.ts

@@ -0,0 +1,24 @@
+import type { Config } from './types';
+/**
+ * Default AI refinement configuration
+ */
+export declare const DEFAULT_AI_REFINEMENT: {
+    quality: "standard";
+    contextLevel: "balanced";
+    outputFormat: "markdown";
+    tokenBudget: number;
+    includeExamples: boolean;
+    includeBestPractices: boolean;
+};
+/**
+ * Token budget thresholds by quality level
+ */
+export declare const TOKEN_BUDGETS: Record<string, number>;
+/**
+ * Apply AI refinement transformations to instruction content
+ */
+export declare function refineInstructions(content: string, config: Config['aiRefinement']): string;
+/**
+ * Estimate token count for content
+ */
+export declare function estimateTokens(content: string): number;

package/dist/analysis.d.ts

@@ -0,0 +1,18 @@
+import type { ConfigFileTagMap, DependencyTagMap, FileGlobTagMap } from './types';
+/**
+ * The data structure representing the analysis of a project.
+ * This is built by scanning the project's files and dependencies.
+ */
+export interface ProjectAnalysisData {
+    /** Dependencies from package.json (both dependencies and devDependencies) */
+    dependencies: Record<string, string>;
+    /** Key config files found at the project root */
+    configFiles: string[];
+    /** All project files (for glob matching) */
+    projectFiles: string[];
+}
+/**
+ * Analyzes a project and returns the set of tags that apply to it.
+ * This is the core logic that determines which instruction templates to apply.
+ */
+export declare function analyzeProjectTags(analysisData: ProjectAnalysisData, dependencyTagMap: DependencyTagMap, configFileTagMap: ConfigFileTagMap, fileGlobTagMap: FileGlobTagMap): Set<string>;

package/dist/analysis.service.d.ts

@@ -0,0 +1,11 @@
+import type { DetectionContext, Instruction } from './plugins/plugin.interface';
+export declare class AnalysisService {
+    private plugins;
+    constructor();
+    /**
+     * Analyzes a project and generates all AI instructions.
+     * @param context - The project file context.
+     * @returns An array of all instructions from all detected plugins.
+     */
+    analyzeProject(context: DetectionContext): Promise<Instruction[]>;
+}

package/dist/browser.d.ts

@@ -0,0 +1,9 @@
+export { analyzeProjectTags, type ProjectAnalysisData } from './analysis';
+export { BUILT_IN_CONFIG } from './built-in-config';
+export { type AssistantTarget, getFormatter, type InstructionFormatter, GitHubCopilotFormatter, ClaudeFormatter, CopilotChatFormatter, GenericFormatter, } from './formatters';
+export * from './types';
+import type { Config, MergedConfig } from './types';
+/**
+ * Merge user config with built-in config (browser version - no filesystem access)
+ */
+export declare function mergeConfigs(userConfig: Partial<Config>): MergedConfig;

package/dist/built-in-config.d.ts

@@ -0,0 +1,8 @@
+import type { MergedConfig } from './types';
+/**
+ * This is the "brain" of the tool.
+ * It contains all the pre-configured rules for common frameworks and tools.
+ * This configuration is used automatically, so the user doesn't have to
+ * create a config file for basic projects.
+ */
+export declare const BUILT_IN_CONFIG: MergedConfig;

package/dist/builtin-plugins/base/BasePlugin.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Base Plugin Class
+ *
+ * Abstract base class providing common functionality for all language plugins.
+ * Plugins should extend this class and implement the abstract methods.
+ */
+import type { ConfigFileTagMap, DependencyTagMap, FileGlobTagMap, LanguagePlugin, ProjectMetadata, TemplateDefinition } from '../../types';
+export declare abstract class BasePlugin implements LanguagePlugin {
+    abstract name: string;
+    abstract displayName: string;
+    abstract version: string;
+    abstract priority: number;
+    /**
+     * Abstract method: Detect if this plugin applies to the project
+     */
+    abstract detect(projectPath: string): Promise<ProjectMetadata | null>;
+    /**
+     * Abstract method: Get templates provided by this plugin
+     */
+    abstract getTemplates(): TemplateDefinition[] | Promise<TemplateDefinition[]>;
+    /**
+     * Optional: Get dependency-to-tag mapping
+     */
+    getDependencyTagMap?(): DependencyTagMap;
+    /**
+     * Optional: Get config file-to-tag mapping
+     */
+    getConfigFileTagMap?(): ConfigFileTagMap;
+    /**
+     * Optional: Get file glob-to-tag mapping
+     */
+    getFileGlobTagMap?(): FileGlobTagMap;
+    /**
+     * Check if a file exists in the project
+     */
+    protected fileExists(projectPath: string, filename: string): boolean;
+    /**
+     * Read a file from the project
+     */
+    protected readFile(projectPath: string, filename: string): string | null;
+    /**
+     * Parse JSON file from the project
+     */
+    protected readJSON<T = Record<string, unknown>>(projectPath: string, filename: string): T | null;
+    /**
+     * Get project name from path
+     */
+    protected getProjectName(projectPath: string): string;
+    /**
+     * Load template from file
+     */
+    protected loadTemplateFromFile(templatePath: string): Promise<string | null>;
+    /**
+     * Create a template definition with lazy loading
+     */
+    protected createTemplate(name: string, tags: string[], contentOrPath: string | (() => string | Promise<string>), options?: Partial<TemplateDefinition>): TemplateDefinition;
+    /**
+     * Parse dependencies from package-like files
+     */
+    protected parseDependencies(obj: Record<string, unknown>, ...keys: string[]): Record<string, string>;
+    /**
+     * Find files matching a pattern
+     */
+    protected findFiles(projectPath: string, pattern: string): Promise<string[]>;
+    /**
+     * Check if any files exist matching a pattern
+     */
+    protected hasFiles(projectPath: string, pattern: string): Promise<boolean>;
+}

package/dist/builtin-plugins/csharp/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * C# / .NET Language Plugin
+ *
+ * Detects C# projects via .csproj files
+ */
+import type { ProjectMetadata, TemplateDefinition } from '../../types';
+import { BasePlugin } from '../base/BasePlugin';
+export declare class CSharpPlugin extends BasePlugin {
+    name: string;
+    displayName: string;
+    version: string;
+    priority: number;
+    detect(projectPath: string): Promise<ProjectMetadata | null>;
+    getTemplates(): TemplateDefinition[];
+    getDependencyTagMap(): {
+        'Microsoft.AspNetCore': string;
+        xunit: string;
+        NUnit: string;
+    };
+}

package/dist/builtin-plugins/go/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Go Language Plugin
+ *
+ * Detects Go projects via go.mod file
+ * Parses module dependencies from go.mod
+ */
+import type { ProjectMetadata, TemplateDefinition } from '../../types';
+import { BasePlugin } from '../base/BasePlugin';
+export declare class GoPlugin extends BasePlugin {
+    name: string;
+    displayName: string;
+    version: string;
+    priority: number;
+    detect(projectPath: string): Promise<ProjectMetadata | null>;
+    getTemplates(): TemplateDefinition[];
+    getDependencyTagMap(): {
+        'github.com/gin-gonic/gin': string;
+        'github.com/gofiber/fiber': string;
+        'github.com/labstack/echo': string;
+        'gorm.io/gorm': string;
+    };
+    private getGoTemplate;
+}

package/dist/builtin-plugins/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Magic Helix Language Plugins
+ *
+ * Built-in language detection plugins for popular languages.
+ */
+export { BasePlugin } from './base/BasePlugin';
+export { NodeJSPlugin } from './nodejs';
+export { GoPlugin } from './go';
+export { PythonPlugin } from './python';
+export { RustPlugin } from './rust';
+export { JavaPlugin } from './java';
+export { RubyPlugin } from './ruby';
+export { PHPPlugin } from './php';
+export { CSharpPlugin } from './csharp';
+export { SwiftPlugin } from './swift';

package/dist/builtin-plugins/java/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Java Language Plugin
+ *
+ * Detects Java projects via pom.xml (Maven) or build.gradle (Gradle)
+ */
+import type { ProjectMetadata, TemplateDefinition } from '../../types';
+import { BasePlugin } from '../base/BasePlugin';
+export declare class JavaPlugin extends BasePlugin {
+    name: string;
+    displayName: string;
+    version: string;
+    priority: number;
+    detect(projectPath: string): Promise<ProjectMetadata | null>;
+    getTemplates(): TemplateDefinition[];
+    getDependencyTagMap(): {
+        'org.springframework.boot:spring-boot': string;
+        'spring-boot-starter': string;
+        junit: string;
+    };
+    private detectMaven;
+    private detectGradle;
+}

package/dist/builtin-plugins/nodejs/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Node.js Language Plugin
+ *
+ * Detects Node.js/JavaScript/TypeScript projects via package.json
+ * Supports npm workspaces for monorepo detection
+ */
+import type { ProjectMetadata, TemplateDefinition } from '../../types';
+import { BasePlugin } from '../base/BasePlugin';
+export declare class NodeJSPlugin extends BasePlugin {
+    name: string;
+    displayName: string;
+    version: string;
+    priority: number;
+    detect(projectPath: string): Promise<ProjectMetadata | null>;
+    getTemplates(): TemplateDefinition[];
+    getDependencyTagMap(): {
+        react: string;
+        'react-dom': string;
+        vue: string;
+        '@vue/runtime-core': string;
+        pinia: string;
+        '@nestjs/core': string;
+        tailwindcss: string;
+        vitest: string;
+        zustand: string;
+        typescript: string;
+    };
+    getConfigFileTagMap(): {
+        'tailwind.config.js': string;
+        'tailwind.config.ts': string;
+        'vitest.config.js': string;
+        'vitest.config.ts': string;
+        'tsconfig.json': string;
+    };
+    private extractWorkspaces;
+    private getTypescriptTemplate;
+    private getReactTemplate;
+    private getReactZustandTemplate;
+    private getVueTemplate;
+    private getVuePiniaTemplate;
+    private getNestJSTemplate;
+    private getTailwindTemplate;
+    private getVitestTemplate;
+}

package/dist/builtin-plugins/php/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * PHP Language Plugin
+ *
+ * Detects PHP projects via composer.json
+ */
+import type { ProjectMetadata, TemplateDefinition } from '../../types';
+import { BasePlugin } from '../base/BasePlugin';
+export declare class PHPPlugin extends BasePlugin {
+    name: string;
+    displayName: string;
+    version: string;
+    priority: number;
+    detect(projectPath: string): Promise<ProjectMetadata | null>;
+    getTemplates(): TemplateDefinition[];
+    getDependencyTagMap(): {
+        'laravel/framework': string;
+        'symfony/symfony': string;
+        'phpunit/phpunit': string;
+    };
+}