ngx-locatorjs 0.1.0 → 0.2.0

package/README.ko.md

@@ -1,6 +1,7 @@
 # ngx-locatorjs (Open-in-Editor)
 
 브라우저에서 Alt+클릭으로 Angular 컴포넌트 파일을 에디터에서 바로 여는 개발용 도구입니다. Angular 프로젝트 어디에나 npm 패키지로 설치해 사용할 수 있습니다.
+이 프로젝트는 [locatorjs.com](https://www.locatorjs.com/)에서 영감을 받았습니다.
 
 **기능**
 - Alt+클릭: 템플릿(.html) 열기
@@ -8,13 +9,13 @@
 - Alt 키 홀드: 컴포넌트 하이라이트 + 툴팁 표시
 - Cursor, VS Code, WebStorm 지원
 
-**필수 단계 (1~5 반드시 수행)**
+**필수 단계 (1~4 반드시 수행)**
 1. 패키지 설치: `npm i -D ngx-locatorjs`
-2. `main.ts`에 런타임 훅 추가 (아래 예시 참고)
-3. 설정/프록시 생성: `npx locatorjs-config`
-4. 컴포넌트 스캔: `npx locatorjs-scan`
-5. 파일 오프너 서버 + dev 서버 실행 (둘 다 켜진 상태 유지): `npx locatorjs-open-in-editor` + `ng serve --proxy-config ngx-locatorjs.proxy.json`
-   - `npm run start` 사용 시 `--` 뒤에 전달: `npm run start -- --proxy-config ngx-locatorjs.proxy.json`
+2. 설정/프록시 생성: `npx locatorjs-config`
+3. `main.ts`에 런타임 훅 추가 (아래 예시 참고)
+4. 파일 오프너 서버 + dev 서버 실행 (둘 다 켜진 상태 유지): `npx locatorjs-open-in-editor --watch` + `ng serve --proxy-config ngx-locatorjs.proxy.json`
+
+`npm run start` 사용 시 `--` 뒤에 전달: `npm run start -- --proxy-config ngx-locatorjs.proxy.json`
 
 **Angular 코드 추가 (main.ts)**
 ```ts
@@ -32,7 +33,9 @@ platformBrowserDynamic()
   .then(() => {
     if (!environment.production) {
       setTimeout(() => {
-        import('ngx-locatorjs').then((m) => m.installAngularLocator());
+        import('ngx-locatorjs').then((m) =>
+          m.installAngularLocator({ enableNetwork: true }),
+        );
       }, 1000);
     }
   })
@@ -49,7 +52,9 @@ bootstrapApplication(AppComponent, appConfig)
   .then(() => {
     setTimeout(() => {
       import('ngx-locatorjs')
-        .then((m) => m.installAngularLocator())
+        .then((m) =>
+          m.installAngularLocator({ enableNetwork: true }),
+        )
         .catch((err) => console.warn('[angular-locator] Failed to load:', err));
     }, 1000);
   })
@@ -76,7 +81,6 @@ bootstrapApplication(AppComponent, appConfig)
 - 단일 Angular 앱, workspace, Nx 구조에서 동작
 
 **불가능/제한 사항**
-- 동적/반복 템플릿의 정확한 라인 매칭은 100% 보장 불가
 - SSR/SSG 환경에서는 동작하지 않음 (브라우저 DOM 기반)
 
 **ngx-locatorjs.config.json 가이드**
@@ -84,24 +88,30 @@ bootstrapApplication(AppComponent, appConfig)
 
 **중요**
 - `npx locatorjs-config`는 **실행한 현재 폴더를 기준**으로 설정합니다.
-- 프로젝트 루트에서 실행하고, `workspaceRoot` 질문에서 **Enter**를 누르면 `.`(현재 폴더)로 저장됩니다.
-- 모노레포처럼 실제 Angular 앱이 하위 폴더에 있으면 그 **상대 경로**를 입력하세요. (예: `apps/web`)
+- 기본값: `port: 4123`, `workspaceRoot: "."`.
+- 모노레포처럼 실제 Angular 앱이 하위 폴더에 있으면 `workspaceRoot`를 그 **상대 경로**로 수정하세요. (예: `apps/web`)
 - `.gitignore`가 있으면 `npx locatorjs-config`가 `.open-in-editor/`를 자동 추가합니다. 커밋하려면 해당 항목을 제거하세요.
 
 예시:
 ```json
 {
-  "port": 4123,
-  "workspaceRoot": ".",
-  "editor": "cursor",
-  "fallbackEditor": "code",
+  "port": 4123, // 프록시 서버가 실행될 포트 주소
+  "workspaceRoot": ".", // Angular 워크스페이스 루트
+  "editor": "cursor", // 파일을 열 때 사용할 에디터 (`cursor`, `code`, `webstorm`)
+  "fallbackEditor": "code", // 기본 에디터 실패 시 사용할 에디터
   "scan": {
+    /**
+     * 탐색할 컴포넌트의 경로 목록
+     */
     "includeGlobs": [
       "src/**/*.{ts,tsx}",
       "projects/**/*.{ts,tsx}",
       "apps/**/*.{ts,tsx}",
       "libs/**/*.{ts,tsx}"
     ],
+    /**
+     * 스캔에서 제외할 경로 목록
+     */
     "excludeGlobs": [
       "**/node_modules/**",
       "**/dist/**",
@@ -115,15 +125,7 @@ bootstrapApplication(AppComponent, appConfig)
 }
 ```
 
-**필드 설명**
-- `port`: file-opener 서버 포트
-- `workspaceRoot`: 실제 Angular 워크스페이스 루트(모노레포에서 하위 폴더일 때 사용)
-- `editor`: 기본 에디터 (`cursor`, `code`, `webstorm`)
-- `fallbackEditor`: 기본 에디터 실패 시 사용할 에디터
-- `scan.includeGlobs`: 컴포넌트 탐색 대상 경로
-- `scan.excludeGlobs`: 스캔 제외 경로
-
-**프로젝트 구조별 추천 includeGlobs**
+**프로젝트 구조별 includeGlobs 예시**
 1. 일반 Angular 앱
 `["src/app/**/*.ts"]`
 2. Angular Workspace (projects/)
@@ -166,21 +168,24 @@ bootstrapApplication(AppComponent, appConfig)
 `ng serve --proxy-config ngx-locatorjs.proxy.json` 사용 여부 확인
 2. npm run 경고
 `npm run start -- --proxy-config ngx-locatorjs.proxy.json` 형태로 실행
-3. component-map.json not found
+3. 네트워크 비활성
+`installAngularLocator({ enableNetwork: true })` 설정 확인
+4. component-map.json not found
 `npx locatorjs-scan` 실행 후 `.open-in-editor/component-map.json` 생성 여부 확인
-4. 스캔 결과가 비어있거나 컴포넌트가 누락됨
-`scan.includeGlobs` 경로 확인 후 재스캔
-5. 잘못된 파일이 열리거나 매칭이 안 됨
-`workspaceRoot`가 실제 Angular 앱 루트인지 확인
-6. 하이라이트가 안 보이거나 info가 null로 나옴
-`/__cmp-map` 응답에 내 컴포넌트 클래스명이 포함되는지 확인
-7. 에디터가 열리지 않음
-CLI 설치 확인 또는 `EDITOR_CMD` 설정
-8. 포트 충돌
+5. 컴포넌트 변경이 반영되지 않음
+`npx locatorjs-open-in-editor --watch` 사용 또는 `npx locatorjs-scan` 재실행
+6. 스캔 결과가 비어있거나 컴포넌트가 누락됨
+`scan.includeGlobs` 경로 확인 후 재스캔. 실제 컴포넌트들이 위치한 경로를 입력해야 합니다.
+7. 잘못된 파일이 열리거나 매칭이 안 됨
+`workspaceRoot`가 Angular 앱 루트인지 확인
+8. 하이라이트가 안 보이거나 info가 null로 나옴
+`http://localhost:${port}/__cmp-map` 에서 컴포넌트 정보가 잘 나타나는지 확인
+9. 포트 충돌
 `ngx-locatorjs.config.json`과 `ngx-locatorjs.proxy.json`에서 포트 일치 여부 확인
 
 **주의**
 - 개발 모드에서만 사용하세요. 프로덕션 번들에 포함되지 않도록 `environment.production` 체크를 권장합니다.
+- 네트워크 요청은 opt-in이며 localhost로만 제한됩니다. `enableNetwork: true`로 활성화하세요.
 
 **원 커맨드 실행 (추천)**
 file-opener 서버와 Angular dev server를 한 번에 띄우려면 아래 방식 중 하나를 사용하세요.

package/README.md

@@ -1,5 +1,7 @@
 # ngx-locatorjs (Angular Open-in-Editor)
 
+![2026-02-045 13 22-ezgif com-optimize](https://github.com/user-attachments/assets/9956e311-1af6-4096-9b9e-eb8dd6ea62be)
+
 한국어 문서: [README.ko.md](README.ko.md)
 
 Open Angular component files directly from the browser with **Alt + Click** during development. This package provides:
@@ -7,6 +9,8 @@ Open Angular component files directly from the browser with **Alt + Click** duri
 - CLI tools to scan Angular components and open files in your editor
 - Config + proxy setup guidance
 
+Inspired by [locatorjs.com](https://www.locatorjs.com/).
+
 ## Features
 - **Alt + Click**: open template (.html)
 - **Alt + Shift + Click**: open component (.ts)
@@ -19,14 +23,14 @@ npm i -D ngx-locatorjs
 ```
 
 ## Required Steps (Do This First)
-You must complete steps 1–5 for this to work.
+You must complete steps 1–4 for this to work.
 
 1. Install the package: `npm i -D ngx-locatorjs`
-2. Add the runtime hook to `main.ts` (see the examples below)
-3. Generate config + proxy: `npx locatorjs-config`
-4. Scan components: `npx locatorjs-scan`
-5. Run the file-opener server and your dev server (keep both running): `npx locatorjs-open-in-editor` + `ng serve --proxy-config ngx-locatorjs.proxy.json`
-   - If you use `npm run start`, pass args after `--`: `npm run start -- --proxy-config ngx-locatorjs.proxy.json`
+2. Generate config + proxy: `npx locatorjs-config`
+3. Add the runtime hook to `main.ts` (see the examples below)
+4. Run the file-opener server and your dev server (keep both running): `npx locatorjs-open-in-editor --watch` + `ng serve --proxy-config ngx-locatorjs.proxy.json`
+
+If you use `npm run start`, pass args after `--`: `npm run start -- --proxy-config ngx-locatorjs.proxy.json`
 
 ## Add to `main.ts`
 
@@ -47,7 +51,9 @@ platformBrowserDynamic()
     if (!environment.production) {
       setTimeout(() => {
         import('ngx-locatorjs')
-          .then((m) => m.installAngularLocator())
+          .then((m) =>
+            m.installAngularLocator({ enableNetwork: true }), // required for network access (localhost-only)
+          )
           .catch((err) => console.warn('[angular-locator] Failed to load:', err));
       }, 1000);
     }
@@ -65,7 +71,9 @@ bootstrapApplication(AppComponent, appConfig)
   .then(() => {
     setTimeout(() => {
       import('ngx-locatorjs')
-        .then((m) => m.installAngularLocator())
+        .then((m) =>
+          m.installAngularLocator({ enableNetwork: true }), // required for network access (localhost-only)
+        )
         .catch((err) => console.warn('[angular-locator] Failed to load:', err));
     }, 1000);
   })
@@ -77,24 +85,30 @@ Location: project root
 
 **Important**
 - `npx locatorjs-config` uses the **current directory** as the base.
-- Run it from the project root and press **Enter** for `workspaceRoot: "."`.
-- In a monorepo, enter the **relative path** to your Angular app (e.g. `apps/web`).
+- Defaults: `port: 4123`, `workspaceRoot: "."`.
+- In a monorepo, update `workspaceRoot` to the **relative path** of your Angular app (e.g. `apps/web`).
 - If `.gitignore` exists, `npx locatorjs-config` will append `.open-in-editor/`. Remove it if you want to commit the map.
 
 Example:
 ```json
 {
-  "port": 4123,
-  "workspaceRoot": ".",
-  "editor": "cursor",
-  "fallbackEditor": "code",
+  "port": 4123, // Port for the local file-opener server
+  "workspaceRoot": ".", // Angular workspace root
+  "editor": "cursor", // Editor to open files (`cursor`, `code`, `webstorm`)
+  "fallbackEditor": "code", // Fallback editor if the default fails
   "scan": {
+    /**
+     * Globs to include when scanning components
+     */
     "includeGlobs": [
       "src/**/*.{ts,tsx}",
       "projects/**/*.{ts,tsx}",
       "apps/**/*.{ts,tsx}",
       "libs/**/*.{ts,tsx}"
     ],
+    /**
+     * Globs to exclude from scanning
+     */
     "excludeGlobs": [
       "**/node_modules/**",
       "**/dist/**",
@@ -108,15 +122,7 @@ Example:
 }
 ```
 
-### Field Reference
-- `port`: file-opener server port
-- `workspaceRoot`: actual Angular workspace root
-- `editor`: default editor (`cursor`, `code`, `webstorm`)
-- `fallbackEditor`: used if default fails
-- `scan.includeGlobs`: component scan targets
-- `scan.excludeGlobs`: scan excludes
-
-### Recommended includeGlobs
+### Example includeGlobs
 - Simple app: `"src/app/**/*.ts"`
 - Angular workspace: `"projects/**/*.{ts,tsx}"`
 - Nx: `"apps/**/*.{ts,tsx}", "libs/**/*.{ts,tsx}"`
@@ -154,15 +160,17 @@ Example:
 ## Troubleshooting
 - **CORS / JSON parse error**: ensure dev server uses `--proxy-config ngx-locatorjs.proxy.json`
 - **npm run shows "Unknown cli config --proxy-config"**: use `npm run start -- --proxy-config ngx-locatorjs.proxy.json`
+- **Network disabled**: pass `enableNetwork: true` to `installAngularLocator`
 - **component-map.json not found**: run `npx locatorjs-scan`
+- **Component changes not reflected**: run `npx locatorjs-open-in-editor --watch` or re-run `npx locatorjs-scan`
 - **Map is empty or missing components**: check `scan.includeGlobs` and rerun the scan
 - **Wrong files open or nothing matches**: confirm `workspaceRoot` points to the actual Angular app root
-- **No highlight / info is null**: make sure `/__cmp-map` is loading and includes your component class name
-- **Editor not opening**: install editor CLI or set `EDITOR_CMD`
+- **No highlight / info is null**: make sure `http://localhost:${port}/__cmp-map` is loading and includes your component class name
 - **Port conflict**: change port in both `ngx-locatorjs.config.json` and `ngx-locatorjs.proxy.json`
 
 ## Notes
 - Use only in development (guard with `environment.production`).
+- Network requests are opt-in and limited to localhost. Set `enableNetwork: true` to activate.
 
 ## One-Command Dev (Recommended)
 Running the file-opener server and Angular dev server separately is tedious. You can wire them into a single script.
@@ -201,7 +209,4 @@ npm i -D npm-run-all
 - Works with single apps, Angular workspace, and Nx layouts
 
 ## Limitations
-- Requires proxy setup (`ngx-locatorjs.proxy.json`), otherwise requests will fail
-- Requires the file-opener server to be running
-- Line matching in dynamic/repeated templates is heuristic, not perfect
 - Not supported in SSR/SSG runtime (browser DOM only)

package/dist/browser/auto.js

@@ -1,2 +1,2 @@
 import { installAngularLocator } from './index';
-installAngularLocator();
+installAngularLocator({ enableNetwork: true });

package/dist/browser/index.d.ts

@@ -14,6 +14,7 @@ export type AngularLocatorEndpoints = {
 };
 export type AngularLocatorOptions = {
     endpoints?: Partial<AngularLocatorEndpoints>;
+    enableNetwork?: boolean;
     prefetchMap?: boolean;
     enableHover?: boolean;
     enableClick?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,MAAM,GAAG;IACZ,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AA+CF,iBAAe,SAAS,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB9D;AA2eD,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,qBAA0B,iBAa9E;AAED,wBAAsB,mBAAmB,kBASxC;AAED,wBAAsB,mBAAmB,kBAExC;AAED,wBAAgB,yBAAyB,YAExC;AAED,eAAO,MAAM,SAAS;;CAErB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,MAAM,GAAG;IACZ,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AA4EF,iBAAe,SAAS,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB9D;AA+eD,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,qBAA0B,iBAa9E;AAED,wBAAsB,mBAAmB,kBASxC;AAED,wBAAsB,mBAAmB,kBAExC;AAED,wBAAgB,yBAAyB,YAExC;AAED,eAAO,MAAM,SAAS;;CAErB,CAAC"}

package/dist/browser/index.js

@@ -5,6 +5,7 @@ const DEFAULT_ENDPOINTS = {
 };
 const DEFAULT_OPTIONS = {
     endpoints: DEFAULT_ENDPOINTS,
+    enableNetwork: false,
     prefetchMap: true,
     enableHover: true,
     enableClick: true,
@@ -16,6 +17,30 @@ let OPTIONS = DEFAULT_OPTIONS;
 let INSTALLED = false;
 let CMP_MAP = null;
 let mapLoadPromise = null;
+const LOCALHOST_HOSTS = new Set(['localhost', '127.0.0.1', '::1']);
+function isLocalhostHost(hostname) {
+    if (LOCALHOST_HOSTS.has(hostname))
+        return true;
+    if (hostname.endsWith('.localhost'))
+        return true;
+    return false;
+}
+function assertNetworkAllowed(url) {
+    if (!OPTIONS.enableNetwork) {
+        if (OPTIONS.debug) {
+            console.warn('[angular-locator] Network is disabled. Set enableNetwork: true.');
+        }
+        throw new Error('Network disabled');
+    }
+    const resolved = new URL(url, window.location.href);
+    if (!isLocalhostHost(resolved.hostname)) {
+        if (OPTIONS.debug) {
+            console.warn('[angular-locator] Network is limited to localhost:', resolved.href);
+        }
+        throw new Error('Network restricted to localhost');
+    }
+    return resolved.toString();
+}
 function normalizeMap(map) {
     if (!map.filePathsByClassName || Object.keys(map.filePathsByClassName).length === 0) {
         const rebuilt = {};
@@ -34,7 +59,7 @@ async function ensureMap(forceRefresh = false) {
     if (CMP_MAP && !forceRefresh)
         return CMP_MAP;
     const timestamp = Date.now();
-    const res = await fetch(`${OPTIONS.endpoints.componentMap}?t=${timestamp}`, {
+    const res = await fetch(assertNetworkAllowed(`${OPTIONS.endpoints.componentMap}?t=${timestamp}`), {
         cache: 'no-store',
         headers: {
             'Cache-Control': 'no-cache, no-store, must-revalidate',
@@ -173,7 +198,7 @@ function getNearestComponent(el) {
     };
 }
 async function openFile(absPath, line = 1, col = 1) {
-    const url = `${OPTIONS.endpoints.openInEditor}?file=${encodeURIComponent(absPath)}&line=${line}&col=${col}`;
+    const url = assertNetworkAllowed(`${OPTIONS.endpoints.openInEditor}?file=${encodeURIComponent(absPath)}&line=${line}&col=${col}`);
     try {
         await fetch(url);
     }
@@ -184,7 +209,7 @@ async function openFile(absPath, line = 1, col = 1) {
     }
 }
 async function openFileWithSearch(absPath, searchTerms) {
-    const url = `${OPTIONS.endpoints.openInEditorSearch}?file=${encodeURIComponent(absPath)}&search=${encodeURIComponent(JSON.stringify(searchTerms))}`;
+    const url = assertNetworkAllowed(`${OPTIONS.endpoints.openInEditorSearch}?file=${encodeURIComponent(absPath)}&search=${encodeURIComponent(JSON.stringify(searchTerms))}`);
     try {
         await fetch(url);
     }

package/dist/node/config-setup.js

@@ -32,9 +32,10 @@ else {
 }
 async function startSetup() {
     try {
+        logDefaults();
         const config = {
-            port: await promptPort(),
-            workspaceRoot: await promptWorkspaceRoot(),
+            port: 4123,
+            workspaceRoot: '.',
             editor: await selectEditor(),
             fallbackEditor: 'code',
             scan: await promptScanSettings(),
@@ -193,54 +194,10 @@ function ensureGitignoreEntries(entries) {
     fs.appendFileSync(gitignorePath, block);
     console.log(`🧹 Added to .gitignore: ${missing.join(', ')}`);
 }
-function promptPort() {
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
-    return new Promise((resolve) => {
-        rl.question('🔌 Enter port number (press Enter for default: 4123): ', (answer) => {
-            rl.close();
-            const port = answer.trim();
-            const portNum = port === '' ? 4123 : parseInt(port, 10) || 4123;
-            console.log(`   → Port: ${portNum}`);
-            resolve(portNum);
-        });
-    });
-}
-function promptWorkspaceRoot() {
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
-    console.log(`\n📁 Current directory: ${process.cwd()}`);
-    const askWorkspaceRoot = () => {
-        return new Promise((resolve) => {
-            rl.question('📁 Enter workspace root (press Enter for current directory "."): ', (answer) => {
-                const workspaceRoot = answer.trim();
-                const result = workspaceRoot === '' ? '.' : workspaceRoot;
-                const resolvedPath = path.resolve(process.cwd(), result);
-                if (!fs.existsSync(resolvedPath)) {
-                    console.log(`   ❌ Path does not exist: ${resolvedPath}`);
-                    console.log('   Please try again...\n');
-                    askWorkspaceRoot().then(resolve);
-                    return;
-                }
-                const stat = fs.statSync(resolvedPath);
-                if (!stat.isDirectory()) {
-                    console.log(`   ❌ Path is not a directory: ${resolvedPath}`);
-                    console.log('   Please try again...\n');
-                    askWorkspaceRoot().then(resolve);
-                    return;
-                }
-                console.log(`   → Workspace root: ${result}`);
-                console.log(`   → Resolved path: ${resolvedPath}`);
-                rl.close();
-                resolve(result);
-            });
-        });
-    };
-    return askWorkspaceRoot();
+function logDefaults() {
+    console.log('⚙️  Defaults applied:');
+    console.log('   → Port: 4123');
+    console.log('   → Workspace root: .');
 }
 function selectEditor() {
     const availableEditors = [

package/dist/node/file-opener.js

@@ -1,8 +1,12 @@
 #!/usr/bin/env node
-import express from 'express';
 import fs from 'fs';
 import path from 'path';
 import childProcess from 'child_process';
+import http from 'http';
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 const root = process.cwd();
 const CONFIG_FILENAME = 'ngx-locatorjs.config.json';
 const configPath = path.resolve(root, CONFIG_FILENAME);
@@ -12,8 +16,19 @@ if (!fs.existsSync(configPath)) {
     console.log('Or manually create the config file.');
     process.exit(1);
 }
+const DEFAULT_INCLUDE_GLOBS = [
+    'src/**/*.{ts,tsx}',
+    'projects/**/*.{ts,tsx}',
+    'apps/**/*.{ts,tsx}',
+    'libs/**/*.{ts,tsx}',
+];
 const cfg = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-const PORT = Number(process.env.OPEN_IN_EDITOR_PORT || cfg.port || 4123);
+const WATCH_ENABLED = process.argv.includes('--watch') || process.argv.includes('-w');
+const cfgScan = cfg.scan ?? {};
+const scanIncludeGlobs = cfgScan.includeGlobs ?? DEFAULT_INCLUDE_GLOBS;
+const scanWorkspaceRoot = cfg.workspaceRoot?.trim() || '.';
+const cfgPort = cfg.port;
+const PORT = Number(process.env.OPEN_IN_EDITOR_PORT || cfgPort || 4123);
 const MAP_PATH = path.resolve(root, '.open-in-editor/component-map.json');
 const editorCLICache = {};
 function checkEditorCLI(editorName, cliCommand = editorName) {
@@ -108,13 +123,6 @@ function launchInEditor(fileWithPos, preferred = DEFAULT_EDITOR) {
         return true;
     return false;
 }
-const app = express();
-app.get('/__cmp-map', (req, res) => {
-    if (!fs.existsSync(MAP_PATH))
-        return res.status(404).send('component-map.json not found');
-    res.setHeader('Content-Type', 'application/json');
-    fs.createReadStream(MAP_PATH).pipe(res);
-});
 function findBestLineInFile(filePath, searchTerms) {
     try {
         const content = fs.readFileSync(filePath, 'utf8');
@@ -151,45 +159,178 @@ function findBestLineInFile(filePath, searchTerms) {
         return 1;
     }
 }
-app.get('/__open-in-editor', (req, res) => {
-    let file = req.query.file;
-    const line = req.query.line || '1';
-    const col = req.query.col || '1';
-    if (!file)
-        return res.status(400).send('file is required');
-    file = decodeURIComponent(file);
-    console.log(`[file-opener] Opening file: ${file}:${line}:${col}`);
-    const fileWithPos = `${file}:${line}:${col}`;
-    const ok = launchInEditor(fileWithPos);
-    if (!ok) {
-        return res.status(500).send('Failed to launch editor. Check PATH or set EDITOR_CMD.');
-    }
-    res.end('ok');
-});
-app.get('/__open-in-editor-search', (req, res) => {
-    let file = req.query.file;
-    const searchParam = req.query.search;
-    if (!file)
-        return res.status(400).send('file is required');
-    if (!searchParam)
-        return res.status(400).send('search terms required');
-    file = decodeURIComponent(file);
+function startScanWatch() {
+    const scanScript = path.resolve(__dirname, 'cmp-scan.js');
+    if (!fs.existsSync(scanScript)) {
+        console.log('[file-opener] scan script not found, watch disabled.');
+        return;
+    }
+    const roots = getWatchRoots(scanIncludeGlobs, scanWorkspaceRoot);
+    if (roots.length === 0) {
+        console.log('[file-opener] watch roots not found, watch disabled.');
+        return;
+    }
+    const recursive = process.platform === 'darwin' || process.platform === 'win32';
+    const watchers = [];
+    let scanRunning = false;
+    let scanQueued = false;
+    let timer = null;
+    const runScan = (reason) => {
+        if (scanRunning) {
+            scanQueued = true;
+            return;
+        }
+        scanRunning = true;
+        const label = reason ? ` (${reason})` : '';
+        console.log(`[file-opener] scan started${label}`);
+        const scanProcess = spawn(process.execPath, [scanScript], {
+            stdio: 'inherit',
+            cwd: root,
+        });
+        scanProcess.on('close', (code) => {
+            scanRunning = false;
+            if (code === 0) {
+                console.log('[file-opener] scan completed');
+            }
+            else {
+                console.log('[file-opener] scan failed');
+            }
+            if (scanQueued) {
+                scanQueued = false;
+                scheduleScan('queued');
+            }
+        });
+    };
+    const scheduleScan = (reason) => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => runScan(reason), 500);
+    };
+    const attachWatcher = (watchPath) => {
+        try {
+            const watcher = fs.watch(watchPath, { recursive }, (eventType, filename) => {
+                const detail = filename ? `${eventType}:${filename.toString()}` : eventType;
+                scheduleScan(detail);
+            });
+            watchers.push(watcher);
+        }
+        catch (err) {
+            console.log(`[file-opener] failed to watch ${watchPath}: ${err?.message || err}`);
+            throw err;
+        }
+    };
     try {
-        const searchTerms = JSON.parse(decodeURIComponent(searchParam));
-        const bestLine = findBestLineInFile(file, searchTerms);
-        const fileWithPos = `${file}:${bestLine}:1`;
+        roots.forEach(attachWatcher);
+        console.log(`[file-opener] watch enabled (${recursive ? 'recursive' : 'non-recursive'}): ${roots.join(', ')}`);
+    }
+    catch {
+        watchers.forEach((w) => w.close());
+        console.log('[file-opener] falling back to polling scan every 5s');
+        setInterval(() => runScan('poll'), 5000);
+    }
+    runScan('initial');
+}
+function getWatchRoots(includeGlobs, workspaceRoot) {
+    const roots = new Set();
+    includeGlobs.forEach((glob) => {
+        const base = globToBaseDir(glob);
+        const resolved = path.resolve(root, workspaceRoot, base);
+        if (fs.existsSync(resolved) && fs.statSync(resolved).isDirectory()) {
+            roots.add(resolved);
+        }
+    });
+    return Array.from(roots);
+}
+function globToBaseDir(glob) {
+    const wildcardIndex = glob.search(/[*?[\]{]/);
+    if (wildcardIndex === -1)
+        return glob;
+    const prefix = glob.slice(0, wildcardIndex);
+    if (prefix.endsWith('/'))
+        return prefix.slice(0, -1);
+    return path.dirname(prefix);
+}
+const server = http.createServer((req, res) => {
+    if (!req.url) {
+        res.statusCode = 400;
+        res.end('Bad request');
+        return;
+    }
+    if (req.method !== 'GET') {
+        res.statusCode = 405;
+        res.end('Method not allowed');
+        return;
+    }
+    const url = new URL(req.url, `http://${req.headers.host || 'localhost'}`);
+    const pathname = url.pathname;
+    if (pathname === '/__cmp-map') {
+        if (!fs.existsSync(MAP_PATH)) {
+            res.statusCode = 404;
+            res.end('component-map.json not found');
+            return;
+        }
+        res.setHeader('Content-Type', 'application/json');
+        fs.createReadStream(MAP_PATH).pipe(res);
+        return;
+    }
+    if (pathname === '/__open-in-editor') {
+        const file = url.searchParams.get('file');
+        const line = url.searchParams.get('line') || '1';
+        const col = url.searchParams.get('col') || '1';
+        if (!file) {
+            res.statusCode = 400;
+            res.end('file is required');
+            return;
+        }
+        const decoded = decodeURIComponent(file);
+        console.log(`[file-opener] Opening file: ${decoded}:${line}:${col}`);
+        const fileWithPos = `${decoded}:${line}:${col}`;
         const ok = launchInEditor(fileWithPos);
         if (!ok) {
-            return res.status(500).send('Failed to launch editor');
+            res.statusCode = 500;
+            res.end('Failed to launch editor. Check PATH or set EDITOR_CMD.');
+            return;
         }
-        res.end(`Opened at line ${bestLine}`);
+        res.end('ok');
+        return;
     }
-    catch (e) {
-        console.warn(`[file-opener] Search error: ${e.message}`);
-        res.status(500).send('Search failed: ' + e.message);
+    if (pathname === '/__open-in-editor-search') {
+        const file = url.searchParams.get('file');
+        const searchParam = url.searchParams.get('search');
+        if (!file) {
+            res.statusCode = 400;
+            res.end('file is required');
+            return;
+        }
+        if (!searchParam) {
+            res.statusCode = 400;
+            res.end('search terms required');
+            return;
+        }
+        const decoded = decodeURIComponent(file);
+        try {
+            const searchTerms = JSON.parse(decodeURIComponent(searchParam));
+            const bestLine = findBestLineInFile(decoded, searchTerms);
+            const fileWithPos = `${decoded}:${bestLine}:1`;
+            const ok = launchInEditor(fileWithPos);
+            if (!ok) {
+                res.statusCode = 500;
+                res.end('Failed to launch editor');
+                return;
+            }
+            res.end(`Opened at line ${bestLine}`);
+        }
+        catch (e) {
+            console.warn(`[file-opener] Search error: ${e.message}`);
+            res.statusCode = 500;
+            res.end('Search failed: ' + e.message);
+        }
+        return;
     }
+    res.statusCode = 404;
+    res.end('Not found');
 });
-app
+server
     .listen(PORT, () => {
     console.log(`[file-opener] http://localhost:${PORT}`);
     console.log(` - map: ${path.relative(root, MAP_PATH)}`);
@@ -201,6 +342,9 @@ app
             console.log(`   • ${editor.name}${precision}`);
         });
     }
+    if (WATCH_ENABLED) {
+        startScanWatch();
+    }
 })
     .on('error', (err) => {
     if (err.code === 'EADDRINUSE') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-locatorjs",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "LocatorJs open-in-editor tools for Angular projects",
   "author": "antepost24",
   "type": "module",
@@ -54,13 +54,11 @@
     "format:check": "prettier --check \"**/*.{ts,tsx,js,jsx,json,md}\""
   },
   "dependencies": {
-    "express": "^4.18.2",
     "ts-morph": "^27.0.0"
   },
   "devDependencies": {
     "@typescript-eslint/eslint-plugin": "^7.18.0",
     "@typescript-eslint/parser": "^7.18.0",
-    "@types/express": "^4.17.17",
     "@types/node": "^18.18.0",
     "eslint": "^8.57.1",
     "eslint-config-prettier": "^9.1.0",