@lbruton/spec-workflow-mcp 2.2.4

package/dist/__tests__/index-entrypoint.test.js

@@ -0,0 +1,23 @@
+import { describe, expect, it } from 'vitest';
+import { mkdtempSync, realpathSync, symlinkSync, writeFileSync } from 'fs';
+import { join, resolve } from 'path';
+import { tmpdir } from 'os';
+import { resolveEntrypoint } from '../index.js';
+describe('resolveEntrypoint', () => {
+    it('returns undefined for undefined input', () => {
+        expect(resolveEntrypoint(undefined)).toBeUndefined();
+    });
+    it('falls back to path.resolve when path does not exist', () => {
+        const missing = './definitely-missing-entrypoint.js';
+        expect(resolveEntrypoint(missing)).toBe(resolve(missing));
+    });
+    it('resolves symlinks to their real path', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'specwf-entrypoint-'));
+        const target = join(dir, 'target.js');
+        const link = join(dir, 'link.js');
+        writeFileSync(target, 'console.log("ok");', 'utf-8');
+        symlinkSync(target, link);
+        expect(resolveEntrypoint(link)).toBe(realpathSync(target));
+    });
+});
+//# sourceMappingURL=index-entrypoint.test.js.map

package/dist/__tests__/index-entrypoint.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-entrypoint.test.js","sourceRoot":"","sources":["../../src/__tests__/index-entrypoint.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,OAAO,GAAG,oCAAoC,CAAC;QACrD,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAClC,aAAa,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAC;QACrD,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE1B,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+export interface SpecWorkflowConfig {
+    projectDir?: string;
+    port?: number;
+    bindAddress?: string;
+    allowExternalAccess?: boolean;
+    dashboardOnly?: boolean;
+    lang?: string;
+    security?: {
+        rateLimitEnabled?: boolean;
+        rateLimitPerMinute?: number;
+        auditLogEnabled?: boolean;
+        auditLogPath?: string;
+        auditLogRetentionDays?: number;
+        corsEnabled?: boolean;
+        allowedOrigins?: string[];
+    };
+}
+export interface ConfigLoadResult {
+    config: SpecWorkflowConfig | null;
+    configPath: string | null;
+    error?: string;
+}
+export declare function loadConfigFromPath(configPath: string): ConfigLoadResult;
+export declare function loadConfigFile(projectDir: string, customConfigPath?: string): ConfigLoadResult;
+export declare function mergeConfigs(fileConfig: SpecWorkflowConfig | null, cliArgs: Partial<SpecWorkflowConfig>): SpecWorkflowConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,QAAQ,CAAC,EAAE;QACT,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyFD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAwEvE;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAkC9F;AAED,wBAAgB,YAAY,CAC1B,UAAU,EAAE,kBAAkB,GAAG,IAAI,EACrC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,kBAAkB,CAepB"}

package/dist/config.js

@@ -0,0 +1,188 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as toml from 'toml';
+import { homedir } from 'os';
+import { isLocalhostAddress } from './core/security-utils.js';
+function expandTilde(filepath) {
+    if (filepath.startsWith('~')) {
+        return path.join(homedir(), filepath.slice(1));
+    }
+    return filepath;
+}
+function validatePort(port) {
+    return Number.isInteger(port) && port >= 1024 && port <= 65535;
+}
+function validateConfig(config) {
+    if (config.port !== undefined) {
+        if (!validatePort(config.port)) {
+            return {
+                valid: false,
+                error: `Invalid port: ${config.port}. Port must be between 1024 and 65535.`
+            };
+        }
+    }
+    if (config.projectDir !== undefined && typeof config.projectDir !== 'string') {
+        return {
+            valid: false,
+            error: `Invalid projectDir: must be a string.`
+        };
+    }
+    if (config.dashboardOnly !== undefined && typeof config.dashboardOnly !== 'boolean') {
+        return {
+            valid: false,
+            error: `Invalid dashboardOnly: must be a boolean.`
+        };
+    }
+    if (config.lang !== undefined && typeof config.lang !== 'string') {
+        return {
+            valid: false,
+            error: `Invalid lang: must be a string.`
+        };
+    }
+    // Validate network configuration
+    if (config.bindAddress !== undefined && typeof config.bindAddress !== 'string') {
+        return {
+            valid: false,
+            error: `Invalid bindAddress: must be a valid IP address string.`
+        };
+    }
+    if (config.allowExternalAccess !== undefined && typeof config.allowExternalAccess !== 'boolean') {
+        return {
+            valid: false,
+            error: `Invalid allowExternalAccess: must be a boolean.`
+        };
+    }
+    // Network security validation: if binding to non-localhost address, require explicit allowExternalAccess
+    if (config.bindAddress !== undefined && !isLocalhostAddress(config.bindAddress) && !config.allowExternalAccess) {
+        return {
+            valid: false,
+            error: `Network security: binding to '${config.bindAddress}' (non-localhost) requires explicit allowExternalAccess = true. This exposes your dashboard to network access.`
+        };
+    }
+    // Validate security features
+    if (config.security !== undefined) {
+        const sec = config.security;
+        if (sec.rateLimitPerMinute !== undefined && (typeof sec.rateLimitPerMinute !== 'number' || sec.rateLimitPerMinute < 1)) {
+            return {
+                valid: false,
+                error: `Invalid security.rateLimitPerMinute: must be a positive number.`
+            };
+        }
+        if (sec.auditLogRetentionDays !== undefined && (typeof sec.auditLogRetentionDays !== 'number' || sec.auditLogRetentionDays < 1)) {
+            return {
+                valid: false,
+                error: `Invalid security.auditLogRetentionDays: must be a positive number.`
+            };
+        }
+    }
+    return { valid: true };
+}
+export function loadConfigFromPath(configPath) {
+    try {
+        const expandedPath = expandTilde(configPath);
+        if (!fs.existsSync(expandedPath)) {
+            return {
+                config: null,
+                configPath: expandedPath,
+                error: `Config file not found: ${expandedPath}`
+            };
+        }
+        const configContent = fs.readFileSync(expandedPath, 'utf-8');
+        const parsedConfig = toml.parse(configContent);
+        const validation = validateConfig(parsedConfig);
+        if (!validation.valid) {
+            return {
+                config: null,
+                configPath: expandedPath,
+                error: validation.error
+            };
+        }
+        const config = {};
+        if (parsedConfig.projectDir !== undefined) {
+            config.projectDir = expandTilde(parsedConfig.projectDir);
+        }
+        if (parsedConfig.port !== undefined) {
+            config.port = parsedConfig.port;
+        }
+        if (parsedConfig.bindAddress !== undefined) {
+            config.bindAddress = parsedConfig.bindAddress;
+        }
+        if (parsedConfig.allowExternalAccess !== undefined) {
+            config.allowExternalAccess = parsedConfig.allowExternalAccess;
+        }
+        if (parsedConfig.dashboardOnly !== undefined) {
+            config.dashboardOnly = parsedConfig.dashboardOnly;
+        }
+        if (parsedConfig.lang !== undefined) {
+            config.lang = parsedConfig.lang;
+        }
+        if (parsedConfig.security !== undefined) {
+            config.security = parsedConfig.security;
+        }
+        return {
+            config,
+            configPath: expandedPath
+        };
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            return {
+                config: null,
+                configPath: null,
+                error: `Failed to load config file: ${error.message}`
+            };
+        }
+        return {
+            config: null,
+            configPath: null,
+            error: 'Failed to load config file: Unknown error'
+        };
+    }
+}
+export function loadConfigFile(projectDir, customConfigPath) {
+    // If custom config path is provided, use it
+    if (customConfigPath) {
+        return loadConfigFromPath(customConfigPath);
+    }
+    // Otherwise, look for default config in project directory
+    try {
+        const expandedDir = expandTilde(projectDir);
+        const configDir = path.join(expandedDir, '.spec-workflow');
+        const configPath = path.join(configDir, 'config.toml');
+        if (!fs.existsSync(configPath)) {
+            return {
+                config: null,
+                configPath: null
+            };
+        }
+        return loadConfigFromPath(configPath);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            return {
+                config: null,
+                configPath: null,
+                error: `Failed to load config file: ${error.message}`
+            };
+        }
+        return {
+            config: null,
+            configPath: null,
+            error: 'Failed to load config file: Unknown error'
+        };
+    }
+}
+export function mergeConfigs(fileConfig, cliArgs) {
+    const merged = {};
+    if (fileConfig) {
+        Object.assign(merged, fileConfig);
+    }
+    Object.keys(cliArgs).forEach(key => {
+        const value = cliArgs[key];
+        if (value !== undefined) {
+            merged[key] = value;
+        }
+    });
+    return merged;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/core/__tests__/git-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-utils.test.d.ts.map

package/dist/core/__tests__/git-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.test.d.ts","sourceRoot":"","sources":["../../../src/core/__tests__/git-utils.test.ts"],"names":[],"mappings":""}

package/dist/core/__tests__/git-utils.test.js

@@ -0,0 +1,179 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { execSync } from 'child_process';
+import { resolveGitRoot, resolveGitWorkspaceRoot, isGitWorktree, SPEC_WORKFLOW_SHARED_ROOT_ENV } from '../git-utils.js';
+// Mock child_process
+vi.mock('child_process', () => ({
+    execSync: vi.fn()
+}));
+const mockedExecSync = vi.mocked(execSync);
+describe('resolveGitRoot', () => {
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        delete process.env[SPEC_WORKFLOW_SHARED_ROOT_ENV];
+    });
+    afterEach(() => {
+        process.env = { ...originalEnv };
+    });
+    describe('explicit env var override', () => {
+        it('should use SPEC_WORKFLOW_SHARED_ROOT when set', () => {
+            process.env[SPEC_WORKFLOW_SHARED_ROOT_ENV] = '/custom/root';
+            const result = resolveGitRoot('/some/project');
+            expect(result).toBe('/custom/root');
+            expect(mockedExecSync).not.toHaveBeenCalled();
+        });
+        it('should trim whitespace from env var', () => {
+            process.env[SPEC_WORKFLOW_SHARED_ROOT_ENV] = '  /custom/root  ';
+            const result = resolveGitRoot('/some/project');
+            expect(result).toBe('/custom/root');
+        });
+        it('should ignore empty env var', () => {
+            process.env[SPEC_WORKFLOW_SHARED_ROOT_ENV] = '';
+            mockedExecSync.mockReturnValue('.git');
+            const result = resolveGitRoot('/some/project');
+            expect(result).toBe('/some/project');
+            expect(mockedExecSync).toHaveBeenCalled();
+        });
+        it('should ignore whitespace-only env var', () => {
+            process.env[SPEC_WORKFLOW_SHARED_ROOT_ENV] = '   ';
+            mockedExecSync.mockReturnValue('.git');
+            const result = resolveGitRoot('/some/project');
+            expect(result).toBe('/some/project');
+            expect(mockedExecSync).toHaveBeenCalled();
+        });
+    });
+    describe('main git repository', () => {
+        it('should return original path when in main repo', () => {
+            mockedExecSync.mockReturnValue('.git');
+            const result = resolveGitRoot('/main/repo');
+            expect(result).toBe('/main/repo');
+        });
+        it('should return original path when git returns ".git" with newline', () => {
+            mockedExecSync.mockReturnValue('.git\n');
+            const result = resolveGitRoot('/main/repo');
+            expect(result).toBe('/main/repo');
+        });
+    });
+    describe('git worktree', () => {
+        it('should return main repo path when in worktree (Unix-style path)', () => {
+            mockedExecSync.mockReturnValue('/home/user/main-repo/.git');
+            const result = resolveGitRoot('/home/user/worktree');
+            expect(result).toBe('/home/user/main-repo');
+        });
+        it('should return main repo path when git returns worktree subfolder', () => {
+            mockedExecSync.mockReturnValue('/home/user/main-repo/.git/worktrees/feature-branch');
+            const result = resolveGitRoot('/home/user/worktree');
+            expect(result).toBe('/home/user/main-repo');
+        });
+        it('should handle Windows-style paths', () => {
+            mockedExecSync.mockReturnValue('C:/Users/dev/main-repo/.git');
+            const result = resolveGitRoot('C:/Users/dev/worktree');
+            expect(result).toBe('C:/Users/dev/main-repo');
+        });
+    });
+    describe('subdirectory with relative path', () => {
+        it('should resolve relative path when git returns relative .git path', () => {
+            // When running from a subdirectory, git returns relative paths like "../../.git"
+            mockedExecSync.mockReturnValue('../../.git');
+            const result = resolveGitRoot('/home/user/repo/src/core');
+            // Should resolve to the main repo path, not return "../.." which would fail path traversal check
+            expect(result).toBe('/home/user/repo');
+        });
+        it('should resolve deeply nested relative path', () => {
+            mockedExecSync.mockReturnValue('../../../.git');
+            const result = resolveGitRoot('/home/user/repo/src/lib/utils');
+            expect(result).toBe('/home/user/repo');
+        });
+        it('should resolve single level relative path', () => {
+            mockedExecSync.mockReturnValue('../.git');
+            const result = resolveGitRoot('/home/user/repo/src');
+            expect(result).toBe('/home/user/repo');
+        });
+    });
+    describe('error handling', () => {
+        it('should return original path when git command fails', () => {
+            mockedExecSync.mockImplementation(() => {
+                throw new Error('not a git repository');
+            });
+            const result = resolveGitRoot('/not/a/git/repo');
+            expect(result).toBe('/not/a/git/repo');
+        });
+        it('should return original path when git is not installed', () => {
+            mockedExecSync.mockImplementation(() => {
+                throw new Error('git: command not found');
+            });
+            const result = resolveGitRoot('/some/path');
+            expect(result).toBe('/some/path');
+        });
+        it('should return original path on timeout', () => {
+            mockedExecSync.mockImplementation(() => {
+                const error = new Error('timeout');
+                error.killed = true;
+                throw error;
+            });
+            const result = resolveGitRoot('/some/path');
+            expect(result).toBe('/some/path');
+        });
+    });
+    describe('execSync configuration', () => {
+        it('should call git with correct options', () => {
+            mockedExecSync.mockReturnValue('.git');
+            resolveGitRoot('/test/path');
+            expect(mockedExecSync).toHaveBeenCalledWith('git rev-parse --git-common-dir', expect.objectContaining({
+                cwd: '/test/path',
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout: 5000
+            }));
+        });
+    });
+});
+describe('resolveGitWorkspaceRoot', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should return workspace root from git when available', () => {
+        mockedExecSync.mockReturnValue('/home/user/repo\n');
+        const result = resolveGitWorkspaceRoot('/home/user/repo/src/components');
+        expect(result).toBe('/home/user/repo');
+        expect(mockedExecSync).toHaveBeenCalledWith('git rev-parse --show-toplevel', expect.objectContaining({
+            cwd: '/home/user/repo/src/components',
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 5000
+        }));
+    });
+    it('should return original path when git fails', () => {
+        mockedExecSync.mockImplementation(() => {
+            throw new Error('not a git repository');
+        });
+        const result = resolveGitWorkspaceRoot('/not/a/repo');
+        expect(result).toBe('/not/a/repo');
+    });
+});
+describe('isGitWorktree', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should return false when in main repo', () => {
+        mockedExecSync.mockReturnValue('.git');
+        expect(isGitWorktree('/main/repo')).toBe(false);
+    });
+    it('should return true when in worktree', () => {
+        mockedExecSync.mockReturnValue('/home/user/main-repo/.git');
+        expect(isGitWorktree('/home/user/worktree')).toBe(true);
+    });
+    it('should return false when not a git repo', () => {
+        mockedExecSync.mockImplementation(() => {
+            throw new Error('not a git repository');
+        });
+        expect(isGitWorktree('/not/a/repo')).toBe(false);
+    });
+    it('should return false when git is not available', () => {
+        mockedExecSync.mockImplementation(() => {
+            throw new Error('git: command not found');
+        });
+        expect(isGitWorktree('/some/path')).toBe(false);
+    });
+});
+//# sourceMappingURL=git-utils.test.js.map

package/dist/core/__tests__/git-utils.test.js.map

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

package/dist/core/__tests__/mdx-validator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mdx-validator.test.d.ts.map

package/dist/core/__tests__/mdx-validator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-validator.test.d.ts","sourceRoot":"","sources":["../../../src/core/__tests__/mdx-validator.test.ts"],"names":[],"mappings":""}

package/dist/core/__tests__/mdx-validator.test.js

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+import { validateMarkdownForMdx, formatMdxValidationIssues } from '../mdx-validator.js';
+describe('mdx-validator', () => {
+    it('returns invalid when mdx pre-render (compile) fails', async () => {
+        const content = `# Metrics\n\n- Threshold: <5%\n`;
+        const result = await validateMarkdownForMdx(content);
+        expect(result.valid).toBe(false);
+        expect(result.issues.length).toBeGreaterThan(0);
+        expect(result.issues.some((issue) => issue.ruleId === 'mdx-compile-error')).toBe(true);
+        expect(result.issues[0].message).toContain('Unexpected character');
+    });
+    it('ignores less-than inside inline code and fenced code blocks', async () => {
+        const content = [
+            '# Safe',
+            '',
+            '- Inline code: `<5%`',
+            '',
+            '```md',
+            '- Code block: <5%',
+            '```',
+            ''
+        ].join('\n');
+        const result = await validateMarkdownForMdx(content);
+        expect(result.valid).toBe(true);
+        expect(result.issues).toHaveLength(0);
+    });
+    it('formats issues with line and column', () => {
+        const formatted = formatMdxValidationIssues([
+            {
+                line: 12,
+                column: 18,
+                ruleId: 'mdx-compile-error',
+                message: 'Unexpected character',
+                severity: 'error'
+            }
+        ]);
+        expect(formatted).toEqual([
+            'Line 12:18 [mdx-compile-error] Unexpected character'
+        ]);
+    });
+});
+//# sourceMappingURL=mdx-validator.test.js.map

package/dist/core/__tests__/mdx-validator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-validator.test.js","sourceRoot":"","sources":["../../../src/core/__tests__/mdx-validator.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAExF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,OAAO,GAAG,iCAAiC,CAAC;QAElD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAErD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,OAAO,GAAG;YACd,QAAQ;YACR,EAAE;YACF,sBAAsB;YACtB,EAAE;YACF,OAAO;YACP,mBAAmB;YACnB,KAAK;YACL,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAErD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,SAAS,GAAG,yBAAyB,CAAC;YAC1C;gBACE,IAAI,EAAE,EAAE;gBACR,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,mBAAmB;gBAC3B,OAAO,EAAE,sBAAsB;gBAC/B,QAAQ,EAAE,OAAO;aAClB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;YACxB,qDAAqD;SACtD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/__tests__/path-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=path-utils.test.d.ts.map

package/dist/core/__tests__/path-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.test.d.ts","sourceRoot":"","sources":["../../../src/core/__tests__/path-utils.test.ts"],"names":[],"mappings":""}