@meistrari/tela-build 1.38.0 → 1.38.2

package/components/tela/transparent-input.vue

@@ -141,7 +141,6 @@ onUnmounted(() => {
                 :size="editIconSize || 'xs'"
                 icon="i-ph-pencil-simple"
                 color="secondary"
-                icon-class="text-gray-400"
                 @click="onStartEditing"
             />
         </div>

package/modules/tela-build-docs/index.ts

@@ -1,9 +1,8 @@
 /* eslint-disable no-console */
 import { existsSync, writeFileSync, mkdirSync, lstatSync, readFileSync, symlinkSync } from 'node:fs'
 import { defineNuxtModule, createResolver } from '@nuxt/kit'
-import { dirname, join, relative, resolve } from 'pathe'
+import { dirname, resolve } from 'pathe'
 import { collectComponentDocs, generateMarkdown, generateDocsToDirectory } from '../../lib/doc-generator'
-import { telaBuildSkill } from '../../lib/tela-build-skill'
 import { ensureOverlayTsconfig } from '../../lib/extractors/volar-extract'
 
 export interface TelaBuildDocsOptions {
@@ -13,11 +12,6 @@ export interface TelaBuildDocsOptions {
     enabled?: boolean
 }
 
-interface IgnoreTarget {
-    path: string
-    kind: 'dir' | 'file'
-}
-
 export default defineNuxtModule<TelaBuildDocsOptions>({
     meta: {
         name: 'tela-build-docs',
@@ -53,7 +47,7 @@ export default defineNuxtModule<TelaBuildDocsOptions>({
             reset: '\x1B[0m',
         }
 
-        function generateDocsInBackground() {
+        async function generateDocs() {
             if (hasGenerated) {
                 return // Only generate once
             }
@@ -69,81 +63,74 @@ export default defineNuxtModule<TelaBuildDocsOptions>({
 
             logger.log(`${colors.gray}[tela/build] ${colors.cyan}◎${colors.gray} Scanning components from ${layerPath}${colors.reset}`)
 
-            // Run in background without blocking
-            setImmediate(async () => {
+            try {
+                const repositoryRoot = resolveRepositoryRoot(nuxt.options.rootDir, nuxt.options.workspaceDir)
                 try {
-                    const repositoryRoot = resolveRepositoryRoot(nuxt.options.rootDir, nuxt.options.workspaceDir)
-                    try {
-                        if (!options.outDir) {
-                            ensureClaudeSymlink(repositoryRoot, logger, colors)
-                        }
-                    }
-                    catch (symlinkError: any) {
-                        logger.log(`${colors.gray}[tela/build] ${colors.orange}✗${colors.gray} Could not create .claude symlink: ${symlinkError.message}${colors.reset}`)
+                    if (!options.outDir) {
+                        ensureClaudeSymlink(repositoryRoot, logger, colors)
                     }
+                }
+                catch (symlinkError: any) {
+                    logger.log(`${colors.gray}[tela/build] ${colors.orange}✗${colors.gray} Could not create .claude symlink: ${symlinkError.message}${colors.reset}`)
+                }
 
-                    // Prepare tsconfig overlay (safe even if Volar is disabled; creation is idempotent)
-                    try {
-                        if (nuxt.options.rootDir) {
-                            ensureOverlayTsconfig(nuxt.options.rootDir, layerPath)
-                        }
-                    }
-                    catch {}
-
-                    // Collect component documentation with stories
-                    logger.log(`${colors.gray}[tela/build] ${colors.yellow}◒${colors.gray} Analyzing TypeScript types${colors.reset}`)
-                    // Pass the app's root directory so vue-docgen-api can find node_modules
-                    const { docs: componentDocs, typeResolver } = await collectComponentDocs(layerPath, nuxt.options.rootDir)
-
-                    // Generate documentation (directory-first unless outFile explicitly set)
-                    logger.log(`${colors.gray}[tela/build] ${colors.orange}◐${colors.gray} Generating documentation for ${componentDocs.length} components${colors.reset}`)
-
-                    const baseDir = repositoryRoot
-
-                    if (options.outFile) {
-                        // Single-file mode (legacy)
-                        const outPath = resolve(nuxt.options.rootDir, options.outFile)
-                        const outDir = resolve(outPath, '..')
-                        if (!existsSync(outDir)) {
-                            mkdirSync(outDir, { recursive: true })
-                        }
-                        const markdown = generateMarkdown(componentDocs, typeResolver)
-                        writeFileSync(outPath, markdown, 'utf-8')
-                        // Skip auto-gitignore for legacy outFile — the path is user-managed and may be intentionally tracked
-                        logger.log(`${colors.gray}[tela/build] ${colors.green}●${colors.gray} Documentation complete → ${outPath}${colors.reset}`)
+                // Prepare tsconfig overlay (safe even if Volar is disabled; creation is idempotent)
+                try {
+                    if (nuxt.options.rootDir) {
+                        ensureOverlayTsconfig(nuxt.options.rootDir, layerPath)
                     }
-                    else {
-                        // Directory output: single Skill (tela-build) + supporting component pages
-                        const outputDirs = resolveOutputDirectories(baseDir, options.outDir)
-                        for (const dir of outputDirs) {
-                            generateDocsToDirectory(componentDocs, typeResolver, dir, layerPath)
-                        }
-                        ensurePathsIgnored(baseDir, outputDirs.map(dir => ({
-                            path: join(dir, telaBuildSkill.name),
-                            kind: 'dir' as const,
-                        })))
-                        logger.log(`${colors.gray}[tela/build] ${colors.green}●${colors.gray} Documentation complete → ${outputDirs.join(', ')}${colors.reset}`)
+                }
+                catch {}
+
+                // Collect component documentation with stories
+                logger.log(`${colors.gray}[tela/build] ${colors.yellow}◒${colors.gray} Analyzing TypeScript types${colors.reset}`)
+                // Pass the app's root directory so vue-docgen-api can find node_modules
+                const { docs: componentDocs, typeResolver } = await collectComponentDocs(layerPath, nuxt.options.rootDir)
+
+                // Generate documentation (directory-first unless outFile explicitly set)
+                logger.log(`${colors.gray}[tela/build] ${colors.orange}◐${colors.gray} Generating documentation for ${componentDocs.length} components${colors.reset}`)
+
+                const baseDir = repositoryRoot
+
+                if (options.outFile) {
+                    // Single-file mode (legacy)
+                    const outPath = resolve(nuxt.options.rootDir, options.outFile)
+                    const outDir = resolve(outPath, '..')
+                    if (!existsSync(outDir)) {
+                        mkdirSync(outDir, { recursive: true })
                     }
+                    const markdown = generateMarkdown(componentDocs, typeResolver)
+                    writeFileSync(outPath, markdown, 'utf-8')
+                    // Skip auto-gitignore for legacy outFile — the path is user-managed and may be intentionally tracked
+                    logger.log(`${colors.gray}[tela/build] ${colors.green}●${colors.gray} Documentation complete → ${outPath}${colors.reset}`)
                 }
-                catch (error: any) {
-                    console.log(`${colors.gray}[tela/build] ${colors.orange}✗${colors.gray} Generation failed: ${error.message}${colors.reset}`)
-                    if (nuxt.options.dev) {
-                        console.error(error)
+                else {
+                    // Directory output: single Skill (tela-build) + supporting component pages
+                    const outputDirs = resolveOutputDirectories(baseDir, options.outDir)
+                    for (const dir of outputDirs) {
+                        generateDocsToDirectory(componentDocs, typeResolver, dir, layerPath)
                     }
+                    logger.log(`${colors.gray}[tela/build] ${colors.green}●${colors.gray} Documentation complete → ${outputDirs.join(', ')}${colors.reset}`)
                 }
-            })
+            }
+            catch (error: any) {
+                console.log(`${colors.gray}[tela/build] ${colors.orange}✗${colors.gray} Generation failed: ${error.message}${colors.reset}`)
+                if (nuxt.options.dev) {
+                    console.error(error)
+                }
+            }
         }
 
         // Generate once on server ready for dev
         if (nuxt.options.dev) {
-            nuxt.hook('ready', () => {
-                generateDocsInBackground()
+            nuxt.hook('ready', async () => {
+                await generateDocs()
             })
         }
         else {
             // Generate before production build
-            nuxt.hook('nitro:build:before', () => {
-                generateDocsInBackground()
+            nuxt.hook('nitro:build:before', async () => {
+                await generateDocs()
             })
         }
     },
@@ -215,35 +202,6 @@ function isRepositoryRoot(directory: string): boolean {
     }
 }
 
-function ensurePathsIgnored(repositoryRoot: string, targets: IgnoreTarget[]): void {
-    const gitignorePath = resolve(repositoryRoot, '.gitignore')
-    const existingLines = existsSync(gitignorePath)
-        ? readFileSync(gitignorePath, 'utf-8').split('\n')
-        : []
-    const existingEntries = new Set(existingLines.map(line => line.trim()).filter(Boolean))
-    const entriesToAdd = targets
-        .map(target => toGitignoreEntry(repositoryRoot, target))
-        .filter(entry => !existingEntries.has(entry))
-
-    if (entriesToAdd.length === 0) {
-        return
-    }
-
-    const nextLines = [...existingLines]
-    if (nextLines.length > 0 && nextLines[nextLines.length - 1] !== '') {
-        nextLines.push('')
-    }
-    nextLines.push(...entriesToAdd)
-
-    writeFileSync(gitignorePath, `${nextLines.join('\n')}\n`, 'utf-8')
-}
-
-function toGitignoreEntry(repositoryRoot: string, target: IgnoreTarget): string {
-    const relativePath = relative(repositoryRoot, target.path).replace(/\\/g, '/')
-    const normalizedPath = relativePath.startsWith('.') ? relativePath : `/${relativePath}`
-    return target.kind === 'dir' ? `${normalizedPath}/` : normalizedPath
-}
-
 export function ensureClaudeSymlink(
     repositoryRoot: string,
     logger: Pick<Console, 'log'>,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/tela-build",
-  "version": "1.38.0",
+  "version": "1.38.2",
   "type": "module",
   "files": [
     "app.config.ts",