@vibecuting/component-project-helper 0.1.136 → 0.1.137

package/package.json

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

package/src/decorators/index.ts

@@ -8,6 +8,7 @@ import {
   VIDEO_RESOURCE_METADATA_KEY,
   createVideoResourceAnnotation,
   defineScenePluginMetadata as defineScenePluginMetadataBase,
+  inferSceneMotion,
   defineThemePluginMetadata as defineThemePluginMetadataBase,
   defineTransitionPluginMetadata as defineTransitionPluginMetadataBase,
   getVideoResourceMetadata,
@@ -31,7 +32,11 @@ export type ComponentProjectComponentMetadata = LegacyComponentProjectComponentM
 export function defineComponentProjectComponentMetadata(
   metadata: ComponentProjectComponentMetadata,
 ): ComponentProjectComponentMetadata {
-  return ComponentProjectComponentMetadataSchema.parse(metadata) as ComponentProjectComponentMetadata
+  const parsed = ComponentProjectComponentMetadataSchema.parse(metadata)
+  return {
+    ...parsed,
+    motion: parsed.motion ?? inferSceneMotion(parsed),
+  } as ComponentProjectComponentMetadata
 }
 
 const sceneAnnotation = createVideoResourceAnnotation(sceneResourceDescriptor)
@@ -42,7 +47,7 @@ function normalizeSceneMetadata(
   metadata: ComponentProjectComponentMetadata | ScenePluginMetadata,
 ): ScenePluginMetadata {
   if ('resourceKind' in metadata) {
-    return ScenePluginMetadataSchema.parse(metadata)
+    return defineScenePluginMetadataBase(metadata)
   }
 
   return ScenePluginMetadataSchema.parse({
@@ -52,6 +57,7 @@ function normalizeSceneMetadata(
     sourceFile: metadata.sourceFile,
     aspectRatio: metadata.aspectRatio,
     sceneType: metadata.sceneType,
+    motion: inferSceneMotion(metadata),
     sceneFamily: 'custom',
     themePreset: undefined,
     slots: undefined,
@@ -71,6 +77,7 @@ export const TransitionComponent = transitionAnnotation.annotate
 export const ThemeComponent = themeAnnotation.annotate
 
 export const defineScenePluginMetadata = defineScenePluginMetadataBase
+export { inferSceneMotion }
 export const defineTransitionPluginMetadata = defineTransitionPluginMetadataBase
 export const defineThemePluginMetadata = defineThemePluginMetadataBase
 

package/src/discovery/index.ts

@@ -10,6 +10,8 @@ import {
   type TransitionPluginMetadata,
   type VideoResourceDescriptor,
   type VideoResourceMetadata,
+  defineScenePluginMetadata,
+  inferSceneMotion,
   ScenePluginMetadataSchema,
 } from '../resources/video-resource.ts'
 import {
@@ -358,7 +360,13 @@ function collectMetadataVariables(sourceFile: ts.SourceFile): Map<string, ts.Exp
 function normalizeSceneMetadata(value: unknown, filePath: string): ScenePluginMetadata {
   const modern = ScenePluginMetadataSchema.safeParse(value)
   if (modern.success) {
-    return modern.data
+    const explicitMotion = value && typeof value === 'object' && 'motion' in value ? value.motion : undefined
+    return defineScenePluginMetadata({
+      ...modern.data,
+      motion: explicitMotion === 'animated' || explicitMotion === 'static'
+        ? explicitMotion
+        : inferSceneMotion(modern.data),
+    })
   }
 
   const legacy = ComponentProjectComponentMetadataSchema.safeParse(value)
@@ -366,7 +374,7 @@ function normalizeSceneMetadata(value: unknown, filePath: string): ScenePluginMe
     throw new Error(`${filePath}: invalid scene metadata`)
   }
 
-  return ScenePluginMetadataSchema.parse({
+  return defineScenePluginMetadata({
     resourceKind: 'scene',
     name: legacy.data.name,
     description: legacy.data.description,

package/src/index.ts

@@ -2,6 +2,7 @@ export {
   VIDEO_RESOURCE_METADATA_KEY,
   BaseVideoResourceMetadataSchema,
   ScenePluginMetadataSchema,
+  SceneMotionSchema,
   SceneSlotsSchema,
   SceneSlotHintSchema,
   ThemePluginMetadataSchema,
@@ -11,6 +12,7 @@ export {
   createVideoResourceAnnotation,
   getVideoResourceMetadata,
   type ScenePluginMetadata,
+  type ScenePluginMetadataInput,
   type SceneSlotHint,
   type ThemePluginMetadata,
   type TransitionPluginMetadata,
@@ -45,6 +47,7 @@ export {
   VideoComponent,
   defineComponentProjectComponentMetadata,
   defineScenePluginMetadata,
+  inferSceneMotion,
   defineThemePluginMetadata,
   defineTransitionPluginMetadata,
   getScenePluginMetadata,

package/src/meta/update-component-skills.ts

@@ -20,6 +20,7 @@ type VideoResourceMetaRecord = {
     tags: string[]
     aspectRatio?: '9:16' | '16:9'
     sceneType?: 'intro' | 'scene' | 'outro'
+    motion?: 'static' | 'animated'
     sceneFamily?: string
     themePreset?: string
     slots?: Array<string | {
@@ -132,6 +133,7 @@ function renderSceneMetadata(record: VideoResourceMetaRecord): string {
     `- resourceKind: ${metadata.resourceKind}`,
     `  aspectRatio: ${metadata.aspectRatio ?? ''}`,
     `  sceneType: ${metadata.sceneType ?? ''}`,
+    `  motion: ${metadata.motion ?? 'static'}`,
     `  sceneFamily: ${metadata.sceneFamily ?? ''}`,
     `  themePreset: ${metadata.themePreset ?? ''}`,
     `  rootLayout: ${metadata.rootLayout ?? ''}`,

package/src/resources/video-resource.ts

@@ -28,11 +28,13 @@ export const SceneSlotsSchema = z.union([
 ])
 
 const SceneFamilySchema = z.enum(['slide', 'canvas-2d', 'game-2d', 'three-3d', 'custom'])
+export const SceneMotionSchema = z.enum(['static', 'animated'])
 
 export const ScenePluginMetadataSchema = BaseVideoResourceMetadataSchema.extend({
   resourceKind: z.literal('scene'),
   aspectRatio: z.enum(['9:16', '16:9']),
   sceneType: z.enum(['intro', 'scene', 'outro']).optional(),
+  motion: SceneMotionSchema.default('static'),
   sceneFamily: SceneFamilySchema.default('custom'),
   themePreset: z.string().min(1).optional(),
   slots: SceneSlotsSchema.optional(),
@@ -58,6 +60,7 @@ export const VideoResourceMetadataSchema = z.discriminatedUnion('resourceKind',
 ])
 
 export type ScenePluginMetadata = z.infer<typeof ScenePluginMetadataSchema>
+export type ScenePluginMetadataInput = z.input<typeof ScenePluginMetadataSchema>
 export type SceneSlotHint = z.infer<typeof SceneSlotHintSchema>
 export type TransitionPluginMetadata = z.infer<typeof TransitionPluginMetadataSchema>
 export type ThemePluginMetadata = z.infer<typeof ThemePluginMetadataSchema>
@@ -128,8 +131,17 @@ export function getVideoResourceMetadata<TMetadata extends VideoResourceMetadata
   return parsed.data as TMetadata
 }
 
-export function defineScenePluginMetadata(input: ScenePluginMetadata): ScenePluginMetadata {
-  return ScenePluginMetadataSchema.parse(input)
+export function inferSceneMotion(input: Pick<ScenePluginMetadataInput, 'name' | 'sourceFile'>): z.infer<typeof SceneMotionSchema> {
+  return input.name.endsWith('Animated') && /(?:^|\/)animated(?:\/|$)/u.test(input.sourceFile)
+    ? 'animated'
+    : 'static'
+}
+
+export function defineScenePluginMetadata(input: ScenePluginMetadataInput): ScenePluginMetadata {
+  return ScenePluginMetadataSchema.parse({
+    ...input,
+    motion: input.motion ?? inferSceneMotion(input),
+  })
 }
 
 export function defineTransitionPluginMetadata(

package/src/schemas/index.ts

@@ -25,6 +25,7 @@ const ComponentProjectComponentMetadataInputSchema = z.object({
   sourceFile: z.string().min(1),
   aspectRatio: z.enum(['9:16', '16:9']),
   sceneType: z.enum(['intro', 'scene', 'outro']).optional(),
+  motion: z.enum(['static', 'animated']).optional(),
   tags: z.array(z.string().min(1)).default([]),
   propsTypeName: z.string().min(1).optional(),
 })