v0.2.1

Highlights

• Prepare Anima Prompt Studio Advanced v2 with structured prompt data output.
• Downstream nodes should read Prompt Studio data by dict keys instead of
  positional output indexes so future output changes remain compatible.
• Add artist-field handling modes so text from Prompt Studio's artist-tag input
  fields can stay inline or be routed as separate structured data for
  artist-conditioning nodes, following the ComfyUI-AnimaPromptEditor
  artist-mix payload as the default compatibility target.
• Keep the existing Anima Prompt Studio Advanced node compatible while v2
  output contracts are introduced.

Added

• Added Anima Prompt Studio Advanced v2 with a single output socket of type
  EASYUSE_ANIMA_PROMPT_DATA.
• The v2 prompt data output is a Python dict with keyed compatibility outputs,
  node parameter state, resolution data, wildcard state, Mod Guidance flags,
  and artist-field data.
• Added EASYUSE_ANIMA_PROMPT_DATA helper node to pass prompt data through,
  optionally override compatibility fields, and unfold it into the existing
  Prompt Studio compatibility outputs.
• Added Anima Prompt Data Conditioning to consume EASYUSE_ANIMA_PROMPT_DATA,
  encode positive/negative CONDITIONING, create a batch-size-1 latent image
  from prompt-data width/height, and apply the comfyui-spectrum-ksampler
AnimaModGuidance MODEL patch when enabled.
• Anima Prompt Data Conditioning now supports artist mix modes from
  prompt-data or node controls. off/prompt preserve the inline positive
  prompt, while average and exact separate Advanced artist-field text from
  the base prompt and rebuild artist variants through EasyUseAnima's Anima
  prompt ordering rules.
• Added approximate artist mix modes for cheaper exact-like mixing:
  delta_rms, hybrid, and clustered. These reduce positive conditioning
  branch count by compressing artist deltas while preserving the existing
  average and exact behavior.
• Artist mix controls now expose tuning values for style gain, RMS scale cap,
  hybrid top-K, clustered branch count, and clustered dominant-artist
  isolation.
• Artist mix mode tooltips now describe the method and expected conditioning
  branch cost.
• Added Anima Artist Mix Conditioning as a standalone artist mix node. It
  accepts a regular prompt plus separate artist_tags, supports
  correct/front/back artist positioning, and outputs positive
  CONDITIONING without requiring Prompt Data.
• Added user-facing artist mix documentation covering Advanced v2 Prompt Data
  routing, standalone artist tag positioning, artist mix modes, and branch cost
  tradeoffs.
• Added an Artist Mix example workflow and preview under
  docs/example_workflows/.
• Prompt data now stores global_prompt /
  positive_without_artist_section, structured artist.tags, and
  artist_mix routing values for artist-conditioning nodes.
• Prompt data now stores a parameters dict generated from every required
  Anima Prompt Studio Advanced v2 input, so new v2 parameters are caught by
  tests instead of being silently omitted from EASYUSE_ANIMA_PROMPT_DATA.
• Anima Prompt Studio Advanced v2 now exposes inline foldout controls for
  Mod Guidance and Artist Mix, with Artist Mix mode written into prompt data.
• Prompt-data socket names are fixed to English identifiers across locales so
  displayed socket names match the Python node contract.
• Added NAIA resolution bucket fit mode for Anima Prompt Studio Advanced.
  NAIA width/height can now resolve to the nearest aspect ratio inside a
  configured saved resolution bucket.
• Added naia.resolution_mode and naia.resolution_bucket settings plus
  localized frontend controls for original-scale and bucket-fit modes.

Changed

• Bumped package metadata and maintained example workflow package_version
  metadata to 0.2.1.

Fixed

• Fixed Regional Prompt Studio dynamic field sockets so field input sockets stay
  synchronized with node fields and connection changes.
• Connected Regional Prompt Studio STRING inputs can now override masked
  prompt text at queue time without overwriting the saved field text.
• Foldout controls in Prompt Studio keep their open state across internal
  re-renders so clicks inside the control do not immediately collapse them.
• Advanced Prompt Studio native controls such as resolution bucket, wildcard,
  and Artist Mix dropdowns now consistently stop canvas event propagation so
  opened dropdowns stay open while selecting values.
• Anima Prompt Data Conditioning now calls Spectrum
  AnimaModGuidance.patch() with the installed node's supported signature, so
  current Spectrum builds no longer raise an argument-count TypeError.
• Older Spectrum AnimaModGuidance builds now emit a warning when their
  signature cannot receive separate negative quality tags. Execution continues,
  but negative Mod Guidance quality tags are ignored by that model patch.

Validation Notes

• Added regression coverage for the Advanced v2 prompt data socket, dict
  payload, EASYUSE_ANIMA_PROMPT_DATA helper outputs and overrides, and
  artist-field-only artist data extraction.
• Added regression coverage that every required Advanced v2 input is present
  in prompt data parameters.
• Added regression coverage for prompt-data conditioning and Spectrum
  AnimaModGuidance patcher invocation.
• Added regression coverage for current Spectrum AnimaModGuidance invocation
  without a separate negative quality-tag argument and for future-compatible
  invocation when that argument is supported.
• Added regression coverage for the old Spectrum warning path.
• Added regression coverage for prompt-data latent image creation with fixed
  batch size 1.
• Added regression coverage for artist-field-only prompt data, artist-free
  base prompts, artist mix prompt rebuilding, and exact-mode conditioning
  metadata.
• Added regression coverage for duplicate artist coalescing, hybrid top-K tail
  compression, approximate artist mix mode routing, and prompt-data storage of
  artist mix tuning values.
• Added regression coverage for the standalone artist mix conditioning node,
  including default corrected placement and fixed front/back placement.
• Added regression coverage for Regional Prompt Studio field socket overrides.
• Added regression coverage for NAIA resolution mode/bucket validation and
  bucket-fit output sizing.