@vibecuting/video-project-core 0.1.40 → 0.1.42

package/bin/vibecuting-lint-scenes.mjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+import process from 'node:process'
+
+import { lintSceneConvention } from '../src/lint/scene-convention-lint-runtime.mjs'
+
+function readArgValue(argv, flag) {
+  const index = argv.indexOf(flag)
+  return index >= 0 ? argv[index + 1] : null
+}
+
+function buildSourceRoots(profile) {
+  if (profile === 'video-project-core') {
+    return [
+      { sourceRoot: 'src/core/intro', titleRoot: 'core/intro', sharedFolderName: '_shared' },
+      { sourceRoot: 'src/core/outro', titleRoot: 'core/outro', sharedFolderName: '_shared' },
+      { sourceRoot: 'src/core/scene', titleRoot: 'core/scene', sharedFolderName: '_shared' },
+    ]
+  }
+
+  if (profile === 'component-project') {
+    return [
+      { sourceRoot: 'src/components', titleRoot: 'components', sharedFolderName: '_shared' },
+    ]
+  }
+
+  throw new Error(`Unknown scene lint profile: ${profile}`)
+}
+
+function main() {
+  const argv = process.argv.slice(2)
+  const fix = argv.includes('--fix')
+  const all = argv.includes('--all')
+
+  if (!all) {
+    process.exit(0)
+  }
+
+  const profile = readArgValue(argv, '--profile') ?? 'component-project'
+  const rootDir = readArgValue(argv, '--root') ?? process.cwd()
+
+  const result = lintSceneConvention({
+    rootDir,
+    sourceRoots: buildSourceRoots(profile),
+    fix,
+  })
+
+  if (result.errors.length > 0) {
+    console.error('Scene convention lint failed:')
+    for (const error of result.errors) {
+      console.error(`- ${error}`)
+    }
+    process.exit(1)
+  }
+
+  console.log(
+    `Scene convention lint passed for ${result.checkedSceneFolders.length} scene folder(s), ${result.checkedStoryFiles.length} story file(s).`,
+  )
+}
+
+main()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecuting/video-project-core",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
   "main": "src/index.ts",
@@ -9,7 +9,8 @@
     ".": "./src/index.ts",
     "./storybook": "./src/storybook/index.ts",
     "./storybook/remotion-preview": "./src/storybook/remotion-preview.tsx",
-    "./lint": "./src/lint/index.ts"
+    "./lint": "./src/lint/index.ts",
+    "./lint/runtime": "./src/lint/scene-convention-lint-runtime.mjs"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -19,13 +20,13 @@
     "dev": "storybook dev -p 6010 --host 0.0.0.0",
     "preview": "storybook dev -p 6010 --host 0.0.0.0",
     "build:storybook": "storybook build",
-    "lint": "node ../../../scripts/run-eslint.mjs src .storybook && node ../../../scripts/lint-vibecuting-scenes.mjs --all",
-    "lint:fix": "node ../../../scripts/run-eslint.mjs src .storybook --fix && node ../../../scripts/lint-vibecuting-scenes.mjs --all --fix",
+    "lint": "node ../../../scripts/run-eslint.mjs src .storybook && node bin/vibecuting-lint-scenes.mjs --profile video-project-core --all",
+    "lint:fix": "node ../../../scripts/run-eslint.mjs src .storybook --fix && node bin/vibecuting-lint-scenes.mjs --profile video-project-core --all --fix",
     "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit",
     "test": "pnpm exec vitest run"
   },
   "dependencies": {
-    "@vibecuting/component-project-helper": "0.1.40",
+    "@vibecuting/component-project-helper": "0.1.42",
     "@remotion/transitions": "4.0.473",
     "mermaid": "^11.12.2",
     "react": "^19.0.0",

package/src/lint/index.ts

@@ -1,2 +1,6 @@
 export { lintSceneConvention } from './scene-convention-lint'
-export type { SceneConventionLintOptions, SceneConventionLintResult } from './scene-convention-lint'
+export type {
+  SceneConventionLintOptions,
+  SceneConventionLintResult,
+  SceneConventionSourceRoot,
+} from './scene-convention-lint'

package/src/lint/scene-convention-lint-runtime.d.mts

@@ -0,0 +1,23 @@
+export type SceneConventionSourceRoot = {
+  sourceRoot: string
+  titleRoot: string
+  sharedFolderName?: string
+}
+
+export type SceneConventionLintOptions = {
+  rootDir: string
+  sourceRoot?: string
+  titleRoot?: string
+  checkedFolderPrefix?: string
+  sharedFolderName?: string
+  sourceRoots?: SceneConventionSourceRoot[]
+  fix?: boolean
+}
+
+export type SceneConventionLintResult = {
+  checkedSceneFolders: string[]
+  checkedStoryFiles: string[]
+  errors: string[]
+}
+
+export declare function lintSceneConvention(options: SceneConventionLintOptions): SceneConventionLintResult

package/src/lint/scene-convention-lint-runtime.mjs

@@ -0,0 +1,280 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+const toPosix = (value) => value.split(path.sep).join('/')
+
+function toRootRelative(rootDir, file) {
+  if (path.isAbsolute(file)) {
+    return toPosix(path.relative(rootDir, file))
+  }
+
+  return toPosix(file).replace(/^\.\//, '')
+}
+
+function resolveRootPath(rootDir, file) {
+  return path.resolve(rootDir, toRootRelative(rootDir, file))
+}
+
+function readText(rootDir, file) {
+  return fs.readFileSync(resolveRootPath(rootDir, file), 'utf8')
+}
+
+function writeText(rootDir, file, text) {
+  fs.writeFileSync(resolveRootPath(rootDir, file), text)
+}
+
+function readStoryTitle(text) {
+  const titleMatch = text.match(/const\s+meta\s*=\s*{[\s\S]*?title:\s*['"`]([^'"`]+)['"`]/m)
+  return titleMatch?.[1] ?? ''
+}
+
+function replaceStoryTitlePrefix(text, expectedPrefix) {
+  return text.replace(
+    /(const\s+meta\s*=\s*{[\s\S]*?title:\s*['"`])([^'"`]+)(['"`])/m,
+    (_match, before, currentTitle, after) => {
+      const titleLabel = currentTitle.includes('/') ? currentTitle.split('/').filter(Boolean).at(-1) : currentTitle
+      return `${before}${expectedPrefix}${titleLabel}${after}`
+    },
+  )
+}
+
+function collectFiles(rootDir, dir, suffix) {
+  const absoluteDir = resolveRootPath(rootDir, dir)
+  const results = []
+  const stack = [absoluteDir]
+
+  while (stack.length > 0) {
+    const current = stack.pop()
+    if (!current || !fs.existsSync(current)) {
+      continue
+    }
+
+    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+      const fullPath = path.join(current, entry.name)
+      if (entry.isDirectory()) {
+        stack.push(fullPath)
+        continue
+      }
+
+      if (entry.isFile() && entry.name.endsWith(suffix)) {
+        results.push(toRootRelative(rootDir, fullPath))
+      }
+    }
+  }
+
+  return results.sort()
+}
+
+function collectSceneFolders(rootDir, sourceRoot, sharedFolderName = '_shared', checkedFolderPrefix) {
+  const sourceRootPath = resolveRootPath(rootDir, sourceRoot)
+  const results = []
+  const stack = [sourceRootPath]
+
+  while (stack.length > 0) {
+    const current = stack.pop()
+    if (!current || !fs.existsSync(current)) {
+      continue
+    }
+
+    const entries = fs.readdirSync(current, { withFileTypes: true })
+    const slug = path.basename(current)
+    const relative = toRootRelative(rootDir, current)
+    const hasBaseScene = entries.some((entry) => entry.isFile() && entry.name === `${slug}.tsx`)
+    const isSharedFolder = relative.includes(`/${sharedFolderName}/`)
+    const matchesPrefix = !checkedFolderPrefix || slug.startsWith(checkedFolderPrefix)
+
+    if (hasBaseScene && !isSharedFolder && matchesPrefix) {
+      results.push(relative)
+      continue
+    }
+
+    for (const entry of entries) {
+      if (entry.isDirectory() && entry.name !== sharedFolderName) {
+        stack.push(path.join(current, entry.name))
+      }
+    }
+  }
+
+  return results.sort()
+}
+
+function lintSceneFolder(rootDir, folder) {
+  const slug = path.posix.basename(folder)
+  const errors = []
+  const requiredFiles = [
+    `${slug}.tsx`,
+    `${slug}-Landscape.tsx`,
+    `${slug}-Horizontal.tsx`,
+    `${slug}.stories.tsx`,
+    `${slug}.animated.stories.tsx`,
+    `${slug}-Horizontal.stories.tsx`,
+    `${slug}-Horizontal.animated.stories.tsx`,
+    `${slug}.test.tsx`,
+    'index.ts',
+  ]
+
+  for (const fileName of requiredFiles) {
+    const requiredPath = `${folder}/${fileName}`
+    if (!fs.existsSync(resolveRootPath(rootDir, requiredPath))) {
+      errors.push(`${folder}: missing ${fileName}`)
+    }
+  }
+
+  const filesToCheck = [
+    `${folder}/${slug}.tsx`,
+    `${folder}/${slug}-Landscape.tsx`,
+    `${folder}/${slug}-Horizontal.tsx`,
+  ]
+
+  for (const file of filesToCheck) {
+    if (!fs.existsSync(resolveRootPath(rootDir, file))) {
+      continue
+    }
+
+    const text = readText(rootDir, file)
+    const sourceFileMatch = text.match(/sourceFile:\s*['"`]([^'"`]+)['"`]/)
+    if (!sourceFileMatch) {
+      errors.push(`${file}: missing componentMetadata.sourceFile`)
+    } else if (sourceFileMatch[1] !== file) {
+      errors.push(`${file}: sourceFile must be "${file}", got "${sourceFileMatch[1]}"`)
+    }
+  }
+
+  const baseFile = `${folder}/${slug}.tsx`
+  if (fs.existsSync(resolveRootPath(rootDir, baseFile))) {
+    const text = readText(rootDir, baseFile)
+    if (!/defineSceneComponent\s*\(/.test(text)) {
+      errors.push(`${baseFile}: base scene must use defineSceneComponent(...)`)
+    }
+    if (!/propsSchema:\s*z\.object\s*\(/.test(text)) {
+      errors.push(`${baseFile}: base scene must colocate propsSchema with z.object(...)`)
+    }
+    if (!/useRemotionSceneRuntime\s*\(/.test(text)) {
+      errors.push(`${baseFile}: base scene must use useRemotionSceneRuntime()`)
+    }
+    if (!/SceneMotionLayer|SceneMotionStack|useSceneMotion/.test(text)) {
+      errors.push(`${baseFile}: scene animation must use SceneMotionLayer, SceneMotionStack, or useSceneMotion`)
+    }
+  }
+
+  const landscapeFile = `${folder}/${slug}-Landscape.tsx`
+  if (
+    fs.existsSync(resolveRootPath(rootDir, landscapeFile)) &&
+    !/aspectRatio:\s*['"]16:9['"]/.test(readText(rootDir, landscapeFile))
+  ) {
+    errors.push(`${landscapeFile}: Landscape variant must set aspectRatio: '16:9'`)
+  }
+
+  const horizontalFile = `${folder}/${slug}-Horizontal.tsx`
+  if (
+    fs.existsSync(resolveRootPath(rootDir, horizontalFile)) &&
+    !/aspectRatio:\s*['"]9:16['"]/.test(readText(rootDir, horizontalFile))
+  ) {
+    errors.push(`${horizontalFile}: Horizontal variant must set aspectRatio: '9:16'`)
+  }
+
+  return errors
+}
+
+function lintStoryFile(rootDir, sourceRoot, titleRoot, storyFile, fix = false) {
+  const normalized = toRootRelative(rootDir, storyFile)
+  const text = readText(rootDir, normalized)
+  const errors = []
+  const storyDir = path.posix.dirname(normalized.slice(`${sourceRoot}/`.length))
+  const expectedPrefix = `${titleRoot}/${storyDir}/`
+  const title = readStoryTitle(text)
+  const isAnimatedStory = normalized.endsWith('.animated.stories.tsx')
+  const isHorizontalStory = /-Horizontal(\.animated)?\.stories\.tsx$/.test(normalized)
+  const isLandscapeStory = !isHorizontalStory
+
+  if (!title.startsWith(expectedPrefix)) {
+    if (fix) {
+      writeText(rootDir, normalized, replaceStoryTitlePrefix(text, expectedPrefix))
+    } else {
+      errors.push(`${normalized}: story title must start with "${expectedPrefix}"`)
+    }
+  }
+
+  if (isAnimatedStory && !/scenePreviewMode:\s*['"]animation['"]/.test(text)) {
+    errors.push(`${normalized}: animated stories must set scenePreviewMode: 'animation'`)
+  }
+
+  if (isLandscapeStory && !/scenePreviewAspectRatio:\s*['"]16:9['"]/.test(text)) {
+    errors.push(`${normalized}: landscape stories must set scenePreviewAspectRatio: '16:9'`)
+  }
+
+  if (isHorizontalStory && !/scenePreviewAspectRatio:\s*['"]9:16['"]/.test(text)) {
+    errors.push(`${normalized}: horizontal stories must set scenePreviewAspectRatio: '9:16'`)
+  }
+
+  return errors
+}
+
+function lintSharedFolder(rootDir, sourceRoot, sharedFolderName = '_shared') {
+  const sharedRoot = `${sourceRoot}/${sharedFolderName}`
+  const sharedRootPath = resolveRootPath(rootDir, sharedRoot)
+  const errors = []
+
+  if (!fs.existsSync(sharedRootPath)) {
+    return errors
+  }
+
+  for (const file of collectFiles(rootDir, sharedRoot, '.tsx')) {
+    const text = readText(rootDir, file)
+    if (/componentMetadata|defineComponentProjectComponentMetadata|defineScenePluginMetadata/.test(text)) {
+      errors.push(`${file}: shared files must not declare publishable component metadata`)
+    }
+  }
+
+  return errors
+}
+
+function normalizeSourceRoots(options) {
+  if (Array.isArray(options.sourceRoots) && options.sourceRoots.length > 0) {
+    return options.sourceRoots
+  }
+
+  if (options.sourceRoot && options.titleRoot) {
+    return [
+      {
+        sourceRoot: options.sourceRoot,
+        titleRoot: options.titleRoot,
+        sharedFolderName: options.sharedFolderName,
+      },
+    ]
+  }
+
+  return []
+}
+
+export function lintSceneConvention(options) {
+  const sourceRoots = normalizeSourceRoots(options)
+  const checkedSceneFolders = []
+  const checkedStoryFiles = []
+  const errors = []
+
+  for (const rootConfig of sourceRoots) {
+    const sharedFolderName = rootConfig.sharedFolderName ?? '_shared'
+    const sceneFolders = collectSceneFolders(
+      options.rootDir,
+      rootConfig.sourceRoot,
+      sharedFolderName,
+      options.checkedFolderPrefix,
+    )
+    const storyFiles = collectFiles(options.rootDir, rootConfig.sourceRoot, '.stories.tsx').filter(
+      (file) => !file.includes(`/${sharedFolderName}/`),
+    )
+
+    checkedSceneFolders.push(...sceneFolders)
+    checkedStoryFiles.push(...storyFiles)
+    errors.push(...sceneFolders.flatMap((folder) => lintSceneFolder(options.rootDir, folder)))
+    errors.push(...storyFiles.flatMap((file) => lintStoryFile(options.rootDir, rootConfig.sourceRoot, rootConfig.titleRoot, file, options.fix)))
+    errors.push(...lintSharedFolder(options.rootDir, rootConfig.sourceRoot, sharedFolderName))
+  }
+
+  return {
+    checkedSceneFolders: checkedSceneFolders.sort(),
+    checkedStoryFiles: checkedStoryFiles.sort(),
+    errors,
+  }
+}

package/src/lint/scene-convention-lint.test.ts

@@ -6,79 +6,103 @@ import { describe, expect, it } from 'vitest'
 
 import { lintSceneConvention } from './scene-convention-lint'
 
-function writeSceneFixture(rootDir: string) {
-  const folder = path.join(rootDir, 'src/components/default-component-scene')
-  const sharedFolder = path.join(rootDir, 'src/components/_shared')
+function sceneNameFromSlug(slug: string): string {
+  return slug
+    .split(/[-/]/)
+    .filter(Boolean)
+    .map((part) => `${part[0].toUpperCase()}${part.slice(1)}`)
+    .join('')
+}
+
+function writeSceneFixture(rootDir: string, relativeFolder: string, sourceRoot: string, titleRoot: string) {
+  const folder = path.join(rootDir, relativeFolder)
+  const slug = path.basename(relativeFolder)
+  const sharedFolder = path.join(rootDir, sourceRoot, '_shared')
   fs.mkdirSync(folder, { recursive: true })
   fs.mkdirSync(sharedFolder, { recursive: true })
 
   fs.writeFileSync(
-    path.join(folder, 'default-component-scene.tsx'),
+    path.join(folder, `${slug}.tsx`),
     [
       "import { z } from 'zod'",
-      "export const componentMetadata = { sourceFile: 'src/components/default-component-scene/default-component-scene.tsx' }",
-      "export const DefaultComponentScene = defineSceneComponent({ propsSchema: z.object({ title: z.string() }), component: function DefaultComponentScene() { useRemotionSceneRuntime(); return <SceneMotionLayer /> } })",
+      `export const componentMetadata = { sourceFile: '${relativeFolder}/${slug}.tsx' }`,
+      `export const ${sceneNameFromSlug(slug)} = defineSceneComponent({ propsSchema: z.object({ title: z.string() }), component: function ${sceneNameFromSlug(slug)}() { useRemotionSceneRuntime(); return <SceneMotionLayer /> } })`,
       '',
     ].join('\n'),
   )
   fs.writeFileSync(
-    path.join(folder, 'default-component-scene-Landscape.tsx'),
-    "export const componentMetadata = { sourceFile: 'src/components/default-component-scene/default-component-scene-Landscape.tsx', aspectRatio: '16:9' }\n",
+    path.join(folder, `${slug}-Landscape.tsx`),
+    `export const componentMetadata = { sourceFile: '${relativeFolder}/${slug}-Landscape.tsx', aspectRatio: '16:9' }\n`,
   )
   fs.writeFileSync(
-    path.join(folder, 'default-component-scene-Horizontal.tsx'),
-    "export const componentMetadata = { sourceFile: 'src/components/default-component-scene/default-component-scene-Horizontal.tsx', aspectRatio: '9:16' }\n",
+    path.join(folder, `${slug}-Horizontal.tsx`),
+    `export const componentMetadata = { sourceFile: '${relativeFolder}/${slug}-Horizontal.tsx', aspectRatio: '9:16' }\n`,
   )
   fs.writeFileSync(
-    path.join(folder, 'default-component-scene.stories.tsx'),
-    "const meta = { title: 'components/default-component-scene/DefaultComponentSceneLandscape' }\nexport default meta\nexport const Default = { parameters: { scenePreviewAspectRatio: '16:9' } }\n",
+    path.join(folder, `${slug}.stories.tsx`),
+    `const meta = { title: '${titleRoot}/${relativeFolder.replace(`${sourceRoot}/`, '')}/SceneLandscape' }\nexport default meta\nexport const Default = { parameters: { scenePreviewAspectRatio: '16:9' } }\n`,
   )
   fs.writeFileSync(
-    path.join(folder, 'default-component-scene.animated.stories.tsx'),
-    "const meta = { title: 'components/default-component-scene/DefaultComponentSceneLandscape' }\nexport default meta\nexport const Animated = { parameters: { scenePreviewAspectRatio: '16:9', scenePreviewMode: 'animation' } }\n",
+    path.join(folder, `${slug}.animated.stories.tsx`),
+    `const meta = { title: '${titleRoot}/${relativeFolder.replace(`${sourceRoot}/`, '')}/SceneLandscape' }\nexport default meta\nexport const Animated = { parameters: { scenePreviewAspectRatio: '16:9', scenePreviewMode: 'animation' } }\n`,
   )
   fs.writeFileSync(
-    path.join(folder, 'default-component-scene-Horizontal.stories.tsx'),
-    "const meta = { title: 'components/default-component-scene/DefaultComponentSceneHorizontal' }\nexport default meta\nexport const Default = { parameters: { scenePreviewAspectRatio: '9:16' } }\n",
+    path.join(folder, `${slug}-Horizontal.stories.tsx`),
+    `const meta = { title: '${titleRoot}/${relativeFolder.replace(`${sourceRoot}/`, '')}/SceneHorizontal' }\nexport default meta\nexport const Default = { parameters: { scenePreviewAspectRatio: '9:16' } }\n`,
   )
   fs.writeFileSync(
-    path.join(folder, 'default-component-scene-Horizontal.animated.stories.tsx'),
-    "const meta = { title: 'components/default-component-scene/DefaultComponentSceneHorizontal' }\nexport default meta\nexport const Animated = { parameters: { scenePreviewAspectRatio: '9:16', scenePreviewMode: 'animation' } }\n",
+    path.join(folder, `${slug}-Horizontal.animated.stories.tsx`),
+    `const meta = { title: '${titleRoot}/${relativeFolder.replace(`${sourceRoot}/`, '')}/SceneHorizontal' }\nexport default meta\nexport const Animated = { parameters: { scenePreviewAspectRatio: '9:16', scenePreviewMode: 'animation' } }\n`,
   )
-  fs.writeFileSync(path.join(folder, 'default-component-scene.test.tsx'), "import test from 'node:test'\ntest('ok', () => {})\n")
-  fs.writeFileSync(path.join(folder, 'index.ts'), "export * from './default-component-scene'\n")
+  fs.writeFileSync(path.join(folder, `${slug}.test.tsx`), "import test from 'node:test'\ntest('ok', () => {})\n")
+  fs.writeFileSync(path.join(folder, 'index.ts'), `export * from './${slug}'\n`)
   fs.writeFileSync(path.join(sharedFolder, 'scene-frame.tsx'), 'export function SceneFrame() { return null }\n')
 }
 
 describe('scene convention lint', () => {
-  it('passes on the expected folder structure', () => {
+  it('passes on the expected component folder structure', () => {
     const rootDir = fs.mkdtempSync(path.join(os.tmpdir(), 'scene-convention-lint-'))
-    writeSceneFixture(rootDir)
+    writeSceneFixture(rootDir, 'src/components/default-component-scene', 'src/components', 'components')
 
     const result = lintSceneConvention({
       rootDir,
-      sourceRoot: 'src/components',
-      titleRoot: 'components',
-      sharedFolderName: '_shared',
+      sourceRoots: [
+        { sourceRoot: 'src/components', titleRoot: 'components', sharedFolderName: '_shared' },
+      ],
     })
 
     expect(result.errors).toEqual([])
     expect(result.checkedSceneFolders).toContain('src/components/default-component-scene')
   })
 
+  it('finds nested core scene folders recursively', () => {
+    const rootDir = fs.mkdtempSync(path.join(os.tmpdir(), 'scene-convention-lint-nested-'))
+    writeSceneFixture(rootDir, 'src/core/scene/slide/gallery/default-gallery-slide', 'src/core/scene', 'core/scene')
+
+    const result = lintSceneConvention({
+      rootDir,
+      sourceRoots: [
+        { sourceRoot: 'src/core/scene', titleRoot: 'core/scene', sharedFolderName: '_shared' },
+      ],
+    })
+
+    expect(result.errors).toEqual([])
+    expect(result.checkedSceneFolders).toContain('src/core/scene/slide/gallery/default-gallery-slide')
+  })
+
   it('reports missing animation mode', () => {
     const rootDir = fs.mkdtempSync(path.join(os.tmpdir(), 'scene-convention-lint-missing-animation-'))
-    writeSceneFixture(rootDir)
+    writeSceneFixture(rootDir, 'src/components/default-component-scene', 'src/components', 'components')
     fs.writeFileSync(
       path.join(rootDir, 'src/components/default-component-scene/default-component-scene.animated.stories.tsx'),
-      "const meta = { title: 'components/default-component-scene/DefaultComponentSceneLandscape' }\nexport default meta\nexport const Animated = { parameters: { scenePreviewAspectRatio: '16:9' } }\n",
+      "const meta = { title: 'components/default-component-scene/SceneLandscape' }\nexport default meta\nexport const Animated = { parameters: { scenePreviewAspectRatio: '16:9' } }\n",
     )
 
     const result = lintSceneConvention({
       rootDir,
-      sourceRoot: 'src/components',
-      titleRoot: 'components',
-      sharedFolderName: '_shared',
+      sourceRoots: [
+        { sourceRoot: 'src/components', titleRoot: 'components', sharedFolderName: '_shared' },
+      ],
     })
 
     expect(result.errors.some((error) => error.includes("scenePreviewMode: 'animation'"))).toBe(true)

package/src/lint/scene-convention-lint.ts

@@ -1,247 +1,6 @@
-import fs from 'node:fs'
-import path from 'node:path'
-
-export type SceneConventionLintOptions = {
-  rootDir: string
-  sourceRoot: string
-  titleRoot: string
-  checkedFolderPrefix?: string
-  sharedFolderName?: string
-  fix?: boolean
-}
-
-export type SceneConventionLintResult = {
-  checkedSceneFolders: string[]
-  checkedStoryFiles: string[]
-  errors: string[]
-}
-
-const toPosix = (value: string) => value.split(path.sep).join('/')
-
-function toRootRelative(rootDir: string, file: string) {
-  if (path.isAbsolute(file)) {
-    return toPosix(path.relative(rootDir, file))
-  }
-
-  return toPosix(file).replace(/^\.\//, '')
-}
-
-function resolveRootPath(rootDir: string, file: string) {
-  return path.resolve(rootDir, toRootRelative(rootDir, file))
-}
-
-function readText(rootDir: string, file: string) {
-  return fs.readFileSync(resolveRootPath(rootDir, file), 'utf8')
-}
-
-function writeText(rootDir: string, file: string, text: string) {
-  fs.writeFileSync(resolveRootPath(rootDir, file), text)
-}
-
-function readStoryTitle(text: string) {
-  const titleMatch = text.match(/const\s+meta\s*=\s*{[\s\S]*?title:\s*['"`]([^'"`]+)['"`]/m)
-  return titleMatch?.[1] ?? ''
-}
-
-function replaceStoryTitlePrefix(text: string, expectedPrefix: string) {
-  return text.replace(
-    /(const\s+meta\s*=\s*{[\s\S]*?title:\s*['"`])([^'"`]+)(['"`])/m,
-    (_match, before: string, currentTitle: string, after: string) => {
-      const titleLabel = currentTitle.includes('/') ? currentTitle.split('/').filter(Boolean).at(-1) : currentTitle
-      return `${before}${expectedPrefix}${titleLabel}${after}`
-    },
-  )
-}
-
-function collectFiles(rootDir: string, dir: string, suffix: string) {
-  const absoluteDir = resolveRootPath(rootDir, dir)
-  const results: string[] = []
-  const stack = [absoluteDir]
-
-  while (stack.length > 0) {
-    const current = stack.pop()
-    if (!current || !fs.existsSync(current)) {
-      continue
-    }
-
-    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
-      const fullPath = path.join(current, entry.name)
-      if (entry.isDirectory()) {
-        stack.push(fullPath)
-        continue
-      }
-      if (entry.isFile() && entry.name.endsWith(suffix)) {
-        results.push(toRootRelative(rootDir, fullPath))
-      }
-    }
-  }
-
-  return results.sort()
-}
-
-function collectSceneFolders(options: SceneConventionLintOptions) {
-  const sourceRootPath = resolveRootPath(options.rootDir, options.sourceRoot)
-  const sharedFolderName = options.sharedFolderName ?? '_shared'
-
-  if (!fs.existsSync(sourceRootPath)) {
-    return []
-  }
-
-  return fs
-    .readdirSync(sourceRootPath, { withFileTypes: true })
-    .filter((entry) => entry.isDirectory())
-    .filter((entry) => entry.name !== sharedFolderName)
-    .filter((entry) => !options.checkedFolderPrefix || entry.name.startsWith(options.checkedFolderPrefix))
-    .map((entry) => toRootRelative(options.rootDir, path.join(sourceRootPath, entry.name)))
-    .sort()
-}
-
-function lintSceneFolder(options: SceneConventionLintOptions, folder: string) {
-  const slug = path.posix.basename(folder)
-  const errors: string[] = []
-  const requiredFiles = [
-    `${slug}.tsx`,
-    `${slug}-Landscape.tsx`,
-    `${slug}-Horizontal.tsx`,
-    `${slug}.stories.tsx`,
-    `${slug}.animated.stories.tsx`,
-    `${slug}-Horizontal.stories.tsx`,
-    `${slug}-Horizontal.animated.stories.tsx`,
-    `${slug}.test.tsx`,
-    'index.ts',
-  ]
-
-  for (const fileName of requiredFiles) {
-    const requiredPath = `${folder}/${fileName}`
-    if (!fs.existsSync(resolveRootPath(options.rootDir, requiredPath))) {
-      errors.push(`${folder}: missing ${fileName}`)
-    }
-  }
-
-  const filesToCheck = [
-    `${folder}/${slug}.tsx`,
-    `${folder}/${slug}-Landscape.tsx`,
-    `${folder}/${slug}-Horizontal.tsx`,
-  ]
-
-  for (const file of filesToCheck) {
-    if (!fs.existsSync(resolveRootPath(options.rootDir, file))) {
-      continue
-    }
-
-    const text = readText(options.rootDir, file)
-    const sourceFileMatch = text.match(/sourceFile:\s*['"`]([^'"`]+)['"`]/)
-    if (!sourceFileMatch) {
-      errors.push(`${file}: missing componentMetadata.sourceFile`)
-    } else if (sourceFileMatch[1] !== file) {
-      errors.push(`${file}: sourceFile must be "${file}", got "${sourceFileMatch[1]}"`)
-    }
-  }
-
-  const baseFile = `${folder}/${slug}.tsx`
-  if (fs.existsSync(resolveRootPath(options.rootDir, baseFile))) {
-    const text = readText(options.rootDir, baseFile)
-    if (!/defineSceneComponent\s*\(/.test(text)) {
-      errors.push(`${baseFile}: base scene must use defineSceneComponent(...)`)
-    }
-    if (!/propsSchema:\s*z\.object\s*\(/.test(text)) {
-      errors.push(`${baseFile}: base scene must colocate propsSchema with z.object(...)`)
-    }
-    if (!/useRemotionSceneRuntime\s*\(/.test(text)) {
-      errors.push(`${baseFile}: base scene must use useRemotionSceneRuntime()`)
-    }
-    if (!/SceneMotionLayer|SceneMotionStack|useSceneMotion/.test(text)) {
-      errors.push(`${baseFile}: scene animation must use SceneMotionLayer, SceneMotionStack, or useSceneMotion`)
-    }
-  }
-
-  const landscapeFile = `${folder}/${slug}-Landscape.tsx`
-  if (
-    fs.existsSync(resolveRootPath(options.rootDir, landscapeFile)) &&
-    !/aspectRatio:\s*['"]16:9['"]/.test(readText(options.rootDir, landscapeFile))
-  ) {
-    errors.push(`${landscapeFile}: Landscape variant must set aspectRatio: '16:9'`)
-  }
-
-  const horizontalFile = `${folder}/${slug}-Horizontal.tsx`
-  if (
-    fs.existsSync(resolveRootPath(options.rootDir, horizontalFile)) &&
-    !/aspectRatio:\s*['"]9:16['"]/.test(readText(options.rootDir, horizontalFile))
-  ) {
-    errors.push(`${horizontalFile}: Horizontal variant must set aspectRatio: '9:16'`)
-  }
-
-  return errors
-}
-
-function lintStoryFile(options: SceneConventionLintOptions, storyFile: string) {
-  const normalized = toRootRelative(options.rootDir, storyFile)
-  const text = readText(options.rootDir, normalized)
-  const errors: string[] = []
-  const storyDir = path.posix.dirname(normalized.slice(`${options.sourceRoot}/`.length))
-  const expectedPrefix = `${options.titleRoot}/${storyDir}/`
-  const title = readStoryTitle(text)
-  const isAnimatedStory = normalized.endsWith('.animated.stories.tsx')
-  const isHorizontalStory = /-Horizontal(\.animated)?\.stories\.tsx$/.test(normalized)
-  const isLandscapeStory = !isHorizontalStory
-
-  if (!title.startsWith(expectedPrefix)) {
-    if (options.fix) {
-      writeText(options.rootDir, normalized, replaceStoryTitlePrefix(text, expectedPrefix))
-    } else {
-      errors.push(`${normalized}: story title must start with "${expectedPrefix}"`)
-    }
-  }
-
-  if (isAnimatedStory && !/scenePreviewMode:\s*['"]animation['"]/.test(text)) {
-    errors.push(`${normalized}: animated stories must set scenePreviewMode: 'animation'`)
-  }
-
-  if (isLandscapeStory && !/scenePreviewAspectRatio:\s*['"]16:9['"]/.test(text)) {
-    errors.push(`${normalized}: landscape stories must set scenePreviewAspectRatio: '16:9'`)
-  }
-
-  if (isHorizontalStory && !/scenePreviewAspectRatio:\s*['"]9:16['"]/.test(text)) {
-    errors.push(`${normalized}: horizontal stories must set scenePreviewAspectRatio: '9:16'`)
-  }
-
-  return errors
-}
-
-function lintSharedFolder(options: SceneConventionLintOptions) {
-  const sharedFolderName = options.sharedFolderName ?? '_shared'
-  const sharedRoot = `${options.sourceRoot}/${sharedFolderName}`
-  const sharedRootPath = resolveRootPath(options.rootDir, sharedRoot)
-  const errors: string[] = []
-
-  if (!fs.existsSync(sharedRootPath)) {
-    return errors
-  }
-
-  for (const file of collectFiles(options.rootDir, sharedRoot, '.tsx')) {
-    const text = readText(options.rootDir, file)
-    if (/componentMetadata|defineComponentProjectComponentMetadata|defineScenePluginMetadata/.test(text)) {
-      errors.push(`${file}: shared files must not declare publishable component metadata`)
-    }
-  }
-
-  return errors
-}
-
-export function lintSceneConvention(options: SceneConventionLintOptions): SceneConventionLintResult {
-  const sceneFolders = collectSceneFolders(options)
-  const storyFiles = collectFiles(options.rootDir, options.sourceRoot, '.stories.tsx').filter(
-    (file) => !file.includes(`/${options.sharedFolderName ?? '_shared'}/`),
-  )
-  const errors = [
-    ...sceneFolders.flatMap((folder) => lintSceneFolder(options, folder)),
-    ...storyFiles.flatMap((file) => lintStoryFile(options, file)),
-    ...lintSharedFolder(options),
-  ]
-
-  return {
-    checkedSceneFolders: sceneFolders,
-    checkedStoryFiles: storyFiles,
-    errors,
-  }
-}
+export { lintSceneConvention } from './scene-convention-lint-runtime.mjs'
+export type {
+  SceneConventionLintOptions,
+  SceneConventionLintResult,
+  SceneConventionSourceRoot,
+} from './scene-convention-lint-runtime.mjs'