@changw98ic/cli 1.0.0

package/dist/utils/project-locator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-locator.d.ts","sourceRoot":"","sources":["../../src/utils/project-locator.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,yBAAyB,+BAAgC,CAAC;AACvE,eAAO,MAAM,2BAA2B,QAA+C,CAAC;AACxF,eAAO,MAAM,mBAAmB,QAA6C,CAAC;AAE9E,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAC3D,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAC7C,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAC/D,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AAMjE;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAStD;AAuOD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,mBAAmB,CAAC,EAAE,MAAM,EAC5B,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,MAAM,CAuER;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE;IAC1D,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,GAAG,IAAI,CAiChB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,MAAM,GAAG,IAAI,CA+Cf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,iBAAiB,CAAC,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE;IACR,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,MAAM,CAaR"}

package/dist/utils/project-locator.js

@@ -0,0 +1,372 @@
+/**
+ * Project Locator - 项目根目录解析器
+ *
+ * 迁移自 Python project_locator.py，保持完全兼容
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join, resolve, dirname } from 'path';
+import { platform } from 'os';
+import { getStatePath, isProjectRoot, isExplicitProjectRoot, normalizePath, getGlobalRegistryPath, makePathKey, nowIso, } from './path-compat.js';
+// ============================================================================
+// Constants
+// ============================================================================
+export const DEFAULT_PROJECT_DIR_NAMES = ['webnovel-project'];
+export const CURRENT_PROJECT_POINTER_REL = join('.claude', '.webnovel-current-project');
+export const GLOBAL_REGISTRY_REL = join('webnovel-writer', 'workspaces.json');
+export const ENV_CLAUDE_PROJECT_DIR = 'CLAUDE_PROJECT_DIR';
+export const ENV_CLAUDE_HOME = 'CLAUDE_HOME';
+export const ENV_WEBNOVEL_CLAUDE_HOME = 'WEBNOVEL_CLAUDE_HOME';
+export const ENV_WEBNOVEL_PROJECT_ROOT = 'WEBNOVEL_PROJECT_ROOT';
+// ============================================================================
+// Git Root Detection
+// ============================================================================
+/**
+ * 查找最近的 Git 根目录
+ */
+export function findGitRoot(cwd) {
+    const parts = resolve(cwd).split(/[/\\]/);
+    for (let i = parts.length; i > 0; i--) {
+        const candidate = parts.slice(0, i).join(sep());
+        if (existsSync(join(candidate, '.git'))) {
+            return candidate || '/';
+        }
+    }
+    return null;
+}
+function sep() {
+    return platform() === 'win32' ? '\\' : '/';
+}
+function defaultRegistry() {
+    return {
+        schema_version: 1,
+        workspaces: {},
+        last_used_project_root: '',
+        updated_at: nowIso(),
+    };
+}
+function loadGlobalRegistry(path) {
+    if (!existsSync(path)) {
+        return defaultRegistry();
+    }
+    try {
+        const content = readFileSync(path, 'utf-8');
+        const data = JSON.parse(content || '{}');
+        if (typeof data !== 'object' || data === null) {
+            return defaultRegistry();
+        }
+        return {
+            schema_version: data.schema_version ?? 1,
+            workspaces: data.workspaces ?? {},
+            last_used_project_root: data.last_used_project_root ?? '',
+            updated_at: data.updated_at ?? nowIso(),
+        };
+    }
+    catch {
+        return defaultRegistry();
+    }
+}
+function saveGlobalRegistry(path, data) {
+    try {
+        const dir = dirname(path);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        data.updated_at = nowIso();
+        writeFileSync(path, JSON.stringify(data, null, 2), 'utf-8');
+    }
+    catch {
+        // best-effort, 非阻断
+    }
+}
+/**
+ * 从用户级 registry 解析 project_root
+ */
+function resolveProjectRootFromGlobalRegistry(base, options) {
+    const regPath = getGlobalRegistryPath();
+    const reg = loadGlobalRegistry(regPath);
+    const workspaces = reg.workspaces;
+    if (Object.keys(workspaces).length === 0) {
+        return null;
+    }
+    const hints = [];
+    const envWs = process.env[ENV_CLAUDE_PROJECT_DIR];
+    if (envWs) {
+        hints.push(normalizePath(envWs));
+    }
+    if (options?.workspaceHint) {
+        hints.push(normalizePath(options.workspaceHint));
+    }
+    hints.push(normalizePath(base));
+    // 1) 精确匹配
+    for (const hint of hints) {
+        const key = makePathKey(hint);
+        const entry = workspaces[key];
+        if (entry && entry.current_project_root) {
+            const target = resolve(normalizePath(entry.current_project_root));
+            if (isProjectRoot(target)) {
+                return target;
+            }
+        }
+    }
+    // 2) 前缀匹配
+    for (const hint of hints) {
+        const hintKey = makePathKey(hint);
+        let bestKey = null;
+        let bestLen = -1;
+        for (const wsKey of Object.keys(workspaces)) {
+            if (hintKey === wsKey || hintKey.startsWith(wsKey + sep())) {
+                if (wsKey.length > bestLen) {
+                    bestKey = wsKey;
+                    bestLen = wsKey.length;
+                }
+            }
+        }
+        if (bestKey) {
+            const entry = workspaces[bestKey];
+            if (entry && entry.current_project_root) {
+                const target = resolve(normalizePath(entry.current_project_root));
+                if (isProjectRoot(target)) {
+                    return target;
+                }
+            }
+        }
+    }
+    // 3) last_used fallback
+    if (options?.allowLastUsedFallback) {
+        const lastUsed = reg.last_used_project_root;
+        if (lastUsed) {
+            const target = resolve(normalizePath(lastUsed));
+            if (isProjectRoot(target)) {
+                return target;
+            }
+        }
+    }
+    return null;
+}
+// ============================================================================
+// Pointer File
+// ============================================================================
+/**
+ * 查找包含 .claude/ 的最近祖先目录
+ */
+function findWorkspaceRootWithClaude(start) {
+    const parts = resolve(start).split(/[/\\]/);
+    for (let i = parts.length; i > 0; i--) {
+        const candidate = parts.slice(0, i).join(sep());
+        if (existsSync(join(candidate, '.claude'))) {
+            return candidate || '/';
+        }
+    }
+    return null;
+}
+/**
+ * 从 workspace 指针文件解析 project_root
+ */
+function resolveProjectRootFromPointer(cwd, stopAt) {
+    const parts = resolve(cwd).split(/[/\\]/);
+    for (let i = parts.length; i > 0; i--) {
+        const candidate = parts.slice(0, i).join(sep());
+        const pointerFile = join(candidate, CURRENT_PROJECT_POINTER_REL);
+        if (existsSync(pointerFile)) {
+            const raw = readFileSync(pointerFile, 'utf-8').trim();
+            if (!raw)
+                continue;
+            let target = normalizePath(raw);
+            if (!resolve(target).startsWith('/')) {
+                // 相对路径，相对于指针文件所在目录
+                target = resolve(join(dirname(pointerFile), raw));
+            }
+            if (isProjectRoot(target)) {
+                return resolve(target);
+            }
+        }
+        if (stopAt && candidate === stopAt) {
+            break;
+        }
+    }
+    return null;
+}
+// ============================================================================
+// Candidate Roots
+// ============================================================================
+function* candidateRoots(cwd, stopAt) {
+    const resolved = resolve(cwd);
+    yield resolved;
+    for (const name of DEFAULT_PROJECT_DIR_NAMES) {
+        yield join(resolved, name);
+    }
+    const parts = resolved.split(/[/\\]/);
+    for (let i = parts.length - 1; i > 0; i--) {
+        const parent = parts.slice(0, i).join(sep());
+        yield parent;
+        for (const name of DEFAULT_PROJECT_DIR_NAMES) {
+            yield join(parent, name);
+        }
+        if (stopAt && parent === stopAt) {
+            break;
+        }
+    }
+}
+// ============================================================================
+// Main API
+// ============================================================================
+/**
+ * 解析项目根目录
+ *
+ * 解析优先级：
+ * 1) 显式传入的 project_root
+ * 2) 环境变量 WEBNOVEL_PROJECT_ROOT
+ * 3) workspace 指针文件
+ * 4) 用户级 registry (前缀匹配)
+ * 5) 从 CWD 向上搜索 .webnovel/state.json
+ *
+ * @throws Error 如果无法找到有效的项目根目录
+ */
+export function resolveProjectRoot(explicitProjectRoot, options) {
+    const cwd = resolve(options?.cwd || process.cwd());
+    // 1) 显式传入
+    if (explicitProjectRoot) {
+        const root = resolve(normalizePath(explicitProjectRoot));
+        if (isExplicitProjectRoot(root)) {
+            return root;
+        }
+        // 兼容：显式传入工作区根目录（含指针文件）
+        const pointerRoot = resolveProjectRootFromPointer(root, findGitRoot(root));
+        if (pointerRoot) {
+            return pointerRoot;
+        }
+        // 兼容：从用户级 registry 查找
+        const regRoot = resolveProjectRootFromGlobalRegistry(root, {
+            workspaceHint: root,
+            allowLastUsedFallback: false,
+        });
+        if (regRoot) {
+            return regRoot;
+        }
+        throw new Error(`Not a webnovel project root (missing .webnovel/state.json): ${root}`);
+    }
+    // 2) 环境变量
+    const envRoot = process.env[ENV_WEBNOVEL_PROJECT_ROOT];
+    if (envRoot) {
+        const root = resolve(normalizePath(envRoot));
+        if (isProjectRoot(root)) {
+            return root;
+        }
+        throw new Error(`WEBNOVEL_PROJECT_ROOT is set but invalid (missing .webnovel/state.json): ${root}`);
+    }
+    const gitRoot = findGitRoot(cwd);
+    // 3) workspace 指针文件
+    const pointerRoot = resolveProjectRootFromPointer(cwd, gitRoot);
+    if (pointerRoot) {
+        return pointerRoot;
+    }
+    // 4) 用户级 registry
+    const allowLastUsed = Boolean(process.env[ENV_CLAUDE_PROJECT_DIR]);
+    const regRoot = resolveProjectRootFromGlobalRegistry(cwd, {
+        allowLastUsedFallback: allowLastUsed,
+    });
+    if (regRoot) {
+        return regRoot;
+    }
+    // 5) 从 CWD 向上搜索
+    for (const candidate of candidateRoots(cwd, gitRoot)) {
+        if (isProjectRoot(candidate)) {
+            return resolve(candidate);
+        }
+    }
+    throw new Error('Unable to locate webnovel project root. Expected `.webnovel/state.json` under the current directory, ' +
+        'a parent directory, or `webnovel-project/`. Run /webnovel-init first or pass --project-root / set ' +
+        'WEBNOVEL_PROJECT_ROOT.');
+}
+/**
+ * 更新用户级 registry：workspace -> current_project_root 映射
+ */
+export function updateGlobalRegistryCurrentProject(options) {
+    const root = resolve(normalizePath(options.projectRoot));
+    if (!isProjectRoot(root)) {
+        throw new Error(`Not a webnovel project root (missing .webnovel/state.json): ${root}`);
+    }
+    let ws = options.workspaceRoot;
+    if (!ws) {
+        const envWs = process.env[ENV_CLAUDE_PROJECT_DIR];
+        if (envWs) {
+            ws = normalizePath(envWs);
+        }
+    }
+    if (!ws) {
+        return null;
+    }
+    ws = resolve(normalizePath(ws));
+    const regPath = getGlobalRegistryPath();
+    const reg = loadGlobalRegistry(regPath);
+    const workspaces = reg.workspaces;
+    workspaces[makePathKey(ws)] = {
+        workspace_root: ws,
+        current_project_root: root,
+        updated_at: nowIso(),
+    };
+    reg.last_used_project_root = root;
+    saveGlobalRegistry(regPath, reg);
+    return regPath;
+}
+/**
+ * 写入 workspace 级当前项目指针
+ */
+export function writeCurrentProjectPointer(projectRoot, options) {
+    const root = resolve(normalizePath(projectRoot));
+    if (!isProjectRoot(root)) {
+        throw new Error(`Not a webnovel project root (missing .webnovel/state.json): ${root}`);
+    }
+    let wsRoot = options?.workspaceRoot
+        ? resolve(normalizePath(options.workspaceRoot))
+        : findWorkspaceRootWithClaude(root);
+    if (!wsRoot) {
+        wsRoot = findWorkspaceRootWithClaude(resolve(process.cwd()));
+    }
+    if (!wsRoot) {
+        // 兜底：使用项目父目录
+        wsRoot = dirname(root);
+    }
+    let pointerFile = null;
+    // 仅当工作区内已存在 .claude/ 时才写入指针
+    if (existsSync(join(wsRoot, '.claude'))) {
+        try {
+            pointerFile = join(wsRoot, CURRENT_PROJECT_POINTER_REL);
+            const pointerDir = dirname(pointerFile);
+            if (!existsSync(pointerDir)) {
+                mkdirSync(pointerDir, { recursive: true });
+            }
+            writeFileSync(pointerFile, root, 'utf-8');
+        }
+        catch {
+            pointerFile = null;
+        }
+    }
+    // best-effort 更新用户级 registry
+    try {
+        updateGlobalRegistryCurrentProject({
+            workspaceRoot: wsRoot,
+            projectRoot: root,
+        });
+    }
+    catch {
+        // 非阻断
+    }
+    return pointerFile;
+}
+/**
+ * 解析 state.json 文件路径
+ */
+export function resolveStateFile(explicitStateFile, options) {
+    const cwd = resolve(options?.cwd || process.cwd());
+    if (explicitStateFile) {
+        const p = resolve(normalizePath(explicitStateFile));
+        if (!p.startsWith('/')) {
+            return resolve(join(cwd, p));
+        }
+        return p;
+    }
+    const root = resolveProjectRoot(options?.explicitProjectRoot, { cwd });
+    return getStatePath(root);
+}
+//# sourceMappingURL=project-locator.js.map

package/dist/utils/project-locator.js.map

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

package/dist/utils/runtime-compat.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 在 Windows 上启用 UTF-8 stdio
+ *
+ * Node.js 默认在 Windows 上使用 UTF-8，但控制台可能需要设置
+ * 此函数主要用于打印前的编码确保
+ */
+export declare function setupWindowsUtf8(): boolean;
+/**
+ * 规范化 Windows 上的 POSIX 风格路径
+ *
+ * 处理以下格式：
+ * - Git Bash / MSYS: /d/desktop/... => D:/desktop/...
+ * - WSL: /mnt/d/desktop/... => D:/desktop/...
+ *
+ * @param path 原始路径
+ * @returns 规范化后的路径
+ */
+export declare function normalizeWindowsPath(path: string): string;
+/**
+ * 跨平台路径规范化
+ *
+ * 统一处理不同来源的路径格式
+ */
+export declare function normalizePathCrossPlatform(path: string): string;
+/**
+ * 获取安全的 stdio 编码
+ *
+ * Node.js 默认 UTF-8，此函数返回编码名称供参考
+ */
+export declare function getStdioEncoding(): string;
+/**
+ * 检测是否在 WSL 环境中运行
+ */
+export declare function isWsl(): boolean;
+/**
+ * 获取平台特定的换行符
+ */
+export declare function getNewline(): string;
+//# sourceMappingURL=runtime-compat.d.ts.map

package/dist/utils/runtime-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-compat.d.ts","sourceRoot":"","sources":["../../src/utils/runtime-compat.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAgB1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BzD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAY/B;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/utils/runtime-compat.js

@@ -0,0 +1,113 @@
+/**
+ * 运行时兼容性工具
+ *
+ * 迁移自 Python runtime_compat.py
+ * 处理 Windows UTF-8 stdio 和跨平台路径规范化
+ */
+import { platform } from 'os';
+import { normalize, resolve } from 'path';
+const isWindows = platform() === 'win32';
+// Windows POSIX 风格路径正则（Git Bash / MSYS 风格）
+const WIN_POSIX_DRIVE_RE = /^\/([a-zA-Z])\/(.*)$/;
+// WSL 挂载路径正则
+const WIN_WSL_MNT_DRIVE_RE = /^\/mnt\/([a-zA-Z])\/(.*)$/;
+/**
+ * 在 Windows 上启用 UTF-8 stdio
+ *
+ * Node.js 默认在 Windows 上使用 UTF-8，但控制台可能需要设置
+ * 此函数主要用于打印前的编码确保
+ */
+export function setupWindowsUtf8() {
+    if (!isWindows) {
+        return false;
+    }
+    // Node.js 在 Windows 上默认使用 UTF-8，无需额外设置
+    // 但可以设置控制台代码页为 UTF-8
+    try {
+        // 通过环境变量抑制编码警告
+        if (!process.env.NODE_OPTIONS?.includes('--no-warnings')) {
+            process.env.NODE_OPTIONS = (process.env.NODE_OPTIONS || '') + ' --no-warnings';
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 规范化 Windows 上的 POSIX 风格路径
+ *
+ * 处理以下格式：
+ * - Git Bash / MSYS: /d/desktop/... => D:/desktop/...
+ * - WSL: /mnt/d/desktop/... => D:/desktop/...
+ *
+ * @param path 原始路径
+ * @returns 规范化后的路径
+ */
+export function normalizeWindowsPath(path) {
+    if (!isWindows) {
+        return normalize(path);
+    }
+    const raw = path.trim();
+    if (!raw) {
+        return raw;
+    }
+    // WSL 挂载路径: /mnt/d/... => D:/...
+    let match = raw.match(WIN_WSL_MNT_DRIVE_RE);
+    if (match) {
+        const drive = match[1].toUpperCase();
+        const rest = match[2];
+        return normalize(`${drive}:/${rest}`);
+    }
+    // Git Bash / MSYS 路径: /d/... => D:/...
+    match = raw.match(WIN_POSIX_DRIVE_RE);
+    if (match) {
+        const drive = match[1].toUpperCase();
+        const rest = match[2];
+        return normalize(`${drive}:/${rest}`);
+    }
+    return normalize(path);
+}
+/**
+ * 跨平台路径规范化
+ *
+ * 统一处理不同来源的路径格式
+ */
+export function normalizePathCrossPlatform(path) {
+    // 先处理 Windows 特殊格式
+    let normalized = normalizeWindowsPath(path);
+    // 再规范化
+    return resolve(normalized);
+}
+/**
+ * 获取安全的 stdio 编码
+ *
+ * Node.js 默认 UTF-8，此函数返回编码名称供参考
+ */
+export function getStdioEncoding() {
+    return 'utf-8';
+}
+/**
+ * 检测是否在 WSL 环境中运行
+ */
+export function isWsl() {
+    if (!isWindows && process.platform === 'linux') {
+        // 检测 WSL 环境
+        try {
+            const fs = require('fs');
+            const release = fs.readFileSync('/proc/version', 'utf-8');
+            return release.toLowerCase().includes('microsoft');
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+/**
+ * 获取平台特定的换行符
+ */
+export function getNewline() {
+    return isWindows ? '\r\n' : '\n';
+}
+//# sourceMappingURL=runtime-compat.js.map

package/dist/utils/runtime-compat.js.map

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

package/dist/utils/security.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 清理文件名，防止路径遍历攻击 (CWE-22)
+ *
+ * @param name 原始文件名（可能包含路径遍历字符）
+ * @param maxLength 文件名最大长度（默认 100 字符）
+ * @returns 安全的文件名
+ */
+export declare function sanitizeFilename(name: string, maxLength?: number): string;
+/**
+ * 清理 Git 提交消息，防止命令注入 (CWE-77)
+ *
+ * @param message 原始提交消息
+ * @param maxLength 消息最大长度（默认 200 字符）
+ * @returns 安全的提交消息
+ */
+export declare function sanitizeCommitMessage(message: string, maxLength?: number): string;
+/**
+ * 检测 Git 是否可用
+ */
+export declare function isGitAvailable(): boolean;
+/**
+ * 检测指定目录是否是 Git 仓库
+ */
+export declare function isGitRepo(path: string): boolean;
+interface GitOperationResult {
+    success: boolean;
+    output: string;
+    wasSkipped: boolean;
+}
+/**
+ * 优雅执行 Git 操作
+ */
+export declare function gitGracefulOperation(args: string[], cwd: string, fallbackMsg?: string): Promise<GitOperationResult>;
+/**
+ * Git add
+ */
+export declare function gitAdd(files: string[], cwd: string): Promise<GitOperationResult>;
+/**
+ * Git commit
+ */
+export declare function gitCommit(message: string, cwd: string): Promise<GitOperationResult>;
+/**
+ * Git status
+ */
+export declare function gitStatus(cwd: string): Promise<string[]>;
+export declare class AtomicWriteError extends Error {
+    constructor(message: string);
+}
+/**
+ * 原子化写入 JSON 文件
+ *
+ * 实现策略：
+ * 1. 写入临时文件（同目录）
+ * 2. 可选：备份原文件
+ * 3. 原子重命名
+ */
+export declare function writeJsonAtomic(filePath: string, data: unknown, options?: {
+    backup?: boolean;
+    indent?: number;
+}): void;
+/**
+ * 安全读取 JSON 文件
+ */
+export declare function readJsonSafe<T = Record<string, unknown>>(filePath: string, defaultValue?: T): T;
+/**
+ * 从备份恢复文件
+ */
+export declare function restoreFromBackup(filePath: string): boolean;
+/**
+ * 验证并转换整数输入
+ */
+export declare function validateIntegerInput(value: string, fieldName: string): number;
+export {};
+//# sourceMappingURL=security.d.ts.map

package/dist/utils/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/utils/security.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CA4BtE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CA8B9E;AAQD;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAiBxC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK/C;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,WAAW,SAAqB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CA0C7B;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAEtF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAGzF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAM9D;AAMD,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,IAAI,CAuDN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,CAAC,GACf,CAAC,CAcH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgB3D;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAU7E"}