Spec
The DSL is one authoring interface. The AST underneath it is the contract.
slidelang and doclang parse into one shared, versioned AST — a typed JSON document that any tool, agent, or renderer can consume without going through the DSL parser at all. That's the real interoperability boundary: today an LLM writes .slidelang/.doclangsource; a validated AST can also be produced directly by other tools, from spreadsheets, databases, or a CRM.
What's versioned
| Layer | Stability |
|---|---|
AST JSON shape (SchemaVersion) | Semver'd contract — MAJOR/MINOR/PATCH compatibility policy |
| DSL syntax (Strict/Flex mode) | Living documentation, not a versioned wire format |
Go package API (slidelang-core) | Explicitly not covered — internal implementation detail |
Status
The formal spec, JSON Schema, and @ziradocs/ast-types package are being migrated out of the internal monorepo into a standalone public ziradocs/spec repository as part of the open-source launch. This page will link directly to the spec and schema once that migration lands — see the docs section for the practical, example-driven language reference in the meantime.