index.md

CEM Documentation Index

This index links the active project, release, and token workflow documents.

Project Planning

• Roadmap — product/module sequencing and major delivery phases.
• Todo — remaining execution tasks only.
• CEM ML library plan — Rust parser/runtime ownership for canonical CEM-ML plus XML/HTML parity responsibilities.
• CEM ML acceptance criteria — testable AC for the parser, schema, mutations, and plugin runtime.
• CEM QL acceptance criteria — testable AC for the CEM-ML query language consumed by templates and validation.
• CEM QL stack design — high-level design: pipeline layers, grammar, evaluator IR, type system, stdlib module layout, cost model, and binary artifact layout.
• CEM QL implementation design — concrete Rust module map, surface AST, IR shapes, diagnostic table, and stdlib function tables.
• CEM ML CLI feature summary — planned CLI capabilities, options, reports, diagnostics, fixture workflows, and exit codes.
• CEM ML CLI plan — Rust cem-ml CLI implementation plan with cem-ml library separation.
• CEM ML parser/schema ADR — Phase 1 parser engine, schema mirror, source-location, security, and WASM decisions.
• CEM ML syntax — canonical {name @attributes | content...} syntax and XML convention parity examples.
• CEM component MVP — first component list and state matrix.
• cem-element design — custom-element successor substrate, <template> data islands, event-to-data wiring, render loop, UI/processing split, migration path, and parity gates.
• cem-element WASM proposal — options for using cem_ml WASM, inline and URI declaration templates, module-map resolution, streaming source adapters, host runtime support, patch-frame streams, worker-pool scheduling, edge processing, and server-side rendering.
• CEM-ML UID and scoped CSS design — generated identity requirements for scoped CSS, anonymous declarations, public-tag debug prefixes, deterministic UIDs, hydration, and validation gates.
• CEM Elements HTTP request resource design — substrate-backed <http-request> resource slices, streaming content-type parsing, AST resource data, and data source maps.
• CEM UI Kit plan — Figma page, token, component, and QA mapping.
• Token pipeline smoke — full propagation check for a one-token source change.

Release

• NPM publishing workflow — release, publish, post-release Figma refresh, and branch sync steps.

Theme And Token Pipeline

• CEM theme package — package-level build and test notes.
• Token export architecture — DTCG export, Figma workflow, platform strategy, risks, and output contracts.
• CEM tokens in Figma — native Figma library variable model and UI checks.
• Docs generation — markdown, XHTML, CSS, token, and docs pipeline.
• HTML compile workflow — package HTML compilation notes.

Components

• CEM components package — package-level build and test notes.
• Component reference — MVP component semantics, token families, states, and accessibility notes.
• Component conventions — host API, attributes, events, forms, validation, loading, and progressive enhancement.
• Light-DOM rendering rules — no shadow DOM, data-island isolation, slot projection, render lifecycle, and substrate compatibility.
• Accessibility contract — names, ARIA, focus, keyboard behavior, live regions, unsafe content, and verification.
• Component examples — package-local workflow examples, separate from executable tests.

Parser Runtime

• @epa-wg/cem-ml — active Rust parser/runtime library (Cargo crate cem-ml) for canonical CEM-ML plus XML/HTML parity inputs.
• @epa-wg/cem-ml-cli — active Rust CLI (Cargo crate cem-ml-cli, binary cem-ml) for parsing, validation, reports, fixtures, and migration workflows.

Native Outputs

Generated by nx run @epa-wg/cem-theme:build:token-platforms from the canonical token spine.

• iOS Swift report — CEMTokens.swift plus CEMTokens.xcassets-hints.json for asset-catalog wiring.
• Android report — values/, values-night/, and compose/ outputs.
• Per-mode JSON report — flat cem-tokens-{light,dark,contrast-light,contrast-dark,native}.json for adapter experiments.

Examples

• Figma token workflow — native Figma library setup, validation, screenshot, and prompts.
• Figma sample token application — fixture for applying variables to a button and card.
• Canonical CEM-ML fixture set
• Canonical CEM-ML login fixture
• Canonical CEM-ML registration fixture
• Canonical CEM-ML profile fixture
• Canonical CEM-ML assets list fixture
• Canonical CEM-ML message thread fixture
• Semantic HTML login parity fixture
• Semantic HTML registration parity fixture
• Semantic HTML profile parity fixture
• Semantic HTML assets list parity fixture
• Semantic HTML message thread parity fixture