@fluojs/testing 1.0.0-beta.2 → 1.0.0-beta.3

package/README.ko.md

@@ -2,9 +2,9 @@
 
 <p><a href="./README.md"><kbd>English</kbd></a> <strong><kbd>한국어</kbd></strong></p>
 
-fluo 애플리케이션 테스트를 위한 모듈 구성 및 프로바이더 오버라이드 유틸리티입니다.
+fluo 애플리케이션을 위한 기본 request-level 테스트 헬퍼, 모듈 구성, 프로바이더 오버라이드 유틸리티입니다.
 
-`@fluojs/testing`은 fluo 애플리케이션 테스트를 위한 공식적인 기준(Baseline)을 제공합니다. 격리된 테스트 환경을 구축하고, 의존성을 가짜(Fake)나 목(Mock)으로 교체하며, 모듈 그래프에서 직접 컴포넌트를 resolve하거나 가상 HTTP 요청을 디스패치하여 통합 테스트를 수행할 수 있게 합니다.
+`@fluojs/testing`은 fluo 애플리케이션 테스트를 위한 공식적인 기준(Baseline)을 제공합니다. 격리된 테스트 환경을 구축하고, 의존성을 가짜(Fake)나 목(Mock)으로 교체하며, 모듈 그래프에서 직접 컴포넌트를 resolve하거나 `createTestApp(...).request(...).send()`로 가상 HTTP 요청을 실행하여 e2e 스타일 테스트를 수행할 수 있게 합니다.
 
 ## 목차
 
@@ -12,6 +12,7 @@ fluo 애플리케이션 테스트를 위한 모듈 구성 및 프로바이더
 - [사용 시점](#사용-시점)
 - [빠른 시작](#빠른-시작)
 - [주요 패턴](#주요-패턴)
+- [canonical TDD ladder](#canonical-tdd-ladder)
 - [공개 API](#공개-api)
 - [관련 패키지](#관련-패키지)
 - [예제 소스](#예제-소스)
@@ -24,7 +25,7 @@ pnpm add -D @fluojs/testing vitest
 
 `vitest`는 mock 헬퍼와 `@fluojs/testing/vitest` 엔트리포인트가 요구하는 peer dependency입니다.
 
-`@fluojs/testing/vitest`를 사용할 때는 `fluoBabelDecoratorsPlugin()`이 런타임에 Babel을 호출하므로, 사용하는 워크스페이스에 `@babel/core`도 함께 설치해야 합니다.
+`@fluojs/testing/vitest`를 사용할 때는 `fluoBabelDecoratorsPlugin()`이 런타임에 Babel을 호출하므로, 사용하는 워크스페이스에 `@babel/core`도 함께 설치해야 합니다. Vitest 플러그인은 Vite query/hash suffix를 제거한 뒤 `.ts`, `.tsx`, `.mts`, `.cts` 소스 id를 변환하고, `node_modules`는 건너뛰며, 가장 가까운 root Babel config인 `babel.config.cjs`, `babel.config.mjs`, `babel.config.js`, `babel.config.json`을 해석합니다.
 
 ```bash
 pnpm add -D @babel/core
@@ -39,6 +40,30 @@ pnpm add -D @babel/core
 
 ## 빠른 시작
 
+```typescript
+import { createTestApp } from '@fluojs/testing';
+
+const app = await createTestApp({ rootModule: AppModule });
+
+const response = await app
+  .request('POST', '/users/')
+  .header('x-request-id', 'test-request-1')
+  .query('include', 'profile')
+  .principal({ subject: 'user-1', roles: ['admin'] })
+  .body({ name: 'Ada' })
+  .send();
+
+expect(response.status).toBe(201);
+
+await app.close();
+```
+
+애플리케이션 route, guard, interceptor, DTO validation, request body, query parameter, header, synthetic principal, serialized response를 검증하는 기본 HTTP/e2e 스타일 경로로는 `createTestApp({ rootModule })`을 사용하세요. 하나의 slice 안에서 module wiring, provider visibility, provider/guard/interceptor override가 계약일 때는 `createTestingModule(...)`을 사용합니다.
+
+## 주요 패턴
+
+### 컴파일 전 프로바이더 오버라이드
+
 ```typescript
 import { createTestingModule } from '@fluojs/testing';
 import { vi } from 'vitest';
@@ -52,18 +77,7 @@ const module = await createTestingModule({ rootModule: AppModule })
 const service = await module.resolve(UserService);
 ```
 
-## 주요 패턴
-
-### 오버라이드를 이용한 유닛 테스트
-
-```typescript
-const module = await createTestingModule({ rootModule: AppModule })
-  .overrideProviders([
-    [USER_REPOSITORY, fakeUserRepo],
-    [EMAIL_SERVICE, fakeEmailService],
-  ])
-  .compile();
-```
+Testing builder는 route-pipeline 테스트에서 cross-cutting behavior를 교체할 수 있도록 `overrideGuard(...)`, `overrideInterceptor(...)`, `overrideFilter(...)`도 지원합니다.
 
 ### `overrideModule()` 사용 시 모듈 identity 보존
 
@@ -78,7 +92,7 @@ expect(module.rootModule).toBe(AppModule);
 expect(module.modules.some((compiledModule) => compiledModule.type === BillingModule)).toBe(true);
 ```
 
-### HTTP 통합 테스트
+### `createTestApp()` 기반 request-level 테스트
 
 ```typescript
 import { createTestApp } from '@fluojs/testing';
@@ -86,13 +100,22 @@ import { createTestApp } from '@fluojs/testing';
 const app = await createTestApp({ rootModule: AppModule });
 
 const response = await app
-  .request('GET', '/users/me')
+  .request('POST', '/users/')
+  .header('authorization', 'Bearer test-token')
+  .query('include', ['profile', 'settings'])
   .principal({ subject: 'user-1', roles: ['member'] })
+  .body({ name: 'Ada' })
   .send();
 
+expect(response.status).toBe(201);
+
 await app.close();
 ```
 
+`app.request(...).send()`는 수동 `FrameworkRequest`/`FrameworkResponse` stub 없이 HTTP 의미에 가까운 테스트를 작성하게 해 주므로 애플리케이션 개발자의 기본 경로입니다. `app.dispatch(...)`, `makeRequest(...)`, raw `FluoFactory.create(...)` 테스트는 adapter/runtime contract, framework internal, 또는 low-level dispatch boundary 자체를 증명해야 하는 compatibility case에 남겨 둡니다.
+
+`createTestApp(...)`은 runtime HTTP bootstrap과 같은 application bootstrap option을 받습니다. 여기에는 `providers`, `filters`, `converters`, `interceptors`, `middleware`, `observers`, `versioning`, diagnostics option이 포함됩니다. 테스트 헬퍼는 request-context middleware를 앞에 추가하되, 호출자가 넘긴 middleware를 같은 app middleware chain 안에 보존합니다.
+
 ### 명시적 서브패스의 mock 헬퍼
 
 ```typescript
@@ -103,15 +126,41 @@ const repo = createMock<UserRepository>({ findById: vi.fn() });
 const mailer = createDeepMock(MailService);
 ```
 
+`asMock(value)`는 기존 값을 mock-friendly 타입으로 좁히고, `mockToken(token, value)`는 token 기반 dependency를 위한 provider override tuple을 만듭니다. `createMock(..., { strict: true })`는 지정하지 않은 member 접근을 거부합니다.
+
 배포된 런타임 import가 안정적으로 해석되도록, mock 헬퍼를 사용할 워크스페이스에는 `vitest`를 함께 설치해야 합니다.
 
 ### 적합성 및 이식성 하니스
 
 프레임워크 지향 플랫폼 패키지를 작성할 때는 `@fluojs/testing/platform-conformance`, `@fluojs/testing/http-adapter-portability`, `@fluojs/testing/web-runtime-adapter-portability` 같은 서브패스를 사용해 적합성 및 이식성 검증을 수행합니다.
 
+`HttpAdapterPortabilityHarness` 메서드는 공개 어댑터 계약 체크입니다. 직접 같은 검증을 다시 만들기보다 `assertPreservesMalformedCookieValues()`, `assertSupportsSseStreaming()`, `assertPreservesRawBodyForJsonAndText()`, `assertPreservesExactRawBodyBytesForByteSensitivePayloads()`, `assertExcludesRawBodyForMultipart()`, `assertDefaultsMultipartTotalLimitToMaxBodySize()`, `assertSettlesStreamDrainWaitOnClose()`, `assertReportsConfiguredHostInStartupLogs()`, `assertReportsHttpsStartupUrl(...)`, `assertRemovesShutdownSignalListenersAfterClose()`처럼 초점이 분명한 assertion을 사용하세요.
+
+## canonical TDD ladder
+
+애플리케이션 기능 테스트는 가장 작은 명시적 dependency boundary에서 시작해 바깥쪽으로 확장합니다.
+
+1. **Unit**: `src/**` 아래 service, controller, helper, failure branch 가까이에 `*.test.ts` 파일을 둡니다. 클래스를 직접 구성하고 명시적 fake를 넘기거나, typed mock이 설정을 읽기 쉽게 만들 때 `@fluojs/testing/mock` 헬퍼를 사용합니다.
+2. **Slice/module integration**: DI wiring과 provider override coverage에는 `createTestingModule({ rootModule })` 또는 `Test.createTestingModule({ rootModule })` 기반 `*.slice.test.ts` 파일을 추가합니다.
+3. **HTTP e2e-style**: `test/app.e2e.test.ts` 같은 app-level 테스트는 `createTestApp({ rootModule })`와 기본 route assertion helper인 `app.request(...).send()`로 virtual request pipeline을 검증합니다. 더 낮은 수준의 dispatch contract 자체가 테스트 대상일 때만 `app.dispatch(...)`를 사용합니다.
+4. **Platform/conformance**: harness subpath는 일반 애플리케이션 기능 coverage가 아니라 adapter/runtime package contract에만 사용합니다.
+
+```txt
+src/users/
+  users.service.test.ts
+  users.controller.test.ts
+  users.slice.test.ts
+
+test/
+  app.e2e.test.ts
+```
+
+fluo는 테스트가 명시적인 `rootModule`을 이름으로 지정해야 한다는 점에서 NestJS와 다릅니다. 테스트 유틸리티는 legacy TypeScript design metadata나 reflection flag에서 dependency를 추론하지 않고, 작성자가 만든 module graph를 컴파일합니다.
+
 ## 공개 API
 
 - **루트 패키지**: `createTestingModule(...)`, `createTestApp(...)`, 모듈 introspection 헬퍼, 공용 테스트 타입
+- **서브패스**: `@fluojs/testing/app`, `@fluojs/testing/module`, `@fluojs/testing/http`, `@fluojs/testing/mock`, `@fluojs/testing/types`, `@fluojs/testing/vitest`
 - **Mock 서브패스**: `@fluojs/testing/mock`
 - **HTTP 헬퍼**: `@fluojs/testing/http`
 - **하니스 서브패스**: `platform-conformance`, `http-adapter-portability`, `web-runtime-adapter-portability`, `fetch-style-websocket-conformance`

package/README.md

@@ -2,7 +2,7 @@
 
 <p><strong><kbd>English</kbd></strong> <a href="./README.ko.md"><kbd>한국어</kbd></a></p>
 
-Testing module construction, provider overrides, and request-level test helpers for fluo applications.
+Default request-level testing helpers, testing module construction, and provider overrides for fluo applications.
 
 ## Table of Contents
 
@@ -10,6 +10,7 @@ Testing module construction, provider overrides, and request-level test helpers
 - [When to Use](#when-to-use)
 - [Quick Start](#quick-start)
 - [Common Patterns](#common-patterns)
+- [Canonical TDD Ladder](#canonical-tdd-ladder)
 - [Public API](#public-api)
 - [Related Packages](#related-packages)
 - [Example Sources](#example-sources)
@@ -22,7 +23,7 @@ npm install --save-dev @fluojs/testing vitest
 
 `vitest` is a required peer dependency for the mock helpers and the `@fluojs/testing/vitest` entrypoint.
 
-If you use `@fluojs/testing/vitest`, install `@babel/core` in the consuming workspace as well because `fluoBabelDecoratorsPlugin()` invokes Babel at runtime:
+If you use `@fluojs/testing/vitest`, install `@babel/core` in the consuming workspace as well because `fluoBabelDecoratorsPlugin()` invokes Babel at runtime. The Vitest plugin transforms `.ts`, `.tsx`, `.mts`, and `.cts` source ids after removing Vite query/hash suffixes, skips `node_modules`, and resolves the nearest root Babel config named `babel.config.cjs`, `babel.config.mjs`, `babel.config.js`, or `babel.config.json`:
 
 ```bash
 npm install --save-dev @babel/core
@@ -38,31 +39,44 @@ npm install --save-dev @babel/core
 ## Quick Start
 
 ```ts
-import { createTestingModule } from '@fluojs/testing';
-import { vi } from 'vitest';
+import { createTestApp } from '@fluojs/testing';
 
-const module = await createTestingModule({ rootModule: AppModule })
-  .overrideProvider(USER_REPOSITORY, {
-    create: vi.fn().mockResolvedValue({ id: '1', name: 'Alice' }),
-  })
-  .compile();
+const app = await createTestApp({ rootModule: AppModule });
 
-const service = await module.resolve(UserService);
+const response = await app
+  .request('POST', '/users/')
+  .header('x-request-id', 'test-request-1')
+  .query('include', 'profile')
+  .principal({ subject: 'user-1', roles: ['admin'] })
+  .body({ name: 'Ada' })
+  .send();
+
+expect(response.status).toBe(201);
+
+await app.close();
 ```
 
+Use `createTestApp({ rootModule })` as the default HTTP/e2e-style path for application routes, guards, interceptors, DTO validation, request bodies, query parameters, headers, synthetic principals, and serialized responses. Reach for `createTestingModule(...)` when the contract is module wiring, provider visibility, or provider/guard/interceptor overrides inside one slice.
+
 ## Common Patterns
 
 ### Override providers before compilation
 
 ```ts
+import { createTestingModule } from '@fluojs/testing';
+import { vi } from 'vitest';
+
 const module = await createTestingModule({ rootModule: AppModule })
-  .overrideProviders([
-    [USER_REPOSITORY, fakeUserRepo],
-    [EMAIL_SERVICE, fakeEmailService],
-  ])
+  .overrideProvider(USER_REPOSITORY, {
+    create: vi.fn().mockResolvedValue({ id: '1', name: 'Alice' }),
+  })
   .compile();
+
+const service = await module.resolve(UserService);
 ```
 
+The testing builder also supports `overrideGuard(...)`, `overrideInterceptor(...)`, and `overrideFilter(...)` for route-pipeline tests that need to replace cross-cutting behavior.
+
 ### Preserve module identity with `overrideModule()`
 
 `createTestingModule({ rootModule })` requires an explicit root module so tests compile the same module graph shape that production bootstrap uses. When `overrideModule(source, replacement)` swaps imported modules, the compiled testing module preserves the original `rootModule` and compiled `modules[].type` identities while using the replacement imports for provider resolution. This keeps diagnostics, graph assertions, and module-introspection helpers tied to the application module classes you authored instead of synthetic test-only wrapper classes.
@@ -84,13 +98,22 @@ import { createTestApp } from '@fluojs/testing';
 const app = await createTestApp({ rootModule: AppModule });
 
 const response = await app
-  .request('GET', '/users/me')
+  .request('POST', '/users/')
+  .header('authorization', 'Bearer test-token')
+  .query('include', ['profile', 'settings'])
   .principal({ subject: 'user-1', roles: ['member'] })
+  .body({ name: 'Ada' })
   .send();
 
+expect(response.status).toBe(201);
+
 await app.close();
 ```
 
+`app.request(...).send()` is the preferred app-developer path because it keeps tests close to HTTP semantics without manual `FrameworkRequest`/`FrameworkResponse` stubs. Keep `app.dispatch(...)`, `makeRequest(...)`, and raw `FluoFactory.create(...)` tests for adapter/runtime contracts, framework internals, or compatibility cases where the low-level dispatch boundary itself is what the test must prove.
+
+`createTestApp(...)` accepts the same application bootstrap options as the runtime HTTP bootstrap, including `providers`, `filters`, `converters`, `interceptors`, `middleware`, `observers`, `versioning`, and diagnostics options. The testing helper prepends its request-context middleware while preserving caller-provided middleware in the same app middleware chain.
+
 ### Mock helpers from explicit subpaths
 
 ```ts
@@ -101,15 +124,41 @@ const repo = createMock<UserRepository>({ findById: vi.fn() });
 const mailer = createDeepMock(MailService);
 ```
 
+`asMock(value)` narrows an existing value to a mock-friendly type, and `mockToken(token, value)` creates a provider override tuple for token-based dependencies. `createMock(..., { strict: true })` rejects access to unspecified members.
+
 Install `vitest` in the consuming workspace before using the mock helpers so the published runtime import resolves consistently.
 
 ### Conformance and portability harnesses
 
 Use subpaths like `@fluojs/testing/platform-conformance`, `@fluojs/testing/http-adapter-portability`, and `@fluojs/testing/web-runtime-adapter-portability` when authoring framework-facing platform packages.
 
+`HttpAdapterPortabilityHarness` methods are the public adapter contract checks. Prefer focused assertions such as `assertPreservesMalformedCookieValues()`, `assertSupportsSseStreaming()`, `assertPreservesRawBodyForJsonAndText()`, `assertPreservesExactRawBodyBytesForByteSensitivePayloads()`, `assertExcludesRawBodyForMultipart()`, `assertDefaultsMultipartTotalLimitToMaxBodySize()`, `assertSettlesStreamDrainWaitOnClose()`, `assertReportsConfiguredHostInStartupLogs()`, `assertReportsHttpsStartupUrl(...)`, and `assertRemovesShutdownSignalListenersAfterClose()` instead of hand-rolled equivalents.
+
+## Canonical TDD Ladder
+
+For application features, build tests from the smallest explicit dependency boundary outward:
+
+1. **Unit**: place `*.test.ts` files next to the service, controller, helper, or failure branch under `src/**`. Construct the class directly with explicit fakes, or use `@fluojs/testing/mock` helpers when typed mocks keep setup readable.
+2. **Slice/module integration**: add `*.slice.test.ts` files for DI wiring and provider override coverage with `createTestingModule({ rootModule })` or `Test.createTestingModule({ rootModule })`.
+3. **HTTP e2e-style**: place app-level tests such as `test/app.e2e.test.ts` around the virtual request pipeline with `createTestApp({ rootModule })` and `app.request(...).send()` as the default route assertion helper. Use `app.dispatch(...)` only when a lower-level dispatch contract is the subject of the test.
+4. **Platform/conformance**: use harness subpaths only for adapter/runtime package contracts, not ordinary application feature coverage.
+
+```txt
+src/users/
+  users.service.test.ts
+  users.controller.test.ts
+  users.slice.test.ts
+
+test/
+  app.e2e.test.ts
+```
+
+fluo differs from NestJS by requiring tests to name an explicit `rootModule`. The testing utilities compile the module graph you authored instead of inferring dependencies from legacy TypeScript design metadata or reflection flags.
+
 ## Public API
 
 - **Root package**: `createTestingModule(...)`, `createTestApp(...)`, module introspection helpers, shared testing types
+- **Subpaths**: `@fluojs/testing/app`, `@fluojs/testing/module`, `@fluojs/testing/http`, `@fluojs/testing/mock`, `@fluojs/testing/types`, `@fluojs/testing/vitest`
 - **Mock subpath**: `@fluojs/testing/mock`
 - **HTTP helpers**: `@fluojs/testing/http`
 - **Harness subpaths**: `platform-conformance`, `http-adapter-portability`, `web-runtime-adapter-portability`, `fetch-style-websocket-conformance`

package/dist/app.d.ts

@@ -1,4 +1,4 @@
-import type { TestApp, TestingModuleOptions } from './types.js';
+import type { TestApp, TestingApplicationOptions } from './types.js';
 /**
  * Boots a lightweight test app with the real dispatcher and a fluent request client.
  *
@@ -12,5 +12,5 @@ import type { TestApp, TestingModuleOptions } from './types.js';
  * await app.close();
  * ```
  */
-export declare function createTestApp(options: TestingModuleOptions): Promise<TestApp>;
+export declare function createTestApp(options: TestingApplicationOptions): Promise<TestApp>;
 //# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EAErB,MAAM,YAAY,CAAC;AA6BpB;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBnF"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,OAAO,EACP,yBAAyB,EAE1B,MAAM,YAAY,CAAC;AA6BpB;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBxF"}

package/dist/app.js

@@ -36,7 +36,7 @@ function normalizeRequestInput(methodOrRequest, pathOrOptions, options) {
 export async function createTestApp(options) {
   const app = await bootstrapApplication({
     ...options,
-    middleware: [createTestRequestContextMiddleware()]
+    middleware: [createTestRequestContextMiddleware(), ...(options.middleware ?? [])]
   });
   const request = (methodOrRequest, pathOrOptions, options) => {
     return createRequestBuilder(app.dispatcher, normalizeRequestInput(methodOrRequest, pathOrOptions, options));

package/dist/babel-decorators-plugin.d.ts

@@ -1,9 +1,9 @@
 /**
- * Resolves the nearest `babel.config.cjs` file starting from the given file path
+ * Resolves the nearest Babel root configuration file starting from the given file path
  * and searching upwards through the directory hierarchy.
  *
  * @param filePath - The path to the file whose nearest Babel configuration should be found.
- * @returns The absolute path to the nearest `babel.config.cjs` file.
+ * @returns The absolute path to the nearest Babel root configuration file.
  * @throws Error if no configuration file can be located.
  */
 export declare function resolveNearestBabelConfigFile(filePath: string): string;

package/dist/babel-decorators-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"babel-decorators-plugin.d.ts","sourceRoot":"","sources":["../src/babel-decorators-plugin.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAyBtE;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM;;oBAIvB,MAAM,MAAM,MAAM;;;;;;;;;;;;EAsB3C;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC"}
+{"version":3,"file":"babel-decorators-plugin.d.ts","sourceRoot":"","sources":["../src/babel-decorators-plugin.ts"],"names":[],"mappings":"AAsBA;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2BtE;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM;;oBAIvB,MAAM,MAAM,MAAM;;;;;;;;;;;;EAwB3C;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/babel-decorators-plugin.js

@@ -1,31 +1,44 @@
 import { existsSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import { dirname, extname, join } from 'node:path';
 import { transformAsync } from '@babel/core';
 const babelConfigFileCache = new Map();
+const babelConfigFileNames = ['babel.config.cjs', 'babel.config.mjs', 'babel.config.js', 'babel.config.json'];
+function normalizeTransformId(id) {
+  const withoutQuery = id.split(/[?#]/, 1)[0] ?? id;
+  return withoutQuery.startsWith('\0') ? withoutQuery.slice(1) : withoutQuery;
+}
+function isNodeModulesPath(filePath) {
+  return /(?:^|[/\\])node_modules(?:[/\\]|$)/.test(filePath);
+}
+function isTypeScriptSource(filePath) {
+  return ['.cts', '.mts', '.ts', '.tsx'].includes(extname(filePath));
+}
 
 /**
- * Resolves the nearest `babel.config.cjs` file starting from the given file path
+ * Resolves the nearest Babel root configuration file starting from the given file path
  * and searching upwards through the directory hierarchy.
  *
  * @param filePath - The path to the file whose nearest Babel configuration should be found.
- * @returns The absolute path to the nearest `babel.config.cjs` file.
+ * @returns The absolute path to the nearest Babel root configuration file.
  * @throws Error if no configuration file can be located.
  */
 export function resolveNearestBabelConfigFile(filePath) {
-  let currentDirectory = dirname(filePath);
+  let currentDirectory = dirname(normalizeTransformId(filePath));
   while (true) {
     const cachedConfigFile = babelConfigFileCache.get(currentDirectory);
     if (cachedConfigFile) {
       return cachedConfigFile;
     }
-    const configFile = join(currentDirectory, 'babel.config.cjs');
-    if (existsSync(configFile)) {
-      babelConfigFileCache.set(currentDirectory, configFile);
-      return configFile;
+    for (const configFileName of babelConfigFileNames) {
+      const configFile = join(currentDirectory, configFileName);
+      if (existsSync(configFile)) {
+        babelConfigFileCache.set(currentDirectory, configFile);
+        return configFile;
+      }
     }
     const parentDirectory = dirname(currentDirectory);
     if (parentDirectory === currentDirectory) {
-      throw new Error(`Unable to locate babel.config.cjs for ${filePath}.`);
+      throw new Error(`Unable to locate a Babel root config (${babelConfigFileNames.join(', ')}) for ${filePath}.`);
     }
     currentDirectory = parentDirectory;
   }
@@ -42,13 +55,14 @@ export function createFluoBabelDecoratorsPlugin(resolveConfigFile) {
   return {
     name: 'fluo-babel-decorators',
     async transform(code, id) {
-      if (!id.endsWith('.ts') || id.includes('/node_modules/')) {
+      const filePath = normalizeTransformId(id);
+      if (!isTypeScriptSource(filePath) || isNodeModulesPath(filePath)) {
         return null;
       }
       const result = await transformAsync(code, {
         babelrc: false,
-        configFile: resolveConfigFile(id),
-        filename: id,
+        configFile: resolveConfigFile(filePath),
+        filename: filePath,
         sourceMaps: true
       });
       if (!result?.code) {

package/dist/conformance/fetch-style-websocket-conformance.d.ts

@@ -1,14 +1,26 @@
 import type { FetchStyleHttpAdapterRealtimeCapability, HttpApplicationAdapter } from '@fluojs/http';
+/**
+ * Describes the fetch style web socket conformance harness options contract.
+ */
 export interface FetchStyleWebSocketConformanceHarnessOptions<TAdapter extends HttpApplicationAdapter = HttpApplicationAdapter> {
     createAdapter: () => TAdapter;
     expectedReason: string;
     expectedSupport?: FetchStyleHttpAdapterRealtimeCapability['support'];
     name: string;
 }
+/**
+ * Represents the fetch style web socket conformance harness.
+ */
 export declare class FetchStyleWebSocketConformanceHarness<TAdapter extends HttpApplicationAdapter = HttpApplicationAdapter> {
     private readonly options;
     constructor(options: FetchStyleWebSocketConformanceHarnessOptions<TAdapter>);
     assertExposesRawWebSocketExpansionContract(): void;
 }
+/**
+ * Create fetch style web socket conformance harness.
+ *
+ * @param options The options.
+ * @returns The create fetch style web socket conformance harness result.
+ */
 export declare function createFetchStyleWebSocketConformanceHarness<TAdapter extends HttpApplicationAdapter = HttpApplicationAdapter>(options: FetchStyleWebSocketConformanceHarnessOptions<TAdapter>): FetchStyleWebSocketConformanceHarness<TAdapter>;
 //# sourceMappingURL=fetch-style-websocket-conformance.d.ts.map

package/dist/conformance/fetch-style-websocket-conformance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-style-websocket-conformance.d.ts","sourceRoot":"","sources":["../../src/conformance/fetch-style-websocket-conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uCAAuC,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEpG,MAAM,WAAW,4CAA4C,CAC3D,QAAQ,SAAS,sBAAsB,GAAG,sBAAsB;IAEhE,aAAa,EAAE,MAAM,QAAQ,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,uCAAuC,CAAC,SAAS,CAAC,CAAC;IACrE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,qCAAqC,CAChD,QAAQ,SAAS,sBAAsB,GAAG,sBAAsB;IAEpD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,4CAA4C,CAAC,QAAQ,CAAC;IAE5F,0CAA0C,IAAI,IAAI;CAoCnD;AAED,wBAAgB,2CAA2C,CACzD,QAAQ,SAAS,sBAAsB,GAAG,sBAAsB,EAEhE,OAAO,EAAE,4CAA4C,CAAC,QAAQ,CAAC,GAC9D,qCAAqC,CAAC,QAAQ,CAAC,CAEjD"}
+{"version":3,"file":"fetch-style-websocket-conformance.d.ts","sourceRoot":"","sources":["../../src/conformance/fetch-style-websocket-conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uCAAuC,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEpG;;GAEG;AACH,MAAM,WAAW,4CAA4C,CAC3D,QAAQ,SAAS,sBAAsB,GAAG,sBAAsB;IAEhE,aAAa,EAAE,MAAM,QAAQ,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,uCAAuC,CAAC,SAAS,CAAC,CAAC;IACrE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,qBAAa,qCAAqC,CAChD,QAAQ,SAAS,sBAAsB,GAAG,sBAAsB;IAEpD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,4CAA4C,CAAC,QAAQ,CAAC;IAE5F,0CAA0C,IAAI,IAAI;CAoCnD;AAED;;;;;GAKG;AACH,wBAAgB,2CAA2C,CACzD,QAAQ,SAAS,sBAAsB,GAAG,sBAAsB,EAEhE,OAAO,EAAE,4CAA4C,CAAC,QAAQ,CAAC,GAC9D,qCAAqC,CAAC,QAAQ,CAAC,CAEjD"}

package/dist/conformance/fetch-style-websocket-conformance.js

@@ -1,3 +1,10 @@
+/**
+ * Describes the fetch style web socket conformance harness options contract.
+ */
+
+/**
+ * Represents the fetch style web socket conformance harness.
+ */
 export class FetchStyleWebSocketConformanceHarness {
   constructor(options) {
     this.options = options;
@@ -29,6 +36,13 @@ export class FetchStyleWebSocketConformanceHarness {
     }
   }
 }
+
+/**
+ * Create fetch style web socket conformance harness.
+ *
+ * @param options The options.
+ * @returns The create fetch style web socket conformance harness result.
+ */
 export function createFetchStyleWebSocketConformanceHarness(options) {
   return new FetchStyleWebSocketConformanceHarness(options);
 }

package/dist/conformance/platform-conformance.d.ts

@@ -1,22 +1,34 @@
 import type { MaybePromise } from '@fluojs/core';
 import type { PlatformComponent, PlatformDiagnosticIssue, PlatformSnapshot, PlatformState, PlatformValidationResult } from '@fluojs/runtime';
+/**
+ * Describes the platform conformance scenario contract.
+ */
 export interface PlatformConformanceScenario {
     createComponent: () => PlatformComponent;
     enterState: (component: PlatformComponent) => MaybePromise<void>;
     name: string;
     expectedState?: PlatformState;
 }
+/**
+ * Describes the platform conformance diagnostics options contract.
+ */
 export interface PlatformConformanceDiagnosticsOptions {
     collect?: (component: PlatformComponent, validation: PlatformValidationResult) => MaybePromise<readonly PlatformDiagnosticIssue[]>;
     expectedCodes?: readonly string[];
     requireFixHintForSeverities?: ReadonlyArray<PlatformDiagnosticIssue['severity']>;
 }
+/**
+ * Describes the platform conformance snapshot options contract.
+ */
 export interface PlatformConformanceSnapshotOptions {
     allowKeyPatterns?: readonly RegExp[];
     compare?: (left: unknown, right: unknown) => boolean;
     forbiddenKeyPatterns?: readonly RegExp[];
     sanitize?: (snapshot: PlatformSnapshot) => PlatformSnapshot;
 }
+/**
+ * Describes the platform conformance harness options contract.
+ */
 export interface PlatformConformanceHarnessOptions {
     captureValidationSideEffects?: (component: PlatformComponent) => MaybePromise<unknown>;
     createComponent: () => PlatformComponent;
@@ -27,6 +39,9 @@ export interface PlatformConformanceHarnessOptions {
     };
     snapshot?: PlatformConformanceSnapshotOptions;
 }
+/**
+ * Represents the platform conformance harness.
+ */
 export declare class PlatformConformanceHarness {
     private readonly options;
     constructor(options: PlatformConformanceHarnessOptions);
@@ -38,5 +53,11 @@ export declare class PlatformConformanceHarness {
     assertSnapshotSanitized(): Promise<void>;
     assertAll(): Promise<void>;
 }
+/**
+ * Create platform conformance harness.
+ *
+ * @param options The options.
+ * @returns The create platform conformance harness result.
+ */
 export declare function createPlatformConformanceHarness(options: PlatformConformanceHarnessOptions): PlatformConformanceHarness;
 //# sourceMappingURL=platform-conformance.d.ts.map

package/dist/conformance/platform-conformance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-conformance.d.ts","sourceRoot":"","sources":["../../src/conformance/platform-conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,2BAA2B;IAC1C,eAAe,EAAE,MAAM,iBAAiB,CAAC;IACzC,UAAU,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,qCAAqC;IACpD,OAAO,CAAC,EAAE,CACR,SAAS,EAAE,iBAAiB,EAC5B,UAAU,EAAE,wBAAwB,KACjC,YAAY,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAAC;IACtD,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,2BAA2B,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACrD,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,gBAAgB,CAAC;CAC7D;AAED,MAAM,WAAW,iCAAiC;IAChD,4BAA4B,CAAC,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;IACvF,eAAe,EAAE,MAAM,iBAAiB,CAAC;IACzC,WAAW,CAAC,EAAE,qCAAqC,CAAC;IACpD,SAAS,CAAC,EAAE;QACV,QAAQ,EAAE,2BAA2B,CAAC;QACtC,MAAM,EAAE,2BAA2B,CAAC;KACrC,CAAC;IACF,QAAQ,CAAC,EAAE,kCAAkC,CAAC;CAC/C;AA4ED,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,iCAAiC;IAEjE,yCAAyC,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B1D,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3C,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCvC,2CAA2C,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5D,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCxC,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBxC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAQjC;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,iCAAiC,GACzC,0BAA0B,CAE5B"}
+{"version":3,"file":"platform-conformance.d.ts","sourceRoot":"","sources":["../../src/conformance/platform-conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,eAAe,EAAE,MAAM,iBAAiB,CAAC;IACzC,UAAU,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,qCAAqC;IACpD,OAAO,CAAC,EAAE,CACR,SAAS,EAAE,iBAAiB,EAC5B,UAAU,EAAE,wBAAwB,KACjC,YAAY,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAAC;IACtD,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,2BAA2B,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC;CAClF;AAED;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACrD,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,gBAAgB,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,4BAA4B,CAAC,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;IACvF,eAAe,EAAE,MAAM,iBAAiB,CAAC;IACzC,WAAW,CAAC,EAAE,qCAAqC,CAAC;IACpD,SAAS,CAAC,EAAE;QACV,QAAQ,EAAE,2BAA2B,CAAC;QACtC,MAAM,EAAE,2BAA2B,CAAC;KACrC,CAAC;IACF,QAAQ,CAAC,EAAE,kCAAkC,CAAC;CAC/C;AA4ED;;GAEG;AACH,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,iCAAiC;IAEjE,yCAAyC,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B1D,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3C,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCvC,2CAA2C,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5D,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCxC,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBxC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAQjC;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,iCAAiC,GACzC,0BAA0B,CAE5B"}

package/dist/conformance/platform-conformance.js

@@ -1,3 +1,19 @@
+/**
+ * Describes the platform conformance scenario contract.
+ */
+
+/**
+ * Describes the platform conformance diagnostics options contract.
+ */
+
+/**
+ * Describes the platform conformance snapshot options contract.
+ */
+
+/**
+ * Describes the platform conformance harness options contract.
+ */
+
 const DEFAULT_FORBIDDEN_KEY_PATTERNS = [/secret/i, /password/i, /token/i, /credential/i, /api[-_]?key/i];
 const DEFAULT_REQUIRED_FIX_HINT_SEVERITIES = ['error'];
 function isRecord(value) {
@@ -52,6 +68,10 @@ function collectForbiddenKeyPaths(value, patterns, allowPatterns, currentPath, v
     collectForbiddenKeyPaths(entry, patterns, allowPatterns, nextPath, violations);
   }
 }
+
+/**
+ * Represents the platform conformance harness.
+ */
 export class PlatformConformanceHarness {
   constructor(options) {
     this.options = options;
@@ -188,6 +208,13 @@ export class PlatformConformanceHarness {
     await this.assertSnapshotSanitized();
   }
 }
+
+/**
+ * Create platform conformance harness.
+ *
+ * @param options The options.
+ * @returns The create platform conformance harness result.
+ */
 export function createPlatformConformanceHarness(options) {
   return new PlatformConformanceHarness(options);
 }

package/dist/mock.d.ts

@@ -2,25 +2,42 @@ import type { Mock } from 'vitest';
 import type { Token } from '@fluojs/core';
 import type { ValueProvider } from '@fluojs/di';
 import type { DeepMocked } from './types.js';
+/**
+ * Defines the mocked methods type.
+ */
 export type MockedMethods<T> = {
     [K in keyof T]: T[K] extends (...args: never[]) => unknown ? Mock<T[K]> : T[K];
 };
 /**
  * Creates a proxy mock object with optional strict missing-property checks.
+ *
+ * @param partial The partial.
+ * @param options The options.
+ * @returns The create mock result.
  */
 export declare function createMock<T extends object>(partial?: Partial<MockedMethods<T>>, options?: {
     strict?: boolean;
 }): MockedMethods<T>;
 /**
  * Casts a function to a strongly typed Vitest mock.
+ *
+ * @param fn The fn.
+ * @returns The as mock result.
  */
 export declare function asMock<T extends (...args: never[]) => unknown>(fn: T): Mock<T>;
 /**
  * Creates a deep mock by replacing prototype methods with `vi.fn()` spies.
+ *
+ * @param type The type.
+ * @returns The create deep mock result.
  */
 export declare function createDeepMock<T extends object>(type: new (...args: unknown[]) => T): DeepMocked<T>;
 /**
  * Creates a `useValue` provider for overriding a token in tests.
+ *
+ * @param token The token.
+ * @param partial The partial.
+ * @returns The mock token result.
  */
 export declare function mockToken<T>(token: Token<T>, partial?: Partial<T>): ValueProvider<T>;
 //# sourceMappingURL=mock.d.ts.map

package/dist/mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC/E,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAM,EACvC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,aAAa,CAAC,CAAC,CAAC,CAsBlB;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAE9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAkBnG;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,OAAO,CAAC,CAAC,CAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAExF"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC/E,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAM,EACvC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,aAAa,CAAC,CAAC,CAAC,CAsBlB;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAkBnG;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,OAAO,CAAC,CAAC,CAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAExF"}