@yyc3/music-ai 0.0.0-stage → 2.0.1

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 YanYuCloudCube™ (YYC³)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+YYC³（YanYuCloudCube™）· 言启象限 | 语枢未来
+Words Initiate Quadrants, Language Serves as Core for Future
+万象归元于云枢 | 深栈智启新纪元

package/README.md

@@ -1,3 +1,80 @@
-# Temporary Holding Version
+# @yyc3/music-ai
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> AI 助手、AI 歌词生成、创作工作室与 MV 生成器。
+
+| 属性 | 值 |
+| --- | --- |
+| 版本 | 2.0.0 |
+| 定位 | AI 创作组件 |
+| 许可证 | MIT |
+| 仓库 | https://github.com/YYC-Cube/YYC3-MusAI |
+
+## 安装
+
+```bash
+pnpm add @yyc3/music-ai react
+```
+
+## 快速开始
+
+```tsx
+import { AILyricsGenerator, CreationStudio } from '@yyc3/music-ai'
+
+export function Studio({ open, setOpen, playlist }: any) {
+  return (
+    <>
+      <AILyricsGenerator isOpen={open} onClose={() => setOpen(false)} />
+      <CreationStudio
+        isOpen={open} onClose={() => setOpen(false)}
+        playlist={playlist} currentTrackIndex={0}
+        onCreateTrack={(lyrics, theme, audioBlobUrl) => console.log(theme, lyrics, audioBlobUrl)}
+      />
+    </>
+  )
+}
+```
+
+## 导出清单
+
+- AIAssistant
+- AILyricsGenerator
+- CreationStudio
+- MVCreator
+
+## 关键 API
+
+| 名称 | 说明 |
+| --- | --- |
+| `AIAssistant` | activeTips、onDismissTip、onExecuteAction、isListening、voiceFeedback、sessionInsight 等 |
+| `AILyricsGenerator` | isOpen、onClose、onCreateTrack(lyrics, theme, audioBlobUrl?, compositionParams?) |
+| `CreationStudio` | isOpen、onClose、playlist、currentTrackIndex、onShareWork、onOpenMV 等 |
+| `MVCreator` | track、isPlaying、audioEnergy、frequencyData、currentTime、emotion 等 |
+
+## 说明
+
+AI 组件通过回调向上层暴露创作结果，不自带网络层；模型调用请由宿主注入 Provider（见路线图的 AIProvider 契约）。
+
+## 兼容性
+
+- React 19+（组件包 peer 依赖）
+- TypeScript 5.6+ / Node.js 20.19+
+- 现代浏览器（Chrome/Edge/Safari/Firefox 最近两个大版本）
+
+## 开发与验证
+
+```bash
+pnpm --filter @yyc3/music-ai build
+pnpm --filter @yyc3/music-ai typecheck
+pnpm --filter @yyc3/music-ai lint
+pnpm test:coverage
+```
+
+## 许可证
+
+MIT © 2026 YanYuCloudCube™（YYC³）
+
+<p align="center">
+  <b>YYC³</b>（YanYuCloudCube™ · 注册商标）<br>
+  言启象限 | 语枢未来 — Words Initiate Quadrants, Language Serves as Core for Future<br>
+  <sub>© 2026 YanYuCloudCube™（YYC³）· <a href="mailto:admin@0379.email">admin@0379.email</a></sub>
+</p>

package/dist/components/AIAssistant.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { AITip, VoiceCommand } from '@yyc3/music-hooks';
+interface AIAssistantProps {
+    activeTips: AITip[];
+    onDismissTip: (id: string) => void;
+    onExecuteAction: (actionKey: string) => void;
+    isListening: boolean;
+    onToggleListening: () => void;
+    voiceSupported: boolean;
+    voiceFeedback: string;
+    voiceHistory: VoiceCommand[];
+    sessionInsight: string;
+    isPlaying: boolean;
+    audioEnergy: number;
+    externalExpanded?: boolean;
+    onExternalExpandedChange?: (expanded: boolean) => void;
+}
+export declare const AIAssistant: React.FC<AIAssistantProps>;
+export {};
+//# sourceMappingURL=AIAssistant.d.ts.map

package/dist/components/AIAssistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIAssistant.d.ts","sourceRoot":"","sources":["../../src/components/AIAssistant.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAO3D,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAM7D,UAAU,gBAAgB;IACxB,UAAU,EAAE,KAAK,EAAE,CAAC;IACpB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;CACxD;AA4CD,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAwflD,CAAC"}

package/dist/components/AILyricsGenerator.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { type CompositionParams } from '@yyc3/music-hooks';
+interface AILyricsGeneratorProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onCreateTrack?: (lyrics: string[], theme: AILyricsTheme, audioBlobUrl?: string, compositionParams?: CompositionParams) => void;
+}
+export type AILyricsTheme = 'happy' | 'sad' | 'energetic' | 'calm' | 'love';
+export declare const AILyricsGenerator: React.FC<AILyricsGeneratorProps>;
+export {};
+//# sourceMappingURL=AILyricsGenerator.d.ts.map

package/dist/components/AILyricsGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AILyricsGenerator.d.ts","sourceRoot":"","sources":["../../src/components/AILyricsGenerator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAgC,MAAM,OAAO,CAAC;AAuBrD,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,UAAU,sBAAsB;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAChI;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAiB5E,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAoY9D,CAAC"}

package/dist/components/CreationStudio.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import { type CompositionParams } from '@yyc3/music-hooks';
+import type { Track } from '@yyc3/music-data';
+interface CreationStudioProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onCreateTrack?: (lyrics: string[], theme: string, audioBlobUrl?: string, compositionParams?: CompositionParams) => void;
+    playlist: Track[];
+    currentTrackIndex: number;
+    onHaptic?: (pattern: string) => void;
+    onShareWork?: (work: CreatedWork) => void;
+    onOpenMV?: (workLyrics?: string[]) => void;
+    user?: any;
+    starPower?: number;
+    onStarPowerUpdate?: (sp: number) => void;
+}
+interface CreatedWork {
+    id: string;
+    title: string;
+    theme: string;
+    lyrics: string[];
+    createdAt: number;
+    mode: string;
+}
+export declare const CreationStudio: React.FC<CreationStudioProps>;
+export {};
+//# sourceMappingURL=CreationStudio.d.ts.map

package/dist/components/CreationStudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreationStudio.d.ts","sourceRoot":"","sources":["../../src/components/CreationStudio.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAchE,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAc9C,UAAU,mBAAmB;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,CAAC,EAAE,CACd,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,EACrB,iBAAiB,CAAC,EAAE,iBAAiB,KAClC,IAAI,CAAC;IACV,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC3C,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AA6FD,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAinCxD,CAAC"}

package/dist/components/MVCreator.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { Track } from '@yyc3/music-data';
+interface MVCreatorProps {
+    isOpen: boolean;
+    onClose: () => void;
+    track: Track;
+    isPlaying: boolean;
+    audioEnergy: number;
+    frequencyData: Uint8Array;
+    currentTime: number;
+    emotion: string;
+    customLyrics?: string[] | null;
+    onHaptic?: (pattern: string) => void;
+}
+export declare const MVCreator: React.FC<MVCreatorProps>;
+export {};
+//# sourceMappingURL=MVCreator.d.ts.map

package/dist/components/MVCreator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MVCreator.d.ts","sourceRoot":"","sources":["../../src/components/MVCreator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAQxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAU9C,UAAU,cAAc;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,UAAU,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAiFD,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAghB9C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './components/AIAssistant';
+export * from './components/AILyricsGenerator';
+export * from './components/CreationStudio';
+export * from './components/MVCreator';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC"}