ref: Refactor for browser compatibility

.c8rc.json

@@ -1,7 +1,7 @@
 {
   "all": true,
   "include": ["dist/**/*.js"],
-  "exclude": ["dist/types/generated/**/*.js", "dist/**/*.d.ts"],
+  "exclude": ["dist/types/generated/**/*.js", "dist/**/*.d.ts", "dist/**/*.cjs"],
   "reporter": ["text", "lcov", "json", "json-summary"],
   "report-dir": "coverage",
   "check-coverage": false

.gitignore

@@ -1,3 +1,5 @@
+settings.local.json
+
 # Logs
 logs
 *.log

dist/detectTests.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Browser-compatible test detection utilities.
+ * This module provides pure parsing functionality that works with strings/objects,
+ * without dependencies on Node.js file system or path modules.
+ */
+export interface FileType {
+    name?: string;
+    extensions: string[];
+    inlineStatements?: {
+        testStart?: string[];
+        testEnd?: string[];
+        ignoreStart?: string[];
+        ignoreEnd?: string[];
+        step?: string[];
+    };
+    markup?: Array<{
+        regex: string[];
+        actions?: (string | Record<string, any>)[];
+        batchMatches?: boolean;
+    }>;
+    runShell?: Record<string, any>;
+}
+export interface DetectTestsConfig {
+    detectSteps?: boolean;
+    origin?: string;
+    logLevel?: string;
+    _herettoPathMapping?: Record<string, string>;
+}
+export interface DetectedTest {
+    testId?: string;
+    detectSteps?: boolean;
+    steps: Array<Record<string, any>>;
+    [key: string]: any;
+}
+export interface DetectTestsInput {
+    content: string;
+    filePath: string;
+    fileType: FileType;
+    config?: DetectTestsConfig;
+}
+/**
+ * Browser-compatible test detection function.
+ * Detects tests from content string using specified file type configuration.
+ *
+ * This is the main entry point for test detection in Common.
+ * It works with content strings rather than file paths, making it browser-compatible.
+ *
+ * @param input - Detection input
+ * @param input.content - Content string to parse for tests
+ * @param input.filePath - File path (for metadata only, not file I/O)
+ * @param input.fileType - File type configuration with parsing rules
+ * @param input.config - Optional configuration
+ * @returns Array of detected tests
+ *
+ * @example
+ * ```typescript
+ * const tests = await detectTests({
+ *   content: markdownContent,
+ *   filePath: 'docs/test.md',
+ *   fileType: { extensions: ['md'], markup: [...] },
+ *   config: { detectSteps: true }
+ * });
+ * ```
+ */
+export declare function detectTests(input: DetectTestsInput): Promise<DetectedTest[]>;
+/**
+ * Parses XML-style attributes to an object.
+ * Example: 'wait=500' becomes { wait: 500 }
+ * Example: 'testId="myTestId" detectSteps=false' becomes { testId: "myTestId", detectSteps: false }
+ * Example: 'httpRequest.url="https://example.com"' becomes { httpRequest: { url: "https://example.com" } }
+ */
+export declare function parseXmlAttributes({ stringifiedObject }: {
+    stringifiedObject: string;
+}): Record<string, any> | null;
+/**
+ * Parses a JSON or YAML object from a string.
+ */
+export declare function parseObject({ stringifiedObject }: {
+    stringifiedObject: string;
+}): Record<string, any> | null;
+/**
+ * Replaces numeric variables ($0, $1, etc.) in strings and objects with provided values.
+ */
+export declare function replaceNumericVariables(stringOrObjectSource: string | Record<string, any>, values: Record<string, any>): string | Record<string, any> | null;
+/**
+ * Parses raw test content into an array of structured test objects.
+ * This is a browser-compatible function that works with strings and doesn't require file system access.
+ *
+ * @param options - Options for parsing
+ * @param options.config - Test configuration object
+ * @param options.content - Raw file content as a string
+ * @param options.filePath - Path to the file being parsed (for metadata, not file I/O)
+ * @param options.fileType - File type definition containing parsing rules
+ * @returns Array of parsed and validated test objects
+ */
+export declare function parseContent({ config, content, filePath, fileType, }: {
+    config: DetectTestsConfig;
+    content: string;
+    filePath: string;
+    fileType: FileType;
+}): Promise<DetectedTest[]>;
+/**
+ * Simple browser-compatible logging function.
+ */
+export declare function log(config: DetectTestsConfig, level: string, message: any): void;
+//# sourceMappingURL=detectTests.d.ts.map