@dooboostore/simple-web-component 1.0.49 → 1.0.51

package/dist/types/decorators/mutationObserver.d.ts

@@ -1,9 +1,24 @@
 import { SpecialSelector, SwcQueryOptions, SwcSelector, SwcFnSelector, HelperHostSet } from '../types';
 export interface MutationObserverBaseOptions extends MutationObserverInit {
+    /** 매칭 시 핸들러 실행 여부 게이트. Promise<boolean>도 되어 async 판정 가능. false면 스킵. */
     filter?: (matchedEls: HTMLElement[], meta: {
         currentThis: any;
         helper: HelperHostSet;
-    }) => boolean;
+    }) => boolean | Promise<boolean>;
+    /** filter 통과 후 핸들러 직전 훅. await되고, 리턴값은 @mutationObserverBeforeReturn 으로 핸들러에 주입된다. */
+    before?: (matchedEls: HTMLElement[], meta: {
+        currentThis: any;
+        helper: HelperHostSet;
+    }) => any | Promise<any>;
+    /** 핸들러가 성공/실패해도 항상 실행되는 정리 훅. ctx로 결과/에러를 받는다. 에러는 로깅됨. */
+    finally?: (matchedEls: HTMLElement[], meta: {
+        currentThis: any;
+        helper: HelperHostSet;
+    }, ctx: {
+        args: any[];
+        result?: any;
+        error?: any;
+    }) => any | Promise<any>;
     removeObserver?: (target: Element, optionValue: MutationObserverQueryOptions) => void;
 }
 export type MutationObserverQueryOptions = MutationObserverBaseOptions & SwcQueryOptions & {
@@ -20,27 +35,34 @@ export declare const MUTATION_OBSERVER_METADATA_KEY: unique symbol;
 export declare function mutationObserver(target: SpecialSelector, options?: MutationObserverQueryOptions): MethodDecorator;
 export declare function mutationObserver(selector: string, options?: MutationObserverQueryOptions): MethodDecorator;
 export declare function mutationObserver(selector: SwcFnSelector, options?: MutationObserverNonQueryOptions): MethodDecorator;
-export declare function mutationObserver(options?: MutationObserverQueryOptions): MethodDecorator;
-export declare function mutationObserverThis<TEvent extends Event = Event>(options?: MutationObserverQueryOptions): MethodDecorator;
+export declare function mutationObserver(options: MutationObserverQueryOptions): MethodDecorator;
+export declare function mutationObserver(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function mutationObserverDelegateLight(selector: string, options?: MutationObserverBaseOptions): MethodDecorator;
-export declare function mutationObserverDelegateLight(options?: MutationObserverBaseOptions): MethodDecorator;
+export declare function mutationObserverDelegateLight(options: MutationObserverBaseOptions): MethodDecorator;
+export declare function mutationObserverDelegateLight(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function mutationObserverDelegateShadow(selector: string, options?: MutationObserverBaseOptions): MethodDecorator;
-export declare function mutationObserverDelegateShadow(options?: MutationObserverBaseOptions): MethodDecorator;
+export declare function mutationObserverDelegateShadow(options: MutationObserverBaseOptions): MethodDecorator;
+export declare function mutationObserverDelegateShadow(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function mutationObserverDelegateAll(selector: string, options?: MutationObserverBaseOptions): MethodDecorator;
-export declare function mutationObserverDelegateAll(options?: MutationObserverBaseOptions): MethodDecorator;
+export declare function mutationObserverDelegateAll(options: MutationObserverBaseOptions): MethodDecorator;
+export declare function mutationObserverDelegateAll(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function mutationObserverDelegate(selector: string, options?: MutationObserverBaseOptions): MethodDecorator;
-export declare function mutationObserverDelegate(options?: MutationObserverBaseOptions): MethodDecorator;
+export declare function mutationObserverDelegate(options: MutationObserverBaseOptions): MethodDecorator;
+export declare function mutationObserverDelegate(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function mutationObserverLight(selector: string, options?: Omit<MutationObserverQueryOptions, 'root'>): MethodDecorator;
-export declare function mutationObserverLight(options?: Omit<MutationObserverQueryOptions, 'root'>): MethodDecorator;
+export declare function mutationObserverLight(options: Omit<MutationObserverQueryOptions, 'root'>): MethodDecorator;
+export declare function mutationObserverLight(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function mutationObserverShadow(selector: string, options?: Omit<MutationObserverQueryOptions, 'root'>): MethodDecorator;
-export declare function mutationObserverShadow(options?: Omit<MutationObserverQueryOptions, 'root'>): MethodDecorator;
+export declare function mutationObserverShadow(options: Omit<MutationObserverQueryOptions, 'root'>): MethodDecorator;
+export declare function mutationObserverShadow(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function mutationObserverAll(selector: string, options?: Omit<MutationObserverQueryOptions, 'root'>): MethodDecorator;
-export declare function mutationObserverAll(options?: Omit<MutationObserverQueryOptions, 'root'>): MethodDecorator;
+export declare function mutationObserverAll(options: Omit<MutationObserverQueryOptions, 'root'>): MethodDecorator;
+export declare function mutationObserverAll(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function getMutationObserverMetadata(target: any): MutationObserverMetadata[] | undefined;
-import { ElementDefineLifeCycler, OnConnectedResult } from '../types';
+import { ElementDefineLifeCycler, ObserverScope, OnConnectedResult, ResizeObserverSet } from '../types';
 export declare class MutationObserverLifeCycler implements ElementDefineLifeCycler {
     private readonly removeObserverCallbacksMap;
-    onConnected(helperHostSet: HelperHostSet): OnConnectedResult | void;
+    onConnected(helperHostSet: HelperHostSet, _set?: ResizeObserverSet, scope?: ObserverScope): OnConnectedResult | void;
     onDisconnected(helperHostSet: HelperHostSet): void;
 }
 //# sourceMappingURL=mutationObserver.d.ts.map

package/dist/types/decorators/mutationObserver.d.ts.map

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

package/dist/types/decorators/parameter.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @eventObject/@matchedElement/@hostSet/@helperHostSet/@helperSet/@swcAppRouterEvent/@appMessage/@eventBeforeReturn —
+ * @event/lifecycle/subscribeSwcAppRouteChange/subscribeSwcAppMessage
+ * 계열 핸들러의 파라미터를 순서 무관하게 선언할 수 있게 해주는 파라미터 데코레이터.
+ * @dooboostore/simple-boot의 @Inject와 동일한 인덱스 기반 메타데이터 패턴을 따른다:
+ * 데코레이터가 실행되는 순서가 아니라 실제 parameterIndex로 슬롯을 매칭하므로,
+ * 사용자가 파라미터 선언 순서를 자유롭게 바꿔도 된다.
+ */
+export type SwcParamKind = 'eventObject' | 'matchedElement' | 'hostSet' | 'helperHostSet' | 'helperSet' | 'swcAppRouterEvent' | 'appMessage' | 'eventBeforeReturn' | 'appMessageBeforeReturn' | 'routeChangeBeforeReturn' | 'eventMediaBeforeReturn' | 'mutationObserverBeforeReturn' | 'intersectionObserverBeforeReturn' | 'resizeObserverBeforeReturn' | 'changedAttributeBeforeReturn' | 'setTimeoutBeforeReturn' | 'setIntervalBeforeReturn' | 'fetchSettled' | SwcRouteParamKind;
+/** 라우트 핸들러 전용 (subscribeSwcAppRouteChange 가 채움). kind 이름 = 데코레이터 이름 */
+export type SwcRouteParamKind = 'swcAppRouteQueryParam' | 'swcAppRouteFirstQueryParam' | 'swcAppRouteLastQueryParam' | 'swcAppRouteQueryParams' | 'swcAppRouteQueryParamObject' | 'swcAppRouteFirstQueryParamObject' | 'swcAppRouteLastQueryParamObject' | 'swcAppRouteQueryParamsObject' | 'swcAppRouteURLSearchParams' | 'swcAppRoutePathVariable' | 'swcAppRouteFirstPathVariable' | 'swcAppRouteLastPathVariable' | 'swcAppRoutePathVariables' | 'swcAppRoutePathVariableObject' | 'swcAppRouteFirstPathVariableObject' | 'swcAppRouteLastPathVariableObject' | 'swcAppRoutePathVariablesObject';
+/** key: @swcAppRouteQueryParam('q') 처럼 키를 받는 파라미터 데코레이터의 키 */
+type SaveParamConfig = {
+    index: number;
+    kind: SwcParamKind;
+    key?: string;
+};
+/** 이벤트 핸들러의 원본 Event 객체를 주입한다. */
+export declare function eventObject(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** delegate로 매칭된 실제 엘리먼트($matchedElement)를 주입한다. */
+export declare function matchedElement(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** HostSet(호스트 트리 정보 — $host/$hosts/$firstHost/$appHost 등)을 주입한다. */
+export declare function hostSet(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** HelperHostSet(HelperSet + HostSet + $this 전체 묶음)을 주입한다. */
+export declare function helperHostSet(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** HelperSet($d/$w/$q/$qa/$qi 등 순수 DOM/window 헬퍼, 호스트 트리 정보 없음)을 주입한다. */
+export declare function helperSet(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** @subscribeSwcAppRouteChange 핸들러의 라우트 변경 이벤트({...RouterEventType, pathData})를 주입한다. */
+export declare function swcAppRouterEvent(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** @subscribeSwcAppMessage 핸들러의 SwcAppMessage 페이로드를 주입한다. */
+export declare function appMessage(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/**
+ * @event 계열의 before 훅이 이번 호출에 리턴한 값을 주입한다.
+ * (before에서 async로 준비한 데이터를 핸들러가 받는 용도. before 없으면 undefined)
+ * 예: @eventClick({ before: () => loadUser() }) onClick(@eventBeforeReturn user) { ... }
+ */
+export declare function eventBeforeReturn(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/**
+ * @subscribeSwcAppMessage 의 before 훅이 이번 호출에 리턴한 값을 주입한다.
+ * (before에서 async로 준비한 데이터를 핸들러가 받는 용도. 없으면 undefined)
+ * 예: onMsg(@appMessage m, @appMessageBeforeReturn prepared) { ... }
+ */
+export declare function appMessageBeforeReturn(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/**
+ * @subscribeSwcAppRouteChange 의 before 훅이 이번 호출에 리턴한 값을 주입한다.
+ * (before에서 async 가드/준비한 데이터를 핸들러가 받는 용도. 없으면 undefined)
+ * 예: routeChanged(@swcAppRouterEvent e, @routeChangeBeforeReturn guard) { ... }
+ */
+export declare function routeChangeBeforeReturn(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/**
+ * @eventMedia 의 before 훅이 이번 호출에 리턴한 값을 주입한다. (before 없으면 undefined)
+ * 예: @eventMediaChange('(max-width:600px)', { before: () => ... }) onMobile(@eventMediaBeforeReturn v) { ... }
+ */
+export declare function eventMediaBeforeReturn(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** @mutationObserver 의 before 훅이 이번 호출에 리턴한 값을 주입한다. (before 없으면 undefined) */
+export declare function mutationObserverBeforeReturn(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** @intersectionObserver 의 before 훅이 이번 호출에 리턴한 값을 주입한다. (before 없으면 undefined) */
+export declare function intersectionObserverBeforeReturn(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** @resizeObserver 의 before 훅이 이번 호출에 리턴한 값을 주입한다. (before 없으면 undefined) */
+export declare function resizeObserverBeforeReturn(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** @changedAttribute 의 before 훅이 이번 호출에 리턴한 값을 주입한다. (before 없으면 undefined) */
+export declare function changedAttributeBeforeReturn(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** @setTimeout(type:'onConnected') 의 before 훅이 이번 호출에 리턴한 값을 주입한다. (before 없으면 undefined) */
+export declare function setTimeoutBeforeReturn(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/** @setInterval(type:'onConnected') 의 before 훅이 이번 호출에 리턴한 값을 주입한다. (before 없으면 undefined) */
+export declare function setIntervalBeforeReturn(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+/**
+ * @fetch(trigger:'before') 의 fetch settled 결과(PromiseSettledResult)를 주입한다.
+ * 예: save(@fetchSettled settled) { ... }
+ */
+export declare function fetchSettled(target: Object, propertyKey: string | symbol, parameterIndex: number): void;
+export declare const getParameterMetadata: (target: any, propertyKey: string | symbol) => SaveParamConfig[];
+/**
+ * 위 파라미터 데코레이터 메타데이터가 하나라도 있으면 kind별 값을 index 순서에 맞게
+ * 배열로 조립하고, 하나도 없으면 기존 위치 인자(legacyArgs)를 그대로 반환한다 — 완전 하위호환.
+ */
+export declare const buildSwcParameterArgs: (target: any, propertyKey: string | symbol, kindValues: Partial<Record<SwcParamKind, any>>, legacyArgs: any[]) => any[];
+/** ?tag=a&tag=b → @swcAppRouteQueryParam('tag') = 'a' (없으면 null) */
+export declare const swcAppRouteQueryParam: (key: string) => ParameterDecorator;
+/** = swcAppRouteQueryParam */
+export declare const swcAppRouteFirstQueryParam: (key: string) => ParameterDecorator;
+/** ?tag=a&tag=b → 'b' */
+export declare const swcAppRouteLastQueryParam: (key: string) => ParameterDecorator;
+/** ?tag=a&tag=b → ['a', 'b'] */
+export declare const swcAppRouteQueryParams: (key: string) => ParameterDecorator;
+/** ?tag=a&tag=b → { tag: 'a' } */
+export declare const swcAppRouteQueryParamObject: ParameterDecorator;
+/** = swcAppRouteQueryParamObject */
+export declare const swcAppRouteFirstQueryParamObject: ParameterDecorator;
+/** ?tag=a&tag=b → { tag: 'b' } */
+export declare const swcAppRouteLastQueryParamObject: ParameterDecorator;
+/** ?tag=a&tag=b → { tag: ['a', 'b'] } */
+export declare const swcAppRouteQueryParamsObject: ParameterDecorator;
+/** URLSearchParams 그대로 */
+export declare const swcAppRouteURLSearchParams: ParameterDecorator;
+/** '/a/{id}/b/{id}' ← '/a/1/b/2' → @swcAppRoutePathVariable('id') = '1' */
+export declare const swcAppRoutePathVariable: (key: string) => ParameterDecorator;
+/** = swcAppRoutePathVariable */
+export declare const swcAppRouteFirstPathVariable: (key: string) => ParameterDecorator;
+/** → '2' */
+export declare const swcAppRouteLastPathVariable: (key: string) => ParameterDecorator;
+/** → ['1', '2'] */
+export declare const swcAppRoutePathVariables: (key: string) => ParameterDecorator;
+/** → { id: '1' } */
+export declare const swcAppRoutePathVariableObject: ParameterDecorator;
+/** = swcAppRoutePathVariableObject */
+export declare const swcAppRouteFirstPathVariableObject: ParameterDecorator;
+/** → { id: '2' } */
+export declare const swcAppRouteLastPathVariableObject: ParameterDecorator;
+/** → { id: ['1', '2'] } */
+export declare const swcAppRoutePathVariablesObject: ParameterDecorator;
+export {};
+//# sourceMappingURL=parameter.d.ts.map

package/dist/types/decorators/parameter.d.ts.map

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

package/dist/types/decorators/publishSwcAppMessage.d.ts

@@ -23,7 +23,6 @@ export interface PublishSwcAppMessageOptions {
     valueKey?: symbol | string;
 }
 export declare function publishSwcAppMessage(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): PropertyDescriptor | void;
-export declare function publishSwcAppMessage(): MethodDecorator;
 export declare function publishSwcAppMessage(messageType: string): MethodDecorator;
 export declare function publishSwcAppMessage(messageType: string, options: PublishSwcAppMessageOptions): MethodDecorator;
 export declare function publishSwcAppMessage(options: PublishSwcAppMessageOptions): MethodDecorator;

package/dist/types/decorators/publishSwcAppMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publishSwcAppMessage.d.ts","sourceRoot":"","sources":["../../../src/decorators/publishSwcAppMessage.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oCAAoC,eAA6D,CAAC;AAE/G,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAwED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI,CAAC;AAE9I,wBAAgB,oBAAoB,IAAI,eAAe,CAAC;AACxD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAAC;AAC3E,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,2BAA2B,GAAG,eAAe,CAAC;AACjH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,eAAe,CAAC;AA+B5F,eAAO,MAAM,cAAc,6BAAuB,CAAC;AAGnD,eAAO,MAAM,+BAA+B,GAAI,QAAQ,GAAG,KAAG,4BAA4B,EAAE,GAAG,SAG9F,CAAC"}
+{"version":3,"file":"publishSwcAppMessage.d.ts","sourceRoot":"","sources":["../../../src/decorators/publishSwcAppMessage.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oCAAoC,eAA6D,CAAC;AAE/G,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAwED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI,CAAC;AAE9I,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAAC;AAC3E,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,2BAA2B,GAAG,eAAe,CAAC;AACjH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,eAAe,CAAC;AA+B5F,eAAO,MAAM,cAAc,6BAAuB,CAAC;AAGnD,eAAO,MAAM,+BAA+B,GAAI,QAAQ,GAAG,KAAG,4BAA4B,EAAE,GAAG,SAG9F,CAAC"}

package/dist/types/decorators/query.d.ts

@@ -29,16 +29,16 @@ export declare const resolveQueryElements: (inst: any, selector: QuerySelector,
  * - 'all' / 'even'(0,2,4...) / 'odd'(1,3,5...) → 배열
  */
 export declare const pickElements: (all: HTMLElement[], pick: QueryPick) => HTMLElement | HTMLElement[] | null;
-export declare function query(target: Object, propertyKey: string | symbol, descriptor?: PropertyDescriptor): PropertyDescriptor | void;
 export declare function query(selector: string, options?: QueryOptions): PropertyDecorator;
 export declare function query(selector: QueryFnSelector, options?: QueryNonQueryOptions): PropertyDecorator;
-export declare function query(options?: QueryOptions): PropertyDecorator;
+export declare function query(options: QueryOptions): PropertyDecorator;
+export declare function query(target: Object, propertyKey: string | symbol): void;
 export declare const getQueryMetadata: (target: any) => QueryMetadata[];
 export declare const QUERY_ALL_METADATA_KEY: symbol;
-export declare function queryAll(target: Object, propertyKey: string | symbol, descriptor?: PropertyDescriptor): PropertyDescriptor | void;
 export declare function queryAll(selector: string, options?: Omit<QueryOptions, 'pick'>): PropertyDecorator;
 export declare function queryAll(selector: QueryFnSelector, options?: Omit<QueryNonQueryOptions, 'pick'>): PropertyDecorator;
-export declare function queryAll(options?: Omit<QueryOptions, 'pick'>): PropertyDecorator;
+export declare function queryAll(options: Omit<QueryOptions, 'pick'>): PropertyDecorator;
+export declare function queryAll(target: Object, propertyKey: string | symbol): void;
 export declare const getQueryAllMetadata: (target: any) => QueryMetadata[];
 /**
  * @queryShadow(selector, options?) — shadow DOM에서 요소를 쿼리
@@ -69,9 +69,9 @@ export declare function queryAllAll(selector: string | QueryFnSelector, options?
  * first/last/even/odd/all/number를 모두 지원하는 데코레이터를 생성한다.
  *
  * @example
- * @queryIn('shadow', 'even')('.item')   // shadow DOM 짝수 인덱스들
- * @queryIn('light', 2)('.item')         // light DOM 3번째 요소
- * @queryIn('all')('.item')              // root all, pick 기본 first
+ * @(queryIn('shadow', 'even')('.item'))   // shadow DOM 짝수 인덱스들 (호출이 이어지면 바깥 괄호 필요)
+ * @(queryIn('light', 2)('.item'))         // light DOM 3번째 요소
+ * @(queryIn('all')('.item'))              // root all, pick 기본 first
  */
 export declare const queryIn: (root: SwcRootType, pick?: QueryPick) => (selector: string | QueryFnSelector, options?: QueryBaseOptions) => PropertyDecorator;
 //# sourceMappingURL=query.d.ts.map

package/dist/types/decorators/query.d.ts.map

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

package/dist/types/decorators/requestAnimationFrame.d.ts

@@ -0,0 +1,47 @@
+import { ElementDefineLifeCycler, HelperHostSet } from '../types';
+export declare const REQUEST_ANIMATION_FRAME_METADATA_KEY: unique symbol;
+export type RequestAnimationFrameType = 'onConnected' | 'returnValue';
+export interface RequestAnimationFrameOptions {
+    /**
+     * 'onConnected' - connect 시 자동으로 루프 시작 (매 프레임 데코레이트된 메서드를 직접 호출), disconnect 시 자동 정리.
+     * 'returnValue'(기본값) - 자동 시작 없음. 개발자가 이 메서드를 직접 호출해야 시작되고,
+     *   그 호출의 리턴값(또는 valueKey로 뽑은 값)이 실제로 매 프레임 호출될 함수가 된다.
+     */
+    type?: RequestAnimationFrameType;
+    /** 루프 시작 직후 1회 호출 (디버깅/로깅용). id는 첫 requestAnimationFrame 반환값 - cleanup은 자동으로 처리되므로 직접 취소할 필요 없음. */
+    created?: (set: HelperHostSet, id: number) => void;
+    /**
+     * type:'returnValue' 전용 - 리턴값이 함수면 그 자체를, 객체면 이 키의 값이 함수일 때 그 값을
+     * "매 프레임 호출될 함수"로 사용한다. 안 주면 REQUEST_ANIMATION_FRAME_METADATA_KEY로 폴백한다 -
+     * applyAttribute.ts/applyNode.ts의 valueKey와 동일한 컨벤션.
+     */
+    valueKey?: symbol | string;
+}
+export interface RequestAnimationFrameMetadata {
+    propertyKey: string | symbol;
+    options: RequestAnimationFrameOptions;
+}
+/**
+ * 프레임 콜백 시그니처.
+ * - timestamp: 이번 프레임의 시각 (requestAnimationFrame이 넘겨주는 값)
+ * - prevValue: 직전 호출이 리턴한 값 (첫 호출에서는 undefined)
+ * 리턴값이 undefined/null이면 다음 프레임을 예약하지 않고 루프가 멈춘다 (개발자가 종료를 제어).
+ * undefined/null이 아닌 값을 리턴하면 그 값 그대로 다음 호출의 prevValue로 전달된다.
+ */
+export type FrameCallback = (timestamp: number, prevValue?: any) => any;
+/**
+ * type:'onConnected' - connect 시 자동으로 매 프레임 루프를 시작하고, disconnect 시 자동으로 cancelAnimationFrame 한다.
+ * type:'returnValue'(기본값) - 메서드를 감싸지 않는 대신, 호출될 때마다(개발자가 직접 호출) 원본 로직을
+ *   그대로 실행하고 리턴값(또는 valueKey로 뽑은 값)이 함수면 그 함수를 매 프레임 호출되는 루프로 등록한다.
+ *   원본 리턴값은 그대로 통과시키므로 다른 데코레이터와 같은 메서드에 스택해도 순서에 상관없이 안전하다.
+ *
+ * 옵션 없이 `@requestAnimationFrame` 그대로 붙여도 되고, `@requestAnimationFrame({...})`처럼 옵션을 줄 수도 있다.
+ */
+export declare function requestAnimationFrame(options: RequestAnimationFrameOptions): MethodDecorator;
+export declare function requestAnimationFrame(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
+export declare const findAllRequestAnimationFrameMetadata: (target: any) => RequestAnimationFrameMetadata[];
+export declare class RequestAnimationFrameLifeCycler implements ElementDefineLifeCycler {
+    onConnected(helperHostSet: HelperHostSet): void;
+    onDisconnected(helperHostSet: HelperHostSet): void;
+}
+//# sourceMappingURL=requestAnimationFrame.d.ts.map

package/dist/types/decorators/requestAnimationFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestAnimationFrame.d.ts","sourceRoot":"","sources":["../../../src/decorators/requestAnimationFrame.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAElE,eAAO,MAAM,oCAAoC,eAA6D,CAAC;AAE/G,MAAM,MAAM,yBAAyB,GAAG,aAAa,GAAG,aAAa,CAAC;AAEtE,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,IAAI,CAAC,EAAE,yBAAyB,CAAC;IACjC,oGAAoG;IACpG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,OAAO,EAAE,4BAA4B,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC;AA2DxE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,eAAe,CAAC;AAC9F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;AAa1H,eAAO,MAAM,oCAAoC,GAAI,QAAQ,GAAG,KAAG,6BAA6B,EAG/F,CAAC;AAEF,qBAAa,+BAAgC,YAAW,uBAAuB;IAC7E,WAAW,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAY/C,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;CAWnD"}

package/dist/types/decorators/resizeObserver.d.ts

@@ -1,10 +1,25 @@
 import { SpecialSelector, SwcQueryOptions, SwcFnSelector, SwcSelector, HelperHostSet } from '../types';
 export interface ResizeObserverBaseOptions {
     box?: 'content-box' | 'border-box' | 'device-pixel-content-box';
+    /** 매칭 시 핸들러 실행 여부 게이트. Promise<boolean>도 되어 async 판정 가능. false면 스킵. */
     filter?: (matchedEls: HTMLElement[], meta: {
         currentThis: any;
         helper: HelperHostSet;
-    }) => boolean;
+    }) => boolean | Promise<boolean>;
+    /** filter 통과 후 핸들러 직전 훅. await되고, 리턴값은 @resizeObserverBeforeReturn 으로 핸들러에 주입된다. */
+    before?: (matchedEls: HTMLElement[], meta: {
+        currentThis: any;
+        helper: HelperHostSet;
+    }) => any | Promise<any>;
+    /** 핸들러가 성공/실패해도 항상 실행되는 정리 훅. ctx로 인자/결과/에러를 받는다. 에러는 로깅됨. */
+    finally?: (matchedEls: HTMLElement[], meta: {
+        currentThis: any;
+        helper: HelperHostSet;
+    }, ctx: {
+        args: any[];
+        result?: any;
+        error?: any;
+    }) => any | Promise<any>;
     removeObserver?: (target: Element, optionValue: ResizeObserverOptions) => void;
 }
 export type ResizeObserverQueryOptions = ResizeObserverBaseOptions & SwcQueryOptions & {
@@ -22,27 +37,34 @@ export declare const RESIZE_OBSERVER_METADATA_KEY: unique symbol;
 export declare function resizeObserver(target: SpecialSelector, options?: ResizeObserverQueryOptions): MethodDecorator;
 export declare function resizeObserver(selector: string, options?: ResizeObserverQueryOptions): MethodDecorator;
 export declare function resizeObserver(selector: SwcFnSelector, options?: ResizeObserverNonQueryOptions): MethodDecorator;
-export declare function resizeObserver(options?: ResizeObserverQueryOptions): MethodDecorator;
-export declare function resizeObserverThis(options?: ResizeObserverQueryOptions): MethodDecorator;
+export declare function resizeObserver(options: ResizeObserverQueryOptions): MethodDecorator;
+export declare function resizeObserver(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function resizeObserverDelegateLight(selector: string, options?: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
-export declare function resizeObserverDelegateLight(options?: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
+export declare function resizeObserverDelegateLight(options: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
+export declare function resizeObserverDelegateLight(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function resizeObserverDelegateShadow(selector: string, options?: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
-export declare function resizeObserverDelegateShadow(options?: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
+export declare function resizeObserverDelegateShadow(options: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
+export declare function resizeObserverDelegateShadow(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function resizeObserverDelegateAll(selector: string, options?: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
-export declare function resizeObserverDelegateAll(options?: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
+export declare function resizeObserverDelegateAll(options: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
+export declare function resizeObserverDelegateAll(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function resizeObserverDelegate(selector: string, options?: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
-export declare function resizeObserverDelegate(options?: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
+export declare function resizeObserverDelegate(options: Omit<ResizeObserverQueryOptions, 'delegate'>): MethodDecorator;
+export declare function resizeObserverDelegate(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function resizeObserverLight(selector: string, options?: ResizeObserverQueryOptions): MethodDecorator;
-export declare function resizeObserverLight(options?: ResizeObserverQueryOptions): MethodDecorator;
+export declare function resizeObserverLight(options: ResizeObserverQueryOptions): MethodDecorator;
+export declare function resizeObserverLight(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function resizeObserverShadow(selector: string, options?: ResizeObserverQueryOptions): MethodDecorator;
-export declare function resizeObserverShadow(options?: ResizeObserverQueryOptions): MethodDecorator;
+export declare function resizeObserverShadow(options: ResizeObserverQueryOptions): MethodDecorator;
+export declare function resizeObserverShadow(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function resizeObserverAll(selector: string, options?: ResizeObserverQueryOptions): MethodDecorator;
-export declare function resizeObserverAll(options?: ResizeObserverQueryOptions): MethodDecorator;
+export declare function resizeObserverAll(options: ResizeObserverQueryOptions): MethodDecorator;
+export declare function resizeObserverAll(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export declare function getResizeObserverMetadata(target: any): ResizeObserverMetadata[] | undefined;
-import { ElementDefineLifeCycler, OnConnectedResult } from '../types';
+import { ElementDefineLifeCycler, ObserverScope, OnConnectedResult, ResizeObserverSet } from '../types';
 export declare class ResizeObserverLifeCycler implements ElementDefineLifeCycler {
     private readonly removeObserverCallbacksMap;
-    onConnected(helperHostSet: HelperHostSet): OnConnectedResult | void;
+    onConnected(helperHostSet: HelperHostSet, _set?: ResizeObserverSet, scope?: ObserverScope): OnConnectedResult | void;
     onDisconnected(helperHostSet: HelperHostSet): void;
 }
 //# sourceMappingURL=resizeObserver.d.ts.map

package/dist/types/decorators/resizeObserver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resizeObserver.d.ts","sourceRoot":"","sources":["../../../src/decorators/resizeObserver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGvG,MAAM,WAAW,yBAAyB;IACxC,GAAG,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,0BAA0B,CAAC;IAChE,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE;QAAE,WAAW,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,KAAK,OAAO,CAAC;IACnG,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAChF;AAGD,MAAM,MAAM,0BAA0B,GAAG,yBAAyB,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9G,MAAM,MAAM,6BAA6B,GAAG,yBAAyB,CAAC;AAEtE,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAG/D,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,MAAM,GAAG,0BAA0B,GAAG,6BAA6B,CAAC;AAE3I,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,eAAO,MAAM,4BAA4B,eAAqD,CAAC;AAE/F,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,eAAe,CAAC;AAC/G,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,eAAe,CAAC;AACxG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,6BAA6B,GAAG,eAAe,CAAC;AAClH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,eAAe,CAAC;AA6BtF,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,eAAe,CAExF;AAID,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC;AACvI,wBAAgB,2BAA2B,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC;AAQrH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC;AACxI,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC;AAQtH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC;AACrI,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC;AAQnH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC;AAClI,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC;AAUhH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,eAAe,CAAC;AAC7G,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,eAAe,CAAC;AAQ3F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,eAAe,CAAC;AAC9G,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,eAAe,CAAC;AAQ5F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,eAAe,CAAC;AAC3G,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,eAAe,CAAC;AAQzF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,GAAG,GAAG,sBAAsB,EAAE,GAAG,SAAS,CAG3F;AAQD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAA6C,MAAM,UAAU,CAAC;AAGjH,qBAAa,wBAAyB,YAAW,uBAAuB;IACtE,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAA+G;IAE1J,WAAW,CAAC,aAAa,EAAE,aAAa,GAAG,iBAAiB,GAAG,IAAI;IA+EnE,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;CAOnD"}
+{"version":3,"file":"resizeObserver.d.ts","sourceRoot":"","sources":["../../../src/decorators/resizeObserver.ts"],"names":[],"mappings":"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"}

package/dist/types/decorators/setInterval.d.ts

@@ -1,13 +1,32 @@
 import { ElementDefineLifeCycler, HelperHostSet } from '../types';
 export declare const SET_INTERVAL_METADATA_KEY: unique symbol;
+export type SetIntervalType = 'onConnected' | 'returnValue';
 export interface SetIntervalOptions {
-    /** 매 tick마다 데코레이트된 메서드에 넘길 인자를 계산. 없으면 인자 없이 호출. */
+    /**
+     * 'onConnected' (connect 시 자동으로 시작, disconnect 시 자동 정리) |
+     * 'returnValue' (기본값 - 자동 시작 없음. 개발자가 이 메서드를 직접 호출해야 시작되고,
+     *   그 호출의 리턴값이 실제로 반복 실행될 함수가 된다 - 아래 설명 참고).
+     */
+    type?: SetIntervalType;
+    /** 매 tick마다 데코레이트된 메서드에 넘길 인자를 계산. type:'onConnected'에서만 의미가 있음 (없으면 인자 없이 호출). */
     parameter?: (set: HelperHostSet) => any[];
     /** 타이머 등록 직후 1회 호출 (디버깅/로깅용). id는 실제 setInterval 반환값 - cleanup은 자동으로 처리되므로 직접 clear할 필요 없음. */
     created?: (set: HelperHostSet, id: number) => void;
+    /** [type:'onConnected' 전용] 매 tick 실행 여부 게이트. Promise<boolean>도 가능. false면 이 tick 스킵. */
+    filter?: (set: HelperHostSet) => boolean | Promise<boolean>;
+    /** [type:'onConnected' 전용] tick 핸들러 직전 훅. await되고, 리턴값은 @setIntervalBeforeReturn 으로 주입된다. */
+    before?: (set: HelperHostSet) => any | Promise<any>;
+    /** [type:'onConnected' 전용] tick 핸들러가 성공/실패해도 항상 실행되는 정리 훅. ctx로 인자/결과/에러. */
+    finally?: (set: HelperHostSet, ctx: {
+        args: any[];
+        result?: any;
+        error?: any;
+    }) => any | Promise<any>;
     /**
-     * 매 tick마다 데코레이트된 메서드의 리턴값이 객체이고 이 키의 값이 함수이면 (id: number)로 호출한다.
-     * applyAttribute.ts의 valueKey와 동일한 컨벤션 - 리턴 객체에서 이 데코레이터 몫만 뽑아 쓴다.
+     * type:'onConnected' - 매 tick마다 데코레이트된 메서드의 리턴값이 객체이고 이 키의 값이 함수이면 (id: number)로 호출한다.
+     * type:'returnValue' - 리턴값이 함수면 그 자체를, 객체면 이 키의 값이 함수일 때 그 값을 "실제로 반복 실행될 함수"로 사용한다.
+     * 안 주면 SET_INTERVAL_METADATA_KEY로 폴백한다 - applyAttribute.ts/applyNode.ts의 valueKey와 동일한 컨벤션
+     * (리턴 객체에서 이 데코레이터 몫만 뽑아 쓰고, 다른 데코레이터와 스택할 때만 커스텀 키로 구분하면 된다).
      */
     valueKey?: symbol | string;
 }
@@ -17,12 +36,15 @@ export interface SetIntervalMetadata {
     options: SetIntervalOptions;
 }
 /**
- * connect 시 자동으로 setInterval을 걸고, disconnect 시 자동으로 clearInterval 한다.
+ * type:'onConnected' - connect 시 자동으로 setInterval을 걸고, disconnect 시 자동으로 clearInterval 한다.
+ * type:'returnValue'(기본값) - 메서드를 감싸지 않는 대신, 호출될 때마다(개발자가 직접 호출) 원본 로직을
+ *   그대로 실행하고 리턴값(또는 valueKey로 뽑은 값)이 함수면 그 함수를 새 setInterval의 반복 콜백으로 등록한다.
+ *   호출할 때마다 별도의 새 타이머가 생기며, disconnect 시 전부 정리된다. 원본 리턴값은 그대로 통과시키므로
+ *   다른 데코레이터와 같은 메서드에 스택해도 순서에 상관없이 안전하다.
  */
 export declare function setInterval(interval: number, options?: SetIntervalOptions): MethodDecorator;
 export declare const findAllSetIntervalMetadata: (target: any) => SetIntervalMetadata[];
 export declare class SetIntervalLifeCycler implements ElementDefineLifeCycler {
-    private readonly activeMap;
     onConnected(helperHostSet: HelperHostSet): void;
     onDisconnected(helperHostSet: HelperHostSet): void;
 }

package/dist/types/decorators/setInterval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setInterval.d.ts","sourceRoot":"","sources":["../../../src/decorators/setInterval.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAElE,eAAO,MAAM,yBAAyB,eAAkD,CAAC;AAEzF,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,GAAG,EAAE,CAAC;IAC1C,+FAA+F;IAC/F,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,eAAe,CAU/F;AAED,eAAO,MAAM,0BAA0B,GAAI,QAAQ,GAAG,KAAG,mBAAmB,EAG3E,CAAC;AAEF,qBAAa,qBAAsB,YAAW,uBAAuB;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAE1D,WAAW,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAsB/C,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;CAWnD"}
+{"version":3,"file":"setInterval.d.ts","sourceRoot":"","sources":["../../../src/decorators/setInterval.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAElE,eAAO,MAAM,yBAAyB,eAAkD,CAAC;AAEzF,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,aAAa,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,mFAAmF;IACnF,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,GAAG,EAAE,CAAC;IAC1C,+FAA+F;IAC/F,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,wFAAwF;IACxF,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,6FAA6F;IAC7F,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACpD,6EAA6E;IAC7E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE;QAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACtG;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAID;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,eAAe,CAyC/F;AAED,eAAO,MAAM,0BAA0B,GAAI,QAAQ,GAAG,KAAG,mBAAmB,EAG3E,CAAC;AAEF,qBAAa,qBAAsB,YAAW,uBAAuB;IACnE,WAAW,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAmC/C,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;CAWnD"}

package/dist/types/decorators/setTimeout.d.ts

@@ -1,13 +1,32 @@
 import { ElementDefineLifeCycler, HelperHostSet } from '../types';
 export declare const SET_TIMEOUT_METADATA_KEY: unique symbol;
+export type SetTimeoutType = 'onConnected' | 'returnValue';
 export interface SetTimeoutOptions {
-    /** 실행 시 데코레이트된 메서드에 넘길 인자를 계산. 없으면 인자 없이 호출. */
+    /**
+     * 'onConnected' (connect 시 자동으로 예약, disconnect 시 자동 정리) |
+     * 'returnValue' (기본값 - 자동 예약 없음. 개발자가 이 메서드를 직접 호출해야 예약되고,
+     *   그 호출의 리턴값이 실제로 실행될 함수가 된다 - 아래 설명 참고).
+     */
+    type?: SetTimeoutType;
+    /** 실행 시 데코레이트된 메서드에 넘길 인자를 계산. type:'onConnected'에서만 의미가 있음 (없으면 인자 없이 호출). */
     parameter?: (set: HelperHostSet) => any[];
     /** 타이머 등록 직후 1회 호출 (디버깅/로깅용). id는 실제 setTimeout 반환값 - cleanup은 자동으로 처리되므로 직접 clear할 필요 없음. */
     created?: (set: HelperHostSet, id: number) => void;
+    /** [type:'onConnected' 전용] 발화 여부 게이트. Promise<boolean>도 가능. false면 스킵. */
+    filter?: (set: HelperHostSet) => boolean | Promise<boolean>;
+    /** [type:'onConnected' 전용] 핸들러 직전 훅. await되고, 리턴값은 @setTimeoutBeforeReturn 으로 주입된다. */
+    before?: (set: HelperHostSet) => any | Promise<any>;
+    /** [type:'onConnected' 전용] 핸들러가 성공/실패해도 항상 실행되는 정리 훅. ctx로 인자/결과/에러. */
+    finally?: (set: HelperHostSet, ctx: {
+        args: any[];
+        result?: any;
+        error?: any;
+    }) => any | Promise<any>;
     /**
-     * fire 시 데코레이트된 메서드의 리턴값이 객체이고 이 키의 값이 함수이면 (id: number)로 호출한다.
-     * applyAttribute.ts의 valueKey와 동일한 컨벤션 - 리턴 객체에서 이 데코레이터 몫만 뽑아 쓴다.
+     * type:'onConnected' - fire 시 데코레이트된 메서드의 리턴값이 객체이고 이 키의 값이 함수이면 (id: number)로 호출한다.
+     * type:'returnValue' - 리턴값이 함수면 그 자체를, 객체면 이 키의 값이 함수일 때 그 값을 "실제로 실행될 함수"로 사용한다.
+     * 안 주면 SET_TIMEOUT_METADATA_KEY로 폴백한다 - applyAttribute.ts/applyNode.ts의 valueKey와 동일한 컨벤션
+     * (리턴 객체에서 이 데코레이터 몫만 뽑아 쓰고, 다른 데코레이터와 스택할 때만 커스텀 키로 구분하면 된다).
      */
     valueKey?: symbol | string;
 }
@@ -17,12 +36,15 @@ export interface SetTimeoutMetadata {
     options: SetTimeoutOptions;
 }
 /**
- * connect 시 자동으로 setTimeout을 걸고, disconnect 시 (아직 실행 전이라면) 자동으로 clearTimeout 한다.
+ * type:'onConnected' - connect 시 자동으로 setTimeout을 걸고, disconnect 시 (아직 실행 전이라면) 자동으로 clearTimeout 한다.
+ * type:'returnValue'(기본값) - 메서드를 감싸지 않는 대신, 호출될 때마다(개발자가 직접 호출) 원본 로직을
+ *   그대로 실행하고 리턴값(또는 valueKey로 뽑은 값)이 함수면 그 함수를 새 setTimeout으로 예약한다.
+ *   호출할 때마다 별도의 새 타이머가 생기며, disconnect 시 (아직 실행 전인 것들은) 전부 정리된다.
+ *   원본 리턴값은 그대로 통과시키므로 다른 데코레이터와 같은 메서드에 스택해도 순서에 상관없이 안전하다.
  */
 export declare function setTimeout(delay: number, options?: SetTimeoutOptions): MethodDecorator;
 export declare const findAllSetTimeoutMetadata: (target: any) => SetTimeoutMetadata[];
 export declare class SetTimeoutLifeCycler implements ElementDefineLifeCycler {
-    private readonly activeMap;
     onConnected(helperHostSet: HelperHostSet): void;
     onDisconnected(helperHostSet: HelperHostSet): void;
 }

package/dist/types/decorators/setTimeout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setTimeout.d.ts","sourceRoot":"","sources":["../../../src/decorators/setTimeout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAElE,eAAO,MAAM,wBAAwB,eAAiD,CAAC;AAEvF,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,GAAG,EAAE,CAAC;IAC1C,8FAA8F;IAC9F,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,eAAe,CAU1F;AAED,eAAO,MAAM,yBAAyB,GAAI,QAAQ,GAAG,KAAG,kBAAkB,EAGzE,CAAC;AAEF,qBAAa,oBAAqB,YAAW,uBAAuB;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAE1D,WAAW,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAsB/C,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;CAWnD"}
+{"version":3,"file":"setTimeout.d.ts","sourceRoot":"","sources":["../../../src/decorators/setTimeout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAElE,eAAO,MAAM,wBAAwB,eAAiD,CAAC;AAEvF,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,aAAa,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,GAAG,EAAE,CAAC;IAC1C,8FAA8F;IAC9F,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,0EAA0E;IAC1E,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,uFAAuF;IACvF,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACpD,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE;QAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACtG;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAID;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,eAAe,CA4C1F;AAED,eAAO,MAAM,yBAAyB,GAAI,QAAQ,GAAG,KAAG,kBAAkB,EAGzE,CAAC;AAEF,qBAAa,oBAAqB,YAAW,uBAAuB;IAClE,WAAW,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAmC/C,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;CAWnD"}

package/dist/types/decorators/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/decorators/state.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,kBAAkB,eAA2C,CAAC;AAI3E,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAC1E,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC;AAgEvD,eAAO,MAAM,oBAAoB,GAAI,QAAQ,GAAG,KAAG,aAAa,EAG/D,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/decorators/state.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,kBAAkB,eAA2C,CAAC;AAI3E,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAC1E,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC;AAuEvD,eAAO,MAAM,oBAAoB,GAAI,QAAQ,GAAG,KAAG,aAAa,EAG/D,CAAC"}