@reverso/scanner 0.1.0

package/dist/schema/normalizer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Schema normalization utilities.
+ */
+import { type FieldSchema, type PageSchema, type ProjectSchema, type SectionSchema } from '@reverso/core';
+/**
+ * Normalize field paths to ensure consistency.
+ */
+export declare function normalizeFieldPath(path: string): string;
+/**
+ * Normalize all field paths in a list.
+ */
+export declare function normalizeFields(fields: FieldSchema[]): FieldSchema[];
+/**
+ * Sort fields within each section by path.
+ */
+export declare function sortSectionFields(section: SectionSchema): SectionSchema;
+/**
+ * Sort sections within a page by slug.
+ */
+export declare function sortPageSections(page: PageSchema): PageSchema;
+/**
+ * Sort pages within a schema by slug.
+ */
+export declare function sortSchemaPages(schema: ProjectSchema): ProjectSchema;
+/**
+ * Ensure all fields have labels (generate from path if missing).
+ */
+export declare function ensureLabels(fields: FieldSchema[]): FieldSchema[];
+/**
+ * Remove duplicate fields (same path), keeping the first occurrence.
+ */
+export declare function deduplicateFields(fields: FieldSchema[]): FieldSchema[];
+/**
+ * Merge fields with the same path (combine attributes).
+ */
+export declare function mergeFields(fields: FieldSchema[]): FieldSchema[];
+/**
+ * Reorder sections within a page according to a predefined order.
+ */
+export declare function reorderSections(page: PageSchema, order: string[]): PageSchema;
+/**
+ * Validate schema structure and return any issues.
+ */
+export declare function validateSchemaStructure(schema: ProjectSchema): string[];
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/schema/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../src/schema/normalizer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAInB,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAKpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAKvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAO7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAKpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAcjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAYtE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAsBhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAW7E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CA6CvE"}

package/dist/schema/normalizer.js

@@ -0,0 +1,165 @@
+/**
+ * Schema normalization utilities.
+ */
+import { formatLabel, parsePath, sortPaths, } from '@reverso/core';
+/**
+ * Normalize field paths to ensure consistency.
+ */
+export function normalizeFieldPath(path) {
+    // Trim whitespace
+    let normalized = path.trim();
+    // Convert to lowercase
+    normalized = normalized.toLowerCase();
+    // Replace spaces and special characters with underscores
+    normalized = normalized.replace(/[^a-z0-9.$_-]/g, '_');
+    // Remove consecutive dots or underscores
+    normalized = normalized.replace(/\.+/g, '.').replace(/_+/g, '_');
+    // Remove leading/trailing dots or underscores
+    normalized = normalized.replace(/^[._]+|[._]+$/g, '');
+    return normalized;
+}
+/**
+ * Normalize all field paths in a list.
+ */
+export function normalizeFields(fields) {
+    return fields.map((field) => ({
+        ...field,
+        path: normalizeFieldPath(field.path),
+    }));
+}
+/**
+ * Sort fields within each section by path.
+ */
+export function sortSectionFields(section) {
+    return {
+        ...section,
+        fields: [...section.fields].sort((a, b) => a.path.localeCompare(b.path)),
+    };
+}
+/**
+ * Sort sections within a page by slug.
+ */
+export function sortPageSections(page) {
+    return {
+        ...page,
+        sections: [...page.sections]
+            .map(sortSectionFields)
+            .sort((a, b) => a.slug.localeCompare(b.slug)),
+    };
+}
+/**
+ * Sort pages within a schema by slug.
+ */
+export function sortSchemaPages(schema) {
+    return {
+        ...schema,
+        pages: [...schema.pages].map(sortPageSections).sort((a, b) => a.slug.localeCompare(b.slug)),
+    };
+}
+/**
+ * Ensure all fields have labels (generate from path if missing).
+ */
+export function ensureLabels(fields) {
+    return fields.map((field) => {
+        if (field.label) {
+            return field;
+        }
+        const parsed = parsePath(field.path);
+        const fieldName = parsed.repeaterField ?? parsed.field;
+        return {
+            ...field,
+            label: formatLabel(fieldName),
+        };
+    });
+}
+/**
+ * Remove duplicate fields (same path), keeping the first occurrence.
+ */
+export function deduplicateFields(fields) {
+    const seen = new Set();
+    const unique = [];
+    for (const field of fields) {
+        if (!seen.has(field.path)) {
+            seen.add(field.path);
+            unique.push(field);
+        }
+    }
+    return unique;
+}
+/**
+ * Merge fields with the same path (combine attributes).
+ */
+export function mergeFields(fields) {
+    const merged = new Map();
+    for (const field of fields) {
+        const existing = merged.get(field.path);
+        if (!existing) {
+            merged.set(field.path, { ...field });
+        }
+        else {
+            // Merge attributes, preferring new values over existing
+            merged.set(field.path, {
+                ...existing,
+                ...field,
+                // Keep the original file/line info
+                file: existing.file,
+                line: existing.line,
+                column: existing.column,
+            });
+        }
+    }
+    return Array.from(merged.values());
+}
+/**
+ * Reorder sections within a page according to a predefined order.
+ */
+export function reorderSections(page, order) {
+    const orderMap = new Map(order.map((slug, index) => [slug, index]));
+    return {
+        ...page,
+        sections: [...page.sections].sort((a, b) => {
+            const orderA = orderMap.get(a.slug) ?? Number.MAX_SAFE_INTEGER;
+            const orderB = orderMap.get(b.slug) ?? Number.MAX_SAFE_INTEGER;
+            return orderA - orderB;
+        }),
+    };
+}
+/**
+ * Validate schema structure and return any issues.
+ */
+export function validateSchemaStructure(schema) {
+    const issues = [];
+    for (const page of schema.pages) {
+        if (!page.slug) {
+            issues.push('Page missing slug');
+        }
+        for (const section of page.sections) {
+            if (!section.slug) {
+                issues.push(`Section in page "${page.slug}" missing slug`);
+            }
+            for (const field of section.fields) {
+                if (!field.path) {
+                    issues.push(`Field in "${page.slug}.${section.slug}" missing path`);
+                }
+                if (!field.type) {
+                    issues.push(`Field "${field.path}" missing type`);
+                }
+                // Validate path structure
+                try {
+                    const parsed = parsePath(field.path);
+                    if (parsed.page !== page.slug) {
+                        issues.push(`Field "${field.path}" has page "${parsed.page}" but is in page "${page.slug}"`);
+                    }
+                    if (parsed.section !== section.slug) {
+                        issues.push(`Field "${field.path}" has section "${parsed.section}" but is in section "${section.slug}"`);
+                    }
+                }
+                catch (error) {
+                    issues.push(`Field "${field.path}" has invalid path: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/schema/normalizer.js.map

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

package/dist/watch/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Watch exports for @reverso/scanner
+ */
+export { FileWatcher, createWatcher, type WatchEventType, type WatchEvent, type WatchEventHandler, type WatcherOptions, } from './watcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/watch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watch/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC"}

package/dist/watch/index.js

@@ -0,0 +1,5 @@
+/**
+ * Watch exports for @reverso/scanner
+ */
+export { FileWatcher, createWatcher, } from './watcher.js';
+//# sourceMappingURL=index.js.map

package/dist/watch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/watch/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,GAKd,MAAM,cAAc,CAAC"}

package/dist/watch/watcher.d.ts

@@ -0,0 +1,82 @@
+/**
+ * File watcher for detecting changes in source files.
+ */
+/**
+ * Events emitted by the watcher.
+ */
+export type WatchEventType = 'add' | 'change' | 'unlink';
+/**
+ * Watch event data.
+ */
+export interface WatchEvent {
+    type: WatchEventType;
+    path: string;
+    timestamp: number;
+}
+/**
+ * Watch event handler.
+ */
+export type WatchEventHandler = (event: WatchEvent) => void | Promise<void>;
+/**
+ * Options for the file watcher.
+ */
+export interface WatcherOptions {
+    /** Directory to watch */
+    srcDir: string;
+    /** Glob patterns to include */
+    include?: string[];
+    /** Glob patterns to exclude */
+    exclude?: string[];
+    /** Debounce delay in milliseconds */
+    debounce?: number;
+    /** Event handler */
+    onEvent?: WatchEventHandler;
+    /** Error handler */
+    onError?: (error: Error) => void;
+    /** Ready handler */
+    onReady?: () => void;
+}
+/**
+ * File watcher class.
+ */
+export declare class FileWatcher {
+    private watcher;
+    private options;
+    private debounceTimers;
+    private debounceDelay;
+    private isReady;
+    constructor(options: WatcherOptions);
+    /**
+     * Start watching for file changes.
+     */
+    start(): void;
+    /**
+     * Stop watching for file changes.
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if the watcher is running.
+     */
+    isRunning(): boolean;
+    /**
+     * Check if the watcher is ready (initial scan complete).
+     */
+    ready(): boolean;
+    /**
+     * Handle a file system event with debouncing.
+     */
+    private handleEvent;
+    /**
+     * Emit an event to the handler.
+     */
+    private emitEvent;
+    /**
+     * Get the watched paths.
+     */
+    getWatchedPaths(): string[];
+}
+/**
+ * Create a new file watcher.
+ */
+export declare function createWatcher(options: WatcherOptions): FileWatcher;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watch/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/watch/watcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,oBAAoB;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,cAAc;IAKnC;;OAEG;IACH,KAAK,IAAI,IAAI;IAyCb;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,KAAK,IAAI,OAAO;IAIhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;CAgB5B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CAElE"}

package/dist/watch/watcher.js

@@ -0,0 +1,141 @@
+/**
+ * File watcher for detecting changes in source files.
+ */
+import { resolve } from 'node:path';
+import { DEFAULT_EXCLUDE_PATTERNS, DEFAULT_INCLUDE_PATTERNS, DEFAULT_WATCH_DEBOUNCE, } from '@reverso/core';
+import { watch } from 'chokidar';
+/**
+ * File watcher class.
+ */
+export class FileWatcher {
+    watcher = null;
+    options;
+    debounceTimers = new Map();
+    debounceDelay;
+    isReady = false;
+    constructor(options) {
+        this.options = options;
+        this.debounceDelay = options.debounce ?? DEFAULT_WATCH_DEBOUNCE;
+    }
+    /**
+     * Start watching for file changes.
+     */
+    start() {
+        if (this.watcher) {
+            return;
+        }
+        const srcDir = resolve(this.options.srcDir);
+        const include = this.options.include ?? [...DEFAULT_INCLUDE_PATTERNS];
+        const exclude = this.options.exclude ?? [...DEFAULT_EXCLUDE_PATTERNS];
+        // Create glob patterns for chokidar
+        const patterns = include.map((pattern) => `${srcDir}/${pattern}`);
+        this.watcher = watch(patterns, {
+            ignored: exclude,
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 100,
+                pollInterval: 50,
+            },
+        });
+        // Set up event handlers
+        this.watcher.on('add', (path) => this.handleEvent('add', path));
+        this.watcher.on('change', (path) => this.handleEvent('change', path));
+        this.watcher.on('unlink', (path) => this.handleEvent('unlink', path));
+        this.watcher.on('error', (error) => {
+            if (this.options.onError) {
+                this.options.onError(error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+        this.watcher.on('ready', () => {
+            this.isReady = true;
+            if (this.options.onReady) {
+                this.options.onReady();
+            }
+        });
+    }
+    /**
+     * Stop watching for file changes.
+     */
+    async stop() {
+        // Clear all debounce timers
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+            this.isReady = false;
+        }
+    }
+    /**
+     * Check if the watcher is running.
+     */
+    isRunning() {
+        return this.watcher !== null;
+    }
+    /**
+     * Check if the watcher is ready (initial scan complete).
+     */
+    ready() {
+        return this.isReady;
+    }
+    /**
+     * Handle a file system event with debouncing.
+     */
+    handleEvent(type, path) {
+        // Clear existing timer for this path
+        const existingTimer = this.debounceTimers.get(path);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        // Set new debounced timer
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(path);
+            this.emitEvent(type, path);
+        }, this.debounceDelay);
+        this.debounceTimers.set(path, timer);
+    }
+    /**
+     * Emit an event to the handler.
+     */
+    emitEvent(type, path) {
+        if (this.options.onEvent) {
+            const event = {
+                type,
+                path,
+                timestamp: Date.now(),
+            };
+            // Call handler (may be async)
+            Promise.resolve(this.options.onEvent(event)).catch((err) => {
+                if (this.options.onError) {
+                    this.options.onError(err instanceof Error ? err : new Error(String(err)));
+                }
+            });
+        }
+    }
+    /**
+     * Get the watched paths.
+     */
+    getWatchedPaths() {
+        if (!this.watcher) {
+            return [];
+        }
+        const watched = this.watcher.getWatched();
+        const paths = [];
+        for (const [dir, files] of Object.entries(watched)) {
+            for (const file of files) {
+                paths.push(`${dir}/${file}`);
+            }
+        }
+        return paths;
+    }
+}
+/**
+ * Create a new file watcher.
+ */
+export function createWatcher(options) {
+    return new FileWatcher(options);
+}
+//# sourceMappingURL=watcher.js.map

package/dist/watch/watcher.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@reverso/scanner",
+  "version": "0.1.0",
+  "description": "AST parser for detecting data-reverso markers in React/Next.js code",
+  "homepage": "https://reverso.dev/docs/packages/scanner",
+  "bugs": {
+    "url": "https://github.com/hogrid/reverso/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist .turbo"
+  },
+  "dependencies": {
+    "@reverso/core": "workspace:*",
+    "ts-morph": "^27.0.2",
+    "glob": "^13.0.0",
+    "chokidar": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hogrid/reverso.git",
+    "directory": "packages/scanner"
+  },
+  "keywords": [
+    "reverso",
+    "cms",
+    "scanner",
+    "ast",
+    "parser"
+  ],
+  "author": "Emerson Nunes <emerson@hogrid.com>",
+  "license": "MIT"
+}