@thegetty/quire-cli 1.0.0-rc.42 → 1.0.0-rc.44

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@thegetty/quire-cli",
   "description": "Quire command-line interface",
-  "version": "1.0.0-rc.42",
+  "version": "1.0.0-rc.44",
   "author": "Getty Digital",
   "license": "SEE LICENSE IN https://github.com/thegetty/quire/blob/main/LICENSE",
   "bugs": {
@@ -74,7 +74,7 @@
     "marked-terminal": "^7.3.0",
     "node-fetch": "^3.3.2",
     "open": "^8.4.0",
-    "ora": "^6.1.2",
+    "ora": "^9.1.0",
     "pagedjs-cli": "^0.4.3",
     "pdf-lib": "^1.17.1",
     "read-package-up": "^11.0.0",

package/src/lib/11ty/api.js

@@ -44,13 +44,27 @@ const debug = createDebug('lib:11ty:api')
  * These must be set before the Eleventy instance is created and the
  * `.eleventy.js` configuration file is parsed.
  *
+ * Sets QUIRE_LOG_LEVEL to control output from multiple systems:
+ *   - quire-11ty chalk logger (_lib/chalk) — reads env var as level ceiling
+ *   - Vite bundler (_plugins/vite) — maps env var to Vite's logLevel option
+ *   - Directory output plugin (.eleventy.js) — conditionally registered
+ *
+ * CLI flag mapping:
+ *   (default)   → 'warn'   — spinner + warn/error only
+ *   --verbose   → 'info'   — adds chalk info output, directory listing, Vite info
+ *   --debug     → 'debug'  — adds chalk debug output, Eleventy DEBUG traces
+ *   --quiet     → 'silent' — suppresses all chalk/Vite/directory output
+ *
  * @see https://github.com/11ty/eleventy/issues/2655
+ * @see packages/cli/docs/cli-output-modes.md
  *
  * @param {Object} options
  * @param {'production'|'development'} options.mode - Build mode
  * @param {boolean} options.debug - Enable Eleventy debug output
+ * @param {boolean} options.verbose - Enable verbose output
+ * @param {boolean} options.quiet - Suppress output
  */
-const configureEleventyEnv = ({ mode = 'production', debug = false } = {}) => {
+const configureEleventyEnv = ({ mode = 'production', debug = false, verbose = false, quiet = false } = {}) => {
   // Path configuration for decoupling quire-11ty from project input directory
   process.env.ELEVENTY_DATA = paths.getDataDir()
   process.env.ELEVENTY_INCLUDES = paths.getIncludesDir()
@@ -59,6 +73,21 @@ const configureEleventyEnv = ({ mode = 'production', debug = false } = {}) => {
   // Build mode
   process.env.ELEVENTY_ENV = mode
 
+  // Log level for quire-11ty's chalk logger
+  if (quiet) {
+    process.env.QUIRE_LOG_LEVEL = 'silent'
+  } else if (debug) {
+    process.env.QUIRE_LOG_LEVEL = 'debug'
+  } else if (verbose) {
+    process.env.QUIRE_LOG_LEVEL = 'info'
+  } else {
+    process.env.QUIRE_LOG_LEVEL = 'warn'
+  }
+
+  // QUIRE_LOG_PREFIX and QUIRE_LOG_SHOW_LEVEL are set by the preAction hook
+  // in main.js from config values. No action needed here — they are already
+  // in process.env and will be read by the chalk logger at instantiation time.
+
   // Debug output
   if (debug) {
     process.env.DEBUG = 'Eleventy*'
@@ -102,7 +131,7 @@ const createEleventyInstance = async (options = {}) => {
       return eleventyConfig
     },
     configPath: options.config || config,
-    quietMode: options.quiet || false,
+    quietMode: options.quiet || !options.verbose,
     runMode: options.runMode || 'build',
   })
 
@@ -172,14 +201,14 @@ class Quire11ty {
     const projectRoot = this.paths.getProjectRoot()
     process.chdir(projectRoot)
 
-    configureEleventyEnv({ mode: 'production', debug: options.debug })
-
-    reporter.start('Building site...', { showElapsed: true })
+    configureEleventyEnv({ mode: 'production', ...options })
 
     const eleventy = await createEleventyInstance(options)
 
     eleventy.setDryRun(options.dryRun)
 
+    reporter.start('Building site...', { showElapsed: true })
+
     try {
       await eleventy.write()
       reporter.succeed('Build complete')
@@ -202,9 +231,7 @@ class Quire11ty {
     const projectRoot = this.paths.getProjectRoot()
     process.chdir(projectRoot)
 
-    configureEleventyEnv({ mode: 'development', debug: options.debug })
-
-    reporter.start('Starting development server...')
+    configureEleventyEnv({ mode: 'development', ...options })
 
     const eleventy =
       await createEleventyInstance({ ...options, runMode: 'serve' })
@@ -212,9 +239,21 @@ class Quire11ty {
     // Store reference for lifecycle management (graceful shutdown)
     this.activeInstance = eleventy
 
-    // Initialize Eleventy before serving (required for eleventyServe)
+    // Initialize Eleventy (required before watch/serve)
     await eleventy.init()
 
+    reporter.start('Building site...', { showElapsed: true })
+
+    // Build the site and start file watchers.
+    // watch() performs the initial build via write(), then sets up chokidar
+    // file watchers for incremental rebuilds on file changes.
+    // This matches the Eleventy CLI sequence: init() → watch() → serve()
+    // @see https://github.com/11ty/eleventy/blob/main/cmd.cjs
+    await eleventy.watch()
+
+    reporter.succeed('Build complete')
+    reporter.start('Starting development server...')
+
     // Register a ready callback to resolve the spinner when the server is listening
     // @see https://www.11ty.dev/docs/dev-server/#options
     eleventy.eleventyServe.config.serverOptions = {
@@ -228,6 +267,7 @@ class Quire11ty {
       },
     }
 
+    // Start the HTTP dev server (serves the built _site/ directory)
     await eleventy.serve(options.port)
   }
 }

package/src/lib/11ty/cli.js

@@ -93,6 +93,27 @@ const factory = (options = {}) => {
     ELEVENTY_LAYOUTS: paths.getLayoutsDir(),
   }
 
+  // QUIRE_LOG_LEVEL controls output from the quire-11ty chalk logger,
+  // the Vite plugin logLevel, and the directory output plugin registration.
+  // @see packages/cli/docs/cli-output-modes.md
+  if (options.quiet) {
+    env.QUIRE_LOG_LEVEL = 'silent'
+  } else if (options.debug) {
+    env.QUIRE_LOG_LEVEL = 'debug'
+  } else if (options.verbose) {
+    env.QUIRE_LOG_LEVEL = 'info'
+  } else {
+    env.QUIRE_LOG_LEVEL = 'warn'
+  }
+
+  // Forward CLI log prefix and show-level settings (set by configureLogEnv)
+  if (process.env.QUIRE_LOG_PREFIX !== undefined) {
+    env.QUIRE_LOG_PREFIX = process.env.QUIRE_LOG_PREFIX
+  }
+  if (process.env.QUIRE_LOG_SHOW_LEVEL !== undefined) {
+    env.QUIRE_LOG_SHOW_LEVEL = process.env.QUIRE_LOG_SHOW_LEVEL
+  }
+
   if (options.debug) env.DEBUG = 'Eleventy*'
 
   return { command, env, projectRoot }

package/src/lib/logger/index.js

@@ -88,7 +88,7 @@ export const LOG_LEVEL_ENV_VAR = 'QUIRE_LOG_LEVEL'
  * @param {string} text - Prefix text
  * @returns {string} Formatted prefix
  */
-function formatPrefix(style, text) {
+export function formatPrefix(style, text) {
   switch (style) {
     case 'bracket':
       return `[${text}]`

package/src/main.js

@@ -16,6 +16,7 @@ import reporter from '#lib/reporter/index.js'
 import { docsUrl, DOCS_BASE } from '#helpers/docs-url.js'
 import packageConfig from '#src/packageConfig.js'
 import { enableDebug } from '#lib/logger/debug.js'
+import { formatPrefix } from '#lib/logger/index.js'
 
 const { version } = packageConfig
 
@@ -151,6 +152,10 @@ program.hook('preAction', (thisCommand) => {
   if (opts.pager === false) {
     process.env.NO_PAGER = '1'
   }
+
+  // Log prefix and level label visibility for quire-11ty's chalk logger
+  process.env.QUIRE_LOG_PREFIX = formatPrefix(config.get('logPrefixStyle'), config.get('logPrefix'))
+  process.env.QUIRE_LOG_SHOW_LEVEL = String(config.get('logShowLevel'))
 })
 
 /**