# Y6.1 — `slides` generator (docs/RFC_CONTENT_STUDIO.md §3, §5).
#
# Source (url / text / notebook chunks) → a structured deck (llm,
# json_schema: per slide a title, bullets, speaker notes and an optional
# figure) → each figure rendered by `figure` (svg / tikz / typst / d2 / python,
# render errors fed back) → Markdown slides → PPTX through pandoc, with
# the figures embedded as SVG (vector) → a `Deliverable`.
#
#   yanshi workflow run examples/generators/slides.yml \
#     --input url https://example.org/article --output-dir out
#
# Optional `theme`: a reference .pptx in the host's YANSHI_THEMES_DIR.
name: slides
description: "A slide deck of a source, with rendered figures, as .pptx"

inputs:
  url:
    description: "Page to present (fetched with SSRF protection); leave empty to use `text`"
    default: ""
  text:
    description: "Source text, used when `url` is empty"
    default: ""
  chunks:
    description: "Notebook passages to work from instead of url / text: [{chunk_id, source_id, content}]"
    default: []
  focus:
    description: "What the deck should argue or explain"
    default: "the main ideas, for a general audience"
  slides:
    description: "Number of content slides"
    default: 6
  figure_languages:
    description: "Figure languages the deck may use (svg is always available; tikz / typst / d2 / python need their renderers; d2 suits boxes-and-arrows diagrams)"
    default: "svg"
  theme:
    description: "Built-in palette ('dark' or 'light'), empty for default 'dark', or a reference .pptx name in YANSHI_THEMES_DIR"
    default: ""
  enable_illustrations:
    description: "Generate art-directed AI illustrations for slides without an explicit figure"
    default: false
  image_model:
    description: "Text-to-image model used when enable_illustrations is true"
    default: "gemini-3.1-flash-image"
  style_preset:
    description: "Art-direction preset ('editorial_tech' | 'isometric_3d' | 'flat_vector' | 'scientific_diagram' | 'cinematic_keynote')"
    default: "editorial_tech"

nodes:
  - id: options
    type: template
    parameters:
      output_format: json
      template: |
        {
          "has_url": {{ url != "" }},
          "use_native": {{ theme == "" or theme == "dark" or theme == "light" }},
          "use_ref_doc": {{ theme != "" and theme != "dark" and theme != "light" }},
          "palette": {% if theme == "light" %}"light"{% else %}"dark"{% endif %},
          "enable_illustrations": {{ enable_illustrations }},
          "image_model": {{ image_model | json_encode() }}
        }

  # `url` (the workflow input) reaches the node directly.
  - id: fetch
    type: http
    dependencies: ["options"]
    run_if: "{{ nodes.options.outputs.has_url }}"

  - id: source
    type: template
    input_mapping:
      page: "{{ nodes.fetch.outputs.body }}"
    parameters:
      template: "{% if chunks | length > 0 %}{% for c in chunks %}[{{ c.chunk_id }}] {{ c.content }}\n\n{% endfor %}{% elif page %}{{ page | striptags | truncate(length=24000) }}{% else %}{{ text | truncate(length=24000) }}{% endif %}"

  - id: deck_prompt
    type: template
    dependencies: ["source"]
    input_mapping:
      source_text: "{{ nodes.source.outputs.output }}"
    parameters:
      template: |
        Plan a deck of {{ slides }} content slides on the source below,
        presenting {{ focus }}. Each slide: a short title, 2-5 bullets of
        at most twelve words, speaker notes of two to four sentences, and
        a figure only where a diagram explains better than words. A
        figure gives its language (one of: {{ figure_languages }}) and a
        precise description of what to draw. Use only what the source
        supports.

        SOURCE:
        {{ source_text }}

  - id: deck
    type: llm
    dependencies: ["deck_prompt"]
    input_mapping:
      prompt: "{{ nodes.deck_prompt.outputs.output }}"
    parameters:
      system: "You design clear, sparse slide decks. Answer with JSON only."
      json_schema:
        type: object
        required: [title, slides]
        properties:
          title: { type: string }
          subtitle: { type: string }
          slides:
            type: array
            items:
              type: object
              required: [title, bullets, notes]
              properties:
                title: { type: string }
                bullets: { type: array, items: { type: string } }
                notes: { type: string }
                figure:
                  type: object
                  required: [language, description]
                  properties:
                    language: { type: string }
                    description: { type: string }
                    source: { type: string }

  # One Map item per figure, remembering its slide.
  - id: figure_items
    type: template
    dependencies: ["deck"]
    input_mapping:
      plan: "{{ nodes.deck.outputs.output }}"
    parameters:
      output_format: json
      template: |
        {"items": [{% set_global first = true %}{% for s in plan.slides %}{% if s.figure and s.figure.language %}{% if not first %},{% endif %}{% set_global first = false %}{"slide": {{ loop.index0 }}, "language": {{ s.figure.language | json_encode() }}, "description": {{ s.figure.description | json_encode() }}, "source": {{ s.figure.source | default(value="") | json_encode() }}}{% endif %}{% endfor %}]}

  - id: figures
    type: map
    dependencies: ["figure_items"]
    input_mapping:
      input_list: "{{ nodes.figure_items.outputs.items }}"
    parameters:
      parallel: true
      max_concurrent: 3
      template:
        - id: fig
          type: figure
          input_mapping:
            language: "{{ item.language }}"
            description: "{{ item.description }}"
            source: "{{ item.source }}"
          parameters:
            png: true
            png_width: 1600

  - id: deck_spec
    type: template
    dependencies: ["figures", "deck", "figure_items", "options"]
    input_mapping:
      plan: "{{ nodes.deck.outputs.output }}"
      wanted: "{{ nodes.figure_items.outputs.items }}"
      drawn: "{{ nodes.figures.outputs.results }}"
      palette: "{{ nodes.options.outputs.palette }}"
    parameters:
      output_format: json
      template: |
        {"deck": {
          "title": {{ plan.title | json_encode() }},
          "subtitle": {{ plan.subtitle | default(value="") | json_encode() }},
          "theme": {{ palette | json_encode() }},
          "slides": [
            {% for s in plan.slides %}{% set slide = loop.index0 %}{% set_global fig_src = "" %}{% set_global fig_desc = "" %}{% for w in wanted %}{% if w.slide == slide %}{% set r = drawn | nth(n=loop.index0) %}{% if r.fig and r.fig.Ok %}{% set_global fig_src = r.fig.Ok.fig_svg.path %}{% set_global fig_desc = w.description %}{% endif %}{% endif %}{% endfor %}{
              "title": {{ s.title | json_encode() }},
              "left": {
                "kind": "bullets",
                "items": [{% for b in s.bullets %}{"heading": {{ b | json_encode() }}, "body": ""}{% if not loop.last %},{% endif %}{% endfor %}]
              },
              {% if fig_src != "" %}"right": {"kind": "image", "title": "Figure", "src": {{ fig_src | json_encode() }}, "caption": {{ fig_desc | json_encode() }}},
              "visual_mode": "structured_panel",{% else %}{% set joined_b = s.bullets | join(sep="; ") %}{% set ill_p = s.title ~ ": " ~ joined_b %}"visual_mode": "illustration",
              "illustration_prompt": {{ ill_p | json_encode() }},{% endif %}
              "notes": {{ s.notes | json_encode() }}
            }{% if not loop.last %},{% endif %}{% endfor %}
          ]
        }}

  - id: illustrate
    type: illustration
    dependencies: ["deck_spec", "options"]
    input_mapping:
      deck: "{{ nodes.deck_spec.outputs.deck }}"
      model: "{{ nodes.options.outputs.image_model }}"
      palette: "{{ nodes.options.outputs.palette }}"
      enabled: "{{ nodes.options.outputs.enable_illustrations }}"
    parameters:
      max_images: 3
      max_concurrent: 3
      graceful_fallback: true

  - id: deck_pptx
    type: render_slides
    dependencies: ["illustrate", "options"]
    run_if: "{{ nodes.options.outputs.use_native }}"
    input_mapping:
      deck: "{{ nodes.illustrate.outputs.illustrate_deck }}"
    parameters:
      width: 1920
      progressive: false
      section_cards: false
      export_pptx: true

  # Optional custom Pandoc `--reference-doc` path when `theme` names a file in YANSHI_THEMES_DIR.
  - id: assemble
    type: template
    dependencies: ["figures", "deck", "figure_items", "options"]
    run_if: "{{ nodes.options.outputs.use_ref_doc }}"
    input_mapping:
      plan: "{{ nodes.deck.outputs.output }}"
      wanted: "{{ nodes.figure_items.outputs.items }}"
      drawn: "{{ nodes.figures.outputs.results }}"
    parameters:
      template: |
        ---
        title: {{ plan.title | json_encode() }}
        {% if plan.subtitle %}subtitle: {{ plan.subtitle | json_encode() }}
        {% endif %}---
        {% for s in plan.slides %}{% set slide = loop.index0 %}
        ## {{ s.title }}

        {% for b in s.bullets %}- {{ b }}
        {% endfor %}{% for w in wanted %}{% if w.slide == slide %}{% set r = drawn[loop.index0] %}{% if r.fig.Ok %}
        ![]({{ r.fig.Ok.fig_svg.path }}){ height=60% }
        {% endif %}{% endif %}{% endfor %}
        ::: notes
        {{ s.notes }}
        :::
        {% endfor %}

  - id: ref_pptx
    type: render_document
    dependencies: ["assemble", "options"]
    run_if: "{{ nodes.options.outputs.use_ref_doc }}"
    input_mapping:
      markdown: "{{ nodes.assemble.outputs.output }}"
    parameters:
      format: pptx

  - id: deliverable
    type: template
    dependencies: ["illustrate"]
    input_mapping:
      plan: "{{ nodes.deck.outputs.output }}"
      drawn: "{{ nodes.figures.outputs.results }}"
      painted: "{{ nodes.illustrate.outputs.illustrate_images }}"
      native_pptx: "{{ nodes.deck_pptx.outputs.deck_pptx_pptx }}"
      themed_pptx: "{{ nodes.ref_pptx.outputs.ref_pptx_output }}"
    parameters:
      output_format: json
      template: |
        {% if native_pptx is defined and native_pptx %}{% set use_native = true %}{% set out_pptx = native_pptx %}{% elif themed_pptx is defined and themed_pptx %}{% set use_native = false %}{% set out_pptx = themed_pptx %}{% else %}{% set use_native = true %}{% set out_pptx = "" %}{% endif %}{"deliverable": {
          "kind": "slides",
          "title": {{ plan.title | json_encode() }},
          "content": {"slides": {{ plan.slides | json_encode() }}},
          "citations": [],
          "files": [
            {"node_id": {% if use_native %}"deck_pptx"{% else %}"ref_pptx"{% endif %}, "name": {{ out_pptx | split(pat="/") | last | json_encode() }}, "mime_type": "application/vnd.openxmlformats-officedocument.presentationml.presentation", "role": "primary"}{% for r in drawn %}{% if r.fig.Ok %},
            {"node_id": "fig", "name": {{ r.fig.Ok.fig_svg.path | split(pat="/") | last | json_encode() }}, "mime_type": "image/svg+xml", "role": "asset"}{% endif %}{% endfor %}{% for img in painted %},
            {"node_id": "illustrate", "name": {{ img.path | split(pat="/") | last | json_encode() }}, "mime_type": {{ img.mime_type | default(value="image/png") | json_encode() }}, "role": "asset"}{% endfor %}
          ]
        }}
