{% extends "public_base.html" %}
{% import "marketplace/_macros.html" as mk %}

{% block title %}{{ _("Publish your feature") }}{% endblock %}

{% block hero %}
<section class="store-hero store-hero--slim">
    <div class="container">
        <h1 class="store-hero__title">{{ _("Publish your feature") }}</h1>
        <p class="store-hero__subtitle">{{ _("There is no upload button, and that is the point. Releasing a tag in your own repository is publishing, and the marketplace index is rebuilt from your feature's contract.") }}</p>
    </div>
</section>
{% endblock %}

{% block content %}
<div class="container">
    <div class="store-cols">

        <div>
            <ol class="store-howto">
                <li class="store-howto__step">
                    <span class="store-howto__num">1</span>
                    <div>
                        <h2 class="store-howto__title">{{ mk.icon("package") }}{{ _("Build your feature") }}</h2>
                        <p class="store-howto__text">{{ _("Scaffold it in your SPLENT workspace. The contract (what it provides and what it requires) is inferred from the code and kept in the feature's own pyproject.toml. You never write index data by hand.") }}</p>
                        <div class="store-terminal">
                            <span class="store-terminal__prompt">$</span>
                            <code>splent feature:create my_feature</code>
                        </div>
                    </div>
                </li>

                <li class="store-howto__step">
                    <span class="store-howto__num">2</span>
                    <div>
                        <h2 class="store-howto__title">{{ mk.icon("tag") }}{{ _("Release it") }}</h2>
                        <p class="store-howto__text">{{ _("One command bumps the version, regenerates the contract, tags the repository and uploads to PyPI. The Git tag IS the publication. There is no separate submission step.") }}</p>
                        <div class="store-terminal">
                            <span class="store-terminal__prompt">$</span>
                            <code>splent feature:release</code>
                        </div>
                    </div>
                </li>

                <li class="store-howto__step">
                    <span class="store-howto__num">3</span>
                    <div>
                        <h2 class="store-howto__title">{{ mk.icon("git-branch") }}{{ _("Get listed") }}</h2>
                        <p class="store-howto__text">{{ _("Open a pull request adding your organisation or repository on %(forge)s to the registry file of the index. Once reviewed and merged, the indexer reads your released tags. You never push data into the marketplace.", forge=forge) }}</p>
                        <p class="store-howto__text">
                            <a href="{{ registry_url }}" target="_blank" rel="noopener">{{ _("registry.toml in %(repository)s", repository=registry_label) }}{{ mk.trailing_icon("external-link") }}</a>
                        </p>
                    </div>
                </li>

                <li class="store-howto__step">
                    <span class="store-howto__num">4</span>
                    <div>
                        <h2 class="store-howto__title">{{ mk.icon("check-circle") }}{{ _("You are in") }}</h2>
                        <p class="store-howto__text">{{ _("The index rebuilds automatically from the latest released tags. Your feature appears here with its contract, dependencies and collisions. To fix or update anything, just release again.") }}</p>
                        <p class="store-howto__text">
                            <a href="{{ url_for('marketplace.index') }}">{{ _("Browse the catalog") }}{{ mk.trailing_icon("arrow-right") }}</a>
                        </p>
                    </div>
                </li>
            </ol>

            {# A product line is the one thing published through the
               marketplace rather than read from a tag: the marketplace holds
               the UVLHub key and mints the DOI, so it needs an account. #}
            <section class="store-section store-publish-line" id="product-line">
                <h2 class="store-section__title">{{ mk.icon("layers") }}{{ _("Publish a product line") }}</h2>
                <div class="store-panel">
                    <p class="store-howto__text">{{ _("A product line is a UVL model over published features. It goes through this marketplace, which deposits the model on UVLHub and records its DOI, so you need an account here. Sign in once from the CLI, then publish the line from your workspace.") }}</p>
                    <ul class="store-cmdlist">
                        <li class="store-cmdlist__item">
                            <div class="store-terminal">
                                <span class="store-terminal__prompt">$</span>
                                <code>splent login</code>
                            </div>
                        </li>
                        <li class="store-cmdlist__item">
                            <div class="store-terminal">
                                <span class="store-terminal__prompt">$</span>
                                <code>splent spl:publish my_spl</code>
                            </div>
                        </li>
                    </ul>
                    <p class="store-howto__text">{{ _("Publishing the line again records a new version under the same DOI. You never hold a UVLHub key.") }}</p>
                    <p class="store-howto__text store-linkrow">
                        {% if account_url %}<a href="{{ account_url }}">{% if account_is_signup %}{{ _("Create an account") }}{% else %}{{ _("Log in") }}{% endif %}{{ mk.trailing_icon("arrow-right") }}</a>{% endif %}
                        <a href="{{ url_for('marketplace.spls') }}">{{ _("See the product lines") }}{{ mk.trailing_icon("arrow-right") }}</a>
                    </p>
                </div>
            </section>
        </div>

        <aside class="store-side">
            <div class="store-meta-card">
                <div class="store-meta-row">
                    <span class="store-meta-row__label">{{ _("A feature") }}</span>
                    <span class="store-meta-row__value store-muted">{{ _("No account, no upload") }}</span>
                </div>
                <div class="store-meta-row">
                    <span class="store-meta-row__label">{{ _("A product line") }}</span>
                    <span class="store-meta-row__value">
                        {% if account_url %}<a href="#product-line">{{ _("An account here") }}</a>{% else %}{{ _("An account here") }}{% endif %}
                    </span>
                </div>
                <div class="store-meta-row">
                    <span class="store-meta-row__label">{{ _("Source of truth") }}</span>
                    <span class="store-meta-row__value"><code class="store-code">pyproject.toml</code></span>
                </div>
                <div class="store-meta-row">
                    <span class="store-meta-row__label">{{ _("The index") }}</span>
                    <span class="store-meta-row__value">{{ _("A regenerable cache") }}</span>
                </div>
            </div>

            <div class="store-install">
                <p class="store-install__title">{{ mk.icon("info") }}{{ _("Why no upload?") }}</p>
                <p class="store-install__hint">{{ _("Anything uploaded can drift from the code it describes. Here the index is derived from released tags, so it can always be thrown away and rebuilt. It is never a second source of truth.") }}</p>
                <p class="store-install__hint">{{ _("A product line is the exception. Its model is deposited on UVLHub, and the marketplace holds the key for that.") }}</p>
                <p class="store-install__hint">
                    <a href="https://docs.splent.io/marketplace/publishing" target="_blank" rel="noopener">{{ _("Read the full publishing guide") }}{{ mk.trailing_icon("external-link") }}</a>
                </p>
            </div>
        </aside>

    </div>
</div>
{% endblock %}