luau-obfuscator 1.0.0 → 1.0.2

package/dist/index.d.cts

@@ -5,6 +5,13 @@ interface StringsToExpressionsOptions {
     min: number;
     /** 청크 하나에 들어가는 바이트 개수 최대값 */
     max: number;
+    /**
+     * 0~1. 청크를 소스 순서 그대로 이어붙이는 대신, 순서를 섞어 저장해두고
+     * for 루프나 재귀 함수로 원래 순서를 되짚어가며 런타임에 조립할 확률.
+     * 소스에 보이는 조각 순서와 실제 결합 순서가 달라지므로, 단순 텍스트 상의
+     * concat 체인 스캔만으로는 원문을 복원할 수 없다. 기본값 0.6.
+     */
+    controlFlowProbability?: number;
 }
 
 interface NumbersToExpressionsOptions {
@@ -12,10 +19,18 @@ interface NumbersToExpressionsOptions {
     min: number;
     /** 랜덤 보조항의 최대 절댓값 */
     max: number;
+    /**
+     * 0~1. 정수 리터럴을 순수 산술식(depth 얕은 a+b 형태) 대신
+     * for/while 루프나 재귀 함수 호출로 "런타임에 조립"할 확률.
+     * 단순 트리 순회형 상수 접기(constant folding)는 문(statement)/제어흐름을
+     * 해석하지 못하므로 이 경로로 만든 값은 그런 도구로는 복원되지 않는다.
+     * 기본값 0.35.
+     */
+    controlFlowProbability?: number;
 }
 
 interface RenameVariablesOptions {
-    random?: () => string;
+    random: () => string;
 }
 
 interface GlobalMappingOptions {
@@ -30,13 +45,30 @@ interface EncryptStringsOptions {
 interface EncryptNumbersOptions {
 }
 
+interface VmifyOptions {
+    /**
+     * VM 밖에서 값을 그대로 참조해야 하는 전역 이름 목록(GETGLOBAL/SETGLOBAL 대상).
+     * Luau엔 getfenv가 없어서 "임의의 전역 읽기"를 흉내낼 수 없기 때문에,
+     * 여기 나열된 이름들만 브리지 테이블에 실제 값으로 미리 채워 넣는다.
+     * 나열되지 않은 전역을 참조하면 컴파일은 되지만 런타임에 nil이 나온다 — 실사용 전
+     * 반드시 프로그램에서 실제로 쓰는 전역 이름을 전부 이 목록에 채워야 함(TODO: 컴파일러가
+     * ScopeAnalysis.globalsByName을 이용해 자동으로 목록을 뽑아주도록 개선 가능).
+     */
+    builtinGlobals?: readonly string[];
+    /**
+     * opcode 번호 셔플 + 전역/필드 이름 무작위화에 쓸 난수 생성기. 지정하지 않으면
+     * Math.random. 재현 가능한 빌드가 필요하면(테스트 등) 시드 고정 PRNG를 넘길 것.
+     */
+    random?: () => number;
+}
+
 type ObfuscateConfigEach<C> = ({
     active: true;
 } & C) | {
     active: false;
 };
 type ObfuscateConfig = {
-    Vmify: ObfuscateConfigEach<{}>;
+    Vmify: ObfuscateConfigEach<VmifyOptions>;
     Minify: ObfuscateConfigEach<{}>;
     StringsToExpressions: ObfuscateConfigEach<StringsToExpressionsOptions>;
     NumbersToExpressions: ObfuscateConfigEach<NumbersToExpressionsOptions>;

package/dist/index.d.ts

@@ -5,6 +5,13 @@ interface StringsToExpressionsOptions {
     min: number;
     /** 청크 하나에 들어가는 바이트 개수 최대값 */
     max: number;
+    /**
+     * 0~1. 청크를 소스 순서 그대로 이어붙이는 대신, 순서를 섞어 저장해두고
+     * for 루프나 재귀 함수로 원래 순서를 되짚어가며 런타임에 조립할 확률.
+     * 소스에 보이는 조각 순서와 실제 결합 순서가 달라지므로, 단순 텍스트 상의
+     * concat 체인 스캔만으로는 원문을 복원할 수 없다. 기본값 0.6.
+     */
+    controlFlowProbability?: number;
 }
 
 interface NumbersToExpressionsOptions {
@@ -12,10 +19,18 @@ interface NumbersToExpressionsOptions {
     min: number;
     /** 랜덤 보조항의 최대 절댓값 */
     max: number;
+    /**
+     * 0~1. 정수 리터럴을 순수 산술식(depth 얕은 a+b 형태) 대신
+     * for/while 루프나 재귀 함수 호출로 "런타임에 조립"할 확률.
+     * 단순 트리 순회형 상수 접기(constant folding)는 문(statement)/제어흐름을
+     * 해석하지 못하므로 이 경로로 만든 값은 그런 도구로는 복원되지 않는다.
+     * 기본값 0.35.
+     */
+    controlFlowProbability?: number;
 }
 
 interface RenameVariablesOptions {
-    random?: () => string;
+    random: () => string;
 }
 
 interface GlobalMappingOptions {
@@ -30,13 +45,30 @@ interface EncryptStringsOptions {
 interface EncryptNumbersOptions {
 }
 
+interface VmifyOptions {
+    /**
+     * VM 밖에서 값을 그대로 참조해야 하는 전역 이름 목록(GETGLOBAL/SETGLOBAL 대상).
+     * Luau엔 getfenv가 없어서 "임의의 전역 읽기"를 흉내낼 수 없기 때문에,
+     * 여기 나열된 이름들만 브리지 테이블에 실제 값으로 미리 채워 넣는다.
+     * 나열되지 않은 전역을 참조하면 컴파일은 되지만 런타임에 nil이 나온다 — 실사용 전
+     * 반드시 프로그램에서 실제로 쓰는 전역 이름을 전부 이 목록에 채워야 함(TODO: 컴파일러가
+     * ScopeAnalysis.globalsByName을 이용해 자동으로 목록을 뽑아주도록 개선 가능).
+     */
+    builtinGlobals?: readonly string[];
+    /**
+     * opcode 번호 셔플 + 전역/필드 이름 무작위화에 쓸 난수 생성기. 지정하지 않으면
+     * Math.random. 재현 가능한 빌드가 필요하면(테스트 등) 시드 고정 PRNG를 넘길 것.
+     */
+    random?: () => number;
+}
+
 type ObfuscateConfigEach<C> = ({
     active: true;
 } & C) | {
     active: false;
 };
 type ObfuscateConfig = {
-    Vmify: ObfuscateConfigEach<{}>;
+    Vmify: ObfuscateConfigEach<VmifyOptions>;
     Minify: ObfuscateConfigEach<{}>;
     StringsToExpressions: ObfuscateConfigEach<StringsToExpressionsOptions>;
     NumbersToExpressions: ObfuscateConfigEach<NumbersToExpressionsOptions>;