@vibecuting/component-project-helper 0.1.10 → 0.1.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecuting/component-project-helper",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
   "main": "./src/index.ts",

package/scripts/package-json.mjs

@@ -0,0 +1,60 @@
+import fs from 'node:fs/promises'
+import path from 'node:path'
+
+export const componentProjectSkillsScriptName = 'update-component-skills'
+export const componentProjectSkillsScriptCommand =
+  'node ./node_modules/@vibecuting/component-project-helper/scripts/postinstall.mjs'
+
+async function readPackageJson(projectRoot) {
+  const packageJsonPath = path.join(projectRoot, 'package.json')
+  try {
+    return JSON.parse(await fs.readFile(packageJsonPath, 'utf8'))
+  } catch (error) {
+    if (error?.code === 'ENOENT') {
+      return undefined
+    }
+
+    throw error
+  }
+}
+
+async function writePackageJson(projectRoot, packageJson) {
+  const packageJsonPath = path.join(projectRoot, 'package.json')
+  await fs.writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, 'utf8')
+}
+
+export async function ensureComponentProjectSkillsScript(projectRoot) {
+  const packageJson = await readPackageJson(projectRoot)
+  if (!packageJson) {
+    return
+  }
+
+  const scripts = packageJson.scripts ?? {}
+
+  if (scripts[componentProjectSkillsScriptName] !== componentProjectSkillsScriptCommand) {
+    packageJson.scripts = {
+      ...scripts,
+      [componentProjectSkillsScriptName]: componentProjectSkillsScriptCommand,
+    }
+    await writePackageJson(projectRoot, packageJson)
+  }
+}
+
+export async function removeComponentProjectSkillsScript(projectRoot) {
+  const packageJson = await readPackageJson(projectRoot)
+  if (!packageJson) {
+    return
+  }
+
+  const scripts = packageJson.scripts ?? {}
+
+  if (scripts[componentProjectSkillsScriptName] !== componentProjectSkillsScriptCommand) {
+    return
+  }
+
+  const nextScripts = { ...scripts }
+  delete nextScripts[componentProjectSkillsScriptName]
+  packageJson.scripts = nextScripts
+
+  await writePackageJson(projectRoot, packageJson)
+}

package/scripts/postinstall.mjs

@@ -2,6 +2,7 @@ import fs from 'node:fs/promises'
 import path from 'node:path'
 
 import { discoverComponentProjectComponents } from './discover-components.mjs'
+import { ensureComponentProjectSkillsScript } from './package-json.mjs'
 import {
   resolveComponentProjectGeneratedDocsDir,
   resolveComponentProjectGeneratedManifestPath,
@@ -33,6 +34,16 @@ export async function runComponentProjectPostinstall(projectRoot = resolveCompon
   const manifestPath = resolveComponentProjectGeneratedManifestPath(projectRoot)
   const components = await discoverComponentProjectComponents(projectRoot)
 
+  console.log('[component-project-helper] postinstall start')
+  console.log(`[component-project-helper] project root: ${projectRoot}`)
+  console.log(`[component-project-helper] docs dir: ${docsDir}`)
+  console.log(`[component-project-helper] manifest path: ${manifestPath}`)
+  console.log(
+    `[component-project-helper] discovered ${components.length} component(s): ${
+      components.map((component) => component.name).join(', ') || '(none)'
+    }`,
+  )
+
   await ensureDirectory(docsDir)
 
   const files = []
@@ -40,9 +51,21 @@ export async function runComponentProjectPostinstall(projectRoot = resolveCompon
     const filePath = path.join(docsDir, `${component.name}.md`)
     await fs.writeFile(filePath, renderComponentProjectMarkdown(component), 'utf8')
     files.push(filePath)
+    console.log(
+      `[component-project-helper] wrote ${path.relative(projectRoot, filePath)} <- ${component.sourceFile}`,
+    )
   }
 
+  console.log(
+    `[component-project-helper] cleaning stale docs relative to manifest ${path.relative(
+      projectRoot,
+      manifestPath,
+    )}`,
+  )
   await removeStaleGeneratedFiles(manifestPath, files)
+  await ensureComponentProjectSkillsScript(projectRoot)
+  console.log('[component-project-helper] ensured update-component-skills script')
+  console.log('[component-project-helper] ensured stale docs cleaned')
 
   const manifest = ComponentProjectGeneratedManifestSchema.parse({
     projectRoot,
@@ -51,6 +74,9 @@ export async function runComponentProjectPostinstall(projectRoot = resolveCompon
     files,
   })
   await fs.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8')
+  console.log(
+    `[component-project-helper] postinstall complete, manifest files: ${files.length}`,
+  )
 }
 
 const isDirectRun = process.argv[1] && path.resolve(process.argv[1]) === path.resolve(new URL(import.meta.url).pathname)

package/scripts/preuninstall.mjs

@@ -3,6 +3,7 @@ import path from 'node:path'
 
 import { resolveComponentProjectGeneratedManifestPath } from './runtime-root.mjs'
 import { ComponentProjectGeneratedManifestSchema } from './schemas.mjs'
+import { removeComponentProjectSkillsScript } from './package-json.mjs'
 
 export async function runComponentProjectPreuninstall(
   projectRoot = process.env.INIT_CWD ?? process.env.npm_config_local_prefix ?? process.cwd(),
@@ -25,6 +26,8 @@ export async function runComponentProjectPreuninstall(
       throw error
     }
   }
+
+  await removeComponentProjectSkillsScript(projectRoot)
 }
 
 const isDirectRun = process.argv[1] && path.resolve(process.argv[1]) === path.resolve(new URL(import.meta.url).pathname)

package/src/lifecycle/package-json.ts

@@ -7,7 +7,15 @@ export const componentProjectSkillsScriptCommand =
 
 async function readPackageJson(projectRoot: string): Promise<Record<string, unknown>> {
   const packageJsonPath = path.join(projectRoot, 'package.json')
-  return JSON.parse(await fs.readFile(packageJsonPath, 'utf8'))
+  try {
+    return JSON.parse(await fs.readFile(packageJsonPath, 'utf8'))
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
+      return undefined as never
+    }
+
+    throw error
+  }
 }
 
 async function writePackageJson(
@@ -20,6 +28,10 @@ async function writePackageJson(
 
 export async function ensureComponentProjectSkillsScript(projectRoot: string): Promise<void> {
   const packageJson = await readPackageJson(projectRoot)
+  if (!packageJson) {
+    return
+  }
+
   const scripts = (packageJson.scripts as Record<string, string> | undefined) ?? {}
 
   if (scripts[componentProjectSkillsScriptName] !== componentProjectSkillsScriptCommand) {
@@ -33,6 +45,10 @@ export async function ensureComponentProjectSkillsScript(projectRoot: string): P
 
 export async function removeComponentProjectSkillsScript(projectRoot: string): Promise<void> {
   const packageJson = await readPackageJson(projectRoot)
+  if (!packageJson) {
+    return
+  }
+
   const scripts = (packageJson.scripts as Record<string, string> | undefined) ?? {}
 
   if (scripts[componentProjectSkillsScriptName] !== componentProjectSkillsScriptCommand) {

package/src/lifecycle/postinstall.ts

@@ -40,6 +40,16 @@ export async function runComponentProjectPostinstall(
   const manifestPath = resolveComponentProjectGeneratedManifestPath(projectRoot)
   const components = await discoverComponentProjectComponents(projectRoot)
 
+  console.log('[component-project-helper] postinstall start')
+  console.log(`[component-project-helper] project root: ${projectRoot}`)
+  console.log(`[component-project-helper] docs dir: ${docsDir}`)
+  console.log(`[component-project-helper] manifest path: ${manifestPath}`)
+  console.log(
+    `[component-project-helper] discovered ${components.length} component(s): ${
+      components.map((component) => component.name).join(', ') || '(none)'
+    }`,
+  )
+
   await ensureDirectory(docsDir)
 
   const files: string[] = []
@@ -49,10 +59,20 @@ export async function runComponentProjectPostinstall(
     const markdown = renderComponentProjectMarkdown(component)
     await fs.writeFile(filePath, markdown, 'utf8')
     files.push(filePath)
+    console.log(
+      `[component-project-helper] wrote ${path.relative(projectRoot, filePath)} <- ${component.sourceFile}`,
+    )
   }
 
+  console.log(
+    `[component-project-helper] cleaning stale docs relative to manifest ${path.relative(
+      projectRoot,
+      manifestPath,
+    )}`,
+  )
   await removeStaleGeneratedFiles(manifestPath, files)
   await ensureComponentProjectSkillsScript(projectRoot)
+  console.log('[component-project-helper] ensured update-component-skills script')
 
   const manifest = ComponentProjectGeneratedManifestSchema.parse({
     projectRoot,
@@ -62,6 +82,9 @@ export async function runComponentProjectPostinstall(
   })
 
   await fs.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8')
+  console.log(
+    `[component-project-helper] postinstall complete, manifest files: ${files.length}`,
+  )
 }
 
 async function main(): Promise<void> {