{a|b|{c|d}} nested choice expansion (deterministic by seed).
__name__ loads wildcards/name.txt.
__name-mir__ strictly loads wildcards/name-mir.txt.
In negative phase, if __name__ is used and name-mir.txt exists, it auto-mirrors to all options except the chosen one.
Deterministic selection per seed.

Install

Copy this folder to: <ComfyUI>/custom_nodes/ComfyUI-DynPromptSimplified
(Optional) Put your wildcard files in ComfyUI-DynPromptSimplified/wildcards/ or set wildcard_dir to any folder.
Restart ComfyUI.

Node

DynPrompt Expand (mirrored wildcards)

Inputs: text, negative, seed, wildcard_dir, auto_neg_from_mir
Outputs: expanded text, expanded negative

Node Inputs

positive: positive prompt
negative: negative prompt
Seed: this is used to determine how the node will select tags
allow neg from mir: automatically adds -mir tags to negative prompt without explicitly needing to add it to the negative prompt
variety: int between 0-10; creates extra randomness 'lanes' Variety
Wire the outputs into your usual CLIP Text Encode node
You can preview what the output is with the "preview any" node in utils

✨ Features

Nested choices with {option1|option2|{nested1|nested2}}
Wildcard expansion with __name__ → expands from wildcards/name.txt
Line-separated wildcard files that may themselves contain braces and wildcards
Mirrored wildcards with __name-mir__:
- Positive prompt gets the chosen option
- Negative prompt gets all the other options, comma-separated
- Strict resolution: __name-mir__ reads only wildcards/name-mir.txt (no fallback to name.txt)
Deterministic behavior using the current generation seed
Works for both positive and negative prompts
Expanded prompts are saved into PNG metadata

📑 Wildcard Files
Located in the wildcards/ directory (configurable).
Each line is one possible expansion.
Lines may contain further braces {} and wildcard calls.

Example: wildcards/hats.txt

{red hat|blue hat|{green hat|yellow hat|{black hat|gold hat}}}
beret
top hat

🔄 Mirrored Wildcards

File name: name-mir.txt (called via __name-mir__).
Ensures complementary picks between positive/negative prompts.

Example: wildcards/hats-mir.txt

{red hat|blue hat|green hat}
{tall hat|short hat|medium hat}

Positive prompt: portrait, __hats-mir__
Negative prompt: lowres, __hats-mir__
- If pos → red hat, neg → blue hat, green hat
- If pos → short hat, neg → tall hat, medium hat

This ensures that the negative prompt excludes the token chosen in the positive prompt.

🧩 Nested `-mir` behavior (auto-discovery)

Mirrored tokens can be nested inside other wildcards. If a wildcard you use in the positive prompt expands to another token like __foo-mir__, the extension can automatically inject the mirrored complement into the negative prompt (so you don’t have to add __foo-mir__ manually).

This requires the checkbox in the UI:
“Automatically mirror -mir wildcards without explicitly adding them to the negative prompt.” (enabled by default)
The auto-inject only happens if the negative prompt does not already contain that __*-mir__ token.
Resolution is strict: __foo-mir__ reads wildcards/foo-mir.txt only.

Example (nested):

wildcards/outfits.txt
---------------------
__hats-mir__, {casual|formal}

wildcards/hats-mir.txt
----------------------
{red hat|blue hat|green hat}

Usage:

Positive: portrait, __outfits__
Negative: (leave blank or put your usual negatives)
add node from: add node -> prompt -> DSynPrompt Expand (deep-mirrored)

Behavior:

The positive prompt expands __outfits__ → which contains __hats-mir__.
With the checkbox enabled, the extension auto-injects __hats-mir__ into the negative and expands it there as the comma‑separated “other” options.
If the seed picks red hat for positive, the negative gets blue hat, green hat automatically.

🎲 Variety (extra randomness lanes)

What it is: An integer knob that creates alternate, reproducible randomness lanes without changing your seed or prompt.

Deterministic: With the same (seed, variety, prompt, files), you get the same positive & negative outputs every time.

Independence from fixed text: Only decision points advance randomness—each {…} block and each __wildcard__ / __*-mir__. Fixed words/commas/spaces do not affect picks.

How it works (under the hood):

Choices use choice#0, choice#1, …
Wildcards use wild#0, wild#1, … (also salted with the token name)
We hash (seed, counter[, token], variety) to pick an index.

When to use: Keep seed fixed and sweep variety = 0,1,2… to explore different, reproducible variants from the same prompt.

Example

Prompt: __color__, {A|B|{C|D}}, __pose-mir__

(seed=123, variety=0) → picks one set of branches
(seed=123, variety=1) → different set of branches (still reproducible)

## ⚙️ Usage

- Write prompts as usual with `{}` and `__wildcards__`.
- Wildcards are recursively expanded.
- Mirrored wildcards respect complement logic.

**Prompt Example:**

Positive: portrait, {cinematic|studio|outdoor}, hats, soft lighting Negative: lowres, bad anatomy, hats-mir


## Notes
- Missing wildcard files resolve to empty strings.
- Choice/wildcard expansion is capped to prevent runaway recursion.
- If `negative` is blank and `auto_neg_from_mir` is ON, the node scans the positive for `__tokens__`
  and auto-builds a mirrored negative when possible.

## Changelog
### 2025-08-24 — Counter-Based Randomness & “Variety” lanes
**Why**: fixed tokens could cause prompt to converge.

**What changed**
- **Decision-only RNG**: Random choices now depend **only** on decision points (each `{…}` block and each `__wildcard__` / `__*-mir__` call), not on surrounding fixed text.  
  - Internally we hash `(seed, decision_counter[, token], variety)` where counters advance as we hit choices/wildcards left→right.
  - Adding/removing fixed words, commas, or spacing no longer shifts picks.
- **Deterministic lanes via `variety`**: New integer input that adds an extra salt.  
  - Same `(seed, variety, prompt, files)` ⇒ same outputs.  
  - Sweep `variety = 0,1,2…` to get reproducible alternates without touching seed or prompt.
- **Deep mirroring (strict)**: `__foo-mir__` contributes mirrored exclusions to Negative even when **nested** inside other wildcards, and **only** reads `foo-mir.txt` (never falls back).
- **Empty-branch support in `*-mir.txt`**: `{option|}` is honored.  
  - If Positive picks `option`, Negative adds nothing for that token; if Positive picks the empty branch, Negative adds the non-empty options.
- **Single-line `*-mir.txt` with nested braces**: `{1|2|{3|4}}` is flattened to leaves so mirroring can compute “all-except-chosen” correctly.

**Behavior notes**
- Fixed text no longer influences randomness. Only the **number/order** of decision points matters.  
- Changing decision points (e.g., adding a `{…}` or another `__wildcard__`) will change the sequence of draws—as expected.  
- Deep mirror uses the same counters as Positive, ensuring the Negative always gets the correct complement.

**Example**
```text
Prompt: __color__, {A|B|{C|D}}, __pose-mir__
Same seed, same variety → same picks (pos & neg)
Change only fixed words → picks stay identical
Bump variety (e.g., 0→1) → different, reproducible picks

License: GPLv3 (same as the original)

README.md Unescape Escape

ComfyUI Dynamic Prompting Simplified

Overview