@breadstone-tools/localizator-core 0.0.12-beta.0

package/Detectors/JSXDetector.js

@@ -0,0 +1,101 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSXDetector = void 0;
+const BaseDetector_js_1 = require("./Abstracts/BaseDetector.js");
+const Utils_js_1 = require("./Utils.js");
+/**
+ * Detector for extracting translatable strings from JSX files.
+ *
+ * This detector supports the following scenarios:
+ * - **Simple Function Calls**:
+ *   ```jsx
+ *   t("This is a translatable string");
+ *   translate("Another translatable string");
+ *   ```
+ * - **With Context**:
+ *   ```jsx
+ *   t("This is translatable", { context: "example" });
+ *   ```
+ * - **Template Literals**:
+ *   ```jsx
+ *   t(`This is a template literal`);
+ *   ```
+ *
+ * @public
+ */
+class JSXDetector extends BaseDetector_js_1.BaseDetector {
+    // #region Fields
+    _marker;
+    // #endregion
+    // #region Constructor
+    /**
+     * Constructs a new instance of the `JSXDetector` class.
+     *
+     * @public
+     * @param logger - The logger.
+     * @param options - Configuration options for the detector.
+     */
+    constructor(logger, options) {
+        super(logger, options);
+        this._marker = options?.marker ?? /t|translate/;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Provides the regex patterns for extracting strings from JSX content.
+     *
+     * @protected
+     * @returns A RegExp for extracting strings.
+     */
+    getRegexes() {
+        const functionPattern = this._marker instanceof RegExp
+            ? this._marker.source
+            : (0, Utils_js_1.escapeRegExp)(this._marker);
+        return [
+            new RegExp(`(?<function>${functionPattern})` + // Function name
+                '\\(' + // Opening parenthesis
+                '\\s*' + // Optional whitespace
+                "(?<quote>['\"`])" + // Quote type
+                '(?<value>(?:\\\\.|[^\\\\])*?)' + // Content inside quotes
+                '\\k<quote>' + // Match the same quote type
+                '(?:,\\s*(?<context>\\{.*?\\}))?' + // Optional context object
+                '\\)', // Closing parenthesis
+            'gs')
+        ];
+    }
+    /**
+     * Pre-processes content before applying regex matching.
+     *
+     * @protected
+     * @param content - The raw content.
+     * @returns The processed content.
+     */
+    preProcessContent(content) {
+        this.log('Pre-processing JSX content.');
+        return content.replace(/\r?\n/g, ' '); // Normalize multiline strings
+    }
+    /**
+     * Post-processes results after regex matching.
+     *
+     * @protected
+     * @param results - The raw results from regex matching.
+     * @returns The processed results.
+     */
+    postProcessResults(results) {
+        this.log(`Post-processing JSX results: ${JSON.stringify(results)}`);
+        return results
+            .filter((result) => result.match.value !== undefined)
+            .map((result) => {
+            if (result.match.value !== undefined) {
+                result.match.value = result.match.value
+                    .replace(/\\"/g, '"') // Unescape double quotes
+                    .replace(/\\'/g, "'") // Unescape single quotes
+                    .trim(); // Remove extra whitespace
+            }
+            return result;
+        });
+    }
+}
+exports.JSXDetector = JSXDetector;
+//# sourceMappingURL=JSXDetector.js.map

package/Detectors/JSXDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSXDetector.js","sourceRoot":"","sources":["../../src/Detectors/JSXDetector.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;AAGlB,iEAAsF;AAEtF,yCAA0C;AAkB1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,WAAY,SAAQ,8BAAY;IAEzC,iBAAiB;IAEA,OAAO,CAAkB;IAE1C,aAAa;IAEb,sBAAsB;IAEtB;;;;;;OAMG;IACH,YAAmB,MAAe,EAAE,OAA6B;QAC7D,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEvB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,IAAI,aAAa,CAAC;IACpD,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;;;;OAKG;IACgB,UAAU;QACzB,MAAM,eAAe,GACjB,IAAI,CAAC,OAAO,YAAY,MAAM;YAC1B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;YACrB,CAAC,CAAC,IAAA,uBAAY,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAErC,OAAO;YACH,IAAI,MAAM,CACN,eAAe,eAAe,GAAG,GAAG,gBAAgB;gBACpD,KAAK,GAAG,sBAAsB;gBAC9B,MAAM,GAAG,sBAAsB;gBAC/B,kBAAkB,GAAG,aAAa;gBAClC,+BAA+B,GAAG,wBAAwB;gBAC1D,YAAY,GAAG,4BAA4B;gBAC3C,iCAAiC,GAAG,0BAA0B;gBAC9D,KAAK,EAAE,sBAAsB;YAC7B,IAAI,CACP;SACJ,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACgB,iBAAiB,CAAC,OAAe;QAChD,IAAI,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,8BAA8B;IACzE,CAAC;IAED;;;;;;OAMG;IACgB,kBAAkB,CAAC,OAA+B;QACjE,IAAI,CAAC,GAAG,CAAC,gCAAgC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEpE,OAAO,OAAO;aACT,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC;aACpD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACZ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK;qBAClC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAG,yBAAyB;qBAChD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAG,yBAAyB;qBAChD,IAAI,EAAE,CAAC,CAAgB,0BAA0B;YAC1D,CAAC;YAED,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACX,CAAC;CAIJ;AA5FD,kCA4FC"}

package/Detectors/JavaScriptDetector.d.ts

@@ -0,0 +1,74 @@
+import type { ILogger } from '@breadstone-infrastructure/utilities';
+import { BaseDetector, type IBaseDetectorOptions } from './Abstracts/BaseDetector.js';
+import type { IDetectorResult } from './Interfaces/IDetector.js';
+/**
+ * Options for configuring the `JavaScriptDetector`.
+ *
+ * @public
+ */
+export interface IJavaScriptDetectorOptions extends IBaseDetectorOptions {
+    /**
+     * The function name or regex used for translation (default: `/t|translate/`).
+     */
+    marker?: string | RegExp;
+}
+/**
+ * Detector for extracting translatable strings from JavaScript files.
+ *
+ * This detector supports the following scenarios:
+ * - **Simple Function Calls**:
+ *   ```javascript
+ *   t("This is a translatable string");
+ *   translate("Another translatable string");
+ *   ```
+ * - **Multiline Strings**:
+ *   ```javascript
+ *   t("This is a \
+ *      multiline string");
+ *   ```
+ * - **Template Literals**:
+ *   ```javascript
+ *   translate(`This is a translatable template literal`);
+ *   ```
+ * - **Function Calls with Context**:
+ *   ```javascript
+ *   t("This is translatable", { context: "example" });
+ *   ```
+ *
+ * @public
+ */
+export declare class JavaScriptDetector extends BaseDetector {
+    private readonly _marker;
+    /**
+     * Constructs a new instance of the `JavaScriptDetector` class.
+     *
+     * @public
+     * @param logger - The logger.
+     * @param options - Configuration options for the detector.
+     */
+    constructor(logger: ILogger, options?: IJavaScriptDetectorOptions);
+    /**
+     * Provides the regex patterns for extracting strings from JavaScript content.
+     *
+     * @protected
+     * @returns A RegExp for extracting strings.
+     */
+    protected getRegexes(): Array<RegExp>;
+    /**
+     * Pre-processes content before applying regex matching.
+     *
+     * @protected
+     * @param content - The raw content.
+     * @returns The processed content.
+     */
+    protected preProcessContent(content: string): string;
+    /**
+     * Post-processes results after regex matching.
+     *
+     * @protected
+     * @param results - The raw results from regex matching.
+     * @returns The processed results.
+     */
+    protected postProcessResults(results: Array<IDetectorResult>): Array<IDetectorResult>;
+}
+//# sourceMappingURL=JavaScriptDetector.d.ts.map

package/Detectors/JavaScriptDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JavaScriptDetector.d.ts","sourceRoot":"","sources":["../../src/Detectors/JavaScriptDetector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjE;;;;GAIG;AACH,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IAEpE;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAE5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAIhD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAM1C;;;;;;OAMG;gBACgB,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,0BAA0B;IAUxE;;;;;OAKG;cACgB,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;IAqB9C;;;;;;OAMG;cACgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAK7D;;;;;;OAMG;cACgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;CAmBjG"}

package/Detectors/JavaScriptDetector.js

@@ -0,0 +1,106 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JavaScriptDetector = void 0;
+const BaseDetector_js_1 = require("./Abstracts/BaseDetector.js");
+const Utils_js_1 = require("./Utils.js");
+/**
+ * Detector for extracting translatable strings from JavaScript files.
+ *
+ * This detector supports the following scenarios:
+ * - **Simple Function Calls**:
+ *   ```javascript
+ *   t("This is a translatable string");
+ *   translate("Another translatable string");
+ *   ```
+ * - **Multiline Strings**:
+ *   ```javascript
+ *   t("This is a \
+ *      multiline string");
+ *   ```
+ * - **Template Literals**:
+ *   ```javascript
+ *   translate(`This is a translatable template literal`);
+ *   ```
+ * - **Function Calls with Context**:
+ *   ```javascript
+ *   t("This is translatable", { context: "example" });
+ *   ```
+ *
+ * @public
+ */
+class JavaScriptDetector extends BaseDetector_js_1.BaseDetector {
+    // #region Fields
+    _marker;
+    // #endregion
+    // #region Constructor
+    /**
+     * Constructs a new instance of the `JavaScriptDetector` class.
+     *
+     * @public
+     * @param logger - The logger.
+     * @param options - Configuration options for the detector.
+     */
+    constructor(logger, options) {
+        super(logger, options);
+        this._marker = options?.marker ?? /t|translate/;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Provides the regex patterns for extracting strings from JavaScript content.
+     *
+     * @protected
+     * @returns A RegExp for extracting strings.
+     */
+    getRegexes() {
+        const functionPattern = this._marker instanceof RegExp
+            ? this._marker.source
+            : (0, Utils_js_1.escapeRegExp)(this._marker);
+        return [
+            new RegExp(`(?<function>${functionPattern})` + // Function name
+                '\\(' + // Opening parenthesis
+                '\\s*' + // Optional whitespace
+                "(?<quote>['\"`])" + // Quote type
+                '(?<value>(?:\\\\.|[^\\\\])*?)' + // Content inside quotes, including escaped quotes
+                '\\k<quote>' + // Match the same quote type
+                '(?:,\\s*(?<context>\\{.*?\\}))?' + // Optional context object
+                '\\)', // Closing parenthesis
+            'gs')
+        ];
+    }
+    /**
+     * Pre-processes content before applying regex matching.
+     *
+     * @protected
+     * @param content - The raw content.
+     * @returns The processed content.
+     */
+    preProcessContent(content) {
+        this.log('Pre-processing JavaScript content.');
+        return content.replace(/\r?\n/g, ' '); // Normalize multiline strings
+    }
+    /**
+     * Post-processes results after regex matching.
+     *
+     * @protected
+     * @param results - The raw results from regex matching.
+     * @returns The processed results.
+     */
+    postProcessResults(results) {
+        this.log(`Post-processing results: ${JSON.stringify(results)}`);
+        return results
+            .filter((result) => result.match.value !== undefined)
+            .map((result) => {
+            if (result.match.value !== undefined) {
+                result.match.value = result.match.value
+                    .replace(/\\"/g, '"') // Unescape double quotes
+                    .replace(/\\'/g, "'") // Unescape single quotes
+                    .trim(); // Remove extra whitespace
+            }
+            return result;
+        });
+    }
+}
+exports.JavaScriptDetector = JavaScriptDetector;
+//# sourceMappingURL=JavaScriptDetector.js.map

package/Detectors/JavaScriptDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JavaScriptDetector.js","sourceRoot":"","sources":["../../src/Detectors/JavaScriptDetector.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;AAGlB,iEAAsF;AAEtF,yCAA0C;AAkB1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAa,kBAAmB,SAAQ,8BAAY;IAEhD,iBAAiB;IAEA,OAAO,CAAkB;IAE1C,aAAa;IAEb,sBAAsB;IAEtB;;;;;;OAMG;IACH,YAAmB,MAAe,EAAE,OAAoC;QACpE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEvB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,IAAI,aAAa,CAAC;IACpD,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;;;;OAKG;IACgB,UAAU;QACzB,MAAM,eAAe,GACjB,IAAI,CAAC,OAAO,YAAY,MAAM;YAC1B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;YACrB,CAAC,CAAC,IAAA,uBAAY,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAErC,OAAO;YACH,IAAI,MAAM,CACN,eAAe,eAAe,GAAG,GAAG,gBAAgB;gBACpD,KAAK,GAAG,sBAAsB;gBAC9B,MAAM,GAAG,sBAAsB;gBAC/B,kBAAkB,GAAG,aAAa;gBAClC,+BAA+B,GAAG,kDAAkD;gBACpF,YAAY,GAAG,4BAA4B;gBAC3C,iCAAiC,GAAG,0BAA0B;gBAC9D,KAAK,EAAE,sBAAsB;YAC7B,IAAI,CACP;SACJ,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACgB,iBAAiB,CAAC,OAAe;QAChD,IAAI,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,8BAA8B;IACzE,CAAC;IAED;;;;;;OAMG;IACgB,kBAAkB,CAAC,OAA+B;QACjE,IAAI,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEhE,OAAO,OAAO;aACT,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC;aACpD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACZ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK;qBAClC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAG,yBAAyB;qBAChD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAG,yBAAyB;qBAChD,IAAI,EAAE,CAAC,CAAgB,0BAA0B;YAC1D,CAAC;YAED,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACX,CAAC;CAIJ;AA5FD,gDA4FC"}

package/Detectors/TSXDetector.d.ts

@@ -0,0 +1,76 @@
+import type { ILogger } from '@breadstone-infrastructure/utilities';
+import { BaseDetector, type IBaseDetectorOptions } from './Abstracts/BaseDetector.js';
+import type { IDetectorResult } from './Interfaces/IDetector.js';
+/**
+ * Options for configuring the `TSXDetector`.
+ *
+ * @public
+ */
+export interface ITSXDetectorOptions extends IBaseDetectorOptions {
+    /**
+     * The function name or regex used for translation (default: `/t|translate/`).
+     */
+    marker?: string | RegExp;
+    /**
+    * The resource key check configuration for the detector.
+    */
+    resourceKey?: {
+        prefix?: string;
+        suffix?: string;
+    };
+}
+/**
+ * Detector for extracting translatable strings from TSX files.
+ *
+ * This detector supports the following scenarios:
+ * - **Simple Function Calls**:
+ *   ```tsx
+ *   t("This is a translatable string");
+ *   translate("Another translatable string");
+ *   ```
+ * - **With Context**:
+ *   ```tsx
+ *   t("This is translatable", { context: "example" });
+ *   ```
+ * - **Template Literals**:
+ *   ```tsx
+ *   t(`This is a template literal`);
+ *   ```
+ *
+ * @public
+ */
+export declare class TSXDetector extends BaseDetector {
+    private readonly _marker;
+    /**
+     * Constructs a new instance of the `TSXDetector` class.
+     *
+     * @public
+     * @param logger - The logger.
+     * @param options - Configuration options for the detector.
+     */
+    constructor(logger: ILogger, options?: ITSXDetectorOptions);
+    /**
+     * Provides the regex patterns for extracting strings from TSX content.
+     *
+     * @protected
+     * @returns A RegExp for extracting strings.
+     */
+    protected getRegexes(): Array<RegExp>;
+    /**
+     * Pre-processes content before applying regex matching.
+     *
+     * @protected
+     * @param content - The raw content.
+     * @returns The processed content.
+     */
+    protected preProcessContent(content: string): string;
+    /**
+     * Post-processes results after regex matching.
+     *
+     * @protected
+     * @param results - The raw results from regex matching.
+     * @returns The processed results.
+     */
+    protected postProcessResults(results: Array<IDetectorResult>): Array<IDetectorResult>;
+}
+//# sourceMappingURL=TSXDetector.d.ts.map

package/Detectors/TSXDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TSXDetector.d.ts","sourceRoot":"","sources":["../../src/Detectors/TSXDetector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjE;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAE7D;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB;;MAEE;IACF,WAAW,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CAEL;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAIzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAM1C;;;;;;OAMG;gBACgB,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAUjE;;;;;OAKG;cACgB,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;IAqB9C;;;;;;OAMG;cACgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAK7D;;;;;;OAMG;cACgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;CAmBjG"}

package/Detectors/TSXDetector.js

@@ -0,0 +1,101 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TSXDetector = void 0;
+const BaseDetector_js_1 = require("./Abstracts/BaseDetector.js");
+const Utils_js_1 = require("./Utils.js");
+/**
+ * Detector for extracting translatable strings from TSX files.
+ *
+ * This detector supports the following scenarios:
+ * - **Simple Function Calls**:
+ *   ```tsx
+ *   t("This is a translatable string");
+ *   translate("Another translatable string");
+ *   ```
+ * - **With Context**:
+ *   ```tsx
+ *   t("This is translatable", { context: "example" });
+ *   ```
+ * - **Template Literals**:
+ *   ```tsx
+ *   t(`This is a template literal`);
+ *   ```
+ *
+ * @public
+ */
+class TSXDetector extends BaseDetector_js_1.BaseDetector {
+    // #region Fields
+    _marker;
+    // #endregion
+    // #region Constructor
+    /**
+     * Constructs a new instance of the `TSXDetector` class.
+     *
+     * @public
+     * @param logger - The logger.
+     * @param options - Configuration options for the detector.
+     */
+    constructor(logger, options) {
+        super(logger, options);
+        this._marker = options?.marker ?? /t|translate/;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Provides the regex patterns for extracting strings from TSX content.
+     *
+     * @protected
+     * @returns A RegExp for extracting strings.
+     */
+    getRegexes() {
+        const functionPattern = this._marker instanceof RegExp
+            ? this._marker.source
+            : (0, Utils_js_1.escapeRegExp)(this._marker);
+        return [
+            new RegExp(`(?<function>${functionPattern})` + // Function name
+                '\\(' + // Opening parenthesis
+                '\\s*' + // Optional whitespace
+                "(?<quote>['\"`])" + // Quote type
+                '(?<value>(?:\\\\.|[^\\\\])*?)' + // Content inside quotes
+                '\\k<quote>' + // Match the same quote type
+                '(?:,\\s*(?<context>\\{.*?\\}))?' + // Optional context object
+                '\\)', // Closing parenthesis
+            'gs')
+        ];
+    }
+    /**
+     * Pre-processes content before applying regex matching.
+     *
+     * @protected
+     * @param content - The raw content.
+     * @returns The processed content.
+     */
+    preProcessContent(content) {
+        this.log('Pre-processing TSX content.');
+        return content.replace(/\r?\n/g, ' '); // Normalize multiline strings
+    }
+    /**
+     * Post-processes results after regex matching.
+     *
+     * @protected
+     * @param results - The raw results from regex matching.
+     * @returns The processed results.
+     */
+    postProcessResults(results) {
+        this.log(`Post-processing TSX results: ${JSON.stringify(results)}`);
+        return results
+            .filter((result) => result.match.value !== undefined)
+            .map((result) => {
+            if (result.match.value !== undefined) {
+                result.match.value = result.match.value
+                    .replace(/\\"/g, '"') // Unescape double quotes
+                    .replace(/\\'/g, "'") // Unescape single quotes
+                    .trim(); // Remove extra whitespace
+            }
+            return result;
+        });
+    }
+}
+exports.TSXDetector = TSXDetector;
+//# sourceMappingURL=TSXDetector.js.map

package/Detectors/TSXDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TSXDetector.js","sourceRoot":"","sources":["../../src/Detectors/TSXDetector.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;AAGlB,iEAAsF;AAEtF,yCAA0C;AA0B1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,WAAY,SAAQ,8BAAY;IAEzC,iBAAiB;IAEA,OAAO,CAAkB;IAE1C,aAAa;IAEb,sBAAsB;IAEtB;;;;;;OAMG;IACH,YAAmB,MAAe,EAAE,OAA6B;QAC7D,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEvB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,IAAI,aAAa,CAAC;IACpD,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;;;;OAKG;IACgB,UAAU;QACzB,MAAM,eAAe,GACjB,IAAI,CAAC,OAAO,YAAY,MAAM;YAC1B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;YACrB,CAAC,CAAC,IAAA,uBAAY,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAErC,OAAO;YACH,IAAI,MAAM,CACN,eAAe,eAAe,GAAG,GAAG,gBAAgB;gBACpD,KAAK,GAAG,sBAAsB;gBAC9B,MAAM,GAAG,sBAAsB;gBAC/B,kBAAkB,GAAG,aAAa;gBAClC,+BAA+B,GAAG,wBAAwB;gBAC1D,YAAY,GAAG,4BAA4B;gBAC3C,iCAAiC,GAAG,0BAA0B;gBAC9D,KAAK,EAAE,sBAAsB;YAC7B,IAAI,CACP;SACJ,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACgB,iBAAiB,CAAC,OAAe;QAChD,IAAI,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,8BAA8B;IACzE,CAAC;IAED;;;;;;OAMG;IACgB,kBAAkB,CAAC,OAA+B;QACjE,IAAI,CAAC,GAAG,CAAC,gCAAgC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEpE,OAAO,OAAO;aACT,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC;aACpD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACZ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK;qBAClC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAG,yBAAyB;qBAChD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAG,yBAAyB;qBAChD,IAAI,EAAE,CAAC,CAAgB,0BAA0B;YAC1D,CAAC;YAED,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACX,CAAC;CAIJ;AA5FD,kCA4FC"}

package/Detectors/TypeScriptDetector.d.ts

@@ -0,0 +1,76 @@
+import type { ILogger } from '@breadstone-infrastructure/utilities';
+import { BaseDetector, type IBaseDetectorOptions } from './Abstracts/BaseDetector.js';
+import type { IDetectorResult } from './Interfaces/IDetector.js';
+/**
+ * Options for configuring the `TypeScriptDetector`.
+ *
+ * @public
+ */
+export interface ITypeScriptDetectorOptions extends IBaseDetectorOptions {
+    /**
+     * The function name or regex used for translation (default: `/t|translate/`).
+     */
+    marker?: string | RegExp;
+    /**
+     * The resource key check configuration for the detector.
+     */
+    resourceKey?: {
+        prefix?: string;
+        suffix?: string;
+    };
+}
+/**
+ * Detector for extracting translatable strings from TypeScript files.
+ *
+ * This detector supports the following scenarios:
+ * - **Simple Function Calls**:
+ *   ```typescript
+ *   t("This is a translatable string");
+ *   translate("Another translatable string");
+ *   ```
+ * - **With Context**:
+ *   ```typescript
+ *   t("This is translatable", { context: "example" });
+ *   ```
+ * - **Template Literals**:
+ *   ```typescript
+ *   t(`This is a template literal`);
+ *   ```
+ *
+ * @public
+ */
+export declare class TypeScriptDetector extends BaseDetector {
+    private readonly _marker;
+    /**
+     * Constructs a new instance of the `TypeScriptDetector` class.
+     *
+     * @public
+     * @param logger - The logger instance.
+     * @param options - Configuration options for the detector.
+     */
+    constructor(logger: ILogger, options?: ITypeScriptDetectorOptions);
+    /**
+     * Provides the regex patterns for extracting strings from TypeScript content.
+     *
+     * @protected
+     * @returns A RegExp for extracting strings.
+     */
+    protected getRegexes(): Array<RegExp>;
+    /**
+     * Pre-processes content before applying regex matching.
+     *
+     * @protected
+     * @param content - The raw content.
+     * @returns The processed content.
+     */
+    protected preProcessContent(content: string): string;
+    /**
+     * Post-processes results after regex matching.
+     *
+     * @protected
+     * @param results - The raw results from regex matching.
+     * @returns The processed results.
+     */
+    protected postProcessResults(results: Array<IDetectorResult>): Array<IDetectorResult>;
+}
+//# sourceMappingURL=TypeScriptDetector.d.ts.map

package/Detectors/TypeScriptDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeScriptDetector.d.ts","sourceRoot":"","sources":["../../src/Detectors/TypeScriptDetector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjE;;;;GAIG;AACH,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IAEpE;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CAEL;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAIhD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAM1C;;;;;;OAMG;gBACgB,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,0BAA0B;IAUxE;;;;;OAKG;cACgB,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;IAsB9C;;;;;;OAMG;cACgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAK7D;;;;;;OAMG;cACgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;CAmBjG"}

package/Detectors/TypeScriptDetector.js

@@ -0,0 +1,102 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeScriptDetector = void 0;
+const BaseDetector_js_1 = require("./Abstracts/BaseDetector.js");
+const Utils_js_1 = require("./Utils.js");
+/**
+ * Detector for extracting translatable strings from TypeScript files.
+ *
+ * This detector supports the following scenarios:
+ * - **Simple Function Calls**:
+ *   ```typescript
+ *   t("This is a translatable string");
+ *   translate("Another translatable string");
+ *   ```
+ * - **With Context**:
+ *   ```typescript
+ *   t("This is translatable", { context: "example" });
+ *   ```
+ * - **Template Literals**:
+ *   ```typescript
+ *   t(`This is a template literal`);
+ *   ```
+ *
+ * @public
+ */
+class TypeScriptDetector extends BaseDetector_js_1.BaseDetector {
+    // #region Fields
+    _marker;
+    // #endregion
+    // #region Constructor
+    /**
+     * Constructs a new instance of the `TypeScriptDetector` class.
+     *
+     * @public
+     * @param logger - The logger instance.
+     * @param options - Configuration options for the detector.
+     */
+    constructor(logger, options) {
+        super(logger, options);
+        this._marker = options?.marker ?? /t|translate/;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Provides the regex patterns for extracting strings from TypeScript content.
+     *
+     * @protected
+     * @returns A RegExp for extracting strings.
+     */
+    getRegexes() {
+        const functionPattern = this._marker instanceof RegExp
+            ? this._marker.source
+            : (0, Utils_js_1.escapeRegExp)(this._marker);
+        return [
+            new RegExp('(?<!\\w)' + // Ensure the match is not preceded by any word character
+                `(?<function>${functionPattern})` + // Match function name (e.g., t or translate)
+                '\\(' + // Match opening parenthesis
+                '\\s*' + // Optional whitespace
+                "(?<quote>['\"`])" + // Match opening quote type
+                '(?<value>[^\\1]*?)' + // Match string value (non-greedy)
+                '\\k<quote>' + // Match closing quote of the same type
+                '\\s*(?:,\\s*.*?)?' + // Allow optional additional arguments
+                '\\)', // Match closing parenthesis
+            'g')
+        ];
+    }
+    /**
+     * Pre-processes content before applying regex matching.
+     *
+     * @protected
+     * @param content - The raw content.
+     * @returns The processed content.
+     */
+    preProcessContent(content) {
+        this.log('Pre-processing TypeScript content.');
+        return content.replace(/\r?\n/g, ' '); // Normalize multiline strings
+    }
+    /**
+     * Post-processes results after regex matching.
+     *
+     * @protected
+     * @param results - The raw results from regex matching.
+     * @returns The processed results.
+     */
+    postProcessResults(results) {
+        this.log(`Post-processing results: ${JSON.stringify(results)}`);
+        return results
+            .filter((result) => result.match.value !== undefined)
+            .map((result) => {
+            if (result.match.value !== undefined) {
+                result.match.value = result.match.value
+                    .replace(/\\"/g, '"') // Unescape double quotes
+                    .replace(/\\'/g, "'") // Unescape single quotes
+                    .trim(); // Remove extra whitespace
+            }
+            return result;
+        });
+    }
+}
+exports.TypeScriptDetector = TypeScriptDetector;
+//# sourceMappingURL=TypeScriptDetector.js.map

package/Detectors/TypeScriptDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeScriptDetector.js","sourceRoot":"","sources":["../../src/Detectors/TypeScriptDetector.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;AAGlB,iEAAsF;AAEtF,yCAA0C;AA0B1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,kBAAmB,SAAQ,8BAAY;IAEhD,iBAAiB;IAEA,OAAO,CAAkB;IAE1C,aAAa;IAEb,sBAAsB;IAEtB;;;;;;OAMG;IACH,YAAmB,MAAe,EAAE,OAAoC;QACpE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEvB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,IAAI,aAAa,CAAC;IACpD,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;;;;OAKG;IACgB,UAAU;QACzB,MAAM,eAAe,GACjB,IAAI,CAAC,OAAO,YAAY,MAAM;YAC1B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;YACrB,CAAC,CAAC,IAAA,uBAAY,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAErC,OAAO;YACH,IAAI,MAAM,CACN,UAAU,GAAG,yDAAyD;gBACtE,eAAe,eAAe,GAAG,GAAG,6CAA6C;gBACjF,KAAK,GAAG,4BAA4B;gBACpC,MAAM,GAAG,sBAAsB;gBAC/B,kBAAkB,GAAG,2BAA2B;gBAChD,oBAAoB,GAAG,kCAAkC;gBACzD,YAAY,GAAG,uCAAuC;gBACtD,mBAAmB,GAAG,sCAAsC;gBAC5D,KAAK,EAAE,4BAA4B;YACnC,GAAG,CACN;SACJ,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACgB,iBAAiB,CAAC,OAAe;QAChD,IAAI,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,8BAA8B;IACzE,CAAC;IAED;;;;;;OAMG;IACgB,kBAAkB,CAAC,OAA+B;QACjE,IAAI,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEhE,OAAO,OAAO;aACT,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC;aACpD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACZ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK;qBAClC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAG,yBAAyB;qBAChD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAG,yBAAyB;qBAChD,IAAI,EAAE,CAAC,CAAgB,0BAA0B;YAC1D,CAAC;YAED,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACX,CAAC;CAIJ;AA7FD,gDA6FC"}