boperators 0.1.3 → 0.2.0

package/dist/cjs/core/OverloadInjector.js

@@ -1,136 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OverloadInjector = void 0;
-const node_path_1 = __importDefault(require("node:path"));
-const ts_morph_1 = require("ts-morph");
-const ensureImportedName_1 = require("./helpers/ensureImportedName");
-const getModuleSpecifier_1 = require("./helpers/getModuleSpecifier");
-const resolveExpressionType_1 = require("./helpers/resolveExpressionType");
-const operatorMap_1 = require("./operatorMap");
-const SourceMap_1 = require("./SourceMap");
-class OverloadInjector {
-    constructor(
-    /**
-     * TS Morph project.
-     */
-    _project, 
-    /**
-     * Overload store.
-     */
-    _overloadStore, logger) {
-        this._project = _project;
-        this._overloadStore = _overloadStore;
-        this._logger = logger;
-    }
-    overloadFile(file) {
-        const sourceFile = file instanceof ts_morph_1.SourceFile
-            ? file
-            : this._project.getSourceFileOrThrow(file);
-        const fileName = node_path_1.default.basename(sourceFile.getFilePath());
-        const originalText = sourceFile.getFullText();
-        let transformCount = 0;
-        // Process one innermost binary expression per iteration,
-        // re-fetching descendants each time so types resolve correctly
-        // after each transformation and AST references stay fresh.
-        let changed = true;
-        while (changed) {
-            changed = false;
-            // Reverse DFS pre-order → innermost expressions first
-            const binaryExpressions = sourceFile
-                .getDescendantsOfKind(ts_morph_1.SyntaxKind.BinaryExpression)
-                .reverse();
-            for (const expression of binaryExpressions) {
-                const operatorKind = expression.getOperatorToken().getKind();
-                if (!(0, operatorMap_1.isOperatorSyntaxKind)(operatorKind))
-                    continue;
-                const lhs = expression.getLeft();
-                const leftType = (0, resolveExpressionType_1.resolveExpressionType)(lhs);
-                const rhs = expression.getRight();
-                const rightType = (0, resolveExpressionType_1.resolveExpressionType)(rhs);
-                const overloadDesc = this._overloadStore.findOverload(operatorKind, leftType, rightType);
-                if (!overloadDesc)
-                    continue;
-                const { className: classNameRaw, classFilePath, operatorString, index, isStatic, } = overloadDesc;
-                // Look up the fresh ClassDeclaration from the project
-                const classSourceFile = this._project.getSourceFileOrThrow(classFilePath);
-                const classDecl = classSourceFile.getClassOrThrow(classNameRaw);
-                // Ensure class is imported, get its textual name
-                const classModuleSpecifier = (0, getModuleSpecifier_1.getModuleSpecifier)(sourceFile, classSourceFile);
-                const className = (0, ensureImportedName_1.ensureImportedName)(sourceFile, classDecl.getSymbol(), classModuleSpecifier);
-                // Build the text code to replace the binary operator with the overload call
-                const overloadCall = isStatic
-                    ? `${className}["${operatorString}"][${index}](${lhs.getText()}, ${rhs.getText()})`
-                    : `${lhs.getText()}["${operatorString}"][${index}].call(${lhs.getText()}, ${rhs.getText()})`;
-                this._logger.debug(`${fileName}: ${expression.getText()} => ${overloadCall}`);
-                expression.replaceWithText(overloadCall);
-                transformCount++;
-                changed = true;
-                break; // re-fetch descendants after each mutation
-            }
-        }
-        // Process prefix unary expressions (-x, +x, !x, ~x)
-        changed = true;
-        while (changed) {
-            changed = false;
-            const prefixExpressions = sourceFile
-                .getDescendantsOfKind(ts_morph_1.SyntaxKind.PrefixUnaryExpression)
-                .reverse();
-            for (const expression of prefixExpressions) {
-                const operatorKind = expression.getOperatorToken();
-                if (!(0, operatorMap_1.isPrefixUnaryOperatorSyntaxKind)(operatorKind))
-                    continue;
-                const operand = expression.getOperand();
-                const operandType = (0, resolveExpressionType_1.resolveExpressionType)(operand);
-                const overloadDesc = this._overloadStore.findPrefixUnaryOverload(operatorKind, operandType);
-                if (!overloadDesc)
-                    continue;
-                const { className: classNameRaw, classFilePath, operatorString, index, } = overloadDesc;
-                const classSourceFile = this._project.getSourceFileOrThrow(classFilePath);
-                const classDecl = classSourceFile.getClassOrThrow(classNameRaw);
-                const classModuleSpecifier = (0, getModuleSpecifier_1.getModuleSpecifier)(sourceFile, classSourceFile);
-                const className = (0, ensureImportedName_1.ensureImportedName)(sourceFile, classDecl.getSymbol(), classModuleSpecifier);
-                const overloadCall = `${className}["${operatorString}"][${index}](${operand.getText()})`;
-                this._logger.debug(`${fileName}: ${expression.getText()} => ${overloadCall}`);
-                expression.replaceWithText(overloadCall);
-                transformCount++;
-                changed = true;
-                break;
-            }
-        }
-        // Process postfix unary expressions (x++, x--)
-        changed = true;
-        while (changed) {
-            changed = false;
-            const postfixExpressions = sourceFile
-                .getDescendantsOfKind(ts_morph_1.SyntaxKind.PostfixUnaryExpression)
-                .reverse();
-            for (const expression of postfixExpressions) {
-                const operatorKind = expression.getOperatorToken();
-                if (!(0, operatorMap_1.isPostfixUnaryOperatorSyntaxKind)(operatorKind))
-                    continue;
-                const operand = expression.getOperand();
-                const operandType = (0, resolveExpressionType_1.resolveExpressionType)(operand);
-                const overloadDesc = this._overloadStore.findPostfixUnaryOverload(operatorKind, operandType);
-                if (!overloadDesc)
-                    continue;
-                const { operatorString, index } = overloadDesc;
-                const overloadCall = `${operand.getText()}["${operatorString}"][${index}].call(${operand.getText()})`;
-                this._logger.debug(`${fileName}: ${expression.getText()} => ${overloadCall}`);
-                expression.replaceWithText(overloadCall);
-                transformCount++;
-                changed = true;
-                break;
-            }
-        }
-        if (transformCount > 0) {
-            this._logger.debug(`${fileName}: ${transformCount} expression${transformCount === 1 ? "" : "s"} transformed`);
-        }
-        const text = sourceFile.getFullText();
-        const sourceMap = new SourceMap_1.SourceMap(originalText, text);
-        return { sourceFile, text, sourceMap };
-    }
-}
-exports.OverloadInjector = OverloadInjector;

package/dist/cjs/lib/index.js

@@ -1,17 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./operatorSymbols"), exports);

package/dist/esm/core/BopConfig.js

@@ -1,65 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-const CONFIG_FILE_NAME = ".bopconf.json";
-// ----- ConsoleLogger -----
-export class ConsoleLogger {
-    debug(msg) {
-        console.debug(`[boperators] ${msg}`);
-    }
-    info(msg) {
-        console.log(`[boperators] ${msg}`);
-    }
-    warn(msg) {
-        console.warn(`[boperators] ${msg}`);
-    }
-    error(msg) {
-        console.error(`[boperators] ${msg}`);
-    }
-}
-// ----- Filtered logger -----
-const LOG_LEVELS = ["debug", "info", "warn", "error", "silent"];
-function createFilteredLogger(inner, level) {
-    const minIndex = LOG_LEVELS.indexOf(level);
-    const noop = () => { };
-    return {
-        debug: minIndex <= 0 ? inner.debug.bind(inner) : noop,
-        info: minIndex <= 1 ? inner.info.bind(inner) : noop,
-        warn: minIndex <= 2 ? inner.warn.bind(inner) : noop,
-        error: minIndex <= 3 ? inner.error.bind(inner) : noop,
-    };
-}
-// ----- Config file discovery -----
-function findConfigFile(startDir) {
-    let dir = path.resolve(startDir);
-    while (true) {
-        const candidate = path.join(dir, CONFIG_FILE_NAME);
-        try {
-            const content = fs.readFileSync(candidate, "utf-8");
-            return JSON.parse(content);
-        }
-        catch (_a) {
-            // File not found or invalid JSON — keep walking up
-        }
-        const parent = path.dirname(dir);
-        if (parent === dir)
-            break; // filesystem root
-        dir = parent;
-    }
-    return {};
-}
-const DEFAULTS = {
-    errorOnWarning: false,
-    logLevel: "info",
-};
-export function loadConfig(options) {
-    var _a, _b;
-    const fileConfig = findConfigFile((_a = options === null || options === void 0 ? void 0 : options.searchDir) !== null && _a !== void 0 ? _a : process.cwd());
-    const merged = Object.assign(Object.assign(Object.assign({}, DEFAULTS), fileConfig), options === null || options === void 0 ? void 0 : options.overrides);
-    const baseLogger = (_b = options === null || options === void 0 ? void 0 : options.logger) !== null && _b !== void 0 ? _b : new ConsoleLogger();
-    const logger = createFilteredLogger(baseLogger, merged.logLevel);
-    return {
-        errorOnWarning: merged.errorOnWarning,
-        logLevel: merged.logLevel,
-        logger,
-    };
-}

package/dist/esm/core/ErrorManager.js

@@ -1,118 +0,0 @@
-import path from "node:path";
-/**
- * Stores information about an error or warning for later use.
- */
-export class ErrorDescription {
-    /**
-     * Create an ErrorDescription.
-     *
-     * @param errorMessage Custom message text describing the error.
-     * @param filePath Error file path.
-     * @param lineNumber Error line number in its file.
-     * @param codeText Code relevant to the error.q
-     */
-    constructor(errorMessage, filePath, lineNumber, codeText) {
-        this.errorMessage = errorMessage;
-        this.filePath = filePath;
-        this.lineNumber = lineNumber;
-        this.codeText = codeText;
-        this.fileName = path.basename(filePath);
-    }
-    toString() {
-        return `${this.fileName}:${this.lineNumber}: ${this.errorMessage}\n${this.codeText}\n`;
-    }
-}
-/**
- * Stores errors and warnings in a way that means
- * they can be logged or thrown at a later point.
- */
-export class ErrorManager {
-    constructor(config) {
-        /**
-         * Array of warnings.
-         */
-        this._warnings = [];
-        /**
-         * Array of errors.
-         */
-        this._errors = [];
-        this._config = config;
-        this._errorOnWarning = config.errorOnWarning;
-    }
-    /**
-     * Add an ErrorDescription or a string as a "warning",
-     * meaning it will not throw unless `errorOnWarning` is true.
-     * @param description Either a string describing the error or a {@link ErrorDescription} instance.
-     */
-    addWarning(description) {
-        this._warnings.push(description);
-    }
-    /**
-     * Add an ErrorDescription or a string as an "error",
-     * meaning it will throw when checked.
-     * @param description Either a string describing the error or a {@link ErrorDescription} instance.
-     */
-    addError(description) {
-        this._errors.push(description);
-    }
-    /**
-     * Gets all warnings as a single string, separated by newlines.
-     * @returns String of all warnings.
-     */
-    getWarningString() {
-        return this._warnings.map((warning) => warning.toString()).join("\n");
-    }
-    /**
-     * Gets all errors as a single string, separated by newlines.
-     * @returns String of all errors.
-     */
-    getErrorsString() {
-        return this._errors.map((error) => error.toString()).join("\n");
-    }
-    /**
-     * Throws if there are any errors currently registered in the ErrorManager.
-     * If `errorOnWarning` is true then it will also throw if there are warnings.
-     */
-    throwIfErrors() {
-        const shouldThrow = this._errors.length > 0 ||
-            (this._errorOnWarning && this._warnings.length > 0);
-        if (!shouldThrow)
-            return;
-        const errorString = this.getErrorsString() +
-            (this._errorOnWarning ? this.getWarningString() : "");
-        throw new Error(errorString);
-    }
-    /**
-     * Will throw if there are any errors, or if there are warnings and `errorOnWarning` is true.
-     * If it does not throw then it will log all wanrnings to the console.
-     * @param clearSelf If true, all warnings will be cleared after logging.
-     */
-    throwIfErrorsElseLogWarnings(clearSelf = true) {
-        this.throwIfErrors();
-        if (this._warnings.length > 0) {
-            this._config.logger.warn(this.getWarningString());
-        }
-        if (clearSelf) {
-            this.clearWarnings();
-        }
-    }
-    /**
-     * Clear out registered warnings to prevent duplicate logging.
-     */
-    clearWarnings() {
-        this._warnings = [];
-    }
-    /**
-     * Clear out registered errors.
-     */
-    clearErrors() {
-        this._errors = [];
-    }
-    /**
-     * Clear all registered errors and warnings.
-     */
-    clear() {
-        this._errors = [];
-        this._warnings = [];
-    }
-}

package/dist/esm/core/OverloadInjector.js

@@ -1,129 +0,0 @@
-import path from "node:path";
-import { SourceFile, SyntaxKind, } from "ts-morph";
-import { ensureImportedName } from "./helpers/ensureImportedName";
-import { getModuleSpecifier } from "./helpers/getModuleSpecifier";
-import { resolveExpressionType } from "./helpers/resolveExpressionType";
-import { isOperatorSyntaxKind, isPostfixUnaryOperatorSyntaxKind, isPrefixUnaryOperatorSyntaxKind, } from "./operatorMap";
-import { SourceMap } from "./SourceMap";
-export class OverloadInjector {
-    constructor(
-    /**
-     * TS Morph project.
-     */
-    _project, 
-    /**
-     * Overload store.
-     */
-    _overloadStore, logger) {
-        this._project = _project;
-        this._overloadStore = _overloadStore;
-        this._logger = logger;
-    }
-    overloadFile(file) {
-        const sourceFile = file instanceof SourceFile
-            ? file
-            : this._project.getSourceFileOrThrow(file);
-        const fileName = path.basename(sourceFile.getFilePath());
-        const originalText = sourceFile.getFullText();
-        let transformCount = 0;
-        // Process one innermost binary expression per iteration,
-        // re-fetching descendants each time so types resolve correctly
-        // after each transformation and AST references stay fresh.
-        let changed = true;
-        while (changed) {
-            changed = false;
-            // Reverse DFS pre-order → innermost expressions first
-            const binaryExpressions = sourceFile
-                .getDescendantsOfKind(SyntaxKind.BinaryExpression)
-                .reverse();
-            for (const expression of binaryExpressions) {
-                const operatorKind = expression.getOperatorToken().getKind();
-                if (!isOperatorSyntaxKind(operatorKind))
-                    continue;
-                const lhs = expression.getLeft();
-                const leftType = resolveExpressionType(lhs);
-                const rhs = expression.getRight();
-                const rightType = resolveExpressionType(rhs);
-                const overloadDesc = this._overloadStore.findOverload(operatorKind, leftType, rightType);
-                if (!overloadDesc)
-                    continue;
-                const { className: classNameRaw, classFilePath, operatorString, index, isStatic, } = overloadDesc;
-                // Look up the fresh ClassDeclaration from the project
-                const classSourceFile = this._project.getSourceFileOrThrow(classFilePath);
-                const classDecl = classSourceFile.getClassOrThrow(classNameRaw);
-                // Ensure class is imported, get its textual name
-                const classModuleSpecifier = getModuleSpecifier(sourceFile, classSourceFile);
-                const className = ensureImportedName(sourceFile, classDecl.getSymbol(), classModuleSpecifier);
-                // Build the text code to replace the binary operator with the overload call
-                const overloadCall = isStatic
-                    ? `${className}["${operatorString}"][${index}](${lhs.getText()}, ${rhs.getText()})`
-                    : `${lhs.getText()}["${operatorString}"][${index}].call(${lhs.getText()}, ${rhs.getText()})`;
-                this._logger.debug(`${fileName}: ${expression.getText()} => ${overloadCall}`);
-                expression.replaceWithText(overloadCall);
-                transformCount++;
-                changed = true;
-                break; // re-fetch descendants after each mutation
-            }
-        }
-        // Process prefix unary expressions (-x, +x, !x, ~x)
-        changed = true;
-        while (changed) {
-            changed = false;
-            const prefixExpressions = sourceFile
-                .getDescendantsOfKind(SyntaxKind.PrefixUnaryExpression)
-                .reverse();
-            for (const expression of prefixExpressions) {
-                const operatorKind = expression.getOperatorToken();
-                if (!isPrefixUnaryOperatorSyntaxKind(operatorKind))
-                    continue;
-                const operand = expression.getOperand();
-                const operandType = resolveExpressionType(operand);
-                const overloadDesc = this._overloadStore.findPrefixUnaryOverload(operatorKind, operandType);
-                if (!overloadDesc)
-                    continue;
-                const { className: classNameRaw, classFilePath, operatorString, index, } = overloadDesc;
-                const classSourceFile = this._project.getSourceFileOrThrow(classFilePath);
-                const classDecl = classSourceFile.getClassOrThrow(classNameRaw);
-                const classModuleSpecifier = getModuleSpecifier(sourceFile, classSourceFile);
-                const className = ensureImportedName(sourceFile, classDecl.getSymbol(), classModuleSpecifier);
-                const overloadCall = `${className}["${operatorString}"][${index}](${operand.getText()})`;
-                this._logger.debug(`${fileName}: ${expression.getText()} => ${overloadCall}`);
-                expression.replaceWithText(overloadCall);
-                transformCount++;
-                changed = true;
-                break;
-            }
-        }
-        // Process postfix unary expressions (x++, x--)
-        changed = true;
-        while (changed) {
-            changed = false;
-            const postfixExpressions = sourceFile
-                .getDescendantsOfKind(SyntaxKind.PostfixUnaryExpression)
-                .reverse();
-            for (const expression of postfixExpressions) {
-                const operatorKind = expression.getOperatorToken();
-                if (!isPostfixUnaryOperatorSyntaxKind(operatorKind))
-                    continue;
-                const operand = expression.getOperand();
-                const operandType = resolveExpressionType(operand);
-                const overloadDesc = this._overloadStore.findPostfixUnaryOverload(operatorKind, operandType);
-                if (!overloadDesc)
-                    continue;
-                const { operatorString, index } = overloadDesc;
-                const overloadCall = `${operand.getText()}["${operatorString}"][${index}].call(${operand.getText()})`;
-                this._logger.debug(`${fileName}: ${expression.getText()} => ${overloadCall}`);
-                expression.replaceWithText(overloadCall);
-                transformCount++;
-                changed = true;
-                break;
-            }
-        }
-        if (transformCount > 0) {
-            this._logger.debug(`${fileName}: ${transformCount} expression${transformCount === 1 ? "" : "s"} transformed`);
-        }
-        const text = sourceFile.getFullText();
-        const sourceMap = new SourceMap(originalText, text);
-        return { sourceFile, text, sourceMap };
-    }
-}