@codex-ultra/cxu 0.1.0

package/dist/vendor/saVmTreeSitter.d.ts

@@ -0,0 +1,129 @@
+import { type Node } from "web-tree-sitter";
+export type OutlineSymbolKind = "function" | "method" | "class" | "struct" | "interface" | "enum" | "variant" | "trait" | "impl" | "type" | "module" | "constant" | "variable";
+export type OutlineSymbol = {
+    name: string;
+    kind: OutlineSymbolKind;
+    startLine: number;
+    endLine: number;
+    signature?: string;
+    children?: OutlineSymbol[];
+};
+export type FileOutlineResult = {
+    filePath: string;
+    language: string | null;
+    totalLines: number;
+    symbols: OutlineSymbol[];
+    formatted: string;
+};
+export type SymbolEdit = {
+    start: number;
+    end: number;
+    line: number;
+    column: number;
+    oldText: string;
+    newText: string;
+    preview: string;
+};
+export type FileRenameResult = {
+    filePath: string;
+    editsCount: number;
+    edits: SymbolEdit[];
+    newContent: string;
+    applied: boolean;
+};
+export declare function getTreeSitterWasmPath(): string | null;
+export declare function getLanguageWasmPath(langName: string): string | null;
+export declare function initTreeSitter(): Promise<boolean>;
+export declare function getLanguageNameForFile(filePath: string): string | null;
+/** Check if an AST node is located inside comments or string literals. */
+export declare function isInsideCommentOrString(node: Node | null): boolean;
+/** Format symbol outline as a compact tree text for LLM. */
+export declare function formatOutlineAsTree(filePath: string, totalLines: number, symbols: OutlineSymbol[]): string;
+/** Extract structural outline of any supported source file. */
+export declare function extractFileOutline(filePath: string, content: string, options?: {
+    detail?: boolean;
+}): Promise<FileOutlineResult>;
+/**
+ * Safely rename a symbol within a file using Tree-sitter AST.
+ * Skips comments, string literals, and identifiers that don't match the exact symbol boundary.
+ */
+export declare function renameSymbolInContent(filePath: string, content: string, oldName: string, newName: string): Promise<{
+    newContent: string;
+    edits: SymbolEdit[];
+}>;
+export type DefinitionMatch = {
+    filePath: string;
+    symbol: string;
+    kind: OutlineSymbolKind;
+    startLine: number;
+    endLine: number;
+    signature: string;
+    bodySnippet: string;
+};
+export declare function findDefinitionInContent(filePath: string, content: string, targetSymbol: string, options?: {
+    includeBody?: boolean;
+    maxBodyLines?: number;
+}): Promise<DefinitionMatch | null>;
+export type SyntaxDiagnostic = {
+    line: number;
+    column: number;
+    message: string;
+    preview: string;
+    code?: string | number;
+};
+export type SyntaxDiagnosticsResult = {
+    filePath: string;
+    clean: boolean;
+    errorsCount: number;
+    errors: SyntaxDiagnostic[];
+    formatted: string;
+};
+export declare function getSyntaxDiagnostics(filePath: string, content: string): Promise<SyntaxDiagnosticsResult>;
+export declare function addImportToContent(_filePath: string, content: string, options: {
+    statement?: string;
+    symbol?: string;
+    module?: string;
+    isType?: boolean;
+}): {
+    newContent: string;
+    applied: boolean;
+    message: string;
+};
+export interface OrganizeImportsResult {
+    filePath: string;
+    applied: boolean;
+    changed: boolean;
+    newContent: string;
+    removedImportsCount: number;
+    removedUnusedCount: number;
+    mergedImportsCount: number;
+    mergedCount: number;
+    formatted: string;
+    summary: string;
+}
+export declare function organizeImportsInContent(filePath: string, content: string, options?: {
+    removeUnused?: boolean;
+    sort?: boolean;
+    mergeDuplicates?: boolean;
+}): OrganizeImportsResult;
+export interface ScopeAnalysisResult {
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    componentName: string;
+    capturedVariables: Array<{
+        name: string;
+        type: string;
+        isFunction: boolean;
+        isStateSetter: boolean;
+    }>;
+    declaredSymbols: string[];
+    importedDependencies: string[];
+    suggestedPropsInterface: string;
+    suggestedCallSnippet: string;
+    summary: string;
+}
+export declare function analyzeBlockScope(filePath: string, content: string, startLine: number, endLine: number, optionsOrComponentName?: {
+    componentName?: string;
+} | string): ScopeAnalysisResult;
+export declare function generateTargetImportsForBlock(sourcePath: string, targetPath: string, sourceContent: string, startLine: number, endLine: number): string;

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@codex-ultra/cxu",
+  "version": "0.1.0",
+  "description": "Pure-TypeScript cross-platform file and AST toolkit (zero embedded binaries). Bring your own Bun only for run_bun / complex TS tracks.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "cxu": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "wasm",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "vendor": "node scripts/vendor-sa-vm.mjs",
+    "build": "node scripts/build.mjs",
+    "build:bun": "bun scripts/build.mjs",
+    "obfuscate": "node scripts/obfuscate.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepack": "npm run build && npm run obfuscate",
+    "test": "bun test test/ 2>/dev/null || node --test test/*.test.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "tree-sitter-wasms": "^0.1.13",
+    "web-tree-sitter": "0.25.10"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.12",
+    "javascript-obfuscator": "^5.5.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/layola13/codex-ultra#readme",
+  "bugs": {
+    "url": "https://github.com/layola13/codex-ultra/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/layola13/codex-ultra.git",
+    "directory": "packages/cxu"
+  },
+  "keywords": [
+    "codex",
+    "vm-tools",
+    "ast",
+    "tree-sitter",
+    "typescript",
+    "cross-platform"
+  ]
+}