@vibecuting/component-project-helper 0.1.136 → 0.1.138

package/package.json

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

package/src/decorators/index.test.ts

@@ -13,6 +13,7 @@ test('attaches normalized metadata to decorated function components', () => {
     sourceFile: 'src/components/SceneFrame.tsx',
     aspectRatio: '16:9',
     sceneType: 'scene',
+    motion: 'static',
     tags: ['layout', 'frame'],
     propsTypeName: 'SceneFrameProps',
   })
@@ -32,6 +33,7 @@ test('attaches normalized metadata to decorated function components', () => {
     sourceFile: 'src/components/SceneTitle.tsx',
     aspectRatio: '16:9',
     sceneType: 'intro',
+    motion: 'static',
     tags: ['title', 'hero'],
     propsTypeName: 'SceneTitleProps',
   })
@@ -55,6 +57,7 @@ test('attaches metadata to components with required props', () => {
     sourceFile: 'src/components/RequiredPropsScene.tsx',
     aspectRatio: '16:9',
     sceneType: 'scene',
+    motion: 'static',
     tags: ['required', 'props'],
     propsTypeName: 'RequiredProps',
   })

package/src/decorators/index.ts

@@ -31,7 +31,8 @@ export type ComponentProjectComponentMetadata = LegacyComponentProjectComponentM
 export function defineComponentProjectComponentMetadata(
   metadata: ComponentProjectComponentMetadata,
 ): ComponentProjectComponentMetadata {
-  return ComponentProjectComponentMetadataSchema.parse(metadata) as ComponentProjectComponentMetadata
+  const parsed = ComponentProjectComponentMetadataSchema.parse(metadata)
+  return parsed as ComponentProjectComponentMetadata
 }
 
 const sceneAnnotation = createVideoResourceAnnotation(sceneResourceDescriptor)
@@ -42,7 +43,7 @@ function normalizeSceneMetadata(
   metadata: ComponentProjectComponentMetadata | ScenePluginMetadata,
 ): ScenePluginMetadata {
   if ('resourceKind' in metadata) {
-    return ScenePluginMetadataSchema.parse(metadata)
+    return defineScenePluginMetadataBase(metadata)
   }
 
   return ScenePluginMetadataSchema.parse({
@@ -52,13 +53,14 @@ function normalizeSceneMetadata(
     sourceFile: metadata.sourceFile,
     aspectRatio: metadata.aspectRatio,
     sceneType: metadata.sceneType,
+    motion: metadata.motion,
     sceneFamily: 'custom',
     themePreset: undefined,
     slots: undefined,
     propsTypeName: metadata.propsTypeName,
     rootLayout: 'absolute-fill',
     tags: metadata.tags,
-    pluginKey: metadata.name,
+    pluginKey: metadata.pluginKey ?? metadata.name,
   })
 }
 

package/src/discovery/index.test.ts

@@ -35,6 +35,7 @@ test('discovers scene, transition and theme resources from installed packages',
         tags: ['demo'],
         aspectRatio: '16:9',
         sceneType: 'scene',
+        motion: 'static',
         sceneFamily: 'custom',
         rootLayout: 'absolute-fill',
       })

package/src/discovery/index.ts

@@ -10,6 +10,7 @@ import {
   type TransitionPluginMetadata,
   type VideoResourceDescriptor,
   type VideoResourceMetadata,
+  defineScenePluginMetadata,
   ScenePluginMetadataSchema,
 } from '../resources/video-resource.ts'
 import {
@@ -358,7 +359,7 @@ 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
+    return defineScenePluginMetadata(modern.data)
   }
 
   const legacy = ComponentProjectComponentMetadataSchema.safeParse(value)
@@ -366,7 +367,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,
@@ -375,6 +376,7 @@ function normalizeSceneMetadata(value: unknown, filePath: string): ScenePluginMe
     tags: legacy.data.tags,
     aspectRatio: legacy.data.aspectRatio,
     sceneType: legacy.data.sceneType,
+    motion: legacy.data.motion,
     sceneFamily: 'custom',
     rootLayout: 'absolute-fill',
     propsTypeName: legacy.data.propsTypeName,

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,

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

@@ -35,6 +35,7 @@ test('writes and checks the unified video resource metadata file', async () => {
         tags: ['demo'],
         aspectRatio: '16:9',
         sceneType: 'scene',
+        motion: 'static',
         sceneFamily: 'custom',
         rootLayout: 'absolute-fill',
       })

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

@@ -31,6 +31,7 @@ test('writes and checks the skill docs from generated metadata', async () => {
               tags: ['demo'],
               aspectRatio: '16:9',
               sceneType: 'scene',
+              motion: 'static',
               sceneFamily: 'custom',
               rootLayout: 'absolute-fill',
               propsTypeName: 'DemoSceneProps',

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}`,
     `  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,
   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,7 +131,7 @@ export function getVideoResourceMetadata<TMetadata extends VideoResourceMetadata
   return parsed.data as TMetadata
 }
 
-export function defineScenePluginMetadata(input: ScenePluginMetadata): ScenePluginMetadata {
+export function defineScenePluginMetadata(input: ScenePluginMetadataInput): ScenePluginMetadata {
   return ScenePluginMetadataSchema.parse(input)
 }
 

package/src/schemas/index.test.ts

@@ -9,6 +9,7 @@ test('validates component metadata', () => {
     sourceFile: 'src/components/SceneFrame.tsx',
     aspectRatio: '16:9',
     sceneType: 'scene',
+    motion: 'static',
     tags: ['layout', 'frame'],
     propsTypeName: 'SceneFrameProps',
   })

package/src/schemas/index.ts

@@ -21,10 +21,12 @@ export type {
 
 const ComponentProjectComponentMetadataInputSchema = z.object({
   name: z.string().min(1),
+  pluginKey: z.string().min(1).optional(),
   description: z.string().min(1),
   sourceFile: z.string().min(1),
   aspectRatio: z.enum(['9:16', '16:9']),
   sceneType: z.enum(['intro', 'scene', 'outro']).optional(),
+  motion: z.enum(['static', 'animated']),
   tags: z.array(z.string().min(1)).default([]),
   propsTypeName: z.string().min(1).optional(),
 })