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

package/Detectors/Abstracts/BaseDetector.d.ts

@@ -0,0 +1,81 @@
+import { type IDetectOptions, type IDetector, type IDetectorEventMap, type IDetectorResult } from '../Interfaces/IDetector.js';
+import { EventEmitter } from 'events';
+import { type ILogger } from '@breadstone-infrastructure/utilities';
+/**
+ * Options for configuring the `BaseDetector`.
+ *
+ * @public
+ */
+export interface IBaseDetectorOptions extends IDetectOptions {
+    /**
+     * Enable debug logging (default: `false`).
+     * @default false
+     */
+    debug?: boolean;
+}
+export declare const DEFAULT_DETECTOR_OPTIONS: Required<IBaseDetectorOptions>;
+/**
+ * Abstract base detector providing common logic for content parsing.
+ *
+ * @public
+ */
+export declare abstract class BaseDetector extends EventEmitter<IDetectorEventMap> implements IDetector {
+    private readonly _debug;
+    private readonly _resourceKey;
+    private readonly _logger;
+    /**
+     * Constructs a new instance of the `BaseDetector` class.
+     *
+     * @public
+     * @param logger - The logger.
+     * @param options - The optional configuration for the detector.
+     */
+    protected constructor(logger: ILogger, options?: IBaseDetectorOptions);
+    /**
+     * Indicates whether debug logging is enabled.
+     *
+     * @public
+     */
+    get debug(): boolean;
+    /**
+     * Detects content and extracts translatable strings.
+     *
+     * @public
+     * @param content - The content to detect.
+     * @param options - The optional detect options.
+     * @returns An array of extracted results.
+     */
+    detect(content: string, options?: IDetectOptions): Array<IDetectorResult>;
+    /**
+     * Abstract method for retrieving the regex patterns for string extraction.
+     *
+     * @protected
+     * @abstract
+     * @returns An array of RegExps for extracting strings.
+     */
+    protected abstract 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>;
+    /**
+     * Logs a message if debugging is enabled.
+     *
+     * @protected
+     * @param message - The message to log.
+     */
+    protected log(message: string): void;
+}
+//# sourceMappingURL=BaseDetector.d.ts.map

package/Detectors/Abstracts/BaseDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseDetector.d.ts","sourceRoot":"","sources":["../../../src/Detectors/Abstracts/BaseDetector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAS,MAAM,4BAA4B,CAAC;AACtI,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,KAAK,OAAO,EAAK,MAAM,sCAAsC,CAAC;AAIvE;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAIxD;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CAInB;AAED,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,oBAAoB,CAMnE,CAAC;AAEF;;;;GAIG;AACH,8BAAsB,YAAa,SAAQ,YAAY,CAAC,iBAAiB,CAAE,YAAW,SAAS;IAI3F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAG3B;IACF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAMlC;;;;;;OAMG;IACH,SAAS,aAAa,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAoBrE;;;;OAIG;IACH,IAAW,KAAK,IAAI,OAAO,CAE1B;IAMD;;;;;;;OAOG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,KAAK,CAAC,eAAe,CAAC;IAwChF;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;IAE9C;;;;;;OAMG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIpD;;;;;;OAMG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;IAIrF;;;;;OAKG;IACH,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAQvC"}

package/Detectors/Abstracts/BaseDetector.js

@@ -0,0 +1,137 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseDetector = exports.DEFAULT_DETECTOR_OPTIONS = void 0;
+const IDetector_js_1 = require("../Interfaces/IDetector.js");
+const events_1 = require("events");
+const Utils_js_1 = require("../Utils.js");
+const utilities_1 = require("@breadstone-infrastructure/utilities");
+exports.DEFAULT_DETECTOR_OPTIONS = {
+    debug: false,
+    resourceKey: {
+        prefix: '',
+        suffix: ''
+    }
+};
+/**
+ * Abstract base detector providing common logic for content parsing.
+ *
+ * @public
+ */
+class BaseDetector extends events_1.EventEmitter {
+    // #region Fields
+    _debug;
+    _resourceKey;
+    _logger;
+    // #endregion
+    // #region Constructor
+    /**
+     * Constructs a new instance of the `BaseDetector` class.
+     *
+     * @public
+     * @param logger - The logger.
+     * @param options - The optional configuration for the detector.
+     */
+    constructor(logger, options) {
+        super({ captureRejections: true });
+        options = {
+            ...exports.DEFAULT_DETECTOR_OPTIONS,
+            ...options
+        };
+        this._logger = logger;
+        this._debug = options.debug ?? exports.DEFAULT_DETECTOR_OPTIONS.debug;
+        this._resourceKey = {
+            prefix: options.resourceKey?.prefix ?? exports.DEFAULT_DETECTOR_OPTIONS.resourceKey.prefix ?? '',
+            suffix: options.resourceKey?.suffix ?? exports.DEFAULT_DETECTOR_OPTIONS.resourceKey.suffix ?? ''
+        };
+    }
+    // #endregion
+    // #region Properties
+    /**
+     * Indicates whether debug logging is enabled.
+     *
+     * @public
+     */
+    get debug() {
+        return this._debug;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Detects content and extracts translatable strings.
+     *
+     * @public
+     * @param content - The content to detect.
+     * @param options - The optional detect options.
+     * @returns An array of extracted results.
+     */
+    detect(content, options) {
+        const prefix = options?.resourceKey?.prefix ?? this._resourceKey.prefix;
+        const suffix = options?.resourceKey?.suffix ?? this._resourceKey.suffix;
+        try {
+            const regexes = this.getRegexes();
+            const changes = [];
+            const lines = content.split('\n');
+            // const preparedContent = this.preProcessContent(content);
+            lines.forEach((line, lineNumber) => {
+                for (const regex of regexes) {
+                    let match = null;
+                    while ((match = regex.exec(line)) !== null) {
+                        const candidate = match.groups?.value;
+                        if (candidate) {
+                            const change = {
+                                lineNumber: lineNumber + 1,
+                                columnNumber: match.index,
+                                match: match.groups ?? IDetector_js_1.Match.EMPTY,
+                                context: line.trim(),
+                                isStatic: !(0, Utils_js_1.isResourceKey)(candidate, prefix, suffix)
+                            };
+                            changes.push(change);
+                            this.emit('detected', change);
+                        }
+                    }
+                }
+            });
+            this.log(`Found matches: ${JSON.stringify(changes)}`);
+            return this.postProcessResults(changes);
+        }
+        catch (error) {
+            this.emit('failed', error);
+            this.log(`Error during parsing: ${error.message}`);
+            return [];
+        }
+    }
+    /**
+     * Pre-processes content before applying regex matching.
+     *
+     * @protected
+     * @param content - The raw content.
+     * @returns The processed content.
+     */
+    preProcessContent(content) {
+        return content;
+    }
+    /**
+     * Post-processes results after regex matching.
+     *
+     * @protected
+     * @param results - The raw results from regex matching.
+     * @returns The processed results.
+     */
+    postProcessResults(results) {
+        return results;
+    }
+    /**
+     * Logs a message if debugging is enabled.
+     *
+     * @protected
+     * @param message - The message to log.
+     */
+    log(message) {
+        if (this.debug) {
+            this._logger.debug((0, utilities_1.t) `[Detector]: ${message}`);
+        }
+    }
+}
+exports.BaseDetector = BaseDetector;
+//# sourceMappingURL=BaseDetector.js.map

package/Detectors/Abstracts/BaseDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseDetector.js","sourceRoot":"","sources":["../../../src/Detectors/Abstracts/BaseDetector.ts"],"names":[],"mappings":"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"}

package/Detectors/AngularHTMLDetector.d.ts

@@ -0,0 +1,94 @@
+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 `AngularHTMLDetector`.
+ *
+ * @public
+ */
+export interface IAngularHTMLDetectorOptions extends IBaseDetectorOptions {
+    /**
+     * The pipe name used for translation (default: `translate`).
+     */
+    marker?: string;
+}
+/**
+ * Detector for extracting translatable strings from Angular HTML files.
+ *
+ * This detector supports the following Angular-specific cases:
+ *
+ * - **Text Interpolation**:
+ *   Extracts strings inside `{{ ... }}` with the specified pipe.
+ *   ```html
+ *   <label>{{ 'This is a sentence' | translate }}</label>
+ *   ```
+ *
+ * - **Attribute Binding**:
+ *   Extracts strings in Angular attribute bindings.
+ *   ```html
+ *   <my-component [label]="'This is a label' | translate"></my-component>
+ *   ```
+ *
+ * - **Event Binding**:
+ *   Extracts strings from event bindings.
+ *   ```html
+ *   <button (click)="doSomething('This is a key' | translate)">Click Me</button>
+ *   ```
+ *
+ * - **Structural Directives**:
+ *   Extracts strings in Angular structural directives like `*ngIf`.
+ *   ```html
+ *   <div *ngIf="'This is a condition' | translate as conditionText">
+ *       {{ conditionText }}
+ *   </div>
+ *   ```
+ *
+ * - **Content Projection**:
+ *   Extracts strings inside `<ng-content>` blocks.
+ *   ```html
+ *   <ng-content select="[label]">{{ 'Default translation' | translate }}</ng-content>
+ *   ```
+ *
+ * - **JSON-like Configurations**:
+ *   Extracts strings inside JSON-like structures.
+ *   ```html
+ *   <div [config]="{ label: 'This is a translatable label' | translate }"></div>
+ *   ```
+ *
+ * @public
+ */
+export declare class AngularHTMLDetector extends BaseDetector {
+    private readonly _marker;
+    /**
+     * Constructs a new instance of the `AngularHTMLDetector` class.
+     *
+     * @public
+     * @param logger - The logger.
+     * @param options - Configuration options for the detector.
+     */
+    constructor(logger: ILogger, options?: IAngularHTMLDetectorOptions);
+    /**
+     * Provides the regex patterns for extracting strings from Angular HTML.
+     *
+     * @protected
+     * @returns An array of regex patterns.
+     */
+    protected getRegexes(): Array<RegExp>;
+    /**
+     * Pre-processes the Angular HTML content to normalize it.
+     *
+     * @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=AngularHTMLDetector.d.ts.map

package/Detectors/AngularHTMLDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AngularHTMLDetector.d.ts","sourceRoot":"","sources":["../../src/Detectors/AngularHTMLDetector.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,2BAA4B,SAAQ,oBAAoB;IAErE;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAEnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IAIjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAMjC;;;;;;OAMG;gBACgB,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,2BAA2B;IASzE;;;;;OAKG;cACgB,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;IAmB9C;;;;;;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;CAejG"}

package/Detectors/AngularHTMLDetector.js

@@ -0,0 +1,123 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AngularHTMLDetector = void 0;
+const BaseDetector_js_1 = require("./Abstracts/BaseDetector.js");
+const Utils_js_1 = require("./Utils.js");
+/**
+ * Detector for extracting translatable strings from Angular HTML files.
+ *
+ * This detector supports the following Angular-specific cases:
+ *
+ * - **Text Interpolation**:
+ *   Extracts strings inside `{{ ... }}` with the specified pipe.
+ *   ```html
+ *   <label>{{ 'This is a sentence' | translate }}</label>
+ *   ```
+ *
+ * - **Attribute Binding**:
+ *   Extracts strings in Angular attribute bindings.
+ *   ```html
+ *   <my-component [label]="'This is a label' | translate"></my-component>
+ *   ```
+ *
+ * - **Event Binding**:
+ *   Extracts strings from event bindings.
+ *   ```html
+ *   <button (click)="doSomething('This is a key' | translate)">Click Me</button>
+ *   ```
+ *
+ * - **Structural Directives**:
+ *   Extracts strings in Angular structural directives like `*ngIf`.
+ *   ```html
+ *   <div *ngIf="'This is a condition' | translate as conditionText">
+ *       {{ conditionText }}
+ *   </div>
+ *   ```
+ *
+ * - **Content Projection**:
+ *   Extracts strings inside `<ng-content>` blocks.
+ *   ```html
+ *   <ng-content select="[label]">{{ 'Default translation' | translate }}</ng-content>
+ *   ```
+ *
+ * - **JSON-like Configurations**:
+ *   Extracts strings inside JSON-like structures.
+ *   ```html
+ *   <div [config]="{ label: 'This is a translatable label' | translate }"></div>
+ *   ```
+ *
+ * @public
+ */
+class AngularHTMLDetector extends BaseDetector_js_1.BaseDetector {
+    // #region Fields
+    _marker;
+    // #endregion
+    // #region Constructor
+    /**
+     * Constructs a new instance of the `AngularHTMLDetector` class.
+     *
+     * @public
+     * @param logger - The logger.
+     * @param options - Configuration options for the detector.
+     */
+    constructor(logger, options) {
+        super(logger, options);
+        this._marker = options?.marker ?? 'translate';
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Provides the regex patterns for extracting strings from Angular HTML.
+     *
+     * @protected
+     * @returns An array of regex patterns.
+     */
+    getRegexes() {
+        const marker = (0, Utils_js_1.escapeRegExp)(this._marker);
+        return [
+            // Text Interpolation
+            new RegExp(`\\{\\{\\s*['"](?<value>.+?)['"]\\s*\\|\\s*${marker}\\s*\\}\\}`, 'g'),
+            // Attribute Binding
+            new RegExp(`\\[.*?\\]\\s*=\\s*"'(?<value>[^']*?)'\\s*\\|\\s*${marker}"`, 'g'),
+            // Event Binding
+            new RegExp(`\\(.*?\\)\\s*=\\s*".*?\\('(?<value>[^']*?)'\\s*\\|\\s*${marker}\\)"`, 'g'),
+            // Structural Directives
+            new RegExp(`\\*\\w+\\s*=\\s*"'(?<value>[^']*?)'\\s*\\|\\s*${marker}\\s+as\\s+\\w+"`, 'g'),
+            // JSON-like Configurations
+            new RegExp(`\\[.*?\\]\\s*=\\s*"\\{.*?:\\s*'(?<value>[^']*?)'\\s*\\|\\s*${marker}\\s*\\}"`, 'g'),
+            // Content Projection
+            new RegExp(`<ng-content.*?>\\s*['"](?<value>.+?)['"]\\s*\\|\\s*${marker}\\s*<\\/ng-content>`, 'g')
+        ];
+    }
+    /**
+     * Pre-processes the Angular HTML content to normalize it.
+     *
+     * @protected
+     * @param content - The raw content.
+     * @returns The processed content.
+     */
+    preProcessContent(content) {
+        this.log('Pre-processing Angular HTML content.');
+        return content.replace(/\r?\n/g, ' ').trim();
+    }
+    /**
+     * 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)}`);
+        // Remove empty matches
+        return results.filter((result) => {
+            if (result.match.value !== undefined) {
+                return result.match.value.trim().length > 0;
+            }
+            return false;
+        });
+    }
+}
+exports.AngularHTMLDetector = AngularHTMLDetector;
+//# sourceMappingURL=AngularHTMLDetector.js.map

package/Detectors/AngularHTMLDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AngularHTMLDetector.js","sourceRoot":"","sources":["../../src/Detectors/AngularHTMLDetector.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;AAGlB,iEAAsF;AAEtF,yCAA0C;AAkB1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAa,mBAAoB,SAAQ,8BAAY;IAEjD,iBAAiB;IAEA,OAAO,CAAS;IAEjC,aAAa;IAEb,sBAAsB;IAEtB;;;;;;OAMG;IACH,YAAmB,MAAe,EAAE,OAAqC;QACrE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,IAAI,WAAW,CAAC;IAClD,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;;;;OAKG;IACgB,UAAU;QACzB,MAAM,MAAM,GAAG,IAAA,uBAAY,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE1C,OAAO;YACH,qBAAqB;YACrB,IAAI,MAAM,CAAC,6CAA6C,MAAM,YAAY,EAAE,GAAG,CAAC;YAChF,oBAAoB;YACpB,IAAI,MAAM,CAAC,mDAAmD,MAAM,GAAG,EAAE,GAAG,CAAC;YAC7E,gBAAgB;YAChB,IAAI,MAAM,CAAC,yDAAyD,MAAM,MAAM,EAAE,GAAG,CAAC;YACtF,wBAAwB;YACxB,IAAI,MAAM,CAAC,iDAAiD,MAAM,iBAAiB,EAAE,GAAG,CAAC;YACzF,2BAA2B;YAC3B,IAAI,MAAM,CAAC,8DAA8D,MAAM,UAAU,EAAE,GAAG,CAAC;YAC/F,qBAAqB;YACrB,IAAI,MAAM,CAAC,sDAAsD,MAAM,qBAAqB,EAAE,GAAG,CAAC;SACrG,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACgB,iBAAiB,CAAC,OAAe;QAChD,IAAI,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACjD,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;IAED;;;;;;OAMG;IACgB,kBAAkB,CAAC,OAA+B;QACjE,IAAI,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEhE,uBAAuB;QACvB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;YAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACnC,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YAChD,CAAC;YAED,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;IACP,CAAC;CAIJ;AArFD,kDAqFC"}

package/Detectors/Interfaces/IDetector.d.ts

@@ -0,0 +1,73 @@
+import type { EventEmitter } from 'events';
+/**
+ * Represents a record type with a `value` property.
+ *
+ * @public
+ */
+export type Match = Record<string, string> & {
+    value?: string;
+};
+/**
+ * @public
+ */
+export declare namespace Match {
+    const EMPTY: Match;
+}
+/**
+ * Event map for the `IDetector`.
+ *
+ * @public
+ */
+export interface IDetectorEventMap {
+    detected: [change: IDetectorResult];
+    failed: [error: any];
+}
+/**
+ * Result of a detector extraction.
+ *
+ * @public
+ */
+export interface IDetectorResult {
+    isStatic: boolean;
+    lineNumber: number;
+    columnNumber: number;
+    match: Match;
+    context: string;
+}
+interface IDetectorResourceKeyOptions {
+    /**
+     * The prefix for resource keys.
+     *
+     * @default ''
+     */
+    prefix?: string;
+    /**
+     * The suffix for resource keys.
+     *
+     * @default ''
+     */
+    suffix?: string;
+}
+export interface IDetectOptions extends Record<string, unknown> {
+    /**
+     * The resource key check configuration for the detector.
+     */
+    resourceKey?: IDetectorResourceKeyOptions;
+}
+/**
+ * Interface for detectors that extract translatable strings from content.
+ *
+ * @public
+ */
+export interface IDetector extends Pick<EventEmitter<IDetectorEventMap>, 'on'> {
+    /**
+     * Detects content and extracts translatable strings.
+     *
+     * @param content - The content to detect.
+     * @param options - The optional detector options.
+     * @returns An array of extracted results.
+     */
+    detect(content: string, options?: IDetectOptions): Array<IDetectorResult>;
+}
+export {};
+//# sourceMappingURL=IDetector.d.ts.map

package/Detectors/Interfaces/IDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDetector.d.ts","sourceRoot":"","sources":["../../../src/Detectors/Interfaces/IDetector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAI3C;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE;;GAEG;AACH,yBAAiB,KAAK,CAAC;IACZ,MAAM,KAAK,EAAE,KAAU,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,2BAA2B;IAEjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI3D;;OAEG;IACH,WAAW,CAAC,EAAE,2BAA2B,CAAC;CAG7C;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC;IAI1E;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;CAI7E"}

package/Detectors/Interfaces/IDetector.js

@@ -0,0 +1,12 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Match = void 0;
+/**
+ * @public
+ */
+var Match;
+(function (Match) {
+    Match.EMPTY = {};
+})(Match || (exports.Match = Match = {}));
+//# sourceMappingURL=IDetector.js.map

package/Detectors/Interfaces/IDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDetector.js","sourceRoot":"","sources":["../../../src/Detectors/Interfaces/IDetector.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;AAalB;;GAEG;AACH,IAAiB,KAAK,CAErB;AAFD,WAAiB,KAAK;IACL,WAAK,GAAU,EAAE,CAAC;AACnC,CAAC,EAFgB,KAAK,qBAAL,KAAK,QAErB"}

package/Detectors/JSXDetector.d.ts

@@ -0,0 +1,69 @@
+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 `JSXDetector`.
+ *
+ * @public
+ */
+export interface IJSXDetectorOptions extends IBaseDetectorOptions {
+    /**
+     * The function name or regex used for translation (default: `/t|translate/`).
+     */
+    marker?: string | RegExp;
+}
+/**
+ * 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
+ */
+export declare class JSXDetector extends BaseDetector {
+    private readonly _marker;
+    /**
+     * Constructs a new instance of the `JSXDetector` class.
+     *
+     * @public
+     * @param logger - The logger.
+     * @param options - Configuration options for the detector.
+     */
+    constructor(logger: ILogger, options?: IJSXDetectorOptions);
+    /**
+     * Provides the regex patterns for extracting strings from JSX 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=JSXDetector.d.ts.map

package/Detectors/JSXDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSXDetector.d.ts","sourceRoot":"","sources":["../../src/Detectors/JSXDetector.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;CAE5B;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"}