uniweb 0.13.16 → 0.14.0

package/src/templates/fetchers/github.js

@@ -33,13 +33,13 @@ export async function fetchGitHubTemplate(owner, repo, options = {}) {
   try {
     const response = await fetchWithRetry(tarballUrl, {
       headers: {
-        'Accept': 'application/vnd.github+json',
+        Accept: 'application/vnd.github+json',
         'User-Agent': 'uniweb-cli',
         // Support private repos if GITHUB_TOKEN is set
         ...(process.env.GITHUB_TOKEN && {
-          'Authorization': `Bearer ${process.env.GITHUB_TOKEN}`
-        }),
-      },
+          Authorization: `Bearer ${process.env.GITHUB_TOKEN}`
+        })
+      }
     })
 
     if (!response.ok) {
@@ -69,7 +69,7 @@ export async function fetchGitHubTemplate(owner, repo, options = {}) {
 
     return {
       tempDir,
-      ref: displayRef,
+      ref: displayRef
     }
   } catch (err) {
     // Clean up on error
@@ -86,13 +86,13 @@ async function fetchWithRetry(url, options = {}, maxRetries = 3) {
     try {
       const response = await fetch(url, {
         ...options,
-        signal: AbortSignal.timeout(60000), // 60s timeout for GitHub (can be slow)
+        signal: AbortSignal.timeout(60000) // 60s timeout for GitHub (can be slow)
       })
       return response
     } catch (err) {
       if (attempt === maxRetries) throw err
       const delay = Math.min(1000 * Math.pow(2, attempt), 10000)
-      await new Promise(r => setTimeout(r, delay))
+      await new Promise((r) => setTimeout(r, delay))
     }
   }
 }

package/src/templates/fetchers/npm.js

@@ -67,7 +67,7 @@ export async function fetchNpmTemplate(packageName, options = {}) {
     return {
       tempDir,
       version,
-      metadata: versionMeta,
+      metadata: versionMeta
     }
   } catch (err) {
     // Clean up on error
@@ -84,13 +84,13 @@ async function fetchWithRetry(url, options = {}, maxRetries = 3) {
     try {
       const response = await fetch(url, {
         ...options,
-        signal: AbortSignal.timeout(30000), // 30s timeout
+        signal: AbortSignal.timeout(30000) // 30s timeout
       })
       return response
     } catch (err) {
       if (attempt === maxRetries) throw err
       const delay = Math.min(1000 * Math.pow(2, attempt), 10000)
-      await new Promise(r => setTimeout(r, delay))
+      await new Promise((r) => setTimeout(r, delay))
     }
   }
 }

package/src/templates/fetchers/release.js

@@ -40,7 +40,7 @@ export async function fetchManifest(options = {}) {
     : `${GITHUB_API}/repos/${TEMPLATES_REPO}/releases/latest`
 
   const releaseResponse = await fetchWithRetry(releaseUrl, {
-    headers: getGitHubHeaders(),
+    headers: getGitHubHeaders()
   })
 
   if (!releaseResponse.ok) {
@@ -57,18 +57,21 @@ export async function fetchManifest(options = {}) {
   const release = await releaseResponse.json()
 
   // Find manifest.json asset
-  const manifestAsset = release.assets?.find(a => a.name === 'manifest.json')
+  const manifestAsset = release.assets?.find((a) => a.name === 'manifest.json')
   if (!manifestAsset) {
     throw new Error(
       `Release ${release.tag_name} does not contain manifest.json. ` +
-      `This may be an older release format.`
+        `This may be an older release format.`
     )
   }
 
   // Download manifest
-  const manifestResponse = await fetchWithRetry(manifestAsset.browser_download_url, {
-    headers: getGitHubHeaders(),
-  })
+  const manifestResponse = await fetchWithRetry(
+    manifestAsset.browser_download_url,
+    {
+      headers: getGitHubHeaders()
+    }
+  )
 
   if (!manifestResponse.ok) {
     throw new Error(`Failed to download manifest: ${manifestResponse.status}`)
@@ -81,7 +84,7 @@ export async function fetchManifest(options = {}) {
     version: release.tag_name,
     templates: manifest.templates || {},
     // Base URL for downloading template tarballs
-    downloadUrlBase: `https://github.com/${TEMPLATES_REPO}/releases/download/${release.tag_name}`,
+    downloadUrlBase: `https://github.com/${TEMPLATES_REPO}/releases/download/${release.tag_name}`
   }
 
   // Cache if this was a "latest" fetch
@@ -113,7 +116,7 @@ export async function fetchOfficialTemplate(name, options = {}) {
     const available = Object.keys(manifest.templates).join(', ')
     throw new Error(
       `Template "${name}" not found in release ${manifest.version}.\n` +
-      `Available templates: ${available || 'none'}`
+        `Available templates: ${available || 'none'}`
     )
   }
 
@@ -122,14 +125,14 @@ export async function fetchOfficialTemplate(name, options = {}) {
   // Download template tarball
   const tarballUrl = `${manifest.downloadUrlBase}/${name}.tar.gz`
   const tarballResponse = await fetchWithRetry(tarballUrl, {
-    headers: getGitHubHeaders(),
+    headers: getGitHubHeaders()
   })
 
   if (!tarballResponse.ok) {
     if (tarballResponse.status === 404) {
       throw new Error(
         `Template tarball not found: ${name}.tar.gz\n` +
-        `The release may be incomplete or corrupted.`
+          `The release may be incomplete or corrupted.`
       )
     }
     throw new Error(`Failed to download template: ${tarballResponse.status}`)
@@ -153,7 +156,7 @@ export async function fetchOfficialTemplate(name, options = {}) {
       tempDir: join(tempDir, name),
       baseTempDir: tempDir, // For cleanup
       version: manifest.version,
-      metadata: templateInfo,
+      metadata: templateInfo
     }
   } catch (err) {
     // Clean up on error
@@ -174,7 +177,7 @@ export async function listOfficialTemplates(options = {}) {
     const manifest = await fetchManifest(options)
     return Object.entries(manifest.templates).map(([id, info]) => ({
       id,
-      ...info,
+      ...info
     }))
   } catch {
     // Return empty list if can't fetch
@@ -194,12 +197,12 @@ export function clearManifestCache() {
  */
 function getGitHubHeaders() {
   return {
-    'Accept': 'application/vnd.github+json',
+    Accept: 'application/vnd.github+json',
     'User-Agent': 'uniweb-cli',
     // Support private repos or higher rate limits if GITHUB_TOKEN is set
     ...(process.env.GITHUB_TOKEN && {
-      'Authorization': `Bearer ${process.env.GITHUB_TOKEN}`
-    }),
+      Authorization: `Bearer ${process.env.GITHUB_TOKEN}`
+    })
   }
 }
 
@@ -212,7 +215,7 @@ async function handleGitHubError(response) {
     if (remaining === '0') {
       throw new Error(
         'GitHub API rate limit exceeded.\n' +
-        'Set GITHUB_TOKEN environment variable for higher limits.'
+          'Set GITHUB_TOKEN environment variable for higher limits.'
       )
     }
   }
@@ -228,13 +231,13 @@ async function fetchWithRetry(url, options = {}, maxRetries = 3) {
       const response = await fetch(url, {
         ...options,
         redirect: 'follow',
-        signal: AbortSignal.timeout(60000), // 60s timeout
+        signal: AbortSignal.timeout(60000) // 60s timeout
       })
       return response
     } catch (err) {
       if (attempt === maxRetries) throw err
       const delay = Math.min(1000 * Math.pow(2, attempt), 10000)
-      await new Promise(r => setTimeout(r, delay))
+      await new Promise((r) => setTimeout(r, delay))
     }
   }
 }

package/src/templates/index.js

@@ -7,10 +7,19 @@ import { readFile, rm } from 'node:fs/promises'
 import { join, resolve } from 'node:path'
 import { homedir } from 'node:os'
 
-import { parseTemplateId, getTemplateDisplayName, BUILTIN_TEMPLATES, OFFICIAL_TEMPLATES, buildTemplateChoices } from './resolver.js'
+import {
+  parseTemplateId,
+  getTemplateDisplayName,
+  BUILTIN_TEMPLATES,
+  OFFICIAL_TEMPLATES,
+  buildTemplateChoices
+} from './resolver.js'
 import { fetchNpmTemplate } from './fetchers/npm.js'
 import { fetchGitHubTemplate } from './fetchers/github.js'
-import { fetchOfficialTemplate, listOfficialTemplates } from './fetchers/release.js'
+import {
+  fetchOfficialTemplate,
+  listOfficialTemplates
+} from './fetchers/release.js'
 import { validateTemplate } from './validator.js'
 
 /**
@@ -29,7 +38,7 @@ export async function resolveTemplate(identifier, options = {}) {
     case 'builtin':
       return {
         type: 'builtin',
-        name: parsed.name,
+        name: parsed.name
         // Built-in templates are handled programmatically by the CLI
         // No path or cleanup needed
       }
@@ -57,7 +66,9 @@ export async function resolveTemplate(identifier, options = {}) {
 async function resolveOfficialTemplate(name, options = {}) {
   const { onProgress } = options
 
-  const { tempDir, baseTempDir, version } = await fetchOfficialTemplate(name, { onProgress })
+  const { tempDir, baseTempDir, version } = await fetchOfficialTemplate(name, {
+    onProgress
+  })
 
   onProgress?.(`Using official template: ${name} (${version})`)
 
@@ -69,7 +80,7 @@ async function resolveOfficialTemplate(name, options = {}) {
     cleanup: async () => {
       // Clean up the base temp directory (parent of the template)
       await rm(baseTempDir, { recursive: true, force: true }).catch(() => {})
-    },
+    }
   }
 }
 
@@ -81,7 +92,9 @@ async function resolveNpmTemplate(packageName, options = {}) {
 
   onProgress?.(`Resolving npm template: ${packageName}`)
 
-  const { tempDir, version, metadata } = await fetchNpmTemplate(packageName, { onProgress })
+  const { tempDir, version, metadata } = await fetchNpmTemplate(packageName, {
+    onProgress
+  })
 
   return {
     type: 'npm',
@@ -90,7 +103,7 @@ async function resolveNpmTemplate(packageName, options = {}) {
     path: tempDir,
     cleanup: async () => {
       await rm(tempDir, { recursive: true, force: true }).catch(() => {})
-    },
+    }
   }
 }
 
@@ -103,7 +116,10 @@ async function resolveGitHubTemplate(parsed, options = {}) {
 
   onProgress?.(`Resolving GitHub template: ${owner}/${repo}`)
 
-  const { tempDir } = await fetchGitHubTemplate(owner, repo, { ref, onProgress })
+  const { tempDir } = await fetchGitHubTemplate(owner, repo, {
+    ref,
+    onProgress
+  })
 
   return {
     type: 'github',
@@ -113,7 +129,7 @@ async function resolveGitHubTemplate(parsed, options = {}) {
     path: tempDir,
     cleanup: async () => {
       await rm(tempDir, { recursive: true, force: true }).catch(() => {})
-    },
+    }
   }
 }
 
@@ -153,7 +169,7 @@ async function resolveLocalTemplate(templatePath, options = {}) {
     type: 'local',
     name,
     path: resolvedPath,
-    cleanup: null,
+    cleanup: null
   }
 }
 
@@ -171,7 +187,7 @@ export async function listAvailableTemplates() {
         type: 'official',
         id: t.id,
         name: t.name || t.id,
-        description: t.description || '',
+        description: t.description || ''
       })
     }
   } catch {
@@ -182,4 +198,10 @@ export async function listAvailableTemplates() {
 }
 
 // Re-export for convenience
-export { parseTemplateId, getTemplateDisplayName, BUILTIN_TEMPLATES, OFFICIAL_TEMPLATES, buildTemplateChoices }
+export {
+  parseTemplateId,
+  getTemplateDisplayName,
+  BUILTIN_TEMPLATES,
+  OFFICIAL_TEMPLATES,
+  buildTemplateChoices
+}

package/src/templates/processor.js

@@ -69,7 +69,7 @@ function registerPartials() {
  * Handlebars helper to get a package version
  * Usage: {{version "@uniweb/build"}} or {{version "build"}}
  */
-Handlebars.registerHelper('version', function(packageName) {
+Handlebars.registerHelper('version', function (packageName) {
   // Try exact match first
   if (versionData[packageName]) {
     return versionData[packageName]
@@ -85,10 +85,27 @@ Handlebars.registerHelper('version', function(packageName) {
 
 // Text file extensions that should be processed for variables
 const TEXT_EXTENSIONS = new Set([
-  '.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs',
-  '.json', '.yml', '.yaml', '.md', '.mdx',
-  '.html', '.htm', '.css', '.scss', '.less',
-  '.txt', '.xml', '.svg', '.vue', '.astro'
+  '.js',
+  '.jsx',
+  '.ts',
+  '.tsx',
+  '.mjs',
+  '.cjs',
+  '.json',
+  '.yml',
+  '.yaml',
+  '.md',
+  '.mdx',
+  '.html',
+  '.htm',
+  '.css',
+  '.scss',
+  '.less',
+  '.txt',
+  '.xml',
+  '.svg',
+  '.vue',
+  '.astro'
 ])
 
 /**
@@ -96,7 +113,7 @@ const TEXT_EXTENSIONS = new Set([
  */
 function findUnresolvedPlaceholders(content) {
   const patterns = [
-    /\{\{([^#/}>][^}]*)\}\}/g, // {{variable}} - not blocks or partials
+    /\{\{([^#/}>][^}]*)\}\}/g // {{variable}} - not blocks or partials
   ]
 
   const unresolved = []
@@ -146,7 +163,9 @@ async function processFile(sourcePath, targetPath, data, options = {}) {
     // Check for unresolved placeholders
     const unresolved = findUnresolvedPlaceholders(content)
     if (unresolved.length > 0 && options.onWarning) {
-      options.onWarning(`Unresolved placeholders in ${path.basename(targetPath)}: ${unresolved.join(', ')}`)
+      options.onWarning(
+        `Unresolved placeholders in ${path.basename(targetPath)}: ${unresolved.join(', ')}`
+      )
     }
 
     await fs.writeFile(targetPath, content)
@@ -182,7 +201,9 @@ async function processFile(sourcePath, targetPath, data, options = {}) {
  * directory-only behavior.
  */
 function dotfileRename(name) {
-  return name.startsWith('_') && !name.startsWith('__') ? `.${name.slice(1)}` : name
+  return name.startsWith('_') && !name.startsWith('__')
+    ? `.${name.slice(1)}`
+    : name
 }
 
 /**
@@ -191,7 +212,9 @@ function dotfileRename(name) {
  * `.gitignore` and `_env.local.hbs` → `.env.local`.
  */
 function templateOutputName(sourceName) {
-  const base = sourceName.endsWith('.hbs') ? sourceName.slice(0, -4) : sourceName
+  const base = sourceName.endsWith('.hbs')
+    ? sourceName.slice(0, -4)
+    : sourceName
   return dotfileRename(base)
 }
 
@@ -205,7 +228,12 @@ function templateOutputName(sourceName) {
  * @param {Function} options.onWarning - Warning callback
  * @param {Function} options.onProgress - Progress callback
  */
-export async function copyTemplateDirectory(sourcePath, targetPath, data, options = {}) {
+export async function copyTemplateDirectory(
+  sourcePath,
+  targetPath,
+  data,
+  options = {}
+) {
   const { onWarning, onProgress, skip } = options
 
   await fs.mkdir(targetPath, { recursive: true })
@@ -219,7 +247,11 @@ export async function copyTemplateDirectory(sourcePath, targetPath, data, option
       // Rename _prefix directories to .prefix (e.g., _vscode → .vscode).
       const targetFullPath = path.join(targetPath, dotfileRename(sourceName))
 
-      await copyTemplateDirectory(sourceFullPath, targetFullPath, data, { onWarning, onProgress, skip })
+      await copyTemplateDirectory(sourceFullPath, targetFullPath, data, {
+        onWarning,
+        onProgress,
+        skip
+      })
     } else {
       // Skip template.json as it's metadata for the template, not for the output
       if (sourceName === 'template.json') {
@@ -282,7 +314,7 @@ async function enumerateInto(sourcePath, relPath, outputs, skip) {
         path.join(sourcePath, sourceName),
         relPath ? path.join(relPath, targetName) : targetName,
         outputs,
-        skip,
+        skip
       )
     } else {
       if (sourceName === 'template.json') continue

package/src/templates/resolver.js

@@ -45,7 +45,14 @@ export const BUILTIN_TEMPLATES = ['blank', 'starter', 'none']
 function loadOfficialTemplateMap() {
   // Local dev: framework/templates/manifest.json relative to this file
   // at framework/cli/src/templates/resolver.js
-  const workspaceManifest = join(__dirname, '..', '..', '..', 'templates', 'manifest.json')
+  const workspaceManifest = join(
+    __dirname,
+    '..',
+    '..',
+    '..',
+    'templates',
+    'manifest.json'
+  )
   const picked = tryReadTemplateMap(workspaceManifest)
   if (picked) return picked
 
@@ -85,8 +92,16 @@ export const OFFICIAL_TEMPLATES = Object.keys(OFFICIAL_TEMPLATE_MAP)
 // Built-in (programmatic) picker entries — not in the manifest; the CLI
 // generates these itself. "Blank" trails the official templates.
 const BUILTIN_LEAD_CHOICES = [
-  { title: 'None', value: 'none', description: 'Foundation + site with no content' },
-  { title: 'Starter', value: 'starter', description: 'Foundation + site + sample content' }
+  {
+    title: 'None',
+    value: 'none',
+    description: 'Foundation + site with no content'
+  },
+  {
+    title: 'Starter',
+    value: 'starter',
+    description: 'Foundation + site + sample content'
+  }
 ]
 const BLANK_CHOICE = {
   title: 'Blank workspace',
@@ -130,7 +145,7 @@ export function parseTemplateId(identifier) {
   if (BUILTIN_TEMPLATES.includes(identifier)) {
     return {
       type: 'builtin',
-      name: identifier,
+      name: identifier
     }
   }
 
@@ -138,7 +153,7 @@ export function parseTemplateId(identifier) {
   if (OFFICIAL_TEMPLATES.includes(identifier)) {
     return {
       type: 'official',
-      name: identifier,
+      name: identifier
     }
   }
 
@@ -149,19 +164,25 @@ export function parseTemplateId(identifier) {
   }
 
   // GitHub URL: https://github.com/user/repo
-  if (identifier.startsWith('https://github.com/') || identifier.startsWith('http://github.com/')) {
+  if (
+    identifier.startsWith('https://github.com/') ||
+    identifier.startsWith('http://github.com/')
+  ) {
     const url = new URL(identifier)
     const pathParts = url.pathname.split('/').filter(Boolean)
     if (pathParts.length >= 2) {
       const [owner, repo] = pathParts
       // Check for tree/branch in URL
       const treeIndex = pathParts.indexOf('tree')
-      const ref = treeIndex >= 0 && pathParts[treeIndex + 1] ? pathParts[treeIndex + 1] : undefined
+      const ref =
+        treeIndex >= 0 && pathParts[treeIndex + 1]
+          ? pathParts[treeIndex + 1]
+          : undefined
       return {
         type: 'github',
         owner,
         repo: repo.replace(/\.git$/, ''),
-        ref,
+        ref
       }
     }
     throw new Error(`Invalid GitHub URL: ${identifier}`)
@@ -171,16 +192,20 @@ export function parseTemplateId(identifier) {
   if (identifier.startsWith('@')) {
     return {
       type: 'npm',
-      package: identifier,
+      package: identifier
     }
   }
 
   // Local path (relative, absolute, or home directory)
-  if (identifier.startsWith('./') || identifier.startsWith('../') ||
-      identifier.startsWith('/') || identifier.startsWith('~')) {
+  if (
+    identifier.startsWith('./') ||
+    identifier.startsWith('../') ||
+    identifier.startsWith('/') ||
+    identifier.startsWith('~')
+  ) {
     return {
       type: 'local',
-      path: identifier,
+      path: identifier
     }
   }
 
@@ -188,7 +213,7 @@ export function parseTemplateId(identifier) {
   // This allows users to type `uniweb create foo --template blog` for @uniweb/template-blog
   return {
     type: 'npm',
-    package: `@uniweb/template-${identifier}`,
+    package: `@uniweb/template-${identifier}`
   }
 }
 
@@ -200,14 +225,16 @@ function parseGitHubIdentifier(identifier) {
   const [owner, repo] = repoPath.split('/')
 
   if (!owner || !repo) {
-    throw new Error(`Invalid GitHub identifier: ${identifier}. Expected format: user/repo or user/repo#ref`)
+    throw new Error(
+      `Invalid GitHub identifier: ${identifier}. Expected format: user/repo or user/repo#ref`
+    )
   }
 
   return {
     type: 'github',
     owner,
     repo: repo.replace(/\.git$/, ''),
-    ref: ref || undefined,
+    ref: ref || undefined
   }
 }
 

package/src/templates/validator.js

@@ -43,7 +43,8 @@ export function satisfiesVersion(version, range) {
     // ^x.y.z means >=x.y.z and <(x+1).0.0
     const min = parseVersion(range.slice(1))
     if (!min) return true
-    if (current.major !== min.major) return current.major > min.major && min.major === 0
+    if (current.major !== min.major)
+      return current.major > min.major && min.major === 0
     if (current.minor > min.minor) return true
     if (current.minor < min.minor) return false
     return current.patch >= min.patch
@@ -71,9 +72,11 @@ export function satisfiesVersion(version, range) {
   // Exact match
   const exact = parseVersion(range)
   if (!exact) return true
-  return current.major === exact.major &&
-         current.minor === exact.minor &&
-         current.patch === exact.patch
+  return (
+    current.major === exact.major &&
+    current.minor === exact.minor &&
+    current.patch === exact.patch
+  )
 }
 
 /**
@@ -93,7 +96,7 @@ export const ErrorCodes = {
   INVALID_TEMPLATE_JSON: 'INVALID_TEMPLATE_JSON',
   MISSING_CONTENT_DIR: 'MISSING_CONTENT_DIR',
   MISSING_REQUIRED_FIELD: 'MISSING_REQUIRED_FIELD',
-  VERSION_MISMATCH: 'VERSION_MISMATCH',
+  VERSION_MISMATCH: 'VERSION_MISMATCH'
 }
 
 /**
@@ -189,7 +192,7 @@ export function resolveContentDirs(templateRoot, metadata) {
           type: pkg.type,
           name: pkg.name,
           dir,
-          ...(pkg.foundation ? { foundation: pkg.foundation } : {}),
+          ...(pkg.foundation ? { foundation: pkg.foundation } : {})
         }
         if (entry.type === 'foundation' || entry.type === 'extension') {
           applyLegacyFoundationLayout(entry)
@@ -201,7 +204,11 @@ export function resolveContentDirs(templateRoot, metadata) {
     // Standard template: look for foundation/ and site/
     const foundationDir = path.join(templateRoot, 'foundation')
     if (existsSync(foundationDir)) {
-      const entry = { type: 'foundation', name: 'foundation', dir: foundationDir }
+      const entry = {
+        type: 'foundation',
+        name: 'foundation',
+        dir: foundationDir
+      }
       applyLegacyFoundationLayout(entry)
       dirs.push(entry)
     }