@simplysm/sd-claude 14.0.97 → 14.0.99

package/claude/references/sd-simplysm14/apis/excel/wrapper.md

@@ -1,14 +1,14 @@
 # @simplysm/excel — ExcelWrapper
 
-Zod 스키마로 엑셀 헤더 ↔ 필드 매핑, 셀 값 타입 변환, 행 단위 유효성 검사를 자동화해 "레코드 배열 ↔ 엑셀" 변환을 한 번에 처리할 때 쓰는 고수준 래퍼. 헤더 텍스트는 각 필드의 `.describe()` 로 지정하며, 미지정 필드는 키 이름을 헤더로 쓴다. 표준 입력 양식 업로드/다운로드 같은 정형 변환에 적합.
+Zod 스키마로 엑셀 헤더 ↔ 필드 매핑, 셀 값 타입 변환, 행 단위 유효성 검사를 자동화해 "레코드 배열 ↔ 엑셀" 변환을 한 번에 처리하는 고수준 래퍼. 헤더 텍스트는 각 필드의 `.describe()` 로 지정하며, 미지정 필드는 키 이름을 헤더로 쓴다. 클라이언트 화면의 엑셀 다운로드(`write`)·업로드(`read`)에서 같은 wrapper 인스턴스를 공유하는 패턴에 쓰인다.
 
-## 생성자
+## 생성
 
 ```typescript
-new ExcelWrapper<TSchema extends z.ZodObject<z.ZodRawShape>>(schema: TSchema)
+new ExcelWrapper<TSchema extends z.ZodObject>(_schema: TSchema)
 ```
 
-- `schema: TSchema` — 레코드 구조를 정의하는 Zod 객체 스키마. 각 필드에 `.describe("헤더이름")` 으로 엑셀 헤더 표시명을 지정한다. optional/nullable/default/boolean 여부가 읽기 기본값·필수 강조·타입 변환 동작을 결정한다.
+- `_schema` — Zod 객체 스키마. 각 필드가 한 컬럼이 되고, `.describe("헤더명")` 으로 엑셀 헤더를 지정한다.
 
 ## read
 
@@ -20,19 +20,13 @@ read(
 ): Promise<z.infer<TSchema>[]>
 ```
 
-- `file: Bytes | Blob` — 읽을 .xlsx 데이터.
-- `wsNameOrIndex: string | number` — 읽을 시트 이름 또는 0 기반 인덱스. 기본 `0`(첫 시트).
-- `options.excludes?: (keyof Schema)[]` — 매핑에서 제외할 필드 키 배열. 해당 헤더는 읽지 않음.
+엑셀 파일을 레코드 배열로 읽는다. 헤더는 스키마 displayName(`.describe()`)으로 매칭한 컬럼만 채택. 전부 빈 값인 행은 건너뛴다. 각 행을 스키마로 `safeParse` 하며 실패 시 시트명 + 상세 메시지로 throw. 데이터가 0건이면 throw. 내부에서 워크북을 열고 finally 로 `close` 까지 책임진다.
 
-동작: 스키마 표시명 집합에 해당하는 헤더만 골라 데이터 테이블을 읽고, 각 행을 필드 키로 역매핑한 뒤 값 변환 → Zod `safeParse` 검증한다. 빈/누락 값은 스키마 기본값 규칙(아래)으로 채우고, 한 행의 모든 매핑 값이 비면 그 행은 건너뛴다. 데이터가 0건이거나 검증 실패면 시트명을 포함해 throw(부분 반영 없이 전체 중단). 워크북은 내부에서 열고 finally 로 닫는다.
+- `file` — 엑셀 바이트 또는 Blob.
+- `wsNameOrIndex` — 읽을 시트 이름 또는 0 기반 인덱스(기본 0).
+- `options.excludes` — 읽기에서 제외할 필드 키 배열(파생 컬럼 등). 매핑·파싱에서 빠진다.
 
-값 변환 규칙(빈/누락이 아닌 값에 적용, optional/nullable/default 는 내부 타입으로 unwrap 후 판정):
-
-- `ZodString` → 문자열(비문자열은 `String()`).
-- `ZodNumber` → `num.parseFloat`.
-- `ZodBoolean` → `"1"`/`"true"`→`true`, `"0"`/`"false"`→`false`, 그 외 `Boolean()`.
-- `DateOnly`/`DateTime`/`Time` 인스턴스 → 그대로 보존.
-- 빈/누락 값(`null`/`""`) → 스키마 기본값: `ZodDefault` 면 그 기본값, optional/nullable 면 `undefined`, 필수 boolean 이면 `false`, 그 외 `undefined`.
+값 변환: 빈 셀/빈 문자열은 `ZodDefault` 면 기본값, `optional`/`nullable` 이면 `undefined`, 필수 boolean 이면 `false` 로 채운다. 그 외에는 스키마 inner 타입(String/Number/Boolean)에 맞춰 변환(`"1"`/`"true"` → `true` 등), `DateOnly`/`DateTime`/`Time` 인스턴스는 그대로 보존.
 
 ## write
 
@@ -44,37 +38,43 @@ write(
 ): Promise<ExcelWorkbook>
 ```
 
-- `wsName: string` — 만들 시트 이름.
-- `records: Partial<Schema>[]` — 출력할 레코드 배열(부분 객체 허용 — 누락 키는 빈 셀).
-- `options.excludes?: (keyof Schema)[]` — 출력에서 제외할 필드 키 배열.
+레코드 배열을 엑셀 워크북으로 변환해 반환. 0 행에 헤더, 이후 행에 데이터를 쓰고, 표 전체에 테두리, 필수(non-optional/nullable/default)이면서 boolean 이 아닌 필드 헤더에 노란 배경(`00FFFF00`)을 칠한다. zoom 85%, 0 행 틀고정, 헤더~데이터 전체 범위 자동 필터를 설정한다. 변환 중 예외 발생 시 워크북을 `close` 하고 re-throw 한다(부분 산출물 방지).
 
-동작: 새 워크북에 시트 1개를 만들고, 0행에 표시명 헤더, 1행부터 각 레코드 값을 스키마 키 순서대로 쓴다. 전체 표에 4변 테두리, 필수(non-optional·non-nullable·non-default)이며 boolean 이 아닌 필드의 헤더 셀에 노란 배경(`"00FFFF00"`) 강조, zoom 85%, 0행 틀고정, 표 전체 범위(헤더행~마지막 데이터행)에 헤더 자동 필터(드롭다운)를 적용한다. **반환된 워크북의 close 는 호출자 책임** — 사용 후 반드시 `close()`(write 내부에서 실패 시에는 직접 close 후 rethrow).
+- `wsName` — 생성할 시트 이름.
+- `records` — 쓸 레코드 배열(`Partial` — 일부 필드 누락 허용).
+- `options.excludes` — 컬럼에서 제외할 필드 키 배열.
 
-## 사용 예
+반환된 워크북의 리소스 관리는 호출자 책임 — 사용 후 `close()` 해야 한다.
 
-```typescript
-const schema = z.object({
-  code: z.string().describe("코드"),
-  qty: z.number().describe("수량"),
-  note: z.string().optional().describe("비고"),
-});
-const wrapper = new ExcelWrapper(schema);
+## 사용 예
 
-// 읽기
-const records = await wrapper.read(bytes, "입력", { excludes: ["note"] });
+다운로드/업로드에서 같은 wrapper 를 공유한다.
 
-// 쓰기 (워크북 close 는 호출자 책임)
-const wb = await wrapper.write("결과", records);
+```typescript
+private readonly _excelWrapper = new ExcelWrapper(
+  z.object({
+    id: z.number().optional().describe("ID"),
+    name: z.string().describe("이름"),
+    lastModifiedAt: z.instanceof(DateTime).optional().describe("수정일시"),
+  }),
+);
+
+// 다운로드
+const wb = await this._excelWrapper.write(this.viewTitle(), items);
 try {
-  const bytes = await wb.toBytes();
+  downloadBlob(await wb.toBlob(), `${this.viewTitle()}_${new DateTime().toFormatString("yyMMdd")}.xlsx`);
 } finally {
   await wb.close();
 }
+
+// 업로드 (파생 컬럼은 제외)
+const records = await this._excelWrapper.read(files[0], 0, {
+  excludes: ["lastModifiedAt"],
+});
 ```
 
 ## 주의사항
 
-- 헤더 매핑은 `.describe()` 값(미지정 시 키)이 엑셀 헤더 텍스트와 정확히 일치해야 한다. 매핑되는 헤더가 한 행 내 중복이거나 데이터가 0건이면 throw.
-- `read` 는 행 단위 Zod 검증을 거치므로, 한 행이라도 스키마 위반이면 전체가 throw(부분 결과 없음).
-- `write` 의 필수 헤더 노랑 강조는 "필수 입력 칸" 안내 목적 — optional/nullable/default 또는 boolean 필드는 강조되지 않는다.
-- 결측 보존: optional/nullable 필드의 빈 값은 `undefined` 로 유지된다(임의 치환 없음). 필수 boolean 만 `false` 로 채워진다.
+- `write` 반환 워크북은 호출자가 `close()` 해야 한다(`read` 는 내부에서 자동 close).
+- 빈 데이터(0건) 읽기·스키마 검증 실패는 silent skip 없이 throw — 부분 처리하지 않는다.
+- 다운로드 파일명·`downloadBlob` 사용법은 client-crud 매뉴얼 및 [core-browser README](../core-browser/README.md) 참조.

package/claude/references/sd-simplysm14/apis/lint/README.md

@@ -1,23 +1,21 @@
 # @simplysm/lint
 
-심플리즘 전용 ESLint 자산 패키지. 커스텀 규칙 9종을 담은 플러그인과, 그 규칙들에 typescript-eslint·angular-eslint·import·unused-imports 를 결합한 flat config 프리셋을 제공. `src/index.ts` 는 없음 — `package.json` 의 `exports` 두 subpath(`./eslint-plugin`, `./eslint-recommended`)만 진입점이며 패키지 루트 import 는 없음.
+심플리즘 전용 ESLint 자산. 커스텀 규칙 9종을 담은 플러그인과, 그 규칙들에 typescript-eslint·angular-eslint·import·unused-imports 를 결합한 flat config 프리셋을 제공. `src/index.ts` 는 없고, `package.json` 의 `exports` 두 subpath(`./eslint-plugin`, `./eslint-recommended`)만 진입점이다. 두 진입점 모두 `default` export 만 가진다.
 
 ## 사용 트리거 인덱스
 
-- **eslint-recommended** (`@simplysm/lint/eslint-recommended`) — 프로젝트 `eslint.config.ts` 에서 그대로 spread 해 쓰는 완성형 flat config 배열. JS/TS/HTML/tests 파일 패턴별 활성 규칙·심각도·ignore·플러그인·Angular 통합과 금지 globals/imports/syntax 를 확인할 때. 자세히: [recommended.md](./recommended.md)
-- **eslint-plugin** (`@simplysm/lint/eslint-plugin`) — 커스텀 규칙만 담은 ESLint Plugin 객체(`{ rules }`). recommended 를 쓰지 않고 규칙을 직접 골라 등록할 때, 또는 개별 규칙의 위반 메시지·autofix·옵션 의미를 검토할 때. 자세히: [rules.md](./rules.md)
-
-> 두 진입점 모두 default export 만 가짐. `import recommended from "@simplysm/lint/eslint-recommended"`, `import plugin from "@simplysm/lint/eslint-plugin"` 형태로 사용. 규칙 생성 팩토리 `createRule`(`src/utils/create-rule.ts`, `ESLintUtils.RuleCreator` 래퍼로 문서 URL 자동 부여)는 내부 전용이며 두 진입점 어디로도 재노출되지 않음.
+- **eslint-recommended** (`@simplysm/lint/eslint-recommended`) — 프로젝트 `eslint.config.ts` 에서 그대로 spread 하는 완성형 flat config 배열. 파일 패턴(JS / TS / HTML / tests)별 활성 규칙·심각도·플러그인·ignore·금지 global/import/syntax 를 확인할 때. 자세히: [recommended.md](./recommended.md)
+- **eslint-plugin** (`@simplysm/lint/eslint-plugin`) — 커스텀 규칙만 담은 ESLint Plugin 객체. recommended 를 안 쓰고 규칙을 직접 골라 등록하거나, 개별 규칙의 검사 대상·위반 메시지·autofix·옵션을 검토할 때. 자세히: [rules.md](./rules.md)
 
 ## eslint-plugin
 
-`@simplysm/lint/eslint-plugin` 의 default export. ESLint Plugin 형태 객체 `{ rules }`.
+`@simplysm/lint/eslint-plugin` 의 default export 는 ESLint Plugin 형태 객체 `{ rules: Record<id, Rule> }`. `src/eslint-plugin.ts` 가 9개 규칙을 id 로 묶어 노출한다.
 
 ```typescript
 import plugin from "@simplysm/lint/eslint-plugin";
-// plugin === { rules: { "ng-no-async-effect": ..., "no-hard-private": ..., ... } }
+// flat config 에서: plugins: { "@simplysm": plugin } 매핑 후 "@simplysm/<id>" 로 켬
 ```
 
-- `rules` — 규칙 id → 규칙 객체 맵. 등록된 9개 id: `ng-no-async-effect`, `ng-template-no-strict-null-check`, `ng-template-no-todo-comments`, `ng-template-sd-require-binding-attrs`, `no-hard-private`, `no-subpath-imports-from-simplysm`, `ts-no-throw-not-implemented-error`, `ts-no-unused-injects`, `ts-no-unused-protected-readonly`.
+- `rules` — 규칙 id → 규칙 객체 맵. 등록된 9개 id: `ng-no-async-effect`, `ng-template-no-strict-null-check`, `ng-template-no-todo-comments`, `ng-template-sd-require-binding-attrs`, `no-hard-private`, `no-subpath-imports-from-simplysm`, `ts-no-throw-not-implemented-error`, `ts-no-unused-injects`, `ts-no-unused-protected-readonly`. 각 규칙의 검사 대상·옵션·autofix·메시지는 [rules.md](./rules.md) 참조.
 
-flat config 에서 직접 등록할 때는 `plugins: { "@simplysm": plugin }` 로 매핑 후 `"@simplysm/<id>"` 로 켬. 각 규칙의 검사 대상·옵션·autofix·메시지는 [rules.md](./rules.md) 참조.
+> 규칙 생성 팩토리 `createRule`(`src/utils/create-rule.ts`, `ESLintUtils.RuleCreator` 래퍼로 규칙 문서 URL 자동 부여)는 내부 전용이며 두 진입점 어디로도 재노출되지 않는다.

package/claude/references/sd-simplysm14/apis/lint/recommended.md

@@ -1,60 +1,82 @@
 # @simplysm/lint — recommended
 
-`@simplysm/lint/eslint-recommended` 의 default export. `typescript-eslint` 의 `tseslint.config(...)` 결과 = flat config 객체 배열. 프로젝트 `eslint.config.ts` 에서 그대로 spread 해 표준 lint 세트를 적용할 때 같이 읽는 묶음.
-
-## 사용
+`@simplysm/lint/eslint-recommended` 의 default export 는 `tseslint.config(...)` 결과 = ESLint 9 flat config 객체 배열. 프로젝트 `eslint.config.ts` 에서 그대로 spread 하면 표준 lint 세트가 적용된다. 그 자체로 완성형 배열이라 추가 병합 없이 동작하며, 프로젝트별 규칙은 배열 뒤에 config 객체를 이어 붙인다.
 
 ```typescript
 // eslint.config.ts
 import recommended from "@simplysm/lint/eslint-recommended";
-
 export default [...recommended];
 ```
 
 ## config 블록 (배열 순서대로)
 
-각 블록은 `files` 패턴으로 적용 범위를 한정. 같은 파일이 여러 블록 패턴에 걸리면 규칙이 병합됨.
-
-- **globalIgnores** — 순회 자체를 건너뛸 경로. `**/node_modules/**`, `**/dist/**`, `**/.*/**`(점으로 시작하는 디렉토리 전체). lint 대상에서 완전히 제외할 때.
-- **공통 languageOptions** — `ecmaVersion: "latest"`(최신 ECMAScript 구문 허용), `sourceType: "module"`(ESM 으로 파싱). 전 파일 공통 파서 기준.
-- **JS 블록** (`files: **/*.js, **/*.mjs, **/*.cjs`) — `languageOptions.globals: globals.node`(node 전역 인식), `plugins: import/@simplysm/unused-imports` 등록. 활성 규칙:
-  - `require-await: error` — async 함수 안에 `await` 가 없으면 위반. 불필요한 async 표시 방지.
-  - `no-shadow: error` — 바깥 스코프 변수명을 안쪽에서 가림(shadowing) 금지.
-  - `no-duplicate-imports: error` — 같은 모듈을 여러 import 문으로 중복 import 금지.
-  - `no-unused-expressions: error` — 값을 쓰지 않는 식문(부작용 없는 표현식) 금지.
-  - `no-undef: error` — 선언되지 않은 식별자 참조 금지.
-  - `unused-imports/no-unused-imports: error` — 미사용 import 제거(autofix).
-  - `unused-imports/no-unused-vars: error` — 미사용 변수/인자 금지. `varsIgnorePattern`·`argsIgnorePattern` = `^_`(언더스코어 접두는 의도적 미사용으로 허용), `args: "after-used"`(마지막 사용 인자 뒤만 검사).
-  - `import/no-extraneous-dependencies: error` — `package.json` 의존성에 없는 패키지 import 금지. `devDependencies` 허용 경로: `**/lib/**`, `**/eslint.config.{js,cjs,mjs}`, `**/simplysm.{js,cjs,mjs}`, `**/vitest.config.{js,cjs,mjs}`(빌드·설정 파일은 devDeps 사용 허용).
-  - `@simplysm/no-subpath-imports-from-simplysm: error`, `@simplysm/no-hard-private: error` — 커스텀 규칙(자세히는 [rules.md](./rules.md)).
-  - node 빌트인 차단 규칙군·env 직접접근 차단 규칙군(아래 "공유 규칙 묶음").
-- **angular tsRecommended** — `angular.configs.tsRecommended` spread. angular-eslint 의 TS 권장 세트.
-- **TS 블록** (`files: **/*.ts`) — `processor: angular.processInlineTemplates`(컴포넌트 인라인 템플릿을 추출해 별도 lint), `parser: tseslint.parser` + `parserOptions.project: true`(타입 정보 기반 규칙 활성화 요구), `settings.import/resolver` = typescript resolver(`alwaysTryTypes: true`). 활성 규칙:
-  - typescript-eslint 타입체크 규칙군: `@typescript-eslint/require-await`, `await-thenable`, `return-await(["error","in-try-catch"])`, `no-floating-promises`, `no-shadow`, `no-unnecessary-condition({allowConstantLoopConditions:true})`, `no-unnecessary-type-assertion`, `prefer-reduce-type-parameter`, `prefer-return-this-type`, `no-unused-expressions`, `strict-boolean-expressions({allowNullableBoolean:true, allowNullableObject:true})`, `ban-ts-comment({"ts-expect-error":"allow-with-description", minimumDescriptionLength:3})`, `prefer-readonly`, `naming-convention`(private memberLike 는 `_` 접두 강제), `no-misused-promises({checksVoidReturn:{arguments:false, inheritedMethods:false}})`, `only-throw-error`, `no-array-delete` — 모두 `error`.
-  - `no-console: error` — 콘솔 출력 금지(TS 블록 한정).
-  - `@simplysm` 커스텀 규칙 6종 심각도: `ng-no-async-effect`/`no-hard-private`/`no-subpath-imports-from-simplysm`/`ts-no-unused-injects`/`ts-no-unused-protected-readonly` = `error`, `ts-no-throw-not-implemented-error` = `warn`.
-  - `@angular-eslint/no-output-native: off` — output 명이 네이티브 DOM 이벤트와 겹쳐도 허용.
-  - unused-imports 2종·node 빌트인 차단·env 직접접근 차단 규칙군 + `import/no-extraneous-dependencies: error`(TS 는 예외 경로 없이 전면 적용).
-- **HTML 블록** (`files: **/*.html`) — `extends: angular.configs.templateRecommended + templateAccessibility`. 활성 규칙:
-  - `@simplysm/ng-template-no-strict-null-check: error`, `ng-template-no-todo-comments: warn`, `ng-template-sd-require-binding-attrs: error` — 커스텀 템플릿 규칙(자세히는 [rules.md](./rules.md)).
-  - `@angular-eslint/template/eqeqeq: ["error",{allowNullOrUndefined:true}]` — 템플릿 엄격 비교 강제하되 null/undefined 비교는 예외.
-  - `@angular-eslint/template/label-has-associated-control: off` — label-control 연결 검사 비활성.
-  - `@angular-eslint/template/no-any: error` — 템플릿에서 `$any` 사용 금지.
-- **테스트 오버라이드** (`files: **/tests/**/*.ts`) — 테스트 코드 완화: `no-console: off`, `import/no-extraneous-dependencies: off`, `@simplysm/ts-no-throw-not-implemented-error: off`.
-- **vitest.config 오버라이드** (`files: **/vitest.config.ts`) — `no-restricted-properties: off`(설정 파일에서 `process.env` 접근 허용).
+각 블록은 `files` 패턴으로 적용 범위를 한정하고, 한 파일이 여러 블록에 걸리면 규칙이 병합된다.
+
+### globalIgnores
+
+순회 자체를 건너뛸 경로: `**/node_modules/**`, `**/dist/**`, `**/.*/**`(점으로 시작하는 디렉토리 전체).
+
+### 공통 languageOptions
+
+전 파일 공통: `ecmaVersion: "latest"`(최신 ECMAScript 구문 허용), `sourceType: "module"`(ESM 파싱).
+
+### JS 블록 (`**/*.js`, `**/*.mjs`, `**/*.cjs`)
+
+`globals: globals.node`(node 전역 인식), `import`/`@simplysm`/`unused-imports` 플러그인 등록. 활성 규칙:
+
+- `require-await: error` — async 함수 안에 `await` 없으면 위반.
+- `no-shadow: error` — 바깥 스코프 변수명을 안쪽에서 가림 금지.
+- `no-duplicate-imports: error` — 같은 모듈을 여러 import 문으로 중복 import 금지.
+- `no-unused-expressions: error` — 값을 쓰지 않는 식문 금지.
+- `no-undef: error` — 미선언 식별자 참조 금지.
+- `unused-imports/no-unused-imports: error` — 미사용 import 제거(autofix).
+- `unused-imports/no-unused-vars: error` — 미사용 변수/인자 금지. `varsIgnorePattern`·`argsIgnorePattern` = `^_`(언더스코어 접두는 의도적 미사용으로 허용), `args: "after-used"`(마지막 사용 인자 뒤만 검사).
+- `import/no-extraneous-dependencies: error` — `package.json` 의존성에 없는 패키지 import 금지. `devDependencies` 허용 경로: `**/lib/**`, `**/eslint.config.{js,cjs,mjs}`, `**/simplysm.{js,cjs,mjs}`, `**/vitest.config.{js,cjs,mjs}`.
+- 커스텀: `@simplysm/no-subpath-imports-from-simplysm: error`, `@simplysm/no-hard-private: error`([rules.md](./rules.md)).
+- 공유 묶음: node 빌트인 차단 + env 직접접근 차단(아래 "공유 규칙 묶음").
+
+### angular tsRecommended
+
+`angular.configs.tsRecommended` spread — angular-eslint TS 권장 세트.
+
+### TS 블록 (`**/*.ts`)
+
+`processor: angular.processInlineTemplates`(컴포넌트 인라인 템플릿 추출해 별도 lint), `parser: tseslint.parser` + `parserOptions.project: true`(타입 정보 기반 규칙 활성화), `settings.import/resolver` = typescript resolver(`alwaysTryTypes: true`). 활성 규칙:
+
+- 타입체크 규칙군(모두 `error`): `@typescript-eslint/require-await`, `await-thenable`, `return-await`(`["error","in-try-catch"]`), `no-floating-promises`, `no-shadow`, `no-unnecessary-condition`(`{allowConstantLoopConditions:true}`), `no-unnecessary-type-assertion`, `prefer-reduce-type-parameter`, `prefer-return-this-type`, `no-unused-expressions`, `strict-boolean-expressions`(`{allowNullableBoolean:true, allowNullableObject:true}`), `ban-ts-comment`(`{"ts-expect-error":"allow-with-description", minimumDescriptionLength:3}`), `prefer-readonly`, `naming-convention`(private memberLike 는 `_` 접두 강제), `no-misused-promises`(`{checksVoidReturn:{arguments:false, inheritedMethods:false}}`), `only-throw-error`, `no-array-delete`.
+- `no-console: error` — TS 블록 한정 콘솔 출력 금지.
+- `@simplysm` 커스텀 6종 심각도: `ng-no-async-effect`/`no-hard-private`/`no-subpath-imports-from-simplysm`/`ts-no-unused-injects`/`ts-no-unused-protected-readonly` = `error`, `ts-no-throw-not-implemented-error` = `warn`.
+- `@angular-eslint/no-output-native: off` — output 명이 네이티브 DOM 이벤트와 겹쳐도 허용.
+- 공유 묶음(unused-imports 2종·node 빌트인 차단·env 직접접근 차단) + `import/no-extraneous-dependencies: error`(TS 는 예외 경로 없이 전면 적용).
+
+### HTML 블록 (`**/*.html`)
+
+`extends: angular.configs.templateRecommended + templateAccessibility`. 활성 규칙:
+
+- 커스텀: `@simplysm/ng-template-no-strict-null-check: error`, `ng-template-no-todo-comments: warn`, `ng-template-sd-require-binding-attrs: error`([rules.md](./rules.md)).
+- `@angular-eslint/template/eqeqeq: ["error",{allowNullOrUndefined:true}]` — 템플릿 엄격 비교 강제하되 null/undefined 비교는 예외.
+- `@angular-eslint/template/label-has-associated-control: off` — label-control 연결 검사 비활성.
+- `@angular-eslint/template/no-any: error` — 템플릿에서 `$any` 사용 금지.
+
+### 테스트 오버라이드 (`**/tests/**/*.ts`)
+
+테스트 완화: `no-console: off`, `import/no-extraneous-dependencies: off`, `@simplysm/ts-no-throw-not-implemented-error: off`.
+
+### vitest.config 오버라이드 (`**/vitest.config.ts`)
+
+`no-restricted-properties: off` — 설정 파일에서 `process.env` 접근 허용.
 
 ## 공유 규칙 묶음
 
-JS·TS 블록에 함께 적용되는 내부 상수 묶음(외부로 export 되진 않으나 동작 이해용):
+JS·TS 블록에 함께 적용되는 내부 상수 묶음(export 되진 않으나 동작 이해용):
 
 - **noNodeBuiltinsRules** — node 빌트인 차단.
-  - `no-restricted-globals` 로 `Buffer` 전역 금지 → `Uint8Array`/`@simplysm/core-common` 의 `BytesUtils` 유도.
+  - `no-restricted-globals` 로 `Buffer` 전역 금지 → `Uint8Array` / `@simplysm/core-common` 의 `BytesUtils` 유도.
   - `no-restricted-imports` 로 `buffer`(→ `Uint8Array`/`BytesUtils`), `events`·`eventemitter3`(→ `@simplysm/core-common` 의 `EventEmitter`) import 금지.
 - **noDirectEnvAccessRules** — 환경변수 직접접근·엄격 비교 차단.
   - `no-restricted-properties` 로 `process.env` 직접 접근 금지 → `env("...")` 유도.
-  - `no-restricted-syntax` 로 `import.meta.env` 직접 접근 금지(→ `env("...")`), `env("NODE_ENV")` 호출 금지, `=== undefined`/`!== undefined`(엄격 비교 양방향) 금지 → `== null`/`!= null` 유도.
+  - `no-restricted-syntax` 로: `import.meta.env` 직접 접근 금지(→ `env("...")`), `env("NODE_ENV")` 호출 금지, `=== undefined` / `!== undefined`(좌·우변 양방향) 금지 → `== null` / `!= null` 유도.
 
 ## 주의
 
 - TS 블록은 타입 정보(`parserOptions.project: true`)를 요구하므로 대상 프로젝트에 유효한 `tsconfig` 가 있어야 함.
-- recommended 는 그 자체로 ESLint 9 flat config 배열이므로 추가 spread/병합 없이도 동작. 프로젝트별 규칙을 덧붙일 땐 배열 뒤에 config 객체를 이어 붙임.

package/claude/references/sd-simplysm14/apis/lint/rules.md

@@ -1,130 +1,137 @@
 # @simplysm/lint — rules
 
-`eslint-plugin` 이 노출하는 커스텀 ESLint 규칙 9종. 등록 시 규칙 id 는 `@simplysm/<name>`. 개별 규칙을 켜거나 lint 위반 메시지·autofix·옵션 의미를 파악할 때 같이 읽는 묶음. 모든 규칙은 `createRule`(= `ESLintUtils.RuleCreator`, `src/utils/create-rule.ts`)로 생성되어 문서 URL 이 자동 부여됨. 옵션 없는 규칙은 `schema: []`. autofix 는 각 항목의 표기대로만 제공.
+`@simplysm/lint/eslint-plugin` 이 노출하는 커스텀 규칙 9종. `plugins: { "@simplysm": plugin }` 매핑 후 `"@simplysm/<id>"` 로 켠다. id 접두어로 검사 대상 파일군이 갈림: `ts-*` 는 TS 소스, `ng-*` 는 Angular(TS effect 또는 HTML 템플릿), `no-*` 는 JS/TS 공통. 모든 규칙은 `createRule`(`ESLintUtils.RuleCreator` 래퍼)로 생성되어 문서 URL 이 자동 부여된다. 옵션 없는 규칙은 `schema: []`.
 
-## no-hard-private
-
-ECMAScript hard private(`#field`) 사용을 금지하고 TypeScript `private _` 스타일을 강제. `type: "problem"`, autofix 있음, 옵션 없음. JS·TS 양쪽 동작.
+---
 
-검사 대상: 클래스 필드 선언(`#field`), 메서드 선언(`#method()`), 접근자 선언(`accessor #field`), 멤버 접근 표현식(`this.#field`).
+## ng-no-async-effect
 
-메시지:
-- `preferSoftPrivate` — hard private(`#`) 금지, `private _` 스타일 사용 안내. autofix 는 `#name` → `_name` 치환 후, 선언부에 접근제어자가 없으면 `private ` 를 앞에 삽입(데코레이터·`static`·`async`·`readonly` 순서를 보존해 그 뒤 위치에 삽입). 토큰 계산 실패 시 이름만 바뀌는 불완전 수정을 막기 위해 수정 전체를 건너뜀.
-- `nameConflict` — `#{{name}}` 을 `_{{name}}` 으로 바꿀 수 없음(동일 이름 멤버가 클래스에 이미 존재). 이 경우 보고만 하고 autofix 안 함. 중첩 클래스는 스택으로 각 클래스 멤버 집합을 관리.
+- **검사 대상**: `@angular/core` 에서 import 한 `effect()` 호출의 첫 인자가 async 함수(`async () => {}` 또는 `async function`)인 경우. `effect` 식별자가 `@angular/core` 출처인지 스코프로 검증 — named(`import { effect }`) / aliased(`effect as ngEffect`) / namespace(`import * as ng` → `ng.effect(...)`) import 만 인정. 다른 모듈 또는 로컬 선언 `effect` 는 무시.
+- **메시지** `noAsyncEffect`: effect 콜백을 async 로 하면 `await` 이후 signal read 가 reactive 의존성으로 추적되지 않으니, 비동기 작업은 `void untracked(async () => { ... })` 안에서 하라고 안내. 보고 위치는 첫 인자(콜백) 노드.
+- **autofix**: 없음. **옵션**: 없음.
 
 ```typescript
-class A { #count = 0; inc() { this.#count++; } }
-// → private _count = 0; inc() { this._count++; }
+effect(() => { this.sig(); void untracked(async () => { await this.load(); }); });
 ```
 
-## no-subpath-imports-from-simplysm
-
-`@simplysm/*` 패키지의 `src` 하위 경로 import 를 금지(빌드 export 경유 강제). `type: "problem"`, autofix 있음, 옵션 없음. JS·TS 양쪽 동작.
+---
 
-검사 대상: 정적 import(`import ... from`), 동적 import(`import("...")`), 재내보내기(`export { x } from`), 전체 재내보내기(`export * from`). import 경로를 `/` 로 분리해 3번째 세그먼트가 `src` 인 경우(`@simplysm/pkg/src`, `@simplysm/pkg/src/xxx`)만 위반. `@simplysm/pkg`·`@simplysm/pkg/xxx`(src 아닌 subpath)는 허용.
+## ng-template-no-strict-null-check
 
-메시지:
-- `noSubpathImport` — `'@simplysm/{{pkg}}'` 에서 `src` 하위 경로 import 불가(`{{importPath}}` 출력). autofix 는 경로를 `@simplysm/<pkg>`(원래 따옴표 보존)로 치환.
+- **검사 대상**: Angular 템플릿(`*.html` 및 인라인)의 `Binary` 표현식 중 연산자가 `===` / `!==` 이고 한쪽 피연산자가 nil 리터럴(value 가 null/undefined)인 경우. 즉 `x === null`, `x !== null`, `x === undefined`, `x !== undefined`. `== null` / `!= null` 은 통과.
+- **메시지** `noStrictNullCheck`: `{{actual}}`(예: `x === null`) 대신 `{{replacement}}`(`===`→`==`, `!==`→`!=` 로 바꾸고 우변을 `null` 로 통일한 형태) 를 쓰라고 안내.
+- **autofix**: 없음 — 인라인 템플릿 offset 매핑 문제로 미제공(JSDoc 근거). **옵션**: 없음.
 
-```typescript
-import { x } from "@simplysm/core-common/src/x"; // → "@simplysm/core-common"
+```html
+@if (user !== null) {}   <!-- "user != null 사용" 으로 보고 -->
 ```
 
-## ng-no-async-effect
-
-`@angular/core` 의 `effect()` 에 async 함수를 직접 전달하는 것을 금지. `type: "problem"`, autofix 없음, 옵션 없음. `await` 이후 signal read 가 reactive 의존성으로 추적되지 않고 반환값이 `Promise<void>` 가 되어 cleanup 등록이 막히는 문제 방지.
+---
 
-검사 대상: `effect(...)` 호출의 첫 인자가 async ArrowFunction/FunctionExpression 인 경우. `effect` 식별자가 `@angular/core` 에서 import 되었는지 스코프로 검증 — named(`import { effect }`)·aliased(`effect as ngEffect`)·namespace(`import * as ng` → `ng.effect(...)`) import 만 인정. 다른 모듈 또는 로컬 선언 `effect` 는 무시.
+## ng-template-no-todo-comments
 
-메시지:
-- `noAsyncEffect` — async 함수 직접 전달 금지, 비동기는 `void untracked(async () => { ... })` 내부에서 수행하라고 안내. 보고 위치는 첫 인자(콜백) 노드.
+- **검사 대상**: 템플릿 raw 텍스트의 HTML 주석 `<!-- ... -->` 중 본문에 `TODO:` 를 포함하는 것. AST 방문자가 아니라 정규식(`/<!--([\s\S]*?)-->/g`)으로 원문을 스캔(빈 visitor `{}` 반환). 한 파일의 여러 TODO 주석을 각각 개별 보고.
+- **메시지** `noTodo`: 본문은 `{{content}}` — `TODO:` 이후 텍스트를 trim 한 내용을 그대로 출력.
+- **autofix**: 없음. **옵션**: 없음.
 
-```typescript
-effect(() => { this.sig(); void untracked(async () => { await this.load(); }); });
+```html
+<!-- TODO: 페이징 추가 -->   <!-- "페이징 추가" 경고 -->
 ```
 
-## ts-no-throw-not-implemented-error
+---
 
-`@simplysm/core-common` 의 `NotImplementedError` 를 `new` 로 인스턴스화하는 코드를 감지(미구현 코드의 프로덕션 유입 방지). `type: "suggestion"`, autofix 없음, 옵션 없음. recommended 에서 `warn`(테스트 파일은 `off`).
+## ng-template-sd-require-binding-attrs
 
-검사 대상: `new NotImplementedError(...)`(named/aliased import), `new CC.NotImplementedError(...)`(namespace import). 식별자가 `@simplysm/core-common` 에서 import 되었는지 스코프로 검증. 동적 import(`await import(...)`)는 감지 안 함.
+`sd-*` 접두사 컴포넌트의 허용목록 밖 plain attribute 를 금지하고 property binding(`[attr]="..."`)을 강제. **9종 중 유일하게 옵션이 있는 규칙**.
 
-메시지:
-- `noThrowNotImplementedError` — 본문은 `{{text}}` 치환. `new` 의 첫 인자가 비어있지 않은 문자열 리터럴이면 그 값을, 아니면 `"미구현"` 을 출력.
+- **검사 대상**: 태그명이 지정 접두사(기본 `sd-`)로 시작하는 Element 의 attribute 중 `allowAttributes`(정확 일치)·`allowAttributePrefixes`(접두사 일치) 어디에도 안 드는 것(태그명·attribute 명 소문자 비교).
+- **메시지** `requireBindingForAttribute`: `"{{attrName}}"` 는 `"{{elementName}}"` 의 plain attribute 로 불가, `[{{attrName}}]="…"` property binding 을 쓰라고 안내.
+- **autofix**: 있음. 값이 빈 문자열이면 `[attr]="true"`, 값이 있으면 `\`·`'` 를 escape 해 `[attr]="'값'"` 로 치환. attribute span 이 비정상(`start >= end`)이면 fix 생략(`null` 반환).
+- **옵션**(객체 1개, 모두 string 배열, `additionalProperties: false`):
+  - `selectorPrefixes` — 검사 대상 태그 접두사. 기본 `["sd-"]`. 다른 디자인 시스템 접두사를 함께 검사할 때 지정.
+  - `allowAttributes` — plain 허용 attribute 정확 이름. 기본 `["id","class","style","title","tabindex","role"]`. 표준 속성을 추가 허용할 때.
+  - `allowAttributePrefixes` — plain 허용 attribute 접두사. 기본 `["aria-","data-","sd-"]`. aria/data 류 속성군을 통째 허용할 때.
 
-```typescript
-import { NotImplementedError } from "@simplysm/core-common";
-new NotImplementedError("결제 연동"); // → "결제 연동" 경고
+```html
+<sd-button myattr="hello"></sd-button>   <!-- → <sd-button [myattr]="'hello'"></sd-button> -->
+<sd-button disabled></sd-button>          <!-- → <sd-button [disabled]="true"></sd-button> -->
 ```
 
-## ts-no-unused-injects
+---
 
-미사용 Angular `inject()` 필드를 감지. `type: "problem"`, autofix 있음, 옵션 없음.
+## no-hard-private
 
-검사 대상: 클래스 본문에서 `inject(...)` 호출로 초기화된 PropertyDefinition(키가 Identifier). 같은 클래스 본문 전체를 순회해 필드명과 동일한 Identifier 참조(필드 키 자신 제외)가 0개면 미사용으로 판정. 클래스 내부 참조만 검사 — 템플릿 사용 여부는 보지 않음.
+ECMAScript hard private(`#`) 멤버 금지 → TypeScript `private _` 스타일 강제. JS·TS 양쪽 동작.
 
-메시지:
-- `unusedInject` — `inject() field "{{name}}" is never used.` autofix 는 해당 필드 선언을 앞 토큰 끝부터 제거(뒤 토큰이 있으면 필드 끝까지).
+- **검사 대상**: 선언(`#field`, `#method()`, `accessor #field`, getter/setter, static/async/generator 변형)과 사용(`this.#field`, `other.#field`, `MyClass.#static`) 모두. 중첩 클래스·클래스 표현식은 멤버 집합을 스택으로 추적.
+- **메시지**:
+  - `preferSoftPrivate`: hard private(`#`) 금지, `private _` 스타일 안내.
+  - `nameConflict`: `#{{name}}` 을 `_{{name}}` 로 바꾸려는데 동일 이름 멤버가 클래스에 이미 있어 변환 불가 — 보고만, autofix 안 함.
+- **autofix**: 있음. 선언은 `#x → _x`, 접근 제어자가 없으면 데코레이터·`static`·`async`·`readonly` 순서를 보존해 그 앞에 `private ` 삽입(`static #x → private static _x`, `@Deco #x → @Deco private _x`). 기존 `private`/`public`/`protected` 가 있으면 접근자는 두고 이름만 변경. 사용처는 `this.#x → this._x`. 토큰 계산 실패 시 이름만 바뀌는 불완전 수정을 막으려 fix 전체 생략.
+- **옵션**: 없음.
 
 ```typescript
-class C { private _svc = inject(MyService); } // _svc 미참조 시 제거
+class A { #count = 0; inc() { this.#count++; } }
+// → private _count = 0; inc() { this._count++; }
 ```
 
-## ts-no-unused-protected-readonly
+---
 
-Angular `@Component` 의 인라인 템플릿·클래스 본문 어디에서도 안 쓰이는 `protected readonly` 필드를 감지. `type: "problem"`, autofix 있음, 옵션 없음.
+## no-subpath-imports-from-simplysm
 
-검사 대상: `@Component` 데코레이터가 있고 그 첫 인자 객체에 `template` 속성(문자열 리터럴 또는 템플릿 리터럴)이 있는 클래스. 그 클래스의 `protected readonly` 비-static 필드(키가 Identifier)가 ① 인라인 템플릿에서 미참조 ② 클래스 본문 다른 멤버에서 미참조 둘 다일 때 보고. 템플릿 식별자는 `@angular/compiler` 의 `parseTemplate` 으로 AST 파싱 후 `ImplicitReceiver`/`ThisReceiver` 위 `PropertyRead`(클래스 필드 참조)만 수집하며, `*ngFor` 로컬·`@let`·`@if ... as`·`@for` item/별칭 등 스코프 로컬 변수는 제외. `@if`/`@switch`/`@for`/`@defer` 블록과 입력/이벤트/구조 디렉티브 바인딩까지 순회. `templateUrl`(외부 템플릿)은 대상 아님(`template` 문자열만).
+`@simplysm/*` 패키지의 `src` 하위 경로 import 금지(빌드 export 경유 강제). JS·TS 양쪽 동작.
 
-메시지:
-- `unusedField` — `Protected readonly field "{{name}}" is not used in class or template.` autofix 는 필드 선언과 앞 들여쓰기·뒤 `;`·개행을 함께 제거.
+- **검사 대상**: import 경로를 `/` 로 분리해 첫 패키지 세그먼트 뒤가 `src` 인 경우(`@simplysm/<pkg>/src`, `@simplysm/<pkg>/src/...`). `@simplysm/<pkg>` 루트·`src` 외 하위 경로(`@simplysm/<pkg>/utils`)는 통과, 비-`@simplysm` 패키지(`lodash/src/...`)도 통과. 정적 import, 동적 `import(...)`, `export { } from`, `export * from` 모두 검사(side-effect·type-only import 포함).
+- **메시지** `noSubpathImport`: `'@simplysm/{{pkg}}'` 에서 `src` 하위 경로 `'{{importPath}}'` 를 import 할 수 없다는 위반.
+- **autofix**: 있음. 경로를 패키지 루트 `@simplysm/<pkg>` 로 치환하며 원본 따옴표(`'`/`"`) 보존.
+- **옵션**: 없음.
 
 ```typescript
-@Component({ template: `<div>{{title}}</div>` })
-class C { protected readonly title = "x"; protected readonly unused = 1; } // unused 제거
+import { x } from "@simplysm/core-common/src/x"; // → "@simplysm/core-common"
 ```
 
-## ng-template-no-strict-null-check
+---
 
-Angular HTML 템플릿에서 엄격 비교(`=== null`, `!== null`, `=== undefined`, `!== undefined`)를 금지하고 `== null`/`!= null` 로 통일하도록 강제. `type: "problem"`, autofix 없음(인라인 템플릿 offset 매핑 문제로 미제공), 옵션 없음. HTML 대상.
+## ts-no-throw-not-implemented-error
 
-검사 대상: 템플릿 표현식의 `Binary` 노드 중 연산자가 `===`/`!==` 이고 양변 중 하나가 nil 리터럴(value 가 null/undefined)인 경우.
+`@simplysm/core-common` 의 `NotImplementedError` `new` 인스턴스화 감지(미구현 코드 프로덕션 유입 방지).
 
-메시지:
-- `noStrictNullCheck` — `{{actual}}`(예: `x === null`) 사용 금지, `{{replacement}}`(예: `x == null`) 사용 안내. `===`→`==`, `!==`→`!=` 로 변환한 권장 표현을 제시.
+- **검사 대상**: `new NotImplementedError(...)`(named/aliased import), `new CC.NotImplementedError(...)`(namespace import). 식별자가 `@simplysm/core-common` 출처인지 스코프로 검증. 다른 모듈 동명 클래스, import 없는 사용, 동적 `await import(...)`, 재내보내기 경유는 감지 안 함(JSDoc·테스트 근거).
+- **메시지** `noThrowNotImplementedError`: 본문은 `{{text}}` — `new` 의 첫 인자가 비어있지 않은 문자열 리터럴이면 그 값을, 아니면(템플릿 리터럴·숫자·빈 문자열·인자 없음) 기본값 `"미구현"` 을 출력.
+- **autofix**: 없음. **옵션**: 없음. recommended 에서 TS 는 `warn`, tests 는 `off`.
 
-```html
-@if (user !== null) {}  <!-- "user != null 사용" 으로 보고 -->
+```typescript
+import { NotImplementedError } from "@simplysm/core-common";
+new NotImplementedError("결제 연동"); // → "결제 연동" 경고
 ```
 
-## ng-template-no-todo-comments
+---
 
-Angular HTML 템플릿 내 `<!-- TODO: ... -->` 주석을 경고. `type: "problem"`, autofix 없음, 옵션 없음. recommended 에서 `warn`. HTML 대상.
+## ts-no-unused-injects
 
-동작: raw 텍스트를 `<!--...-->` 정규식으로 훑어 주석 내용에 `TODO:` 가 있으면 보고(AST 방문자 없이 빈 객체 반환). 메시지 본문은 `TODO:` 뒤를 trim 한 내용.
+미사용 Angular `inject()` 필드 감지.
 
-메시지:
-- `noTodo` — 본문은 `{{content}}`(TODO 뒤 텍스트) 그대로 출력.
+- **검사 대상**: 클래스 본문에서 `inject(...)` 호출로 초기화된 PropertyDefinition(key 가 Identifier). 같은 클래스 본문 전체를 순회해 필드명과 동일한 Identifier 참조(선언 key 자신 제외)가 0개면 미사용 판정. 클래스 내부 참조만 검사 — 템플릿 사용 여부는 안 봄.
+- **메시지** `unusedInject`: `inject() field "{{name}}" is never used.`
+- **autofix**: 있음. 해당 필드 선언을 앞 토큰 끝부터 제거(뒤 토큰이 있으면 필드 끝까지). 사용 중인 다른 inject 필드는 보존.
+- **옵션**: 없음.
 
-```html
-<!-- TODO: 페이징 추가 -->  <!-- "페이징 추가" 경고 -->
+```typescript
+class C { private _svc = inject(MyService); } // _svc 미참조 시 제거
 ```
 
-## ng-template-sd-require-binding-attrs
-
-`sd-*` 접두사 커스텀 컴포넌트에서 허용목록 밖 plain attribute 사용을 금지하고 Angular property binding(`[attr]="..."`)을 강제. `type: "problem"`, autofix 있음. HTML 대상. **9종 중 유일하게 옵션 있는 규칙**.
+---
 
-옵션(`RuleOptions`, 모두 선택):
-- `selectorPrefixes: string[]` — 검사 대상 요소 태그 접두사. 미지정 시 `["sd-"]`. 태그명을 소문자로 비교. 다른 디자인 시스템 접두사를 함께 검사하려면 지정.
-- `allowAttributes: string[]` — plain attribute 로 허용할 정확한 이름 목록. 미지정 시 `["id","class","style","title","tabindex","role"]`. 소문자 비교. 추가로 허용할 표준 속성을 늘릴 때.
-- `allowAttributePrefixes: string[]` — plain attribute 로 허용할 접두사 목록. 미지정 시 `["aria-","data-","sd-"]`. 소문자 비교. 접두사 기반(aria/data 등) 속성군을 통째 허용할 때.
+## ts-no-unused-protected-readonly
 
-동작: 대상 태그(접두사 매칭) 요소의 attribute 중 `allowAttributes`(정확 일치)·`allowAttributePrefixes`(접두사 일치) 어디에도 안 드는 것을 보고.
+Angular `@Component` 인라인 템플릿·클래스 본문 어디에서도 안 쓰이는 `protected readonly` 필드 감지.
 
-메시지:
-- `requireBindingForAttribute` — `"{{attrName}}"` 은 `"{{elementName}}"` 의 plain attribute 로 불가, property binding 사용 안내. autofix 는 값이 빈 문자열이면 `[attr]="true"`, 값이 있으면 `\` 와 `'` 를 이스케이프해 `[attr]="'값'"` 로 치환(attribute span 의 start≥end 면 수정 안 함).
+- **검사 대상**: `@Component({ template: ... })` 데코레이터(첫 인자 객체에 `template` 키, 비어있지 않은 문자열/템플릿 리터럴)가 달린 클래스의 `protected readonly` 비-static 필드(key 가 Identifier) 중 ① 인라인 템플릿 미참조 ② 클래스 본문 다른 멤버 미참조 둘 다인 것. 템플릿 식별자는 `@angular/compiler` 의 `parseTemplate` 로 AST 파싱 후 `ImplicitReceiver`/`ThisReceiver` 위 `PropertyRead`(클래스 필드 참조)만 수집하며, `*ngFor` 로컬·`@let`·`@if ... as`·`@for` item/별칭 등 스코프 로컬은 제외. `@if`/`@switch`/`@for`/`@defer` 블록과 입력/이벤트/구조 디렉티브 바인딩까지 순회. `templateUrl`(외부 템플릿)은 대상 아님.
+- **메시지** `unusedField`: `Protected readonly field "{{name}}" is not used in class or template.`
+- **autofix**: 있음. 필드 선언을 앞 들여쓰기·뒤 `;`·개행까지 줄 단위로 제거.
+- **옵션**: 없음.
 
-```html
-<sd-button myattr="hello"></sd-button>   <!-- → <sd-button [myattr]="'hello'"></sd-button> -->
-<sd-button disabled></sd-button>          <!-- → <sd-button [disabled]="true"></sd-button> -->
+```typescript
+@Component({ template: `<div>{{title}}</div>` })
+class C { protected readonly title = "x"; protected readonly unused = 1; } // unused 제거
 ```

package/claude/references/sd-simplysm14/apis/orm-common/README.md

@@ -1,14 +1,14 @@
 # @simplysm/orm-common
 
-Dialect(MySQL/MSSQL/PostgreSQL) 독립 ORM 코어. 스키마를 빌더로 정의하고, `DbContext` 를 상속해 연결/트랜잭션/DDL 을 다루며, `Queryable` 체이닝과 `expr` 표현식 빌더로 타입 안전한 쿼리 AST(QueryDef/Expr)를 만든 뒤 dialect 별 QueryBuilder 로 SQL 을 렌더링한다. 실제 DB 연결·실행은 `@simplysm/orm-node` 등 `DbContextExecutor` 구현체가 담당하고, 이 패키지 자체는 dialect 독립 로직(빌더·AST·SQL 문자열 생성)까지만 가진다.
+Dialect(MySQL/MSSQL/PostgreSQL) 독립 ORM 코어. 빌더로 스키마를 정의하고, `DbContext` 를 상속해 연결·트랜잭션·DDL 을 다루며, `Queryable` 체이닝 + `expr` 표현식 빌더로 타입 안전한 쿼리 AST(`QueryDef`/`Expr`)를 만든 뒤 dialect 별 QueryBuilder 로 SQL 문자열을 렌더링한다. 실제 DB 연결·실행은 `DbContextExecutor` 구현체(`@simplysm/orm-node` 등)가 담당하고, 이 패키지는 dialect 독립 로직(빌더·AST·SQL 렌더링·결과 파싱)까지만 가진다.
 
 ## 사용 트리거 인덱스
 
-- **DbContext / 연결·트랜잭션·DDL·마이그레이션** — `DbContext` 를 상속해 테이블·뷰·프로시저를 프로퍼티로 등록하고 `connect`/`transaction`/`createTable`/`initialize` 등으로 연결·트랜잭션 경계와 스키마 변경을 다룰 때. 자세히: [db-context.md](./db-context.md)
-- **스키마 빌더 (Table/View/Procedure/Column/Index/Relation)** — `Table()`/`View()`/`Procedure()` 와 column·index·relation 팩토리로 테이블·뷰·프로시저 정의를 fluent 하게 작성할 때. 자세히: [schema.md](./schema.md)
-- **Queryable / Executable / 검색** — `db.X()` 로 시작하는 SELECT/INSERT/UPDATE/DELETE/UPSERT 체이닝, join/include/union/recursive, 텍스트 검색(`search`/`parseSearchQuery`), 프로시저 실행을 작성할 때. 자세히: [queryable.md](./queryable.md)
-- **expr 표현식 빌더** — `where`/`select`/`groupBy`/`orderBy` 콜백 안에서 비교·논리·문자열·숫자·날짜·집계·조건·윈도우·서브쿼리 표현식을 만들 때. `ExprUnit`/`WhereExprUnit`/`ExprInput`/`expr.val`/`expr.raw` 포함. 자세히: [expr.md](./expr.md)
-- **타입 / QueryDef·Expr AST / QueryBuilder / 결과 파싱** — executor 구현, dialect 별 SQL 렌더링(`createQueryBuilder`), QueryDef/Expr AST 타입, 컬럼 원시 타입(`ColumnPrimitive*`/`DataType`), 결과 변환(`parseQueryResult`/`pickResultSets`)을 다룰 때. 자세히: [types.md](./types.md)
+- **DbContext / 연결·트랜잭션·DDL·마이그레이션** — `DbContext` 를 상속해 테이블·뷰·프로시저를 프로퍼티로 등록하고, `connect`/`transaction`/`createTable`/`initialize` 등으로 연결·트랜잭션 경계와 스키마 변경을 다룰 때. `DbContextExecutor`/`DbTransactionError`/`Migration` 포함. 자세히: [db-context.md](./db-context.md)
+- **스키마 빌더 (Table/View/Procedure/Column/Index/Relation)** — `Table()`/`View()`/`Procedure()` 와 column·index·relation 팩토리로 스키마를 fluent 하게 정의하고 `$inferSelect` 등으로 타입을 추론할 때. 자세히: [schema.md](./schema.md)
+- **Queryable / Executable / 검색** — `db.X()` 로 시작하는 SELECT/INSERT/UPDATE/DELETE/UPSERT 체이닝, `join`/`joinSingle`/`include`/`union`/`recursive`, 텍스트 검색(`search`/`parseSearchQuery`), 프로시저 실행(`Executable`)을 작성할 때. 자세히: [queryable.md](./queryable.md)
+- **expr 표현식 빌더** — `where`/`select`/`groupBy`/`orderBy`/`update` 콜백 안에서 비교·논리·문자열·숫자·날짜·집계·조건·윈도우·서브쿼리 표현식을 만들 때. `expr` 객체와 `ExprUnit`/`WhereExprUnit`/`ExprInput` 포함. 자세히: [expr.md](./expr.md)
+- **타입 / QueryDef·Expr AST / QueryBuilder / 결과 파싱** — executor·dialect 어댑터 구현, dialect 별 SQL 렌더링(`createQueryBuilder`), `QueryDef`/`Expr` AST 타입, 컬럼 원시 타입(`ColumnPrimitive*`/`DataType`), 결과 변환(`parseQueryResult`/`pickResultSets`)을 다룰 때. 자세히: [types.md](./types.md)
 
 ## 전형적 사용 흐름