ngx-locatorjs 0.2.0 → 0.3.0

package/README.ko.md

@@ -4,20 +4,24 @@
 이 프로젝트는 [locatorjs.com](https://www.locatorjs.com/)에서 영감을 받았습니다.
 
 **기능**
+
 - Alt+클릭: 템플릿(.html) 열기
 - Alt+Shift+클릭: 컴포넌트(.ts) 열기
 - Alt 키 홀드: 컴포넌트 하이라이트 + 툴팁 표시
-- Cursor, VS Code, WebStorm 지원
+- Antigravity IDE, Cursor, Zed, VS Code, WebStorm 지원
 
 **필수 단계 (1~4 반드시 수행)**
+
 1. 패키지 설치: `npm i -D ngx-locatorjs`
 2. 설정/프록시 생성: `npx locatorjs-config`
 3. `main.ts`에 런타임 훅 추가 (아래 예시 참고)
-4. 파일 오프너 서버 + dev 서버 실행 (둘 다 켜진 상태 유지): `npx locatorjs-open-in-editor --watch` + `ng serve --proxy-config ngx-locatorjs.proxy.json`
+4. 파일 오프너 서버 + dev 서버 실행 (둘 다 켜진 상태 유지): `npx locatorjs-open-in-editor --watch` + `ng serve --proxy-config {proxyConfigPath}`
 
-`npm run start` 사용 시 `--` 뒤에 전달: `npm run start -- --proxy-config ngx-locatorjs.proxy.json`
+`npm run start` 사용 시 `--` 뒤에 전달: `npm run start -- --proxy-config {proxyConfigPath}`
+`{proxyConfigPath}`는 `npx locatorjs-config`가 선택/병합한 실제 프록시 파일 경로로 바꿔서 사용하세요.
 
 **Angular 코드 추가 (main.ts)**
+
 ```ts
 import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
 import { AppModule } from './app/app.module';
@@ -33,9 +37,7 @@ platformBrowserDynamic()
   .then(() => {
     if (!environment.production) {
       setTimeout(() => {
-        import('ngx-locatorjs').then((m) =>
-          m.installAngularLocator({ enableNetwork: true }),
-        );
+        import('ngx-locatorjs').then((m) => m.installAngularLocator({ enableNetwork: true }));
       }, 1000);
     }
   })
@@ -43,6 +45,7 @@ platformBrowserDynamic()
 ```
 
 **Angular 코드 추가 (standalone: bootstrapApplication)**
+
 ```ts
 import { bootstrapApplication } from '@angular/platform-browser';
 import { appConfig } from './app/app.config';
@@ -52,9 +55,7 @@ bootstrapApplication(AppComponent, appConfig)
   .then(() => {
     setTimeout(() => {
       import('ngx-locatorjs')
-        .then((m) =>
-          m.installAngularLocator({ enableNetwork: true }),
-        )
+        .then((m) => m.installAngularLocator({ enableNetwork: true }))
         .catch((err) => console.warn('[angular-locator] Failed to load:', err));
     }, 1000);
   })
@@ -62,56 +63,56 @@ bootstrapApplication(AppComponent, appConfig)
 ```
 
 **Angular dev server 예시**
+
 - CLI 실행
-`ng serve --proxy-config ngx-locatorjs.proxy.json`
+  `ng serve --proxy-config {proxyConfigPath}`
 
 - angular.json에 적용
-`"serve"` 옵션에 `"proxyConfig": "ngx-locatorjs.proxy.json"` 추가
+  `"serve"` 옵션에 `"proxyConfig": "{proxyConfigPath}"` 추가
 
 **컴포넌트 맵 스캔**
+
 - 수동 스캔
-`npx locatorjs-scan`
+  `npx locatorjs-scan`
 
 - 변경 감지 자동 스캔(선택)
-`nodemon --delay 2.5 -e ts,html -w src -w projects -w apps -w libs -x "npx locatorjs-scan"`
+  `nodemon --delay 2.5 -e ts,html -w src -w projects -w apps -w libs -x "npx locatorjs-scan"`
 
 **가능한 것**
+
 - Alt+클릭으로 템플릿 또는 컴포넌트 파일 열기 (개발 모드)
 - Alt 키 홀드 시 컴포넌트 하이라이트 및 툴팁 표시
 - 단일 Angular 앱, workspace, Nx 구조에서 동작
 
 **불가능/제한 사항**
+
 - SSR/SSG 환경에서는 동작하지 않음 (브라우저 DOM 기반)
 
 **ngx-locatorjs.config.json 가이드**
 파일 위치: 프로젝트 루트
 
 **중요**
+
 - `npx locatorjs-config`는 **실행한 현재 폴더를 기준**으로 설정합니다.
 - 기본값: `port: 4123`, `workspaceRoot: "."`.
 - 모노레포처럼 실제 Angular 앱이 하위 폴더에 있으면 `workspaceRoot`를 그 **상대 경로**로 수정하세요. (예: `apps/web`)
 - `.gitignore`가 있으면 `npx locatorjs-config`가 `.open-in-editor/`를 자동 추가합니다. 커밋하려면 해당 항목을 제거하세요.
 
 예시:
+
 ```json
 {
-  "port": 4123, // 프록시 서버가 실행될 포트 주소
-  "workspaceRoot": ".", // Angular 워크스페이스 루트
-  "editor": "cursor", // 파일을 열 때 사용할 에디터 (`cursor`, `code`, `webstorm`)
-  "fallbackEditor": "code", // 기본 에디터 실패 시 사용할 에디터
+  "port": 4123,
+  "workspaceRoot": ".",
+  "editor": "cursor",
+  "fallbackEditor": "code",
   "scan": {
-    /**
-     * 탐색할 컴포넌트의 경로 목록
-     */
     "includeGlobs": [
       "src/**/*.{ts,tsx}",
       "projects/**/*.{ts,tsx}",
       "apps/**/*.{ts,tsx}",
       "libs/**/*.{ts,tsx}"
     ],
-    /**
-     * 스캔에서 제외할 경로 목록
-     */
     "excludeGlobs": [
       "**/node_modules/**",
       "**/dist/**",
@@ -125,24 +126,40 @@ bootstrapApplication(AppComponent, appConfig)
 }
 ```
 
+**필드 설명**
+
+- `port`: 로컬 file-opener 서버 포트입니다.
+- `workspaceRoot`: 명령 실행 위치 기준 Angular 워크스페이스 루트 상대 경로입니다.
+- `editor`: 기본 에디터입니다 (`cursor`, `zed`, `antigravity`, `code`, `webstorm`).
+- `fallbackEditor`: 기본 에디터 실행 실패 시 사용할 대체 에디터입니다.
+- `scan.includeGlobs`: 컴포넌트 소스 파일 탐색 대상 glob 목록입니다.
+- `scan.excludeGlobs`: 컴포넌트 스캔에서 제외할 glob 목록입니다.
+
 **프로젝트 구조별 includeGlobs 예시**
+
 1. 일반 Angular 앱
-`["src/app/**/*.ts"]`
+   `["src/app/**/*.ts"]`
 2. Angular Workspace (projects/)
-`["projects/**/*.{ts,tsx}"]`
+   `["projects/**/*.{ts,tsx}"]`
 3. Nx (apps/libs)
-`["apps/**/*.{ts,tsx}", "libs/**/*.{ts,tsx}"]`
+   `["apps/**/*.{ts,tsx}", "libs/**/*.{ts,tsx}"]`
 
 **환경변수 우선순위**
+
 1. `EDITOR_CMD` 예: `EDITOR_CMD="cursor --goto"`
 2. `LAUNCH_EDITOR` 예: `LAUNCH_EDITOR=code`
 3. `ngx-locatorjs.config.json`의 `editor`
 4. 자동 감지된 에디터
 
-**프록시 설정 (ngx-locatorjs.proxy.json)**
-`npx locatorjs-config` 실행 시 자동 생성됩니다. `angular.json`에 지정된 proxyConfig나 `proxy.conf.json`이 있으면 그 파일에 병합됩니다. 없으면 `ngx-locatorjs.proxy.json`을 생성합니다.
+**프록시 설정 ({proxyConfigPath})**
+`{proxyConfigPath}`는 `npx locatorjs-config` 실행 시 아래 규칙으로 결정됩니다.
+
+- `angular.json`에 `proxyConfig`가 지정되어 있으면 그 파일에 병합합니다.
+- 없고 `proxy.conf.json`이 있으면 그 파일에 병합합니다.
+- 둘 다 없으면 `ngx-locatorjs.proxy.json`을 생성합니다.
 
 예시:
+
 ```json
 {
   "/__open-in-editor": {
@@ -164,26 +181,28 @@ bootstrapApplication(AppComponent, appConfig)
 ```
 
 **트러블슈팅**
+
 1. CORS 에러
-`ng serve --proxy-config ngx-locatorjs.proxy.json` 사용 여부 확인
+   `ng serve --proxy-config {proxyConfigPath}` 사용 여부 확인
 2. npm run 경고
-`npm run start -- --proxy-config ngx-locatorjs.proxy.json` 형태로 실행
+   `npm run start -- --proxy-config {proxyConfigPath}` 형태로 실행
 3. 네트워크 비활성
-`installAngularLocator({ enableNetwork: true })` 설정 확인
+   `installAngularLocator({ enableNetwork: true })` 설정 확인
 4. component-map.json not found
-`npx locatorjs-scan` 실행 후 `.open-in-editor/component-map.json` 생성 여부 확인
+   `npx locatorjs-scan` 실행 후 `.open-in-editor/component-map.json` 생성 여부 확인
 5. 컴포넌트 변경이 반영되지 않음
-`npx locatorjs-open-in-editor --watch` 사용 또는 `npx locatorjs-scan` 재실행
+   `npx locatorjs-open-in-editor --watch` 사용 또는 `npx locatorjs-scan` 재실행
 6. 스캔 결과가 비어있거나 컴포넌트가 누락됨
-`scan.includeGlobs` 경로 확인 후 재스캔. 실제 컴포넌트들이 위치한 경로를 입력해야 합니다.
+   `scan.includeGlobs` 경로 확인 후 재스캔. 실제 컴포넌트들이 위치한 경로를 입력해야 합니다.
 7. 잘못된 파일이 열리거나 매칭이 안 됨
-`workspaceRoot`가 Angular 앱 루트인지 확인
+   `workspaceRoot`가 Angular 앱 루트인지 확인
 8. 하이라이트가 안 보이거나 info가 null로 나옴
-`http://localhost:${port}/__cmp-map` 에서 컴포넌트 정보가 잘 나타나는지 확인
+   `http://localhost:${port}/__cmp-map` 에서 컴포넌트 정보가 잘 나타나는지 확인
 9. 포트 충돌
-`ngx-locatorjs.config.json`과 `ngx-locatorjs.proxy.json`에서 포트 일치 여부 확인
+   `ngx-locatorjs.config.json`과 `{proxyConfigPath}`에서 포트 일치 여부 확인
 
 **주의**
+
 - 개발 모드에서만 사용하세요. 프로덕션 번들에 포함되지 않도록 `environment.production` 체크를 권장합니다.
 - 네트워크 요청은 opt-in이며 localhost로만 제한됩니다. `enableNetwork: true`로 활성화하세요.
 
@@ -191,6 +210,7 @@ bootstrapApplication(AppComponent, appConfig)
 file-opener 서버와 Angular dev server를 한 번에 띄우려면 아래 방식 중 하나를 사용하세요.
 
 ### Option A: `concurrently`
+
 ```bash
 npm i -D concurrently
 ```
@@ -198,12 +218,13 @@ npm i -D concurrently
 ```json
 {
   "scripts": {
-    "dev:locator": "concurrently -k -n opener,ng \"npx locatorjs-open-in-editor\" \"ng serve --proxy-config ngx-locatorjs.proxy.json\""
+    "dev:locator": "concurrently -k -n opener,ng \"npx locatorjs-open-in-editor\" \"ng serve --proxy-config {proxyConfigPath}\""
   }
 }
 ```
 
 ### Option B: `npm-run-all`
+
 ```bash
 npm i -D npm-run-all
 ```
@@ -212,8 +233,15 @@ npm i -D npm-run-all
 {
   "scripts": {
     "locator:opener": "npx locatorjs-open-in-editor",
-    "dev:app": "ng serve --proxy-config ngx-locatorjs.proxy.json",
+    "dev:app": "ng serve --proxy-config {proxyConfigPath}",
     "dev:locator": "run-p locator:opener dev:app"
   }
 }
 ```
+
+** 고민 **
+
+처음 세팅할 때 귀찮은 단계가 많다고 느낍니다.
+설치하고, `npx locatorjs-config`를 돌리고, `main.ts`에 훅을 넣고, opener와 dev server를 proxy 설정과 함께 실행..
+
+이 흐름을 더 짧고 자연스럽게 만들고 싶습니다. 의견은 언제나 환영합니다.

package/README.md

@@ -5,6 +5,7 @@
 한국어 문서: [README.ko.md](README.ko.md)
 
 Open Angular component files directly from the browser with **Alt + Click** during development. This package provides:
+
 - Browser runtime for Alt+click / hover UI
 - CLI tools to scan Angular components and open files in your editor
 - Config + proxy setup guidance
@@ -12,29 +13,34 @@ Open Angular component files directly from the browser with **Alt + Click** duri
 Inspired by [locatorjs.com](https://www.locatorjs.com/).
 
 ## Features
+
 - **Alt + Click**: open template (.html)
 - **Alt + Shift + Click**: open component (.ts)
 - **Hold Alt**: highlight component + tooltip
-- Supports **Cursor**, **VS Code**, **WebStorm**
+- Supports **Antigravity IDE**, **Cursor**, **Zed**, **VS Code**, **WebStorm**
 
 ## Install
+
 ```bash
 npm i -D ngx-locatorjs
 ```
 
 ## Required Steps (Do This First)
+
 You must complete steps 1–4 for this to work.
 
 1. Install the package: `npm i -D ngx-locatorjs`
 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`
+4. Run the file-opener server and your dev server (keep both running): `npx locatorjs-open-in-editor --watch` + `ng serve --proxy-config {proxyConfigPath}`
 
-If you use `npm run start`, pass args after `--`: `npm run start -- --proxy-config ngx-locatorjs.proxy.json`
+If you use `npm run start`, pass args after `--`: `npm run start -- --proxy-config {proxyConfigPath}`
+Replace `{proxyConfigPath}` with the actual proxy file path selected/updated by `npx locatorjs-config`.
 
 ## Add to `main.ts`
 
 ### NgModule bootstrap
+
 ```ts
 import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
 import { AppModule } from './app/app.module';
@@ -51,8 +57,8 @@ platformBrowserDynamic()
     if (!environment.production) {
       setTimeout(() => {
         import('ngx-locatorjs')
-          .then((m) =>
-            m.installAngularLocator({ enableNetwork: true }), // required for network access (localhost-only)
+          .then(
+            (m) => m.installAngularLocator({ enableNetwork: true }), // required for network access (localhost-only)
           )
           .catch((err) => console.warn('[angular-locator] Failed to load:', err));
       }, 1000);
@@ -62,6 +68,7 @@ platformBrowserDynamic()
 ```
 
 ### Standalone bootstrap
+
 ```ts
 import { bootstrapApplication } from '@angular/platform-browser';
 import { appConfig } from './app/app.config';
@@ -71,8 +78,8 @@ bootstrapApplication(AppComponent, appConfig)
   .then(() => {
     setTimeout(() => {
       import('ngx-locatorjs')
-        .then((m) =>
-          m.installAngularLocator({ enableNetwork: true }), // required for network access (localhost-only)
+        .then(
+          (m) => m.installAngularLocator({ enableNetwork: true }), // required for network access (localhost-only)
         )
         .catch((err) => console.warn('[angular-locator] Failed to load:', err));
     }, 1000);
@@ -81,34 +88,31 @@ bootstrapApplication(AppComponent, appConfig)
 ```
 
 ## Config Guide (`ngx-locatorjs.config.json`)
+
 Location: project root
 
 **Important**
+
 - `npx locatorjs-config` uses the **current directory** as the base.
 - 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, // 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
+  "port": 4123,
+  "workspaceRoot": ".",
+  "editor": "cursor",
+  "fallbackEditor": "code",
   "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/**",
@@ -122,15 +126,31 @@ Example:
 }
 ```
 
+### Field Reference
+
+- `port`: Port for the local file-opener server.
+- `workspaceRoot`: Angular workspace root path (relative to where you run commands).
+- `editor`: Preferred editor (`cursor`, `zed`, `antigravity`, `code`, `webstorm`).
+- `fallbackEditor`: Fallback editor if the preferred editor cannot be launched.
+- `scan.includeGlobs`: Globs used to find component source files.
+- `scan.excludeGlobs`: Globs excluded from component scanning.
+
 ### Example includeGlobs
+
 - Simple app: `"src/app/**/*.ts"`
 - Angular workspace: `"projects/**/*.{ts,tsx}"`
 - Nx: `"apps/**/*.{ts,tsx}", "libs/**/*.{ts,tsx}"`
 
-## Proxy (`ngx-locatorjs.proxy.json`)
-Generated by `npx locatorjs-config`. If a proxy file is already referenced in `angular.json` or `proxy.conf.json` exists, it will merge entries there. Otherwise it creates `ngx-locatorjs.proxy.json`.
+## Proxy (`{proxyConfigPath}`)
+
+`{proxyConfigPath}` is decided by `npx locatorjs-config`:
+
+- If `angular.json` already specifies `proxyConfig`, it updates that file.
+- Else if `proxy.conf.json` exists, it updates that file.
+- Otherwise it creates `ngx-locatorjs.proxy.json`.
 
 Example:
+
 ```json
 {
   "/__open-in-editor": {
@@ -152,30 +172,35 @@ Example:
 ```
 
 ## Environment Variable Priority
+
 1. `EDITOR_CMD` (example: `cursor --goto`)
 2. `LAUNCH_EDITOR` (example: `code`)
 3. `ngx-locatorjs.config.json` → `editor`
 4. auto-detected editor
 
 ## 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`
+
+- **CORS / JSON parse error**: ensure dev server uses `--proxy-config {proxyConfigPath}`
+- **npm run shows "Unknown cli config --proxy-config"**: use `npm run start -- --proxy-config {proxyConfigPath}`
 - **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 `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`
+- **Port conflict**: change port in both `ngx-locatorjs.config.json` and `{proxyConfigPath}`
 
 ## 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.
 
 ### Option A: `concurrently`
+
 ```bash
 npm i -D concurrently
 ```
@@ -183,12 +208,13 @@ npm i -D concurrently
 ```json
 {
   "scripts": {
-    "dev:locator": "concurrently -k -n opener,ng \"npx locatorjs-open-in-editor\" \"ng serve --proxy-config ngx-locatorjs.proxy.json\""
+    "dev:locator": "concurrently -k -n opener,ng \"npx locatorjs-open-in-editor\" \"ng serve --proxy-config {proxyConfigPath}\""
   }
 }
 ```
 
 ### Option B: `npm-run-all`
+
 ```bash
 npm i -D npm-run-all
 ```
@@ -197,16 +223,27 @@ npm i -D npm-run-all
 {
   "scripts": {
     "locator:opener": "npx locatorjs-open-in-editor",
-    "dev:app": "ng serve --proxy-config ngx-locatorjs.proxy.json",
+    "dev:app": "ng serve --proxy-config {proxyConfigPath}",
     "dev:locator": "run-p locator:opener dev:app"
   }
 }
 ```
 
 ## What It Can Do
+
 - Open template or component files with Alt+click in development
 - Show component highlight and tooltip while holding Alt
 - Works with single apps, Angular workspace, and Nx layouts
 
 ## Limitations
+
 - Not supported in SSR/SSG runtime (browser DOM only)
+
+## Maintainer Note (Setup UX)
+
+Current setup works, but the first-time flow still feels too manual. You install, run
+`npx locatorjs-config`, add the bootstrap hook in `main.ts`, and then run opener + dev server
+with proxy config.
+
+This is an area we want to keep improving. Contributions that reduce setup friction are welcome,
+especially around safer automation, clearer defaults, and better error guidance.

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,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"}
+{"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;AAkBF,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,CA2B9D;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/node/cmp-scan.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
-import { Project, SyntaxKind } from 'ts-morph';
+import ts from 'typescript';
 import fs from 'fs';
 import path from 'path';
+import { glob } from 'glob';
 const DEFAULT_INCLUDE_GLOBS = [
     'src/**/*.{ts,tsx}',
     'projects/**/*.{ts,tsx}',
@@ -31,28 +32,71 @@ function readConfig() {
 function toPosix(p) {
     return p.replace(/\\/g, '/');
 }
-function prefixWorkspaceRoot(glob, workspaceRoot) {
+function prefixWorkspaceRoot(globPattern, workspaceRoot) {
     if (!workspaceRoot || workspaceRoot === '.' || workspaceRoot === './')
-        return glob;
-    if (path.isAbsolute(glob))
-        return glob;
+        return globPattern;
+    if (path.isAbsolute(globPattern))
+        return globPattern;
     const rootPosix = toPosix(workspaceRoot).replace(/\/+$/, '');
-    const globPosix = toPosix(glob).replace(/^\/+/, '');
+    const globPosix = toPosix(globPattern).replace(/^\/+/, '');
     if (globPosix.startsWith(rootPosix + '/'))
         return globPosix;
     return `${rootPosix}/${globPosix}`;
 }
-function globToNeedle(glob) {
-    return toPosix(glob).replace(/\*\*/g, '').replace(/\*/g, '');
+function extractTemplateUrl(node) {
+    for (const prop of node.properties) {
+        if (ts.isPropertyAssignment(prop) &&
+            ts.isIdentifier(prop.name) &&
+            prop.name.text === 'templateUrl') {
+            const initializer = prop.initializer;
+            if (ts.isStringLiteral(initializer)) {
+                return initializer.text;
+            }
+        }
+    }
+    return undefined;
+}
+function findComponentDecorator(node) {
+    if (!node.modifiers)
+        return undefined;
+    for (const modifier of node.modifiers) {
+        if (ts.isDecorator(modifier)) {
+            const expr = modifier.expression;
+            if (ts.isCallExpression(expr) && ts.isIdentifier(expr.expression)) {
+                if (expr.expression.text === 'Component') {
+                    return modifier;
+                }
+            }
+        }
+    }
+    return undefined;
 }
-function isExcluded(filePath, excludeGlobs) {
-    const normalized = toPosix(filePath);
-    return excludeGlobs.some((pattern) => {
-        const needle = globToNeedle(pattern);
-        if (!needle)
-            return false;
-        return normalized.includes(needle);
-    });
+function parseSourceFile(filePath, sourceCode) {
+    const sourceFile = ts.createSourceFile(filePath, sourceCode, ts.ScriptTarget.Latest, true);
+    const components = [];
+    function visit(node) {
+        if (ts.isClassDeclaration(node) && node.name) {
+            const componentDecorator = findComponentDecorator(node);
+            if (componentDecorator) {
+                const expr = componentDecorator.expression;
+                const firstArg = expr.arguments[0];
+                if (firstArg && ts.isObjectLiteralExpression(firstArg)) {
+                    const templateUrl = extractTemplateUrl(firstArg);
+                    const className = node.name.text;
+                    const absTs = path.resolve(root, filePath);
+                    const absTpl = templateUrl ? path.resolve(path.dirname(absTs), templateUrl) : undefined;
+                    components.push({
+                        className,
+                        filePath: absTs,
+                        templateUrl: absTpl,
+                    });
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return components;
 }
 async function main() {
     const cfg = readConfig();
@@ -88,14 +132,16 @@ async function main() {
         }
         return stats;
     }
-    const project = new Project({
-        skipAddingFilesFromTsConfig: true,
-    });
-    project.addSourceFilesAtPaths(effectiveIncludeGlobs);
-    const sourceFiles = project
-        .getSourceFiles()
-        .filter((sf) => !isExcluded(sf.getFilePath(), excludeGlobs));
-    const filePaths = sourceFiles.map((sf) => sf.getFilePath());
+    const allFiles = [];
+    for (const pattern of effectiveIncludeGlobs) {
+        const files = await glob(pattern, {
+            ignore: excludeGlobs,
+            absolute: true,
+            cwd: root,
+        });
+        allFiles.push(...files);
+    }
+    const filePaths = [...new Set(allFiles)];
     const currentStats = getFileStats(filePaths);
     const previousCache = loadCache();
     const hasChanges = filePaths.some((filePath) => !previousCache[filePath] || previousCache[filePath] !== currentStats[filePath]);
@@ -108,38 +154,16 @@ async function main() {
     }
     const detailByFilePath = {};
     const filePathsByClassName = {};
-    for (const sf of sourceFiles) {
-        const filePath = sf.getFilePath();
-        const classes = sf.getClasses();
-        for (const cls of classes) {
-            const decorators = cls.getDecorators();
-            const comp = decorators.find((d) => d.getName() === 'Component');
-            if (!comp)
-                continue;
-            const arg = comp.getCallExpression()?.getArguments()[0];
-            if (!arg || !arg.asKind(SyntaxKind.ObjectLiteralExpression))
-                continue;
-            const obj = arg.asKindOrThrow(SyntaxKind.ObjectLiteralExpression);
-            const templateUrlProp = obj.getProperty('templateUrl');
-            const templateUrl = templateUrlProp
-                ?.asKind(SyntaxKind.PropertyAssignment)
-                ?.getInitializer()
-                ?.getText()
-                .replace(/^`|^'|^"|"|'|`$/g, '');
-            const className = cls.getName();
-            if (!className)
-                continue;
-            const absTs = path.resolve(root, filePath);
-            const absTpl = templateUrl ? path.resolve(path.dirname(absTs), templateUrl) : undefined;
-            detailByFilePath[absTs] = {
-                className,
-                filePath: absTs,
-                templateUrl: absTpl,
-            };
-            if (!filePathsByClassName[className])
-                filePathsByClassName[className] = [];
-            if (!filePathsByClassName[className].includes(absTs)) {
-                filePathsByClassName[className].push(absTs);
+    for (const filePath of filePaths) {
+        const sourceCode = fs.readFileSync(filePath, 'utf8');
+        const components = parseSourceFile(filePath, sourceCode);
+        for (const cmp of components) {
+            detailByFilePath[cmp.filePath] = cmp;
+            if (!filePathsByClassName[cmp.className]) {
+                filePathsByClassName[cmp.className] = [];
+            }
+            if (!filePathsByClassName[cmp.className].includes(cmp.filePath)) {
+                filePathsByClassName[cmp.className].push(cmp.filePath);
             }
         }
     }

package/dist/node/config-setup.js

@@ -94,7 +94,8 @@ async function startSetup() {
         }
     }
     catch (error) {
-        console.error('\n❌ Setup failed:', error?.message || error);
+        const message = error instanceof Error ? error.message : String(error);
+        console.error('\n❌ Setup failed:', message);
         process.exit(1);
     }
 }
@@ -156,7 +157,7 @@ function findProxyConfigFromAngularJson() {
         const angularJson = JSON.parse(fs.readFileSync(angularJsonPath, 'utf8'));
         const projects = angularJson?.projects ?? {};
         for (const project of Object.values(projects)) {
-            const targets = project?.architect || project?.targets;
+            const targets = project.architect || project.targets;
             const serve = targets?.serve;
             if (!serve)
                 continue;
@@ -202,6 +203,8 @@ function logDefaults() {
 function selectEditor() {
     const availableEditors = [
         { name: 'Cursor', value: 'cursor' },
+        { name: 'Zed', value: 'zed' },
+        { name: 'Antigravity IDE', value: 'antigravity' },
         { name: 'VS Code', value: 'code' },
         { name: 'WebStorm', value: 'webstorm' },
     ];
@@ -215,7 +218,7 @@ function selectEditor() {
             output: process.stdout,
         });
         return new Promise((resolve) => {
-            rl.question('\nEnter number (1-3, default: 1 for Cursor): ', (answer) => {
+            rl.question('\nEnter number (1-5, default: 1 for Cursor): ', (answer) => {
                 rl.close();
                 const choice = parseInt(answer.trim(), 10) || 1;
                 const selected = availableEditors[Math.max(0, Math.min(choice - 1, availableEditors.length - 1))];
@@ -253,7 +256,7 @@ function selectEditor() {
                     renderMenu();
                     break;
                 case '\r':
-                case '\n':
+                case '\n': {
                     process.stdin.setRawMode(false);
                     process.stdin.pause();
                     process.stdin.removeListener('data', handleKeypress);
@@ -261,6 +264,7 @@ function selectEditor() {
                     console.log(`\n✨ Selected: ${selected.name}`);
                     resolve(selected.value);
                     break;
+                }
                 case '\u0003':
                     console.log('\n\nCancelled. Setting Cursor as default.');
                     process.stdin.setRawMode(false);

package/dist/node/file-opener.js

@@ -16,6 +16,9 @@ if (!fs.existsSync(configPath)) {
     console.log('Or manually create the config file.');
     process.exit(1);
 }
+function isErrnoException(error) {
+    return typeof error === 'object' && error !== null && 'code' in error;
+}
 const DEFAULT_INCLUDE_GLOBS = [
     'src/**/*.{ts,tsx}',
     'projects/**/*.{ts,tsx}',
@@ -46,12 +49,14 @@ function checkEditorCLI(editorName, cliCommand = editorName) {
     return editorCLICache[editorName];
 }
 const MAC_APP_NAMES = {
+    antigravity: 'Antigravity IDE',
     cursor: 'Cursor',
     code: 'Visual Studio Code',
+    zed: 'Zed',
     webstorm: 'WebStorm',
 };
 function detectAvailableEditors() {
-    const editors = ['cursor', 'code', 'webstorm'];
+    const editors = ['cursor', 'zed', 'antigravity', 'code', 'webstorm'];
     const available = [];
     for (const editor of editors) {
         if (checkEditorCLI(editor)) {
@@ -61,9 +66,18 @@ function detectAvailableEditors() {
     return available;
 }
 const AVAILABLE_EDITORS = detectAvailableEditors();
-const DEFAULT_EDITOR = process.env.LAUNCH_EDITOR || cfg.editor || AVAILABLE_EDITORS[0]?.name || 'cursor';
-const FALLBACK_EDITOR = cfg.fallbackEditor || AVAILABLE_EDITORS[1]?.name || 'code';
+const DEFAULT_EDITOR = process.env.LAUNCH_EDITOR || cfg.editor || 'cursor';
+const FALLBACK_EDITOR = cfg.fallbackEditor ||
+    AVAILABLE_EDITORS.find((editor) => editor.name !== DEFAULT_EDITOR)?.name ||
+    'code';
 const COMMAND_TEMPLATES = {
+    antigravity: (file) => {
+        if (checkEditorCLI('antigravity')) {
+            return ['antigravity', ['--goto', file]];
+        }
+        const filePath = file.split(':')[0];
+        return ['open', ['-a', MAC_APP_NAMES.antigravity, filePath]];
+    },
     cursor: (file) => {
         if (checkEditorCLI('cursor')) {
             return ['cursor', ['--goto', file]];
@@ -78,6 +92,13 @@ const COMMAND_TEMPLATES = {
         const filePath = file.split(':')[0];
         return ['open', ['-a', MAC_APP_NAMES.code, filePath]];
     },
+    zed: (file) => {
+        if (checkEditorCLI('zed')) {
+            return ['zed', [file]];
+        }
+        const filePath = file.split(':')[0];
+        return ['open', ['-a', MAC_APP_NAMES.zed, filePath]];
+    },
     webstorm: (file) => {
         if (checkEditorCLI('webstorm')) {
             const [filePath, line, col] = file.split(':');
@@ -100,7 +121,8 @@ function launchInEditor(fileWithPos, preferred = DEFAULT_EDITOR) {
             return true;
         }
         catch (e) {
-            console.log(`[file-opener] EDITOR_CMD failed: ${e.message}`);
+            const message = e instanceof Error ? e.message : String(e);
+            console.log(`[file-opener] EDITOR_CMD failed: ${message}`);
         }
     }
     const tryRun = (editor) => {
@@ -113,7 +135,8 @@ function launchInEditor(fileWithPos, preferred = DEFAULT_EDITOR) {
             return true;
         }
         catch (e) {
-            console.log(`[file-opener] ${editor} failed: ${e.message}`);
+            const message = e instanceof Error ? e.message : String(e);
+            console.log(`[file-opener] ${editor} failed: ${message}`);
             return false;
         }
     };
@@ -155,7 +178,8 @@ function findBestLineInFile(filePath, searchTerms) {
         return bestScore > 0 ? bestLine : 1;
     }
     catch (e) {
-        console.warn(`[file-opener] Failed to search in file: ${e.message}`);
+        const message = e instanceof Error ? e.message : String(e);
+        console.warn(`[file-opener] Failed to search in file: ${message}`);
         return 1;
     }
 }
@@ -215,7 +239,8 @@ function startScanWatch() {
             watchers.push(watcher);
         }
         catch (err) {
-            console.log(`[file-opener] failed to watch ${watchPath}: ${err?.message || err}`);
+            const message = err instanceof Error ? err.message : String(err);
+            console.log(`[file-opener] failed to watch ${watchPath}: ${message}`);
             throw err;
         }
     };
@@ -321,9 +346,10 @@ const server = http.createServer((req, res) => {
             res.end(`Opened at line ${bestLine}`);
         }
         catch (e) {
-            console.warn(`[file-opener] Search error: ${e.message}`);
+            const message = e instanceof Error ? e.message : String(e);
+            console.warn(`[file-opener] Search error: ${message}`);
             res.statusCode = 500;
-            res.end('Search failed: ' + e.message);
+            res.end('Search failed: ' + message);
         }
         return;
     }
@@ -347,7 +373,7 @@ server
     }
 })
     .on('error', (err) => {
-    if (err.code === 'EADDRINUSE') {
+    if (isErrnoException(err) && err.code === 'EADDRINUSE') {
         console.log(`[file-opener] Port ${PORT} already in use - another file:opener is already running`);
         process.exit(0);
     }

package/package.json

@@ -1,25 +1,34 @@
 {
   "name": "ngx-locatorjs",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "LocatorJs open-in-editor tools for Angular projects",
-  "author": "antepost24",
-  "type": "module",
-  "license": "MIT",
   "keywords": [
     "angular",
-    "locatorjs",
-    "open-in-editor",
+    "component",
     "devtools",
-    "component"
+    "locatorjs",
+    "open-in-editor"
   ],
+  "homepage": "https://github.com/Ea-st-ring/ngx-locator#readme",
+  "bugs": {
+    "url": "https://github.com/Ea-st-ring/ngx-locator/issues"
+  },
+  "license": "MIT",
+  "author": "antepost24",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Ea-st-ring/ngx-locator.git"
   },
-  "bugs": {
-    "url": "https://github.com/Ea-st-ring/ngx-locator/issues"
+  "bin": {
+    "locatorjs-config": "dist/node/config-setup.js",
+    "locatorjs-open-in-editor": "dist/node/file-opener.js",
+    "locatorjs-scan": "dist/node/cmp-scan.js"
   },
-  "homepage": "https://github.com/Ea-st-ring/ngx-locator#readme",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
   "main": "dist/browser/index.js",
   "types": "dist/browser/index.d.ts",
   "exports": {
@@ -34,35 +43,21 @@
       "default": "./dist/browser/auto.js"
     }
   },
-  "bin": {
-    "locatorjs-open-in-editor": "dist/node/file-opener.js",
-    "locatorjs-config": "dist/node/config-setup.js",
-    "locatorjs-scan": "dist/node/cmp-scan.js"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
   "scripts": {
     "build": "npm run build:browser && npm run build:node",
     "build:browser": "tsc -p tsconfig.browser.json",
     "build:node": "tsc -p tsconfig.node.json",
     "clean": "rm -rf dist",
     "prepare": "npm run build",
-    "lint": "eslint \"src/**/*.{ts,tsx}\"",
-    "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,md}\"",
-    "format:check": "prettier --check \"**/*.{ts,tsx,js,jsx,json,md}\""
+    "format": "oxfmt",
+    "format:check": "oxfmt --check"
   },
   "dependencies": {
-    "ts-morph": "^27.0.0"
+    "glob": "^13.0.6"
   },
   "devDependencies": {
-    "@typescript-eslint/eslint-plugin": "^7.18.0",
-    "@typescript-eslint/parser": "^7.18.0",
     "@types/node": "^18.18.0",
-    "eslint": "^8.57.1",
-    "eslint-config-prettier": "^9.1.0",
-    "prettier": "^3.2.5",
+    "oxfmt": "^0.35.0",
     "typescript": "^5.5.4"
   }
 }