Playground & Conformance

The Quire playground and conformance suite are language tooling surfaces. They are not the platform renderer, visual builder, or theme system.

Playground scope

The browser playground lets authors type .quire, see diagnostics, format source, inspect compiled stretchpress.blocks.v1, extract localization catalogs, and preview rendered HTML from block IR without executing Quire source.

Inputs are Quire source text, optional project schema JSON, optional source filename, and optional locale and direction defaults.

The required panels are:

• source editor
• optional project-schema JSON input
• diagnostics list
• formatted source preview
• compiled IR JSON preview
• message catalog preview
• active merged schema preview
• rendered HTML preview from compiled block IR

The preview renderer consumes compiled block IR only and escapes rendered values. Capability calls render as inert descriptors, such as data-quire-action.

Playground source examples

The playground can exercise source like examples/site/pricing.quire, which includes imports, localization, SEO metadata, includes, slots, repeats, and token references:

import { Nav, Hero, Pricing, FAQ, CTA, Footer } from "../../library/standard"

quire StretchPressPricing {
  model {
    page: StretchPressPage
    navItems: StandardNavItem[]
    legalItems: StandardNavItem[]
    plans: StandardPricingPlan[]
    faqItems: StandardFAQItem[]
  }

  route "/pricing"
  locale locale("en-US", "ltr")
  dir dir("ltr")
  title page.metaTitle
  seo seo(page.metaTitle, page.seoDescription, page.canonical, page.heroImage.url)

Static packaging

Regenerate the checked-in browser bundle after compiler changes:

npm run playground:build

Verify the checked-in bundle:

npm run playground:check

Build and verify the deployable artifact:

npm run playground:deploy
npm run playground:deploy:check

The deploy artifact is written to playground/dist/ and includes a deterministic quire-playground.manifest.json. Share links use a base64url-encoded quire.playground-state@1 payload in the source query parameter.

Web editor adapter

quire-editor.js provides textarea-backed editor helpers, diagnostic summaries, and marker conversion for browser integrations. It has no network or framework dependency.

Conformance suite

The Quire 1.0 conformance suite is a portable contract for compiler, formatter, editor, and migration tooling. Its manifest is test/conformance/quire-1.0.json and validates against schemas/quire-conformance.v1.json.

Run the reference suite:

npm run conformance:run

The repository test also checks manifest alignment, fixture coverage, artifact existence, and generated spec freshness:

node --test test/conformance.test.js

Third-party implementations can run the portable suite by exporting an ESM adapter with parseSource, formatSource, and compileSource, then running scripts/run-conformance.js. A compatible implementation may claim Quire-compatible only when the manifest's required parse, format, compile, and safety assertions pass.