@vibecuting/component-project-helper 0.1.8 → 0.1.10

package/README.md

@@ -10,7 +10,7 @@ NPM 地址：
 
 - 作为可发布的 npm 包承载组件工程辅助逻辑。
 - 提供组件注解、schema、发现器、Markdown 生成和安装期生命周期逻辑。
-- 安装时扫描 `src/components/**/*.tsx`，把组件元数据生成到 `.agents/skills/project-allow-component/components/`。
+- 安装时扫描 `src/components/**/*.tsx`、`src/video/chapters/**/*.tsx` 以及 `node_modules/@vibecuting/*/src/**/*.tsx`，把组件元数据生成到 `.agents/skills/project-allow-component/components/`。
 - 通过 `postinstall` / `preuninstall` 维护生成文件和清理清单。
 - 安装时会给宿主工程的 `package.json` 补上 `update-component-skills`，它会调用同一套 `postinstall` 逻辑。
 - 宿主工程也可以直接运行 `pnpm update-component-skills` 手动刷新同一套生成结果。

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@vibecuting/component-project-helper",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "type": "module",
+  "license": "SEE LICENSE IN LICENSE",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "exports": {

package/scripts/discover-components.mjs

@@ -97,6 +97,38 @@ async function collectComponentSourceFiles(directory) {
   return files
 }
 
+async function collectNamespacedPackageSourceFiles(projectRoot) {
+  const namespaceRoot = path.join(projectRoot, 'node_modules', '@vibecuting')
+  let entries = []
+
+  try {
+    entries = await fs.readdir(namespaceRoot, { withFileTypes: true })
+  } catch {
+    return []
+  }
+
+  const packageRoots = entries
+    .filter((entry) => entry.isDirectory() || entry.isSymbolicLink())
+    .map((entry) => path.join(namespaceRoot, entry.name, 'src'))
+
+  const files = await Promise.all(packageRoots.map((directory) => collectComponentSourceFiles(directory)))
+  return [...new Set(files.flat())]
+}
+
+async function collectDiscoverableSourceFiles(projectRoot) {
+  const sourceRoots = [
+    path.join(projectRoot, 'src', 'components'),
+    path.join(projectRoot, 'src', 'video', 'chapters'),
+  ]
+
+  const localFiles = await Promise.all(
+    sourceRoots.map((directory) => collectComponentSourceFiles(directory)),
+  )
+  const packageFiles = await collectNamespacedPackageSourceFiles(projectRoot)
+
+  return [...new Set([...localFiles.flat(), ...packageFiles])]
+}
+
 function readMetadataFromSource(source) {
   const decoratorMatch = /@VideoComponent\s*\((\{[\s\S]*?\})\)/m.exec(source)
   if (decoratorMatch) {
@@ -135,9 +167,8 @@ function readMetadataFromSource(source) {
 }
 
 export async function discoverComponentProjectComponents(projectRoot) {
-  const componentsDir = path.join(projectRoot, 'src', 'components')
   const discovered = []
-  const sourceFiles = await collectComponentSourceFiles(componentsDir)
+  const sourceFiles = await collectDiscoverableSourceFiles(projectRoot)
 
   for (const absolutePath of sourceFiles) {
     const source = await fs.readFile(absolutePath, 'utf8')

package/src/discovery/index.test.ts

@@ -68,3 +68,86 @@ test('discovers decorated components recursively', async () => {
     },
   ])
 })
+
+test('discovers decorated components from installed video-project-core', async () => {
+  const projectRoot = await fs.mkdtemp(path.join(tmpdir(), 'component-project-helper-package-'))
+  const videoProjectCoreComponentDir = path.join(
+    projectRoot,
+    'node_modules',
+    '@vibecuting',
+    'video-project-core',
+    'src',
+    'core',
+    'intro',
+  )
+  await fs.mkdir(videoProjectCoreComponentDir, { recursive: true })
+
+  await fs.writeFile(
+    path.join(videoProjectCoreComponentDir, 'DefaultIntroBumper.tsx'),
+    `
+      @VideoComponent({
+        name: 'DefaultIntroBumper',
+        description: 'Default remotion intro bumper',
+        sourceFile: 'node_modules/@vibecuting/video-project-core/src/core/intro/DefaultIntroBumper.tsx',
+        aspectRatio: '16:9',
+        sceneType: 'intro',
+        tags: ['intro', 'core'],
+        propsTypeName: 'DefaultIntroBumperProps',
+      })
+      export const DefaultIntroBumper = () => null
+    `,
+    'utf8',
+  )
+
+  const videoProjectHelperComponentDir = path.join(
+    projectRoot,
+    'node_modules',
+    '@vibecuting',
+    'video-project-helper',
+    'src',
+    'core',
+    'scene',
+  )
+  await fs.mkdir(videoProjectHelperComponentDir, { recursive: true })
+
+  await fs.writeFile(
+    path.join(videoProjectHelperComponentDir, 'DefaultSceneFrame.tsx'),
+    `
+      @VideoComponent({
+        name: 'DefaultSceneFrame',
+        description: 'Default helper scene frame',
+        sourceFile: 'node_modules/@vibecuting/video-project-helper/src/core/scene/DefaultSceneFrame.tsx',
+        aspectRatio: '16:9',
+        sceneType: 'scene',
+        tags: ['scene', 'helper'],
+        propsTypeName: 'DefaultSceneFrameProps',
+      })
+      export const DefaultSceneFrame = () => null
+    `,
+    'utf8',
+  )
+
+  const discovered = await discoverComponentProjectComponents(projectRoot)
+
+  expect(discovered).toEqual([
+    {
+      name: 'DefaultIntroBumper',
+      description: 'Default remotion intro bumper',
+      sourceFile: 'node_modules/@vibecuting/video-project-core/src/core/intro/DefaultIntroBumper.tsx',
+      aspectRatio: '16:9',
+      sceneType: 'intro',
+      tags: ['intro', 'core'],
+      propsTypeName: 'DefaultIntroBumperProps',
+    },
+    {
+      name: 'DefaultSceneFrame',
+      description: 'Default helper scene frame',
+      sourceFile:
+        'node_modules/@vibecuting/video-project-helper/src/core/scene/DefaultSceneFrame.tsx',
+      aspectRatio: '16:9',
+      sceneType: 'scene',
+      tags: ['scene', 'helper'],
+      propsTypeName: 'DefaultSceneFrameProps',
+    },
+  ])
+})

package/src/discovery/index.ts

@@ -44,6 +44,38 @@ async function collectComponentSourceFiles(directory: string): Promise<string[]>
   return files
 }
 
+async function collectNamespacedPackageSourceFiles(projectRoot: string): Promise<string[]> {
+  const namespaceRoot = path.join(projectRoot, 'node_modules', '@vibecuting')
+  let entries: Dirent[] = []
+
+  try {
+    entries = await fs.readdir(namespaceRoot, { withFileTypes: true })
+  } catch {
+    return []
+  }
+
+  const packageRoots = entries
+    .filter((entry) => entry.isDirectory() || entry.isSymbolicLink())
+    .map((entry) => path.join(namespaceRoot, entry.name, 'src'))
+
+  const files = await Promise.all(packageRoots.map((directory) => collectComponentSourceFiles(directory)))
+  return [...new Set(files.flat())]
+}
+
+async function collectDiscoverableSourceFiles(projectRoot: string): Promise<string[]> {
+  const sourceRoots = [
+    path.join(projectRoot, 'src', 'components'),
+    path.join(projectRoot, 'src', 'video', 'chapters'),
+  ]
+
+  const localFiles = await Promise.all(
+    sourceRoots.map((directory) => collectComponentSourceFiles(directory)),
+  )
+  const packageFiles = await collectNamespacedPackageSourceFiles(projectRoot)
+
+  return [...new Set([...localFiles.flat(), ...packageFiles])]
+}
+
 function extractBalancedObjectLiteral(source: string, startIndex: number): string | undefined {
   let depth = 0
   let inString = false
@@ -143,9 +175,8 @@ function readMetadataFromSource(source: string): ComponentProjectComponentMetada
 export async function discoverComponentProjectComponents(
   projectRoot: string,
 ): Promise<ComponentProjectComponentDiscovery[]> {
-  const componentsDir = path.join(projectRoot, 'src', 'components')
   const discovered: ComponentProjectComponentDiscovery[] = []
-  const sourceFiles = await collectComponentSourceFiles(componentsDir)
+  const sourceFiles = await collectDiscoverableSourceFiles(projectRoot)
 
   for (const absolutePath of sourceFiles) {
     const source = await fs.readFile(absolutePath, 'utf8')