kumwe / producer
The PHP producer for Kumwe Studio: receives canonical Studio compositions and makes them real - validated wire handling, semantic server-side rendering, and design-token CSS - while your application keeps all authority and storage.
Maintainers
Requires
- php: >=8.1
- ext-json: *
- ext-mbstring: *
This package is auto-updated.
Last update: 2026-08-29 13:27:51 UTC
README
Studio designs it. Producer makes it real. Your application owns it.
Producer is the PHP realization layer for Kumwe Studio, the schema-aware visual composition platform. Studio hands your application a canonical, portable JSON composition — never markup, never styles, never code. Producer is what turns that composition into reality on a PHP host:
- Wire handling — parses and validates Studio's request envelopes, routes the closed operation set, and answers with strict canonical JSON and the stable twelve-category error taxonomy.
- Rendering — turns a published composition into semantic, fully escaped HTML with working no-JavaScript fallbacks for the complete Studio block catalog.
- Stylesheets — generates the static CSS a design's tokens and layout vocabulary imply; nothing is computed per request and nothing is inlined.
- Contract proof — vendors the Studio corpus at one exact pinned release, digest-verifies it, and replays the published conformance vectors, so what this library claims is what it proves.
Producer deliberately contains no authority, no storage, no Node.js, and no render-time code
generation — your application keeps authentication, authorization, persistence, and templates,
and implements Producer's small port interfaces with its own services. The full rules live in the
charter; the division of labour with Studio and with host applications is recorded in
docs/host-agreement.md.
The pipeline
| Stage | Owner | What happens |
|---|---|---|
| Design | Studio (browser) | An author composes typed, theme-bounded blocks; Studio emits canonical JSON |
| Wire | Producer | Envelope validated, operation routed, host answers through its own ports |
| Authority and storage | Your application | Authorization, revisions, audit, persistence — all yours |
| Realization | Producer | Published composition → semantic HTML + generated stylesheet |
| Delivery | Your application | Embeds the render result in its own templates and serves Studio's prebuilt assets |
How it is built
The library is layered with one dependency direction — Canonical JSON, the schema-property profile, the error taxonomy, the wire layer, rendering, stylesheets — each proven by replaying the vendored Studio conformance corpora before the next layer consumes it. The engineering standard states the architecture, code, testing, and documentation rules in full: strict types, final classes, injected authority, centralized escaping, deterministic output, typed refusals with stable codes, and a suite that proves intended outcomes only — the conformance corpora are the spine, negative paths are first-class, and frivolous tests are forbidden.
Producer is also written to be ported. The contract is language-neutral JSON, so a Python or TypeScript sibling implements the same corpora and claims conformance the same way; the porting guide gives an implementer the order, the boundaries, and the subtleties, so a port needs this repository and nothing else.
Status
Founding stage. The contract is vendored from a pre-release Studio pin and the surface below is
under active construction; nothing here is a supported release yet. See
docs/roadmap.md for what exists, what is proven, and what is next.
Requirements
PHP 8.1 or newer with ext-json and ext-mbstring. No runtime Composer dependencies.
Development
composer check # lint, contract digest verification, dependency-free test suite