@locuschain/lib 0.1.38 → 0.1.40

package/dist/vite-plugin/index.amd.js

@@ -0,0 +1,186 @@
+define(['module', 'exports', 'node:fs', 'node:path', 'node:url'], (function (module, exports, fs, path, node_url) { 'use strict';
+
+    /**
+     * @locuschain/lib/vite-plugin
+     *
+     * Vite (그리고 wxt) 사용자가 lib 의 wasm 4 개를 자동으로 빌드 그래프에 포함시키도록 돕는 plugin.
+     *
+     * 두 가지 모드:
+     *  - `mode: 'assets'` (기본): wasm 을 Vite 의 emitFile 로 자산 그래프에 등록.
+     *    Vite 가 `assets/<name>-<hash>.wasm` 으로 emit. URL 은 `import.meta.ROLLUP_FILE_URL_<id>`
+     *    placeholder 로 치환. 일반 Vite 웹 빌드, wxt 단일 entry 빌드에 적합.
+     *
+     *  - `mode: 'public'`: wasm 을 Vite 의 publicDir 안 `wasm/` 폴더로 복사하고,
+     *    lib URL 을 `chrome.runtime.getURL('wasm/<name>')` 로 치환.
+     *    wxt 처럼 entry 별 별도 빌드를 돌리는 환경에서 모든 entry 가 같은 wasm 사본을
+     *    공유하도록 한다. chrome extension 한정.
+     *
+     * 왜 두 모드인가:
+     *  - 모던 Vite/Webpack 의 자산 그래프는 정적 분석 기반인데, wxt 의 defineImportMeta
+     *    plugin 이 `import.meta.url` 을 `self.location.href` 로 매크로 치환해서 그 그래프
+     *    추적을 깨뜨린다. 이 plugin 은 `enforce: 'pre'` 로 wxt:define 보다 먼저 lib 코드의
+     *    `new URL("../autogen/wasm/<name>", import.meta.url)` 패턴을 직접 잡아 처리한다.
+     *  - 'assets' 모드는 entry 별 빌드 격리 환경에서 entry 마다 wasm 사본이 중복 emit 됨.
+     *  - 'public' 모드는 publicDir 기반이라 entry 빌드와 무관하게 한 번만 출력 + 공유.
+     *
+     * 사용법:
+     *   import { locusWasmPlugin } from '@locuschain/lib/vite-plugin';
+     *   // 단일 entry (일반 web app)
+     *   plugins: [locusWasmPlugin()]
+     *   // wxt 의 chrome extension (entry 격리 빌드)
+     *   plugins: [locusWasmPlugin({ mode: 'public' })]
+     */
+    const WASM_FILES = [
+        'lclib.wasm',
+        'crypto_aimer.wasm',
+        'crypto_smaugt.wasm',
+        'crypto_haetae.wasm'
+    ];
+    // 이 모듈은 lib 패키지의 dist/vite-plugin/index.{esm.js|cjs.cjs} 로 빌드된다.
+    // 따라서 `../autogen/wasm/` 은 dist/autogen/wasm/ 을 가리킨다 (rollup-plugin-copy 로 동봉됨).
+    const WASM_DIR = node_url.fileURLToPath(new URL('../autogen/wasm/', new URL(module.uri, document.baseURI).href));
+    // lib 코드(자체 패키지 또는 npm link 된 로컬 경로) 안에서만 transform 한다.
+    const LIB_ID_PATTERN = /(?:@locuschain[/\\]lib|locuschain-js[/\\]packages[/\\]lib)[/\\]dist[/\\]/;
+    // 두 가지 패턴 모두 매칭:
+    //   (1) `new URL("../autogen/wasm/<name>", import.meta.url)`  — 라이브러리 진입점에서 사용
+    //   (2) `new URL("<name>", import.meta.url)`                  — emscripten glue 의 findWasmBinary() 잔여
+    function buildWasmUrlPatterns(filename) {
+        const fnameEscaped = filename.replace(/\./g, '\\.');
+        return [
+            new RegExp(`new\\s+URL\\(\\s*["']\\.\\./autogen/wasm/${fnameEscaped}["']\\s*,\\s*import\\.meta\\.url\\s*\\)`, 'g'),
+            new RegExp(`new\\s+URL\\(\\s*["']${fnameEscaped}["']\\s*,\\s*import\\.meta\\.url\\s*\\)`, 'g')
+        ];
+    }
+    function locusWasmPlugin(opts = {}) {
+        var _a, _b;
+        const mode = (_a = opts.mode) !== null && _a !== void 0 ? _a : 'assets';
+        const publicSubdir = (_b = opts.publicSubdir) !== null && _b !== void 0 ? _b : 'wasm';
+        const refIds = new Map();
+        let isServe = false;
+        let publicDir = false;
+        return {
+            name: 'locuschain-wasm',
+            enforce: 'pre',
+            configResolved(config) {
+                var _a, _b;
+                isServe = config.command === 'serve';
+                publicDir = config.publicDir;
+                // WASM_DIR 은 lib 패키지 안(보통 node_modules 또는 외부 symlink) 이라 사용자 프로젝트 root
+                // 바깥일 수 있다. dev 에서 `/@fs/<absolute>` 로 wasm 을 서빙하려면 fs.allow 에 등록돼 있어야 한다.
+                // `config()` hook 에서 `server.fs.allow: [WASM_DIR]` 를 반환하면 사용자가 명시하지 않은 경우
+                // Vite 가 기본 workspace root 탐색을 건너뛰어 프로젝트 root 가 allow 에서 빠진다 (→ 사용자 소스 403).
+                // configResolved 시점엔 이미 default 가 채워져 있으므로 안전하게 push 만 한다.
+                if (Array.isArray((_b = (_a = config.server) === null || _a === void 0 ? void 0 : _a.fs) === null || _b === void 0 ? void 0 : _b.allow)) {
+                    config.server.fs.allow.push(WASM_DIR);
+                }
+            },
+            buildStart() {
+                refIds.clear();
+                // public 모드: dev/build 양쪽 모두 wasm 4 개를 publicDir/<publicSubdir>/ 로 복사한다.
+                // wxt dev 는 그 폴더를 그대로 .output/chrome-mv3-dev 에 복사해 extension origin
+                // (chrome.runtime.getURL) 으로 노출하므로 /@fs/ 우회가 필요 없어진다.
+                // 같은 build 안에서 여러 번 호출돼도 멱등 (mtime 비교).
+                if (mode === 'public') {
+                    if (!publicDir || typeof publicDir !== 'string') {
+                        this.warn(`[locuschain-wasm] mode:'public' requires Vite publicDir. ` +
+                            `Falling back to 'assets' mode for this build.`);
+                    }
+                    else {
+                        const targetDir = path.join(publicDir, publicSubdir);
+                        if (!fs.existsSync(targetDir)) {
+                            fs.mkdirSync(targetDir, { recursive: true });
+                        }
+                        for (const filename of WASM_FILES) {
+                            const src = path.join(WASM_DIR, filename);
+                            const dst = path.join(targetDir, filename);
+                            if (!fs.existsSync(src)) {
+                                this.error(`[locuschain-wasm] missing wasm asset: ${src}\n` +
+                                    `lib 가 정상적으로 빌드/설치되었는지 확인하세요.`);
+                            }
+                            // mtime 비교로 불필요한 재복사 회피 (watch 모드 친화적).
+                            const srcMtime = fs.statSync(src).mtimeMs;
+                            const dstMtime = fs.existsSync(dst) ? fs.statSync(dst).mtimeMs : 0;
+                            if (srcMtime > dstMtime) {
+                                fs.copyFileSync(src, dst);
+                            }
+                        }
+                    }
+                }
+            },
+            transform(code, id) {
+                const cleanId = id.replace(/\\/g, '/').replace(/\?.*$/, '');
+                if (!LIB_ID_PATTERN.test(cleanId)) {
+                    return null;
+                }
+                // 이 모듈 안에서 어떤 wasm 들이 참조되는지 먼저 스캔.
+                const referenced = [];
+                for (const filename of WASM_FILES) {
+                    const patterns = buildWasmUrlPatterns(filename);
+                    if (patterns.some(p => p.test(code))) {
+                        referenced.push(filename);
+                    }
+                }
+                if (referenced.length === 0)
+                    return null;
+                // assets 모드 + build: 처음 보는 wasm 은 emit.
+                if (mode === 'assets' && !isServe) {
+                    for (const filename of referenced) {
+                        if (refIds.has(filename))
+                            continue;
+                        const filepath = path.join(WASM_DIR, filename);
+                        if (!fs.existsSync(filepath)) {
+                            this.error(`[locuschain-wasm] missing wasm asset: ${filepath}\n` +
+                                `lib 가 정상적으로 빌드/설치되었는지 확인하세요.`);
+                        }
+                        const referenceId = this.emitFile({
+                            type: 'asset',
+                            name: filename,
+                            source: fs.readFileSync(filepath)
+                        });
+                        refIds.set(filename, referenceId);
+                    }
+                }
+                // 패턴 치환. mode 가 먼저 — public 모드는 dev/build 양쪽 모두 publicDir 안
+                // wasm 을 chrome.runtime.getURL 또는 root-relative URL 로 가리킨다.
+                let newCode = code;
+                for (const filename of referenced) {
+                    const patterns = buildWasmUrlPatterns(filename);
+                    let replacement;
+                    if (mode === 'public') {
+                        // chrome extension: chrome.runtime.getURL 로 절대 URL 생성.
+                        // 일반 web (chrome 없음) 폴백: root-relative URL — dev/build 모두 publicDir
+                        // 의 wasm 을 dev server / 빌드 output 이 동일 경로로 서빙한다.
+                        const relPath = `${publicSubdir}/${filename}`;
+                        replacement =
+                            `((typeof chrome !== 'undefined' && chrome.runtime && chrome.runtime.getURL) ` +
+                                `? chrome.runtime.getURL(${JSON.stringify(relPath)}) ` +
+                                `: new URL(${JSON.stringify('/' + relPath)}, import.meta.url))`;
+                    }
+                    else if (isServe) {
+                        // assets 모드 + dev: /@fs/<absolute path> 로 dev server 가 직접 서빙.
+                        // (이 경로는 fs.allow 에 WASM_DIR 가 등록돼 있어야 한다 — configResolved 참조.)
+                        const absUrl = path.join(WASM_DIR, filename).replace(/\\/g, '/');
+                        replacement = `new URL(${JSON.stringify('/@fs/' + absUrl)}, import.meta.url)`;
+                    }
+                    else {
+                        // assets 모드 + build
+                        const refId = refIds.get(filename);
+                        if (!refId)
+                            continue;
+                        replacement = `new URL(import.meta.ROLLUP_FILE_URL_${refId}, import.meta.url)`;
+                    }
+                    for (const pattern of patterns) {
+                        newCode = newCode.replace(pattern, replacement);
+                    }
+                }
+                return { code: newCode, map: null };
+            }
+        };
+    }
+
+    exports.default = locusWasmPlugin;
+    exports.locusWasmPlugin = locusWasmPlugin;
+
+    Object.defineProperty(exports, '__esModule', { value: true });
+
+}));

package/dist/vite-plugin/index.cjs.cjs

@@ -0,0 +1,189 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var fs = require('node:fs');
+var path = require('node:path');
+var node_url = require('node:url');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+/**
+ * @locuschain/lib/vite-plugin
+ *
+ * Vite (그리고 wxt) 사용자가 lib 의 wasm 4 개를 자동으로 빌드 그래프에 포함시키도록 돕는 plugin.
+ *
+ * 두 가지 모드:
+ *  - `mode: 'assets'` (기본): wasm 을 Vite 의 emitFile 로 자산 그래프에 등록.
+ *    Vite 가 `assets/<name>-<hash>.wasm` 으로 emit. URL 은 `import.meta.ROLLUP_FILE_URL_<id>`
+ *    placeholder 로 치환. 일반 Vite 웹 빌드, wxt 단일 entry 빌드에 적합.
+ *
+ *  - `mode: 'public'`: wasm 을 Vite 의 publicDir 안 `wasm/` 폴더로 복사하고,
+ *    lib URL 을 `chrome.runtime.getURL('wasm/<name>')` 로 치환.
+ *    wxt 처럼 entry 별 별도 빌드를 돌리는 환경에서 모든 entry 가 같은 wasm 사본을
+ *    공유하도록 한다. chrome extension 한정.
+ *
+ * 왜 두 모드인가:
+ *  - 모던 Vite/Webpack 의 자산 그래프는 정적 분석 기반인데, wxt 의 defineImportMeta
+ *    plugin 이 `import.meta.url` 을 `self.location.href` 로 매크로 치환해서 그 그래프
+ *    추적을 깨뜨린다. 이 plugin 은 `enforce: 'pre'` 로 wxt:define 보다 먼저 lib 코드의
+ *    `new URL("../autogen/wasm/<name>", import.meta.url)` 패턴을 직접 잡아 처리한다.
+ *  - 'assets' 모드는 entry 별 빌드 격리 환경에서 entry 마다 wasm 사본이 중복 emit 됨.
+ *  - 'public' 모드는 publicDir 기반이라 entry 빌드와 무관하게 한 번만 출력 + 공유.
+ *
+ * 사용법:
+ *   import { locusWasmPlugin } from '@locuschain/lib/vite-plugin';
+ *   // 단일 entry (일반 web app)
+ *   plugins: [locusWasmPlugin()]
+ *   // wxt 의 chrome extension (entry 격리 빌드)
+ *   plugins: [locusWasmPlugin({ mode: 'public' })]
+ */
+const WASM_FILES = [
+    'lclib.wasm',
+    'crypto_aimer.wasm',
+    'crypto_smaugt.wasm',
+    'crypto_haetae.wasm'
+];
+// 이 모듈은 lib 패키지의 dist/vite-plugin/index.{esm.js|cjs.cjs} 로 빌드된다.
+// 따라서 `../autogen/wasm/` 은 dist/autogen/wasm/ 을 가리킨다 (rollup-plugin-copy 로 동봉됨).
+const WASM_DIR = node_url.fileURLToPath(new URL('../autogen/wasm/', (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('vite-plugin/index.cjs.cjs', document.baseURI).href))));
+// lib 코드(자체 패키지 또는 npm link 된 로컬 경로) 안에서만 transform 한다.
+const LIB_ID_PATTERN = /(?:@locuschain[/\\]lib|locuschain-js[/\\]packages[/\\]lib)[/\\]dist[/\\]/;
+// 두 가지 패턴 모두 매칭:
+//   (1) `new URL("../autogen/wasm/<name>", import.meta.url)`  — 라이브러리 진입점에서 사용
+//   (2) `new URL("<name>", import.meta.url)`                  — emscripten glue 의 findWasmBinary() 잔여
+function buildWasmUrlPatterns(filename) {
+    const fnameEscaped = filename.replace(/\./g, '\\.');
+    return [
+        new RegExp(`new\\s+URL\\(\\s*["']\\.\\./autogen/wasm/${fnameEscaped}["']\\s*,\\s*import\\.meta\\.url\\s*\\)`, 'g'),
+        new RegExp(`new\\s+URL\\(\\s*["']${fnameEscaped}["']\\s*,\\s*import\\.meta\\.url\\s*\\)`, 'g')
+    ];
+}
+function locusWasmPlugin(opts = {}) {
+    var _a, _b;
+    const mode = (_a = opts.mode) !== null && _a !== void 0 ? _a : 'assets';
+    const publicSubdir = (_b = opts.publicSubdir) !== null && _b !== void 0 ? _b : 'wasm';
+    const refIds = new Map();
+    let isServe = false;
+    let publicDir = false;
+    return {
+        name: 'locuschain-wasm',
+        enforce: 'pre',
+        configResolved(config) {
+            var _a, _b;
+            isServe = config.command === 'serve';
+            publicDir = config.publicDir;
+            // WASM_DIR 은 lib 패키지 안(보통 node_modules 또는 외부 symlink) 이라 사용자 프로젝트 root
+            // 바깥일 수 있다. dev 에서 `/@fs/<absolute>` 로 wasm 을 서빙하려면 fs.allow 에 등록돼 있어야 한다.
+            // `config()` hook 에서 `server.fs.allow: [WASM_DIR]` 를 반환하면 사용자가 명시하지 않은 경우
+            // Vite 가 기본 workspace root 탐색을 건너뛰어 프로젝트 root 가 allow 에서 빠진다 (→ 사용자 소스 403).
+            // configResolved 시점엔 이미 default 가 채워져 있으므로 안전하게 push 만 한다.
+            if (Array.isArray((_b = (_a = config.server) === null || _a === void 0 ? void 0 : _a.fs) === null || _b === void 0 ? void 0 : _b.allow)) {
+                config.server.fs.allow.push(WASM_DIR);
+            }
+        },
+        buildStart() {
+            refIds.clear();
+            // public 모드: dev/build 양쪽 모두 wasm 4 개를 publicDir/<publicSubdir>/ 로 복사한다.
+            // wxt dev 는 그 폴더를 그대로 .output/chrome-mv3-dev 에 복사해 extension origin
+            // (chrome.runtime.getURL) 으로 노출하므로 /@fs/ 우회가 필요 없어진다.
+            // 같은 build 안에서 여러 번 호출돼도 멱등 (mtime 비교).
+            if (mode === 'public') {
+                if (!publicDir || typeof publicDir !== 'string') {
+                    this.warn(`[locuschain-wasm] mode:'public' requires Vite publicDir. ` +
+                        `Falling back to 'assets' mode for this build.`);
+                }
+                else {
+                    const targetDir = path.join(publicDir, publicSubdir);
+                    if (!fs.existsSync(targetDir)) {
+                        fs.mkdirSync(targetDir, { recursive: true });
+                    }
+                    for (const filename of WASM_FILES) {
+                        const src = path.join(WASM_DIR, filename);
+                        const dst = path.join(targetDir, filename);
+                        if (!fs.existsSync(src)) {
+                            this.error(`[locuschain-wasm] missing wasm asset: ${src}\n` +
+                                `lib 가 정상적으로 빌드/설치되었는지 확인하세요.`);
+                        }
+                        // mtime 비교로 불필요한 재복사 회피 (watch 모드 친화적).
+                        const srcMtime = fs.statSync(src).mtimeMs;
+                        const dstMtime = fs.existsSync(dst) ? fs.statSync(dst).mtimeMs : 0;
+                        if (srcMtime > dstMtime) {
+                            fs.copyFileSync(src, dst);
+                        }
+                    }
+                }
+            }
+        },
+        transform(code, id) {
+            const cleanId = id.replace(/\\/g, '/').replace(/\?.*$/, '');
+            if (!LIB_ID_PATTERN.test(cleanId)) {
+                return null;
+            }
+            // 이 모듈 안에서 어떤 wasm 들이 참조되는지 먼저 스캔.
+            const referenced = [];
+            for (const filename of WASM_FILES) {
+                const patterns = buildWasmUrlPatterns(filename);
+                if (patterns.some(p => p.test(code))) {
+                    referenced.push(filename);
+                }
+            }
+            if (referenced.length === 0)
+                return null;
+            // assets 모드 + build: 처음 보는 wasm 은 emit.
+            if (mode === 'assets' && !isServe) {
+                for (const filename of referenced) {
+                    if (refIds.has(filename))
+                        continue;
+                    const filepath = path.join(WASM_DIR, filename);
+                    if (!fs.existsSync(filepath)) {
+                        this.error(`[locuschain-wasm] missing wasm asset: ${filepath}\n` +
+                            `lib 가 정상적으로 빌드/설치되었는지 확인하세요.`);
+                    }
+                    const referenceId = this.emitFile({
+                        type: 'asset',
+                        name: filename,
+                        source: fs.readFileSync(filepath)
+                    });
+                    refIds.set(filename, referenceId);
+                }
+            }
+            // 패턴 치환. mode 가 먼저 — public 모드는 dev/build 양쪽 모두 publicDir 안
+            // wasm 을 chrome.runtime.getURL 또는 root-relative URL 로 가리킨다.
+            let newCode = code;
+            for (const filename of referenced) {
+                const patterns = buildWasmUrlPatterns(filename);
+                let replacement;
+                if (mode === 'public') {
+                    // chrome extension: chrome.runtime.getURL 로 절대 URL 생성.
+                    // 일반 web (chrome 없음) 폴백: root-relative URL — dev/build 모두 publicDir
+                    // 의 wasm 을 dev server / 빌드 output 이 동일 경로로 서빙한다.
+                    const relPath = `${publicSubdir}/${filename}`;
+                    replacement =
+                        `((typeof chrome !== 'undefined' && chrome.runtime && chrome.runtime.getURL) ` +
+                            `? chrome.runtime.getURL(${JSON.stringify(relPath)}) ` +
+                            `: new URL(${JSON.stringify('/' + relPath)}, import.meta.url))`;
+                }
+                else if (isServe) {
+                    // assets 모드 + dev: /@fs/<absolute path> 로 dev server 가 직접 서빙.
+                    // (이 경로는 fs.allow 에 WASM_DIR 가 등록돼 있어야 한다 — configResolved 참조.)
+                    const absUrl = path.join(WASM_DIR, filename).replace(/\\/g, '/');
+                    replacement = `new URL(${JSON.stringify('/@fs/' + absUrl)}, import.meta.url)`;
+                }
+                else {
+                    // assets 모드 + build
+                    const refId = refIds.get(filename);
+                    if (!refId)
+                        continue;
+                    replacement = `new URL(import.meta.ROLLUP_FILE_URL_${refId}, import.meta.url)`;
+                }
+                for (const pattern of patterns) {
+                    newCode = newCode.replace(pattern, replacement);
+                }
+            }
+            return { code: newCode, map: null };
+        }
+    };
+}
+
+exports.default = locusWasmPlugin;
+exports.locusWasmPlugin = locusWasmPlugin;

package/dist/vite-plugin/index.d.cts

@@ -0,0 +1,46 @@
+/**
+ * @locuschain/lib/vite-plugin
+ *
+ * Vite (그리고 wxt) 사용자가 lib 의 wasm 4 개를 자동으로 빌드 그래프에 포함시키도록 돕는 plugin.
+ *
+ * 두 가지 모드:
+ *  - `mode: 'assets'` (기본): wasm 을 Vite 의 emitFile 로 자산 그래프에 등록.
+ *    Vite 가 `assets/<name>-<hash>.wasm` 으로 emit. URL 은 `import.meta.ROLLUP_FILE_URL_<id>`
+ *    placeholder 로 치환. 일반 Vite 웹 빌드, wxt 단일 entry 빌드에 적합.
+ *
+ *  - `mode: 'public'`: wasm 을 Vite 의 publicDir 안 `wasm/` 폴더로 복사하고,
+ *    lib URL 을 `chrome.runtime.getURL('wasm/<name>')` 로 치환.
+ *    wxt 처럼 entry 별 별도 빌드를 돌리는 환경에서 모든 entry 가 같은 wasm 사본을
+ *    공유하도록 한다. chrome extension 한정.
+ *
+ * 왜 두 모드인가:
+ *  - 모던 Vite/Webpack 의 자산 그래프는 정적 분석 기반인데, wxt 의 defineImportMeta
+ *    plugin 이 `import.meta.url` 을 `self.location.href` 로 매크로 치환해서 그 그래프
+ *    추적을 깨뜨린다. 이 plugin 은 `enforce: 'pre'` 로 wxt:define 보다 먼저 lib 코드의
+ *    `new URL("../autogen/wasm/<name>", import.meta.url)` 패턴을 직접 잡아 처리한다.
+ *  - 'assets' 모드는 entry 별 빌드 격리 환경에서 entry 마다 wasm 사본이 중복 emit 됨.
+ *  - 'public' 모드는 publicDir 기반이라 entry 빌드와 무관하게 한 번만 출력 + 공유.
+ *
+ * 사용법:
+ *   import { locusWasmPlugin } from '@locuschain/lib/vite-plugin';
+ *   // 단일 entry (일반 web app)
+ *   plugins: [locusWasmPlugin()]
+ *   // wxt 의 chrome extension (entry 격리 빌드)
+ *   plugins: [locusWasmPlugin({ mode: 'public' })]
+ */
+import type { Plugin } from 'vite';
+export interface LocusWasmPluginOptions {
+    /**
+     * - 'assets' (기본): Vite emitFile + ROLLUP_FILE_URL placeholder. 단일 entry 빌드용.
+     * - 'public' : publicDir/wasm/ 에 wasm 복사 + chrome.runtime.getURL 치환.
+     *              wxt 처럼 entry 별 별도 빌드를 돌리는 chrome extension 환경용.
+     */
+    mode?: 'assets' | 'public';
+    /**
+     * public 모드에서 wasm 을 두는 서브 디렉토리. publicDir 기준 상대 경로. 기본 'wasm'.
+     * 빌드 결과는 `<output>/<publicSubdir>/<name>.wasm` 로 나온다.
+     */
+    publicSubdir?: string;
+}
+export declare function locusWasmPlugin(opts?: LocusWasmPluginOptions): Plugin;
+export default locusWasmPlugin;

package/dist/vite-plugin/index.d.mts

@@ -0,0 +1,46 @@
+/**
+ * @locuschain/lib/vite-plugin
+ *
+ * Vite (그리고 wxt) 사용자가 lib 의 wasm 4 개를 자동으로 빌드 그래프에 포함시키도록 돕는 plugin.
+ *
+ * 두 가지 모드:
+ *  - `mode: 'assets'` (기본): wasm 을 Vite 의 emitFile 로 자산 그래프에 등록.
+ *    Vite 가 `assets/<name>-<hash>.wasm` 으로 emit. URL 은 `import.meta.ROLLUP_FILE_URL_<id>`
+ *    placeholder 로 치환. 일반 Vite 웹 빌드, wxt 단일 entry 빌드에 적합.
+ *
+ *  - `mode: 'public'`: wasm 을 Vite 의 publicDir 안 `wasm/` 폴더로 복사하고,
+ *    lib URL 을 `chrome.runtime.getURL('wasm/<name>')` 로 치환.
+ *    wxt 처럼 entry 별 별도 빌드를 돌리는 환경에서 모든 entry 가 같은 wasm 사본을
+ *    공유하도록 한다. chrome extension 한정.
+ *
+ * 왜 두 모드인가:
+ *  - 모던 Vite/Webpack 의 자산 그래프는 정적 분석 기반인데, wxt 의 defineImportMeta
+ *    plugin 이 `import.meta.url` 을 `self.location.href` 로 매크로 치환해서 그 그래프
+ *    추적을 깨뜨린다. 이 plugin 은 `enforce: 'pre'` 로 wxt:define 보다 먼저 lib 코드의
+ *    `new URL("../autogen/wasm/<name>", import.meta.url)` 패턴을 직접 잡아 처리한다.
+ *  - 'assets' 모드는 entry 별 빌드 격리 환경에서 entry 마다 wasm 사본이 중복 emit 됨.
+ *  - 'public' 모드는 publicDir 기반이라 entry 빌드와 무관하게 한 번만 출력 + 공유.
+ *
+ * 사용법:
+ *   import { locusWasmPlugin } from '@locuschain/lib/vite-plugin';
+ *   // 단일 entry (일반 web app)
+ *   plugins: [locusWasmPlugin()]
+ *   // wxt 의 chrome extension (entry 격리 빌드)
+ *   plugins: [locusWasmPlugin({ mode: 'public' })]
+ */
+import type { Plugin } from 'vite';
+export interface LocusWasmPluginOptions {
+    /**
+     * - 'assets' (기본): Vite emitFile + ROLLUP_FILE_URL placeholder. 단일 entry 빌드용.
+     * - 'public' : publicDir/wasm/ 에 wasm 복사 + chrome.runtime.getURL 치환.
+     *              wxt 처럼 entry 별 별도 빌드를 돌리는 chrome extension 환경용.
+     */
+    mode?: 'assets' | 'public';
+    /**
+     * public 모드에서 wasm 을 두는 서브 디렉토리. publicDir 기준 상대 경로. 기본 'wasm'.
+     * 빌드 결과는 `<output>/<publicSubdir>/<name>.wasm` 로 나온다.
+     */
+    publicSubdir?: string;
+}
+export declare function locusWasmPlugin(opts?: LocusWasmPluginOptions): Plugin;
+export default locusWasmPlugin;

package/dist/vite-plugin/index.esm.js

@@ -0,0 +1,183 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/**
+ * @locuschain/lib/vite-plugin
+ *
+ * Vite (그리고 wxt) 사용자가 lib 의 wasm 4 개를 자동으로 빌드 그래프에 포함시키도록 돕는 plugin.
+ *
+ * 두 가지 모드:
+ *  - `mode: 'assets'` (기본): wasm 을 Vite 의 emitFile 로 자산 그래프에 등록.
+ *    Vite 가 `assets/<name>-<hash>.wasm` 으로 emit. URL 은 `import.meta.ROLLUP_FILE_URL_<id>`
+ *    placeholder 로 치환. 일반 Vite 웹 빌드, wxt 단일 entry 빌드에 적합.
+ *
+ *  - `mode: 'public'`: wasm 을 Vite 의 publicDir 안 `wasm/` 폴더로 복사하고,
+ *    lib URL 을 `chrome.runtime.getURL('wasm/<name>')` 로 치환.
+ *    wxt 처럼 entry 별 별도 빌드를 돌리는 환경에서 모든 entry 가 같은 wasm 사본을
+ *    공유하도록 한다. chrome extension 한정.
+ *
+ * 왜 두 모드인가:
+ *  - 모던 Vite/Webpack 의 자산 그래프는 정적 분석 기반인데, wxt 의 defineImportMeta
+ *    plugin 이 `import.meta.url` 을 `self.location.href` 로 매크로 치환해서 그 그래프
+ *    추적을 깨뜨린다. 이 plugin 은 `enforce: 'pre'` 로 wxt:define 보다 먼저 lib 코드의
+ *    `new URL("../autogen/wasm/<name>", import.meta.url)` 패턴을 직접 잡아 처리한다.
+ *  - 'assets' 모드는 entry 별 빌드 격리 환경에서 entry 마다 wasm 사본이 중복 emit 됨.
+ *  - 'public' 모드는 publicDir 기반이라 entry 빌드와 무관하게 한 번만 출력 + 공유.
+ *
+ * 사용법:
+ *   import { locusWasmPlugin } from '@locuschain/lib/vite-plugin';
+ *   // 단일 entry (일반 web app)
+ *   plugins: [locusWasmPlugin()]
+ *   // wxt 의 chrome extension (entry 격리 빌드)
+ *   plugins: [locusWasmPlugin({ mode: 'public' })]
+ */
+const WASM_FILES = [
+    'lclib.wasm',
+    'crypto_aimer.wasm',
+    'crypto_smaugt.wasm',
+    'crypto_haetae.wasm'
+];
+// 이 모듈은 lib 패키지의 dist/vite-plugin/index.{esm.js|cjs.cjs} 로 빌드된다.
+// 따라서 `../autogen/wasm/` 은 dist/autogen/wasm/ 을 가리킨다 (rollup-plugin-copy 로 동봉됨).
+const WASM_DIR = fileURLToPath(new URL('../autogen/wasm/', import.meta.url));
+// lib 코드(자체 패키지 또는 npm link 된 로컬 경로) 안에서만 transform 한다.
+const LIB_ID_PATTERN = /(?:@locuschain[/\\]lib|locuschain-js[/\\]packages[/\\]lib)[/\\]dist[/\\]/;
+// 두 가지 패턴 모두 매칭:
+//   (1) `new URL("../autogen/wasm/<name>", import.meta.url)`  — 라이브러리 진입점에서 사용
+//   (2) `new URL("<name>", import.meta.url)`                  — emscripten glue 의 findWasmBinary() 잔여
+function buildWasmUrlPatterns(filename) {
+    const fnameEscaped = filename.replace(/\./g, '\\.');
+    return [
+        new RegExp(`new\\s+URL\\(\\s*["']\\.\\./autogen/wasm/${fnameEscaped}["']\\s*,\\s*import\\.meta\\.url\\s*\\)`, 'g'),
+        new RegExp(`new\\s+URL\\(\\s*["']${fnameEscaped}["']\\s*,\\s*import\\.meta\\.url\\s*\\)`, 'g')
+    ];
+}
+function locusWasmPlugin(opts = {}) {
+    var _a, _b;
+    const mode = (_a = opts.mode) !== null && _a !== void 0 ? _a : 'assets';
+    const publicSubdir = (_b = opts.publicSubdir) !== null && _b !== void 0 ? _b : 'wasm';
+    const refIds = new Map();
+    let isServe = false;
+    let publicDir = false;
+    return {
+        name: 'locuschain-wasm',
+        enforce: 'pre',
+        configResolved(config) {
+            var _a, _b;
+            isServe = config.command === 'serve';
+            publicDir = config.publicDir;
+            // WASM_DIR 은 lib 패키지 안(보통 node_modules 또는 외부 symlink) 이라 사용자 프로젝트 root
+            // 바깥일 수 있다. dev 에서 `/@fs/<absolute>` 로 wasm 을 서빙하려면 fs.allow 에 등록돼 있어야 한다.
+            // `config()` hook 에서 `server.fs.allow: [WASM_DIR]` 를 반환하면 사용자가 명시하지 않은 경우
+            // Vite 가 기본 workspace root 탐색을 건너뛰어 프로젝트 root 가 allow 에서 빠진다 (→ 사용자 소스 403).
+            // configResolved 시점엔 이미 default 가 채워져 있으므로 안전하게 push 만 한다.
+            if (Array.isArray((_b = (_a = config.server) === null || _a === void 0 ? void 0 : _a.fs) === null || _b === void 0 ? void 0 : _b.allow)) {
+                config.server.fs.allow.push(WASM_DIR);
+            }
+        },
+        buildStart() {
+            refIds.clear();
+            // public 모드: dev/build 양쪽 모두 wasm 4 개를 publicDir/<publicSubdir>/ 로 복사한다.
+            // wxt dev 는 그 폴더를 그대로 .output/chrome-mv3-dev 에 복사해 extension origin
+            // (chrome.runtime.getURL) 으로 노출하므로 /@fs/ 우회가 필요 없어진다.
+            // 같은 build 안에서 여러 번 호출돼도 멱등 (mtime 비교).
+            if (mode === 'public') {
+                if (!publicDir || typeof publicDir !== 'string') {
+                    this.warn(`[locuschain-wasm] mode:'public' requires Vite publicDir. ` +
+                        `Falling back to 'assets' mode for this build.`);
+                }
+                else {
+                    const targetDir = path.join(publicDir, publicSubdir);
+                    if (!fs.existsSync(targetDir)) {
+                        fs.mkdirSync(targetDir, { recursive: true });
+                    }
+                    for (const filename of WASM_FILES) {
+                        const src = path.join(WASM_DIR, filename);
+                        const dst = path.join(targetDir, filename);
+                        if (!fs.existsSync(src)) {
+                            this.error(`[locuschain-wasm] missing wasm asset: ${src}\n` +
+                                `lib 가 정상적으로 빌드/설치되었는지 확인하세요.`);
+                        }
+                        // mtime 비교로 불필요한 재복사 회피 (watch 모드 친화적).
+                        const srcMtime = fs.statSync(src).mtimeMs;
+                        const dstMtime = fs.existsSync(dst) ? fs.statSync(dst).mtimeMs : 0;
+                        if (srcMtime > dstMtime) {
+                            fs.copyFileSync(src, dst);
+                        }
+                    }
+                }
+            }
+        },
+        transform(code, id) {
+            const cleanId = id.replace(/\\/g, '/').replace(/\?.*$/, '');
+            if (!LIB_ID_PATTERN.test(cleanId)) {
+                return null;
+            }
+            // 이 모듈 안에서 어떤 wasm 들이 참조되는지 먼저 스캔.
+            const referenced = [];
+            for (const filename of WASM_FILES) {
+                const patterns = buildWasmUrlPatterns(filename);
+                if (patterns.some(p => p.test(code))) {
+                    referenced.push(filename);
+                }
+            }
+            if (referenced.length === 0)
+                return null;
+            // assets 모드 + build: 처음 보는 wasm 은 emit.
+            if (mode === 'assets' && !isServe) {
+                for (const filename of referenced) {
+                    if (refIds.has(filename))
+                        continue;
+                    const filepath = path.join(WASM_DIR, filename);
+                    if (!fs.existsSync(filepath)) {
+                        this.error(`[locuschain-wasm] missing wasm asset: ${filepath}\n` +
+                            `lib 가 정상적으로 빌드/설치되었는지 확인하세요.`);
+                    }
+                    const referenceId = this.emitFile({
+                        type: 'asset',
+                        name: filename,
+                        source: fs.readFileSync(filepath)
+                    });
+                    refIds.set(filename, referenceId);
+                }
+            }
+            // 패턴 치환. mode 가 먼저 — public 모드는 dev/build 양쪽 모두 publicDir 안
+            // wasm 을 chrome.runtime.getURL 또는 root-relative URL 로 가리킨다.
+            let newCode = code;
+            for (const filename of referenced) {
+                const patterns = buildWasmUrlPatterns(filename);
+                let replacement;
+                if (mode === 'public') {
+                    // chrome extension: chrome.runtime.getURL 로 절대 URL 생성.
+                    // 일반 web (chrome 없음) 폴백: root-relative URL — dev/build 모두 publicDir
+                    // 의 wasm 을 dev server / 빌드 output 이 동일 경로로 서빙한다.
+                    const relPath = `${publicSubdir}/${filename}`;
+                    replacement =
+                        `((typeof chrome !== 'undefined' && chrome.runtime && chrome.runtime.getURL) ` +
+                            `? chrome.runtime.getURL(${JSON.stringify(relPath)}) ` +
+                            `: new URL(${JSON.stringify('/' + relPath)}, import.meta.url))`;
+                }
+                else if (isServe) {
+                    // assets 모드 + dev: /@fs/<absolute path> 로 dev server 가 직접 서빙.
+                    // (이 경로는 fs.allow 에 WASM_DIR 가 등록돼 있어야 한다 — configResolved 참조.)
+                    const absUrl = path.join(WASM_DIR, filename).replace(/\\/g, '/');
+                    replacement = `new URL(${JSON.stringify('/@fs/' + absUrl)}, import.meta.url)`;
+                }
+                else {
+                    // assets 모드 + build
+                    const refId = refIds.get(filename);
+                    if (!refId)
+                        continue;
+                    replacement = `new URL(import.meta.ROLLUP_FILE_URL_${refId}, import.meta.url)`;
+                }
+                for (const pattern of patterns) {
+                    newCode = newCode.replace(pattern, replacement);
+                }
+            }
+            return { code: newCode, map: null };
+        }
+    };
+}
+
+export { locusWasmPlugin as default, locusWasmPlugin };