@blockspool/cli 0.4.1 → 0.4.3

package/dist/lib/run-state.js

@@ -0,0 +1,119 @@
+/**
+ * Persistent run state for cross-session cycle tracking.
+ *
+ * Stored in `.blockspool/run-state.json`. Tracks how many scout cycles
+ * have run so periodic tasks (like docs-audit) can trigger automatically.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const RUN_STATE_FILE = 'run-state.json';
+function statePath(repoRoot) {
+    return path.join(repoRoot, '.blockspool', RUN_STATE_FILE);
+}
+const DEFAULT_STATE = {
+    totalCycles: 0,
+    lastDocsAuditCycle: 0,
+    lastRunAt: 0,
+    deferredProposals: [],
+};
+/**
+ * Read the current run state from disk.
+ */
+export function readRunState(repoRoot) {
+    const fp = statePath(repoRoot);
+    if (!fs.existsSync(fp))
+        return { ...DEFAULT_STATE };
+    try {
+        const raw = fs.readFileSync(fp, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            totalCycles: parsed.totalCycles ?? 0,
+            lastDocsAuditCycle: parsed.lastDocsAuditCycle ?? 0,
+            lastRunAt: parsed.lastRunAt ?? 0,
+            deferredProposals: Array.isArray(parsed.deferredProposals) ? parsed.deferredProposals : [],
+        };
+    }
+    catch {
+        return { ...DEFAULT_STATE };
+    }
+}
+/**
+ * Write the run state to disk.
+ */
+export function writeRunState(repoRoot, state) {
+    const fp = statePath(repoRoot);
+    const dir = path.dirname(fp);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(fp, JSON.stringify(state, null, 2) + '\n');
+}
+/**
+ * Increment the cycle counter and return the new state.
+ */
+export function recordCycle(repoRoot) {
+    const state = readRunState(repoRoot);
+    state.totalCycles += 1;
+    state.lastRunAt = Date.now();
+    writeRunState(repoRoot, state);
+    return state;
+}
+/**
+ * Check if a docs-audit cycle is due.
+ * Returns true every N cycles since the last docs-audit.
+ */
+export function isDocsAuditDue(repoRoot, interval = 3) {
+    const state = readRunState(repoRoot);
+    return (state.totalCycles - state.lastDocsAuditCycle) >= interval;
+}
+/**
+ * Record that a docs-audit was run.
+ */
+export function recordDocsAudit(repoRoot) {
+    const state = readRunState(repoRoot);
+    state.lastDocsAuditCycle = state.totalCycles;
+    writeRunState(repoRoot, state);
+}
+/** Max age for deferred proposals (7 days) */
+const MAX_DEFERRED_AGE_MS = 7 * 24 * 60 * 60 * 1000;
+/**
+ * Defer a proposal for later when the scope matches.
+ */
+export function deferProposal(repoRoot, proposal) {
+    const state = readRunState(repoRoot);
+    // Avoid duplicates by title
+    if (state.deferredProposals.some(d => d.title === proposal.title))
+        return;
+    state.deferredProposals.push(proposal);
+    writeRunState(repoRoot, state);
+}
+/**
+ * Retrieve and remove deferred proposals that now match the given scope.
+ * Also prunes proposals older than 7 days.
+ */
+export function popDeferredForScope(repoRoot, scope) {
+    const state = readRunState(repoRoot);
+    const now = Date.now();
+    const normalizedScope = scope.replace(/\*\*$/, '').replace(/\*$/, '').replace(/\/$/, '');
+    const matched = [];
+    const remaining = [];
+    for (const dp of state.deferredProposals) {
+        // Prune stale
+        if (now - dp.deferredAt > MAX_DEFERRED_AGE_MS)
+            continue;
+        const files = dp.files.length > 0 ? dp.files : dp.allowed_paths;
+        const inScope = !normalizedScope || files.length === 0 || files.every(f => f.startsWith(normalizedScope) || f.startsWith(normalizedScope + '/'));
+        if (inScope) {
+            matched.push(dp);
+        }
+        else {
+            remaining.push(dp);
+        }
+    }
+    if (matched.length > 0 || remaining.length !== state.deferredProposals.length) {
+        state.deferredProposals = remaining;
+        writeRunState(repoRoot, state);
+    }
+    return matched;
+}
+//# sourceMappingURL=run-state.js.map

package/dist/lib/run-state.js.map

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

package/dist/lib/scope.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Scope enforcement utilities
+ *
+ * Validates that file changes stay within ticket's allowed paths
+ * and don't touch forbidden paths.
+ */
+/**
+ * Scope violation result
+ */
+export interface ScopeViolation {
+    file: string;
+    violation: 'not_in_allowed' | 'in_forbidden';
+    pattern?: string;
+}
+/**
+ * Normalize a file path by:
+ * - Removing leading ./
+ * - Collapsing multiple slashes (//)
+ * - Removing trailing slashes (except for root)
+ *
+ * @param filePath - The file path to normalize
+ * @returns Normalized path
+ */
+export declare function normalizePath(filePath: string): string;
+/**
+ * Detect if a path appears to be hallucinated by Claude.
+ * Common hallucination patterns include repeated path segments like 'foo/foo/'.
+ *
+ * @param filePath - The file path to check
+ * @returns Object with isHallucinated flag and optional reason
+ */
+export declare function detectHallucinatedPath(filePath: string): {
+    isHallucinated: boolean;
+    reason?: string;
+};
+/**
+ * Check if changed files violate ticket scope constraints
+ *
+ * @param changedFiles - List of file paths that were modified
+ * @param allowedPaths - Glob patterns for allowed paths (empty = all allowed)
+ * @param forbiddenPaths - Glob patterns for forbidden paths
+ * @returns List of violations, empty if all files are within scope
+ */
+export declare function checkScopeViolations(changedFiles: string[], allowedPaths: string[], forbiddenPaths: string[]): ScopeViolation[];
+/**
+ * Simple glob-style pattern matching
+ * Supports: * (any chars), ** (any path segments), ? (single char)
+ *
+ * @param filePath - The file path to check
+ * @param pattern - Glob pattern to match against
+ * @returns true if the file matches the pattern
+ */
+export declare function matchesPattern(filePath: string, pattern: string): boolean;
+/**
+ * Result of analyzing scope violations for auto-expansion
+ */
+export interface ScopeExpansionResult {
+    /** Whether the paths can be expanded to fix violations */
+    canExpand: boolean;
+    /** New allowed paths after expansion */
+    expandedPaths: string[];
+    /** Files that were added to allowed paths */
+    addedPaths: string[];
+    /** Reason if expansion is not possible */
+    reason?: string;
+}
+/**
+ * Analyze scope violations and determine if paths can be auto-expanded.
+ *
+ * This enables "organic" handling of blocked tickets by automatically
+ * expanding allowed_paths for reasonable related files:
+ * - Same directory (sibling files)
+ * - Test files for source files
+ * - Type definition files (.d.ts)
+ * - Index files
+ *
+ * Will NOT expand for:
+ * - Hallucinated paths
+ * - Forbidden path violations
+ * - Files in completely unrelated directories
+ *
+ * @param violations - List of scope violations from checkScopeViolations
+ * @param currentAllowedPaths - Current allowed_paths for the ticket
+ * @param maxExpansions - Maximum number of paths to add (default: 10)
+ * @returns Expansion result with new paths or reason for rejection
+ */
+export declare function analyzeViolationsForExpansion(violations: ScopeViolation[], currentAllowedPaths: string[], maxExpansions?: number): ScopeExpansionResult;
+/**
+ * Parse git status --porcelain output to get changed file paths
+ *
+ * @param statusOutput - Output from `git status --porcelain`
+ * @returns List of file paths that were changed
+ */
+export declare function parseChangedFiles(statusOutput: string): string[];
+//# sourceMappingURL=scope.d.ts.map

package/dist/lib/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/lib/scope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,gBAAgB,GAAG,cAAc,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACxD,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAwBA;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,MAAM,EAAE,EACtB,cAAc,EAAE,MAAM,EAAE,GACvB,cAAc,EAAE,CAkDlB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAyBzE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,cAAc,EAAE,EAC5B,mBAAmB,EAAE,MAAM,EAAE,EAC7B,aAAa,GAAE,MAAW,GACzB,oBAAoB,CAyItB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAehE"}

package/dist/lib/scope.js

@@ -0,0 +1,291 @@
+/**
+ * Scope enforcement utilities
+ *
+ * Validates that file changes stay within ticket's allowed paths
+ * and don't touch forbidden paths.
+ */
+/**
+ * Normalize a file path by:
+ * - Removing leading ./
+ * - Collapsing multiple slashes (//)
+ * - Removing trailing slashes (except for root)
+ *
+ * @param filePath - The file path to normalize
+ * @returns Normalized path
+ */
+export function normalizePath(filePath) {
+    return filePath
+        .replace(/\\/g, '/') // Normalize backslashes
+        .replace(/^\.\//, '') // Remove leading ./
+        .replace(/\/+/g, '/') // Collapse multiple slashes
+        .replace(/\/$/, ''); // Remove trailing slash
+}
+/**
+ * Detect if a path appears to be hallucinated by Claude.
+ * Common hallucination patterns include repeated path segments like 'foo/foo/'.
+ *
+ * @param filePath - The file path to check
+ * @returns Object with isHallucinated flag and optional reason
+ */
+export function detectHallucinatedPath(filePath) {
+    const normalized = normalizePath(filePath);
+    const segments = normalized.split('/').filter(s => s.length > 0);
+    // Check for repeated consecutive segments (e.g., 'cloud/cloud/', 'src/src/')
+    for (let i = 0; i < segments.length - 1; i++) {
+        if (segments[i] === segments[i + 1] && segments[i].length > 0) {
+            return {
+                isHallucinated: true,
+                reason: `Repeated path segment: '${segments[i]}/${segments[i]}'`,
+            };
+        }
+    }
+    // Check for obviously malformed patterns
+    if (/\/\//.test(filePath)) {
+        // Double slashes in original (before normalization)
+        return {
+            isHallucinated: true,
+            reason: 'Contains double slashes',
+        };
+    }
+    return { isHallucinated: false };
+}
+/**
+ * Check if changed files violate ticket scope constraints
+ *
+ * @param changedFiles - List of file paths that were modified
+ * @param allowedPaths - Glob patterns for allowed paths (empty = all allowed)
+ * @param forbiddenPaths - Glob patterns for forbidden paths
+ * @returns List of violations, empty if all files are within scope
+ */
+export function checkScopeViolations(changedFiles, allowedPaths, forbiddenPaths) {
+    const violations = [];
+    for (const file of changedFiles) {
+        // Check for hallucinated paths first
+        const hallucinationCheck = detectHallucinatedPath(file);
+        if (hallucinationCheck.isHallucinated) {
+            console.warn(`[scope] Warning: Detected hallucinated path '${file}': ${hallucinationCheck.reason}`);
+            // Report hallucinated paths as not_in_allowed since they are invalid
+            violations.push({
+                file,
+                violation: 'not_in_allowed',
+                pattern: `hallucinated: ${hallucinationCheck.reason}`,
+            });
+            continue; // Skip further checks for hallucinated paths
+        }
+        // Normalize the path for consistent matching
+        const normalizedFile = normalizePath(file);
+        // Check forbidden paths first (higher priority)
+        for (const pattern of forbiddenPaths) {
+            if (matchesPattern(normalizedFile, pattern)) {
+                violations.push({ file, violation: 'in_forbidden', pattern });
+                break; // Don't check allowed if forbidden
+            }
+        }
+        // If no forbidden match and allowed_paths is specified, check allowed
+        if (allowedPaths.length > 0 && !violations.some(v => v.file === file)) {
+            let isAllowed = allowedPaths.some(pattern => matchesPattern(normalizedFile, pattern));
+            // For directory entries (git shows new dirs with trailing /),
+            // check if any allowed path is under this directory
+            if (!isAllowed && file.endsWith('/')) {
+                const dirPrefix = normalizedFile + '/';
+                isAllowed = allowedPaths.some(pattern => pattern.startsWith(dirPrefix));
+            }
+            if (!isAllowed) {
+                violations.push({ file, violation: 'not_in_allowed' });
+            }
+        }
+    }
+    return violations;
+}
+/**
+ * Simple glob-style pattern matching
+ * Supports: * (any chars), ** (any path segments), ? (single char)
+ *
+ * @param filePath - The file path to check
+ * @param pattern - Glob pattern to match against
+ * @returns true if the file matches the pattern
+ */
+export function matchesPattern(filePath, pattern) {
+    // Normalize paths
+    const normalizedFile = filePath.replace(/\\/g, '/');
+    const normalizedPattern = pattern.replace(/\\/g, '/');
+    // Convert glob to regex
+    // Step 1: Replace glob patterns with placeholders
+    let regexPattern = normalizedPattern
+        .replace(/\*\*\//g, '<<<GLOBSTAR_SLASH>>>') // **/ matches zero or more directories
+        .replace(/\*\*/g, '<<<GLOBSTAR>>>') // ** at end matches anything
+        .replace(/\*/g, '<<<STAR>>>') // * matches anything except /
+        .replace(/\?/g, '<<<QUESTION>>>'); // ? matches single char
+    // Step 2: Escape special regex chars (but not our placeholders)
+    regexPattern = regexPattern.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    // Step 3: Replace placeholders with regex patterns
+    regexPattern = regexPattern
+        .replace(/<<<GLOBSTAR_SLASH>>>/g, '(?:.*/)?') // **/ = zero or more dirs
+        .replace(/<<<GLOBSTAR>>>/g, '.*') // ** = anything
+        .replace(/<<<STAR>>>/g, '[^/]*') // * = anything except /
+        .replace(/<<<QUESTION>>>/g, '[^/]'); // ? = single char except /
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(normalizedFile);
+}
+/**
+ * Analyze scope violations and determine if paths can be auto-expanded.
+ *
+ * This enables "organic" handling of blocked tickets by automatically
+ * expanding allowed_paths for reasonable related files:
+ * - Same directory (sibling files)
+ * - Test files for source files
+ * - Type definition files (.d.ts)
+ * - Index files
+ *
+ * Will NOT expand for:
+ * - Hallucinated paths
+ * - Forbidden path violations
+ * - Files in completely unrelated directories
+ *
+ * @param violations - List of scope violations from checkScopeViolations
+ * @param currentAllowedPaths - Current allowed_paths for the ticket
+ * @param maxExpansions - Maximum number of paths to add (default: 10)
+ * @returns Expansion result with new paths or reason for rejection
+ */
+export function analyzeViolationsForExpansion(violations, currentAllowedPaths, maxExpansions = 10) {
+    // Check for forbidden violations - these cannot be expanded
+    const forbiddenViolations = violations.filter(v => v.violation === 'in_forbidden');
+    if (forbiddenViolations.length > 0) {
+        return {
+            canExpand: false,
+            expandedPaths: currentAllowedPaths,
+            addedPaths: [],
+            reason: `Cannot expand: ${forbiddenViolations.length} file(s) match forbidden paths`,
+        };
+    }
+    // Check for hallucinated paths - these cannot be expanded
+    const hallucinatedViolations = violations.filter(v => v.pattern?.startsWith('hallucinated:'));
+    if (hallucinatedViolations.length > 0) {
+        return {
+            canExpand: false,
+            expandedPaths: currentAllowedPaths,
+            addedPaths: [],
+            reason: `Cannot expand: ${hallucinatedViolations.length} hallucinated path(s) detected`,
+        };
+    }
+    // Get the "allowed" directories from current paths
+    const allowedDirs = new Set();
+    for (const path of currentAllowedPaths) {
+        const normalized = normalizePath(path);
+        const lastSlash = normalized.lastIndexOf('/');
+        if (lastSlash > 0) {
+            allowedDirs.add(normalized.slice(0, lastSlash));
+        }
+    }
+    // Analyze each violation and check if it's a "reasonable" expansion
+    const pathsToAdd = [];
+    const notAllowedViolations = violations.filter(v => v.violation === 'not_in_allowed');
+    for (const violation of notAllowedViolations) {
+        const normalizedFile = normalizePath(violation.file);
+        const lastSlash = normalizedFile.lastIndexOf('/');
+        const fileDir = lastSlash > 0 ? normalizedFile.slice(0, lastSlash) : '';
+        const fileName = lastSlash > 0 ? normalizedFile.slice(lastSlash + 1) : normalizedFile;
+        // Check if file is in a directory we already allow (sibling file)
+        const isSiblingFile = allowedDirs.has(fileDir);
+        // Check if file is a related type (types file, test file, index file)
+        const isRelatedFile = fileName.endsWith('.d.ts') ||
+            fileName.includes('.test.') ||
+            fileName.includes('.spec.') ||
+            fileName === 'index.ts' ||
+            fileName === 'index.tsx' ||
+            fileName === 'index.js' ||
+            fileName === 'types.ts' ||
+            fileName === 'types.tsx';
+        // Check if file is in an allowed subdirectory
+        const isSubdirectory = [...allowedDirs].some(dir => fileDir.startsWith(dir + '/'));
+        // Check if file is a root-level config (vitest.config.ts, tsconfig.json, etc.)
+        const isRootConfig = !fileDir && /^(vitest|vite|jest|tsconfig|eslint|prettier|babel|rollup|webpack|next|tailwind)\b/.test(fileName);
+        if (isSiblingFile || isRelatedFile || isSubdirectory || isRootConfig) {
+            pathsToAdd.push(normalizedFile);
+        }
+    }
+    // Second pass: if some violations remain, check if they share a common
+    // top-level module with the allowed paths (e.g. both under src/api/).
+    // This handles legitimate cross-directory refactors like renames.
+    if (pathsToAdd.length < notAllowedViolations.length) {
+        const allowedTopDirs = new Set();
+        for (const dir of allowedDirs) {
+            const parts = dir.split('/');
+            // Add the root directory (e.g. "src" from "src/lib/utils")
+            if (parts.length >= 1) {
+                allowedTopDirs.add(parts[0]);
+            }
+            // Also add first two segments as the "module" (e.g. "src/lib")
+            if (parts.length >= 2) {
+                allowedTopDirs.add(parts.slice(0, 2).join('/'));
+            }
+        }
+        // Cross-package awareness: if any packages/*/src path is allowed,
+        // treat other packages/*/src paths as related (monorepo siblings)
+        const hasPackagesDir = [...allowedDirs].some(d => d.startsWith('packages/'));
+        if (hasPackagesDir) {
+            allowedTopDirs.add('packages');
+        }
+        for (const violation of notAllowedViolations) {
+            const normalizedFile = normalizePath(violation.file);
+            if (pathsToAdd.includes(normalizedFile))
+                continue;
+            const fileParts = normalizedFile.split('/');
+            const fileTopDir = fileParts.length >= 2
+                ? fileParts.slice(0, 2).join('/')
+                : fileParts[0];
+            if (allowedTopDirs.has(fileTopDir) || allowedTopDirs.has(fileParts[0])) {
+                pathsToAdd.push(normalizedFile);
+            }
+        }
+    }
+    // Check if we have too many expansions
+    if (pathsToAdd.length === 0) {
+        return {
+            canExpand: false,
+            expandedPaths: currentAllowedPaths,
+            addedPaths: [],
+            reason: `Cannot expand: ${notAllowedViolations.length} file(s) in unrelated directories`,
+        };
+    }
+    if (pathsToAdd.length > maxExpansions) {
+        return {
+            canExpand: false,
+            expandedPaths: currentAllowedPaths,
+            addedPaths: [],
+            reason: `Cannot expand: ${pathsToAdd.length} files need expansion (max: ${maxExpansions})`,
+        };
+    }
+    // Merge new paths with existing
+    const expandedPaths = [...currentAllowedPaths, ...pathsToAdd];
+    const uniquePaths = [...new Set(expandedPaths)];
+    return {
+        canExpand: true,
+        expandedPaths: uniquePaths,
+        addedPaths: pathsToAdd,
+    };
+}
+/**
+ * Parse git status --porcelain output to get changed file paths
+ *
+ * @param statusOutput - Output from `git status --porcelain`
+ * @returns List of file paths that were changed
+ */
+export function parseChangedFiles(statusOutput) {
+    if (!statusOutput.trim())
+        return [];
+    return statusOutput
+        .split('\n')
+        .filter(line => line.trim())
+        .map(line => {
+        // Format: XY filename or XY original -> renamed
+        // eslint-disable-next-line security/detect-unsafe-regex
+        const match = line.match(/^..\s+(.+?)(?:\s+->\s+(.+))?$/);
+        if (!match)
+            return null;
+        // Return the destination for renames, otherwise the filename
+        return match[2] || match[1];
+    })
+        .filter((f) => f !== null);
+}
+//# sourceMappingURL=scope.js.map

package/dist/lib/scope.js.map

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

package/dist/lib/selection.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Selection parser for user input
+ *
+ * Parses selection strings like:
+ * - "1"       → [0]
+ * - "1,3,5"   → [0, 2, 4]
+ * - "1-3"     → [0, 1, 2]
+ * - "1-3,5,7" → [0, 1, 2, 4, 6]
+ * - "all"     → all indices
+ *
+ * Note: User input is 1-indexed, output is 0-indexed.
+ */
+/**
+ * Parse a selection string into 0-indexed array indices
+ *
+ * @param input - Selection string (e.g., "1-3,5,7" or "all")
+ * @param maxIndex - Maximum valid index (0-indexed, exclusive)
+ * @returns Array of 0-indexed indices, sorted and deduplicated
+ * @throws Error for invalid input
+ */
+export declare function parseSelection(input: string, maxIndex: number): number[];
+/**
+ * Validate a selection string without parsing
+ *
+ * @returns true if valid, false otherwise
+ */
+export declare function isValidSelection(input: string, maxIndex: number): boolean;
+/**
+ * Format a selection for display (1-indexed)
+ *
+ * @param indices - 0-indexed array indices
+ * @returns Human-readable string like "1, 2, 3" or "1-3"
+ */
+export declare function formatSelection(indices: number[]): string;
+//# sourceMappingURL=selection.d.ts.map

package/dist/lib/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/lib/selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAoDxE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOzE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CA0BzD"}