@thegetty/quire-cli 1.0.0-rc.45 → 1.0.0-rc.46

package/src/helpers/pager.test.js

@@ -1,85 +0,0 @@
-import sinon from 'sinon'
-import test from 'ava'
-
-/**
- * Pager Helper Tests
- */
-
-test.beforeEach((t) => {
-  t.context.sandbox = sinon.createSandbox()
-})
-
-test.afterEach.always((t) => {
-  t.context.sandbox.restore()
-})
-
-test.serial('outputWithPaging() writes directly when not a TTY', async (t) => {
-  const { sandbox } = t.context
-  const originalIsTTY = process.stdout.isTTY
-  const stdoutWrite = sandbox.stub(process.stdout, 'write')
-
-  try {
-    // Simulate non-TTY (piped output)
-    Object.defineProperty(process.stdout, 'isTTY', { value: false, configurable: true })
-
-    const { outputWithPaging } = await import('./pager.js')
-    await outputWithPaging('Short content')
-
-    t.true(stdoutWrite.calledWith('Short content\n'))
-  } finally {
-    Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, configurable: true })
-  }
-})
-
-test.serial('outputWithPaging() writes directly when content is short', async (t) => {
-  const { sandbox } = t.context
-  const originalIsTTY = process.stdout.isTTY
-  const originalRows = process.stdout.rows
-  const stdoutWrite = sandbox.stub(process.stdout, 'write')
-
-  try {
-    // Simulate TTY with 24 rows
-    Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true })
-    Object.defineProperty(process.stdout, 'rows', { value: 24, configurable: true })
-
-    const { outputWithPaging } = await import('./pager.js')
-    await outputWithPaging('Line 1\nLine 2\nLine 3')
-
-    t.true(stdoutWrite.calledWith('Line 1\nLine 2\nLine 3\n'))
-  } finally {
-    Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, configurable: true })
-    Object.defineProperty(process.stdout, 'rows', { value: originalRows, configurable: true })
-  }
-})
-
-test.serial('outputWithPaging() writes directly when NO_PAGER is set', async (t) => {
-  const { sandbox } = t.context
-  const originalIsTTY = process.stdout.isTTY
-  const originalRows = process.stdout.rows
-  const originalNoPager = process.env.NO_PAGER
-  const stdoutWrite = sandbox.stub(process.stdout, 'write')
-
-  try {
-    // Simulate TTY with small terminal (would normally trigger pager)
-    Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true })
-    Object.defineProperty(process.stdout, 'rows', { value: 5, configurable: true })
-    process.env.NO_PAGER = '1'
-
-    const { outputWithPaging } = await import('./pager.js')
-
-    // Content longer than terminal height
-    const longContent = Array.from({ length: 20 }, (_, i) => `Line ${i + 1}`).join('\n')
-    await outputWithPaging(longContent)
-
-    // Should write directly despite long content, because pager is disabled
-    t.true(stdoutWrite.calledWith(longContent + '\n'))
-  } finally {
-    Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, configurable: true })
-    Object.defineProperty(process.stdout, 'rows', { value: originalRows, configurable: true })
-    if (originalNoPager === undefined) {
-      delete process.env.NO_PAGER
-    } else {
-      process.env.NO_PAGER = originalNoPager
-    }
-  }
-})

package/src/helpers/suggest-similar.js

@@ -1,124 +0,0 @@
-/**
- * Fuzzy string matching for CLI suggestions
- *
- * Uses Damerau-Levenshtein distance (optimal string alignment variant)
- * to find close matches for misspelled user input. The algorithm and
- * parameters match Commander.js's built-in suggestion implementation
- * for consistency.
- *
- * @module helpers/suggest-similar
- */
-
-const MAX_DISTANCE = 3
-const MIN_SIMILARITY = 0.4
-
-/**
- * Calculate Damerau-Levenshtein distance between two strings
- *
- * Supports insertions, deletions, substitutions, and transpositions
- * of adjacent characters. Each substring is edited at most once
- * (optimal string alignment variant).
- *
- * @param {string} a - First string
- * @param {string} b - Second string
- * @returns {number} Edit distance
- * @private
- */
-function editDistance(a, b) {
-  if (Math.abs(a.length - b.length) > MAX_DISTANCE) {
-    return Math.max(a.length, b.length)
-  }
-
-  const d = []
-
-  for (let i = 0; i <= a.length; ++i) d[i] = [i]
-  for (let j = 0; j <= b.length; ++j) d[0][j] = j
-
-  for (let j = 1; j <= b.length; ++j) {
-    for (let i = 1; i <= a.length; ++i) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1
-      d[i][j] = Math.min(
-        d[i - 1][j] + 1,        // deletion
-        d[i][j - 1] + 1,        // insertion
-        d[i - 1][j - 1] + cost, // substitution
-      )
-      // transposition
-      if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
-        d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1)
-      }
-    }
-  }
-
-  return d[a.length][b.length]
-}
-
-/**
- * Find similar strings from a list of candidates
- *
- * Returns the closest matches by edit distance, filtered by a minimum
- * similarity threshold (40%). Only returns matches at the best distance
- * found (does not mix distances).
- *
- * @param {string} word - The misspelled input
- * @param {string[]} candidates - Valid values to match against
- * @returns {string[]} Sorted array of best matches (empty if none close enough)
- *
- * @example
- * suggestSimilar('gt', ['get', 'set', 'delete', 'reset', 'path'])
- * // → ['get']
- *
- * @example
- * suggestSimilar('logLeve', ['logLevel', 'logPrefix', 'verbose'])
- * // → ['logLevel']
- */
-export function suggestSimilar(word, candidates) {
-  if (!word || !candidates?.length) return []
-
-  const unique = [...new Set(candidates)]
-  let similar = []
-  let bestDistance = MAX_DISTANCE
-
-  for (const candidate of unique) {
-    if (candidate.length <= 1) continue
-
-    const distance = editDistance(word, candidate)
-    const length = Math.max(word.length, candidate.length)
-    const similarity = (length - distance) / length
-
-    if (similarity > MIN_SIMILARITY) {
-      if (distance < bestDistance) {
-        bestDistance = distance
-        similar = [candidate]
-      } else if (distance === bestDistance) {
-        similar.push(candidate)
-      }
-    }
-  }
-
-  return similar.sort((a, b) => a.localeCompare(b))
-}
-
-/**
- * Format suggestion matches into a user-facing string
- *
- * @param {string[]} matches - Array of suggested matches
- * @returns {string|undefined} Formatted suggestion or undefined if no matches
- *
- * @example
- * formatSuggestion(['logLevel'])
- * // → 'Did you mean: logLevel?'
- *
- * @example
- * formatSuggestion(['get', 'set'])
- * // → 'Did you mean one of: get, set?'
- *
- * @example
- * formatSuggestion([])
- * // → undefined
- */
-export function formatSuggestion(matches) {
-  if (!matches?.length) return undefined
-  return (matches.length === 1)
-    ? `Did you mean: ${matches[0]}?`
-    : `Did you mean one of: ${matches.join(', ')}?`
-}

package/src/helpers/suggest-similar.test.js

@@ -1,108 +0,0 @@
-import test from 'ava'
-import { suggestSimilar, formatSuggestion } from './suggest-similar.js'
-
-// ─────────────────────────────────────────────────────────────────────────────
-// suggestSimilar
-// ─────────────────────────────────────────────────────────────────────────────
-
-test('suggestSimilar returns match for single-character deletion', (t) => {
-  const result = suggestSimilar('gt', ['get', 'set', 'delete', 'reset', 'path'])
-  t.deepEqual(result, ['get'])
-})
-
-test('suggestSimilar returns match for single-character insertion', (t) => {
-  const result = suggestSimilar('geet', ['get', 'set', 'delete'])
-  t.deepEqual(result, ['get'])
-})
-
-test('suggestSimilar returns match for single-character substitution', (t) => {
-  const result = suggestSimilar('gat', ['get', 'set', 'delete'])
-  t.deepEqual(result, ['get'])
-})
-
-test('suggestSimilar returns match for transposition', (t) => {
-  const result = suggestSimilar('gte', ['get', 'set', 'delete'])
-  t.deepEqual(result, ['get'])
-})
-
-test('suggestSimilar returns match for camelCase near-miss', (t) => {
-  const result = suggestSimilar('logLeve', ['logLevel', 'logPrefix', 'verbose'])
-  t.deepEqual(result, ['logLevel'])
-})
-
-test('suggestSimilar returns match for case difference', (t) => {
-  // 'loglevel' vs 'logLevel' differs by one character (L vs l)
-  const result = suggestSimilar('loglevel', ['logLevel', 'logPrefix', 'verbose'])
-  t.deepEqual(result, ['logLevel'])
-})
-
-test('suggestSimilar returns empty array when no candidates are similar', (t) => {
-  const result = suggestSimilar('xyzabc', ['get', 'set', 'delete', 'reset', 'path'])
-  t.deepEqual(result, [])
-})
-
-test('suggestSimilar returns empty array for empty input', (t) => {
-  t.deepEqual(suggestSimilar('', ['get', 'set']), [])
-})
-
-test('suggestSimilar returns empty array for null input', (t) => {
-  t.deepEqual(suggestSimilar(null, ['get', 'set']), [])
-})
-
-test('suggestSimilar returns empty array for empty candidates', (t) => {
-  t.deepEqual(suggestSimilar('get', []), [])
-})
-
-test('suggestSimilar returns empty array for null candidates', (t) => {
-  t.deepEqual(suggestSimilar('get', null), [])
-})
-
-test('suggestSimilar excludes single-character candidates', (t) => {
-  // 'g' is distance 0 from 'g', but should be excluded
-  const result = suggestSimilar('g', ['g', 'get', 'set'])
-  t.deepEqual(result, [])
-})
-
-test('suggestSimilar deduplicates candidates', (t) => {
-  const result = suggestSimilar('gt', ['get', 'get', 'get'])
-  t.deepEqual(result, ['get'])
-})
-
-test('suggestSimilar returns multiple matches sorted alphabetically', (t) => {
-  // 'bild' is distance 1 from 'bind' and 'build' — both should match
-  // but 'build' is distance 1 (deletion), 'bind' is distance 2 (substitution + deletion)
-  // Let's use a case where two candidates have equal distance
-  const result = suggestSimilar('delet', ['delete', 'reset'])
-  // 'delet' → 'delete' distance 1, 'delet' → 'reset' distance 2
-  t.deepEqual(result, ['delete'])
-})
-
-test('suggestSimilar returns multiple equally-close matches', (t) => {
-  // Both 'bar' and 'baz' are distance 1 from 'bax'
-  const result = suggestSimilar('bax', ['bar', 'baz', 'foo'])
-  t.deepEqual(result, ['bar', 'baz'])
-})
-
-// ─────────────────────────────────────────────────────────────────────────────
-// formatSuggestion
-// ─────────────────────────────────────────────────────────────────────────────
-
-test('formatSuggestion returns undefined for empty array', (t) => {
-  t.is(formatSuggestion([]), undefined)
-})
-
-test('formatSuggestion returns undefined for null', (t) => {
-  t.is(formatSuggestion(null), undefined)
-})
-
-test('formatSuggestion returns undefined for undefined', (t) => {
-  t.is(formatSuggestion(undefined), undefined)
-})
-
-test('formatSuggestion formats single match', (t) => {
-  t.is(formatSuggestion(['logLevel']), 'Did you mean: logLevel?')
-})
-
-test('formatSuggestion formats multiple matches', (t) => {
-  t.is(formatSuggestion(['bar', 'baz']), 'Did you mean one of: bar, baz?')
-})

package/src/helpers/test-cwd.test.js

@@ -1,192 +0,0 @@
-import test from 'ava'
-import { Volume, createFsFromVolume } from 'memfs'
-import sinon from 'sinon'
-import esmock from 'esmock'
-import { NotInProjectError } from '#src/errors/index.js'
-
-test.beforeEach((t) => {
-  // Create in-memory file system
-  t.context.vol = new Volume()
-  t.context.fs = createFsFromVolume(t.context.vol)
-})
-
-test.afterEach.always((t) => {
-  // Restore all mocks if sandbox exists
-  if (t.context.sandbox) {
-    t.context.sandbox.restore()
-  }
-
-  // Clear in-memory file system
-  t.context.vol.reset()
-})
-
-test.serial('testcwd should not error when called in a Quire project directory', async (t) => {
-  const { fs, vol } = t.context
-
-  // Create sandbox for this test
-  const sandbox = sinon.createSandbox()
-  t.context.sandbox = sandbox
-
-  // Setup a Quire project directory with .eleventy.js
-  vol.fromJSON({
-    '/quire-project/.eleventy.js': 'module.exports = function() {}',
-    '/quire-project/content/_data/config.yaml': 'title: Test Project',
-    '/quire-project/package.json': JSON.stringify({ name: 'test-project' })
-  })
-
-  // Create stubs
-  const cwdStub = sandbox.stub(process, 'cwd').returns('/quire-project')
-
-  // Create mock process object with stubbed methods
-  const mockProcess = {
-    cwd: cwdStub
-  }
-
-  // Mock detect module with memfs
-  const mockDetect = await esmock('../lib/project/detect.js', {
-    'node:fs': fs
-  })
-
-  // Mock node:fs and node:process to use memfs and stubbed process
-  const testcwd = await esmock('./test-cwd.js', {
-    'node:process': mockProcess,
-    '#lib/project/index.js': {
-      detect: mockDetect
-    }
-  })
-
-  // Create mock command
-  const mockCommand = {
-    name: sandbox.stub().returns('build')
-  }
-
-  // Call testcwd - should not throw
-  t.notThrows(() => testcwd(mockCommand))
-})
-
-test.serial('testcwd should throw NotInProjectError when called outside a Quire project directory', async (t) => {
-  const { fs, vol } = t.context
-
-  // Create sandbox for this test
-  const sandbox = sinon.createSandbox()
-  t.context.sandbox = sandbox
-
-  // Setup a non-Quire directory (no .eleventy.js or other Quire marker files)
-  vol.fromJSON({
-    '/not-quire/some-file.txt': 'not a quire project',
-    '/not-quire/package.json': JSON.stringify({ name: 'not-a-quire-project' })
-  })
-
-  // Create stubs
-  const cwdStub = sandbox.stub(process, 'cwd').returns('/not-quire')
-
-  // Create mock process object with stubbed methods
-  const mockProcess = {
-    cwd: cwdStub
-  }
-
-  // Mock detect module with memfs
-  const mockDetect = await esmock('../lib/project/detect.js', {
-    'node:fs': fs
-  })
-
-  // Mock node:fs and node:process to use memfs and stubbed process
-  const testcwd = await esmock('./test-cwd.js', {
-    'node:process': mockProcess,
-    '#lib/project/index.js': {
-      detect: mockDetect
-    }
-  })
-
-  // Create mock command
-  const mockCommand = {
-    name: sandbox.stub().returns('build')
-  }
-
-  // Call testcwd - should throw NotInProjectError
-  const error = t.throws(() => testcwd(mockCommand), { instanceOf: NotInProjectError })
-  t.is(error.code, 'NOT_IN_PROJECT')
-  t.is(error.exitCode, 2)
-  t.true(error.message.includes('build'))
-})
-
-test.serial('testcwd should include command name in error message', async (t) => {
-  const { fs, vol } = t.context
-
-  // Create sandbox for this test
-  const sandbox = sinon.createSandbox()
-  t.context.sandbox = sandbox
-
-  // Setup a non-Quire directory
-  vol.fromJSON({
-    '/non-quire-directory/file.txt': 'test'
-  })
-
-  // Create stubs
-  const cwdStub = sandbox.stub(process, 'cwd').returns('/non-quire-directory')
-
-  // Create mock process object with stubbed methods
-  const mockProcess = {
-    cwd: cwdStub
-  }
-
-  // Mock detect module with memfs
-  const mockDetect = await esmock('../lib/project/detect.js', {
-    'node:fs': fs
-  })
-
-  // Mock node:fs and node:process to use memfs and stubbed process
-  const testcwd = await esmock('./test-cwd.js', {
-    'node:process': mockProcess,
-    '#lib/project/index.js': {
-      detect: mockDetect
-    }
-  })
-
-  // Create mock command with specific name
-  const mockCommand = {
-    name: sandbox.stub().returns('clean')
-  }
-
-  // Call testcwd - should throw with command name in message
-  const error = t.throws(() => testcwd(mockCommand), { instanceOf: NotInProjectError })
-  t.true(error.message.includes('clean'), 'error message should include command name')
-})
-
-test.serial('testcwd should work when command is null', async (t) => {
-  const { fs, vol } = t.context
-
-  // Create sandbox for this test
-  const sandbox = sinon.createSandbox()
-  t.context.sandbox = sandbox
-
-  // Setup a non-Quire directory
-  vol.fromJSON({
-    '/not-a-quire-directory/file.txt': 'test'
-  })
-
-  // Create stubs
-  const cwdStub = sandbox.stub(process, 'cwd').returns('/not-a-quire-directory')
-
-  // Create mock process object with stubbed methods
-  const mockProcess = {
-    cwd: cwdStub
-  }
-
-  // Mock detect module with memfs
-  const mockDetect = await esmock('../lib/project/detect.js', {
-    'node:fs': fs
-  })
-
-  // Mock node:fs and node:process to use memfs and stubbed process
-  const testcwd = await esmock('./test-cwd.js', {
-    'node:process': mockProcess,
-    '#lib/project/index.js': {
-      detect: mockDetect
-    }
-  })
-
-  // Call testcwd with null command - should throw but not crash
-  const error = t.throws(() => testcwd(null), { instanceOf: NotInProjectError })
-  t.is(error.exitCode, 2)
-})