@melite/models-yue2 0.1.5-pre-alpha → 0.2.2-alpha

package/README.md

@@ -1,8 +1,3 @@
----
-description: YuE2 music family — YuE2-3B style-plus-lyrics song generation with ABC planning, on the ComfyUI engine from the official Comfy-Org release.
-kind: package-library
----
-
 # @melite/models-yue2
 
 `@melite/models-yue2` is the model family package for YuE2-3B music generation (`form_music`, genre audio, engine comfyui): a style caption plus lyrics go in, an ABC plan is drafted, and a song comes out as mp3. The DECL boards the official Comfy-Org release (`Comfy-Org/YuE2`, the `audio_yue2_text2music` template) and declares the `compose` action, one provision, and the required `prompt` relation. The estate boot mounts it as a Cordis plugin through `ctx.models.registerFamily` inside `ctx.effect`; the music card binds the action. The lane is this package's own `actions.ts`, pinned to committed goldens in `tests/golden/`.

package/lib/actions.js

@@ -31,6 +31,27 @@ export const compose = {
     ],
     facts: parseYue2Facts,
     build({ p, facts, g, runId }) {
+        
+        // mode precedent, music3/actions.ts: the DECL surface drops the
+        // knob, the build refuses the legacy draft). guidance_scale +
+        // lm_cfg_scale are the MiniMax lane's vocabulary (KSampler cfg +
+        // MiniMaxMusic3TextEncode cfg_scale) — the yue2 DECL serves
+        // neither (index.ts params), YuE2GenerateABC/YuE2GenerateMusic
+        // declare no such input, and KSampler cfg is the lane's fixed 1.
+        
+        // at compose — the SD-1 wedge (authored-on-music3, switched to
+        // yue2). Refuse loud in the knob's own voice; the schema
+        // default 1.7 rides (the stated default IS the unstated
+        // compose), and an absent knob (direct action callers) rides.
+        for (const [knob, lane] of [["guidance_scale", "KSampler cfg"], ["lm_cfg_scale", "the lyric-encoder guidance"]]) {
+            const v = p[knob];
+            if (v !== undefined && v !== 1.7) {
+                throw new Error(`yue2 compose: ${knob} '${String(v)}' fires nothing on this lane — ` +
+                    `${knob} is the MiniMax lane's vocabulary (${lane}); ` +
+                    "the YuE2 nodes read style+lyrics+mode only, KSampler cfg is the lane's fixed 1. " +
+                    "Drop it, or switch lane (model=music3) to steer the MiniMax guidance");
+            }
+        }
         const seed = p.seed;
         const ckpt = g.node("CheckpointLoaderSimple", { ckpt_name: facts.checkpoint });
         const style = p.prompt;
@@ -40,6 +61,12 @@ export const compose = {
         // GenerateMusic rides an empty abc (the engine's own off mode);
         // full/melody ride YuE2GenerateABC with the same style + lyrics.
         let abc = "";
+        // Off is CARD vocabulary the node enum cannot spell (full|melody)
+        // and mode is engine-REQUIRED — the off arm wires the engine's
+        // own default 'full' over the EMPTY abc (the off semantics live
+        // in the missing conditioning, never in a mode literal the enum
+        // refuses).
+        const nodeMode = mode === "off" ? "full" : mode;
         if (mode !== "off") {
             abc = g.node("YuE2GenerateABC", {
                 clip: ckpt.out(1), style, lyrics, seed, mode,
@@ -48,7 +75,7 @@ export const compose = {
             }).out(0);
         }
         const music = g.node("YuE2GenerateMusic", {
-            clip: ckpt.out(1), style, lyrics, abc, seed, mode,
+            clip: ckpt.out(1), style, lyrics, abc, seed, mode: nodeMode,
             max_duration: p.duration, temperature: 1.0, top_p: 0.95, top_k: 100,
             repetition_penalty: 1.2,
         });

package/lib/index.js

@@ -11,6 +11,15 @@ export const DECL = {
         "note": "The official Comfy-Org release (template audio_yue2_text2music); int8 convrot is the template's own quant pick. The bf16 cell and the SheetSage2 cover encoder stay unboarded until a cover lane exists."
     },
     "genre": "audio",
+    
+    // user-provided seats (prompt, lyrics) — the compose caller
+    // provides them. No variant-class rows: this family's served
+    // face exposes no steps+cfg pair (the census's surface-derived
+    // carve).
+    "required_defaults": [
+        { "name": "prompt", "class": "user" },
+        { "name": "lyrics", "class": "user" }
+    ],
     "variants": [
         {
             "id": "standard",
@@ -21,7 +30,7 @@ export const DECL = {
                 {
                     
                     // Comfy-Org checkpoint the provisions row carries.
-                    "quant": "int8",
+                    "quant": "int8_convrot",
                     "label": "INT8 ConvRot",
                     "route": "yue2",
                     "vram_peak_gb": 8,
@@ -29,7 +38,7 @@ export const DECL = {
             ]
         },
         {
-            "id": "short_sting",
+            "id": "short-sting",
             "label": "Short Sting",
             "hint": "Duration 5s — the card schema's own floor (a sting or loop).",
             "group": "Recipe",
@@ -37,7 +46,7 @@ export const DECL = {
             "cells": [],
         },
         {
-            "id": "full_length",
+            "id": "full-length",
             "label": "Full Length",
             "hint": "Duration 360s — the card schema's own ceiling (full-song length).",
             "group": "Recipe",
@@ -95,10 +104,17 @@ export const DECL = {
         ],
     },
     // THE LANE SURFACE (the z-image precedent): exactly the knobs the
-    // music card serves.
+    // music card serves. guidance_scale + lm_cfg_scale are NOT served
+    
+    // the MiniMax lane's vocabulary, unread on the YuE2 lane (KSampler
+    // cfg is the lane's fixed 1, neither YuE2 node takes the input).
+    // Dropping them from the surface makes the compose door refuse a
+    // legacy draft stating them (unknown-param refusal, layer 1);
+    // actions.ts refuses them at the card path (layer 2). The card
+    // schema keeps them (music3's seat) with visible_when music3.
     "params": [
         "prompt", "lyrics", "duration", "mode",
-        "guidance_scale", "n_diffusion_steps", "lm_cfg_scale", "seed",
+        "n_diffusion_steps", "seed",
     ],
     // THE DECLARED ACTIONS (the atom vocabulary, stroke 3):
     // the compose action the music card binds (the YuE2-3B lane).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@melite/models-yue2",
-  "version": "0.1.5-pre-alpha",
-  "license": "SSPL-1.0",
+  "version": "0.2.2-alpha",
+  "license": "AGPL-3.0-or-later",
   "type": "module",
   "exports": {
     ".": {
@@ -11,12 +11,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@melite/comfyui-card-kit": "0.1.5-pre-alpha"
-  },
-  "devDependencies": {
-    "@types/node": "^22.20.0",
-    "typescript": "^5.9.3",
-    "@deepseek-ai/cordis": "^4.0.4"
+    "@melite/comfyui-card-kit": "0.2.2-alpha"
   },
   "files": [
     "lib/index.js",
@@ -24,12 +19,29 @@
     "lib/**/*.d.ts"
   ],
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.4"
+    "@deepseek-ai/cordis": "^4.0.5"
+  },
+  "description": "YuE2 music family — YuE2-3B style-plus-lyrics song generation with ABC planning, on the ComfyUI engine from the official Comfy-Org release.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JayDataEngineer/melite.git",
+    "directory": "packages/models/yue2"
   },
+  "keywords": [
+    "melite",
+    "comfyui",
+    "cordis",
+    "agent",
+    "media-generation",
+    "library"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit"
   },
+  "engines": {
+    "node": ">=22.18.0"
+  },
   "publishConfig": {
     "access": "public"
   }