dhtml syntax (draft spec) #

{{ post.title }}
{{ post.created | date }}
{{ post.title | truncate 60 }}
{{ user.name | default "Guest" }}

<d:layout src="main" title="Blog"> ... </d:layout>
<d:slot />                                        <!-- in layouts -->
<d:include src="post-card" />                     <!-- from partials/ -->
<d:use src="shop" />                              <!-- steps from steps/: queries and guards, written once -->
<d:component src="card" title="{{ post.title }}">...</d:component>   <!-- from components/ -->
<d:props title href tone="info" />                <!-- first line of a component -->

<d:if test="post"> ... <d:else> ... </d:if>
<d:if test="not post">
<d:if test="post.likes > 10">

<d:for each="post in posts"> ... <d:empty> ... </d:for>

<d:auth> shown to signed-in visitors <d:else> shown to the others </d:auth>
<d:auth admin> shown to admins </d:auth>
<d:guest> shown to visitors who are not signed in </d:guest>

<d:status code="404" />                           <!-- stops rendering, shows error page -->

<d:query as="posts">
  SELECT id, title FROM posts ORDER BY created DESC LIMIT 20
</d:query>

<d:query as="post" one>
  SELECT * FROM posts WHERE slug = {{ route.slug }}
</d:query>

<d:action method="POST" auth ratelimit="10/minute">

  <d:validate field="title" required max="120" />

  <d:exec>
    INSERT INTO posts (title, user_id) VALUES ({{ form.title }}, {{ user.id }})
  </d:exec>

  <d:respond> HTML fragment for htmx </d:respond>
  <d:invalid> shown when validation fails </d:invalid>

</d:action>

<d:validate field="email" required email />
<d:validate field="age" number min="18" max="120" />
<d:validate field="day" required date />   <!-- YYYY-MM-DD, a day that exists -->
<d:validate field="at" time />            <!-- HH:MM -->
<d:validate field="body" required max="20000" />

<d:respond> ... </d:respond>             <!-- HTML fragment -->
<d:json>{{ posts }}</d:json>             <!-- JSON -->
<d:redirect to="/blog" flash="Saved" />  <!-- redirect -->
<d:redirect next="/home" />              <!-- back to where the visitor was heading, else /home -->
<d:status code="403" />                  <!-- error -->

<d:set as="cents" value="{{ form.price | mul 100 | round }}" />   <!-- a value for the steps below -->

<d:http as="intent" method="POST" url="https://api.stripe.com/v1/payment_intents" bearer="env:STRIPE_KEY">
  <d:header name="Idempotency-Key" value="order-{{ route.id }}" />
  <d:field name="amount" value="{{ cents }}" />
</d:http>
<!-- intent.status, intent.ok, intent.json, intent.text, intent.header -->

<d:login />       <!-- email="email" password="password" -->
<d:logout />
<d:register />    <!-- email, and name when a field called name is declared; no password -->
<d:confirm />     <!-- token="token" password="password", from the emailed link -->
<d:password current="old" password="new" />   <!-- needs an action with auth -->
<d:forgot />      <!-- email="email" -->
<d:reset />       <!-- token="token" password="password" -->

<!-- server/jobs/send-receipt.dhtml -->
<d:job retries="3" timeout="30">
  <d:arg name="order" required number />
  <d:query as="o" one>SELECT email FROM orders WHERE id = {{ args.order }}</d:query>
  <d:http as="sent" method="POST" url="https://api.mail.example/v1/send" bearer="env:MAIL_KEY" />
</d:job>

<!-- server/jobs/clean-up.dhtml -->
<d:job every="1d" at="03:30"> <d:exec>DELETE FROM drafts WHERE created_at < date('now', '-30 days')</d:exec> </d:job>

<!-- in an action with a ratelimit -->
<d:enqueue job="send-receipt" order="{{ order.id }}" />

<d:action method="POST" ratelimit="10/minute">
  <d:validate field="question" required max="500" />

  <d:ai as="answer">
    <d:system>Answer questions about this post. Be brief.</d:system>
    <d:context>{{ post.title }}: {{ post.body }}</d:context>
    <d:user>{{ form.question }}</d:user>
  </d:ai>

  <d:respond>
    <div>{{ answer }}</div>
  </d:respond>
</d:action>

[app]
name = myblog
version = 1.0.0

[server]
port = 3000
routing = files        # or: explicit

[ai]
provider = anthropic
model = claude-sonnet-5-5
key = env:ANTHROPIC_API_KEY

[backups]
keep_daily = 7
keep_weekly = 4

[routes]
/login    = pages/auth/login.dhtml
/old-blog = redirect /blog
/health   = text OK

[features]
shell = off            # never on a hosted site