Skip to content
Back to search

Elementum

Zero-dependency, signal-driven Web Components design system (109 components, WCAG 2.2 AA, DSD SSR, AG-UI, MCP & Penpot DTCG sync)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/pinguxx/Elementum with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/pinguxx/Elementum'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pinguxx--elementum/badge.svg)](/listings/pinguxx--elementum)

HTML

<a href="/listings/pinguxx--elementum"><img src="/api/listings/pinguxx--elementum/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Option A: Zero-Build CDN (Vanilla HTML)

Elementum runs directly in any modern browser without Webpack, Vite, or Babel.

<!DOCTYPE html>
<html lang="en">
<head>
  <!-- 1. Include Design Tokens -->
  <link rel="stylesheet" href="https://unpkg.com/@wcomp/elementum/tokens.css" />

  <!-- 2. Import Component Library -->
  <script type="module" src="https://unpkg.com/@wcomp/elementum"></script>
</head>
<body>
  <!-- Native Form with Form-Associated Custom Elements -->
  <form id="my-form">
    <el-input name="username" placeholder="Enter username...">
      <span slot="prefix">πŸ‘€</span>
    </el-input>

    <el-select name="role" value="member">
      <option value="member">Team Member</option>
      <option value="admin">Administrator</option>
    </el-select>

    <el-button type="submit" variant="primary">Save Changes</el-button>
  </form>
</body>
</html>

Option B: npm Install (Bundlers & Frameworks)

npm install @wcomp/elementum

Import the design tokens CSS and register the Custom Elements in your app entry point:

import '@wcomp/elementum/tokens.css';
import '@wcomp/elementum';

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 341 lines
  1. # @wcomp/elementum
  2. [npm version](https://www.npmjs.com/package/@wcomp/elementum)
  3. > **Elementum** (*Latin*: /e.leˈmen.tum/) β€” **An AI-native, framework-independent UI engineering platform** built on standard Custom Elements, fine-grained micro-signals, W3C DTCG tokens, Declarative Shadow DOM SSR, and MCP/AG-UI tooling.
  4. | Component Count | Dependencies | Avg Gzip | Accessibility | License |
  5. | ----- | ----- | ----- | ----- | ----- |
  6. | **109 Custom Elements** | **0 Runtime Deps** | **2.19 KB** | **WCAG 2.2 AA** (@axe-core/playwright) | **MIT** |
  7. [**Live Showcase**](https://elementum-sage.vercel.app/) Β· [**Catalog (109 elements)**](https://elementum-sage.vercel.app/examples/index.html) Β· [**AG-UI Demo**](https://elementum-sage.vercel.app/examples/ag-ui.html) Β· [**Live DSD SSR**](https://elementum-sage.vercel.app/ssr)
  8. ## πŸ§ͺ Verification & Browser Matrix (Beta β€” `v0.5.2`)
  9. One command verifies everything end-to-end: `npm run verify:all` (see [QUALITY.md](https://github.com/pinguxx/Elementum/blob/main/QUALITY.md) for the auto-generated per-component matrix).
  10. Every architectural claim in Elementum is backed by automated verification in CI:
  11. | Verification Layer | Tooling | Scope |
  12. | ----- | ----- | ----- |
  13. | **Core Signals & Fuzzing** | `node:test` (`test/signal-torture.test.js`) | Cycle detection, stale-dep cleanup, AbortSignal disposal, **1,000-graph multi-seed DAG fuzzer** + **500-step dynamic topology fuzzer** |
  14. | **Unit, Behavior & Contract Suite** | `node:test` + `happy-dom` (Node 20/22/24, Ubuntu, Windows & macOS) | **226+ tests**, **β‰₯ 95% line coverage** enforced in CI, WAI-ARIA/RTL/SSR contract checks (`@wcomp/elementum/testing`), Source-vs-Catalog Diff (`npm run catalog:diff`) |
  15. | **Gzipped Size Budgets** | `npm run check:size` (`size-budget.json`) | **86 entrypoints** gated in CI (`core + behaviors + agent + ssr`: **29.1 KB**, avg component: **2.19 KB gzip**) |
  16. | **External Consumer Tarball** | `npm run verify:consumer` (`tools/verify-consumer.js`) | Packs real `.tgz`, installs into isolated temp app, verifies all ESM subpaths & strict `tsc --noEmit --strict` |
  17. | **Real Browser E2E** | Playwright (`npm run test:e2e`) β€” Chromium, Firefox, WebKit | **17 E2E tests**: `<dialog>` focus restoration, `ElementInternals` `<form>` submit/reset, live CSS transitions (`getAnimations()`), Shadow-DOM agent `snapshot`/`act`, AG-UI SSE |
  18. | **Declarative Shadow DOM SSR** | Playwright (`/?hydrate=0` Zero-JS & `/?hydrate=1` Hydrated) | Native `<template shadowrootmode="open">` attachment with JS disabled + clean client hydration |
  19. | **Accessibility** | `@axe-core/playwright` (WCAG 2.2 AA ruleset) + `@wcomp/elementum/testing` | Automated real-browser `axe-core` audits + WAI-ARIA APG pattern validators + static MCP `lint_accessibility` |
  20. | **Security & MCP Hardening** | `test/security.test.js` + GitHub CodeQL | XSS escaping in `template.js` & `ssr.js`, URL scheme allowlist, prototype-pollution guards, ReDoS-safe parsers, 128 KB MCP payload cap |
  21. | **Performance Benchmarks** | `npm run bench` ([BENCHMARKS.md](https://github.com/pinguxx/Elementum/blob/main/BENCHMARKS.md)) | Reproducible median & p95 suite with CPU/OS/Node metadata (`node tools/benchmark.js --write`) |
  22. ## ⚑ Quick Start
  23. ### Option A: Zero-Build CDN (Vanilla HTML)
  24. Elementum runs directly in any modern browser without Webpack, Vite, or Babel.
  25. ```
  26. <!DOCTYPE html>
  27. <html lang="en">
  28. <head>
  29. <!-- 1. Include Design Tokens -->
  30. <link rel="stylesheet" href="https://unpkg.com/@wcomp/elementum/tokens.css" />
  31. <!-- 2. Import Component Library -->
  32. <script type="module" src="https://unpkg.com/@wcomp/elementum"></script>
  33. </head>
  34. <body>
  35. <!-- Native Form with Form-Associated Custom Elements -->
  36. <form id="my-form">
  37. <el-input name="username" placeholder="Enter username...">
  38. <span slot="prefix">πŸ‘€</span>
  39. </el-input>
  40. <el-select name="role" value="member">
  41. <option value="member">Team Member</option>
  42. <option value="admin">Administrator</option>
  43. </el-select>
  44. <el-button type="submit" variant="primary">Save Changes</el-button>
  45. </form>
  46. </body>
  47. </html>
  48. ```
  49. ### Option B: npm Install (Bundlers & Frameworks)
  50. ```
  51. npm install @wcomp/elementum
  52. ```
  53. Import the design tokens CSS and register the Custom Elements in your app entry point:
  54. ```
  55. import '@wcomp/elementum/tokens.css';
  56. import '@wcomp/elementum';
  57. ```
  58. ## πŸ’‘ Core Principles
  59. `Elementum` is inspired by minimalist libraries like `uce`, modernizing the developer experience with standard browser primitives:
  60. * **Shadow DOM by default** with automatic Constructable Stylesheet adoption (`new CSSStyleSheet()`).
  61. * **Fine-grained & Async-First Signals** (`signal`, `computed`, `effect`, `batch`, `asyncSignal`, `isPending`, `NotReadyError`): state updates mutate **only the exact bound DOM text or attribute node**, while `asyncSignal` adds `AbortSignal` race-condition cancellation, stale-while-revalidate `.value`, and structured `.error` details.
  62. * **Form-Associated Custom Elements (FACE)**: `static formAssociated = true` enables native `<form>` submission, reset, and validation via `ElementInternals`.
  63. * **Zero build requirement**: Plain ES modules (`<script type="module">`), no Babel, decorators, or compile step needed. Runs in SSR / Node.js cleanly.
  64. * **Light & Dark Mode**: Built-in CSS custom property theme tokens with automatic `prefers-color-scheme` and `<el-theme-switch>`.
  65. * **Leak-free lifecycle**: Automatically tracks and tears down event listeners and signal subscriptions via `this.signal` (`AbortSignal`).
  66. * **WCAG 2.2 AA Compliant**: Built-in 24x24px minimum target sizes, high-contrast `:focus-visible` rings, dialog focus preservation, and HTML5 Constraint Validation API (`ElementInternals.setValidity`).
  67. * **Figma 1:1 Parity**: Direct mapping to Figma Component Variants and Figma Variables.
  68. * **AI Agent & MCP Ready**: Generates standard W3C `custom-elements.json` and includes a built-in MCP server (local stdio and hosted Streamable HTTP) for coding agents.
  69. * **CI/CD & Automation**: GitHub Actions multi-OS / multi-Node matrix test runner, OIDC npm Trusted Publishing with provenance, and Dependabot automated dependency updates.
  70. ## Component Catalog
  71. Selected highlights below β€” browse all **109 elements** interactively in the [**Component Catalog**](https://elementum-sage.vercel.app/examples/index.html).
  72. | Component | Tag Name | Description |
  73. | ----- | ----- | ----- |
  74. | **Button** | `<el-button>` | 1:1 Figma variant parity (`primary`, `secondary`, `danger`, `ghost`, sizes `sm`/`md`/`lg`). |
  75. | **Badge** | `<el-badge>` | Status indicator pill (`default`, `success`, `danger`). |
  76. | **Input** | `<el-input>` | Form-associated input with `prefix` and `suffix` icon slots. |
  77. | **Dropdown** | `<el-dropdown>` | Popover container with light-dismiss (closes on outside click or &lt;kbd&gt;Esc&lt;/kbd&gt;). |
  78. | **Calendar** | `<el-calendar>` | Standalone 42-day accessible month grid with traversal. |
  79. | **Datepicker** | `<el-datepicker>` | Form-associated composite datepicker combining input, dropdown, calendar, and quick actions. |
  80. | **Dialog / Modal** | `<el-dialog>` | Native `<dialog>` modal with backdrop blur, overscroll containment, and light-dismiss. |
  81. | **Tabs** | `<el-tabs>`, `<el-tab>` | W3C accessible tablist with keyboard arrow navigation. |
  82. | **Select** | `<el-select>` | Form-associated custom dropdown selection. |
  83. | **Switch** | `<el-switch>` | Form-associated toggle switch with keyboard navigation (&lt;kbd&gt;Space&lt;/kbd&gt;/&lt;kbd&gt;Enter&lt;/kbd&gt;). |
  84. | **Tooltip** | `<el-tooltip>` | Lightweight tooltip bubble with top/bottom/left/right placement. |
  85. | **Accordion** | `<el-accordion>`, `<el-accordion-item>` | W3C accessible disclosure accordion supporting single or multi-expand. |
  86. | **Table** | `<el-table>` | Signal-driven data grid with column sorting and multi-row selection. |
  87. | **Theme Switch** | `<el-theme-switch>` | Toggles between Light β˜€οΈ and Dark πŸŒ™ mode with `localStorage` persistence. |
  88. | **Toast** | `<el-toaster>` | Viewport overlay for programmatic notifications (`toast.success()`, `toast.error()`). |
  89. | **Progress** | `<el-progress>` | Determinate & indeterminate animated progress bar (`role="progressbar"`). |
  90. | **Spinner** | `<el-spinner>` | Accessible SVG loading spinner (`role="status"`). |
  91. | **Avatar** | `<el-avatar>`, `<el-avatar-group>` | User avatar with image fallback, automatic initials, and status dot. |
  92. | **Drawer** | `<el-drawer>` | Slide-over drawer overlay (`left`, `right`, `top`, `bottom`) with focus trap. |
  93. | **Segmented** | `<el-segmented-control>` | Form-associated pill switcher with keyboard arrow navigation. |
  94. | **Pagination** | `<el-pagination>` | Accessible numeric page navigation with ellipsis windowing and `pagechange` events. |
  95. | **Chip / Pill** | `<el-chip>` | Interactive tag with `selectable` and `removable` dismiss modes (`role="button"`). |
  96. | **Autocomplete** | `<el-autocomplete>` | Form-associated combobox supporting single or multiselect (`multiple`) with inline chips, remote URL debouncing, and ARIA 1.2 / WCAG 2.2 accessibility. |
  97. | **Number Flow** | `<el-number-flow>` | Smooth vertical rolling odometer number reels (*NumberFlow* style) with physical easing and reduced-motion fallback. |
  98. | **OTP Input** | `<el-otp-input>` | Form-associated segmented PIN / verification code input with auto-advance, backspace retreat, and paste splitting. |
  99. | **Command Palette** | `<el-command>` | Accessible keyboard-first command menu (*cmdk* style) with &lt;kbd&gt;⌘K&lt;/kbd&gt; / &lt;kbd&gt;Ctrl+K&lt;/kbd&gt; shortcut, fuzzy search, and group headers. |
  100. | **Prompt Input** | `<el-prompt-input>` | Beautiful UI-style auto-expanding AI prompt composer with action bar slots, model chips, and Enter-to-submit handling. |
  101. | **Reasoning Card** | `<el-reasoning-card>` | Collapsible AI thought disclosure with active breathing pulse dot, elapsed duration timer, and smooth accordion expansion. |
  102. | **Border Beam** | `<el-border-beam>` | Hardware-accelerated luminous gradient ray traveling around container perimeters (Magic UI style). |
  103. | **Streaming Text** | `<el-streaming-text>` | Organic token-by-token streaming typewriter text with customizable cadence, blinking cursor, and completion events. |
  104. ## Interactive Examples & Showcase
  105. * [examples/ledgerflow.html](https://github.com/pinguxx/Elementum/blob/main/examples/ledgerflow.html): **LedgerFlow (Penpot β†’ MCP Generated App)**: End-to-end fintech dashboard designed in [**Penpot**](https://design.penpot.app/?screen=viewer&file-id=42288968-6e5e-808d-8008-f77162b618ca&page-id=d8ded059-05ee-80c0-8008-f774c97dd053&section=interactions&index=0&share-id=8218fc5e-f68d-4bab-8fd7-283dd92586e8) and compiled via `npm run penpot:generate` into 15 validated Elementum Web Components (`<el-number-flow>`, `<el-chart>`, `<el-meter>`, `<el-drawer>`, `<el-dialog>`, `<el-toaster>`).
  106. * [examples/references.html](https://github.com/pinguxx/Elementum/blob/main/examples/references.html): **Reference Hub (Anti-AI Slop)**: Real-world patterns reconstructed from curated galleries (SaaS Pricing with rolling odometers & border beams, Linear-style command menu, and segmented PIN auth).
  107. * [examples/agent-studio.html](https://github.com/pinguxx/Elementum/blob/main/examples/agent-studio.html): **AI Agent Studio & Command Center** demonstrating `<el-command>` (⌘K), `<el-prompt-input>`, `<el-reasoning-card>`, `<el-number-flow>` live token odometer, `<el-otp-input>` security key authorization, and `<el-border-beam>`.
  108. * [index.html](https://github.com/pinguxx/Elementum/blob/main/index.html): Interactive landing portal directing to the applications. Run `npm run serve` to launch locally.
  109. * [examples/app.html](https://github.com/pinguxx/Elementum/blob/main/examples/app.html): Complete **Pulse Cloud** showcase dashboard demonstrating native form validation, confirmation modal dialogs, toast notifications, tabs, and theme toggling.
  110. * [examples/index.html](https://github.com/pinguxx/Elementum/blob/main/examples/index.html): Interactive component catalog with live prop editors and signal-reactive previews.
  111. ## Headless Behaviors, Agent Runtime & Testing Contracts
  112. Beyond 109 ready-to-use styled Web Components (all supporting opt-in `unstyled` headless mode), Elementum exports three focused zero-dependency subpaths:
  113. * **`@wcomp/elementum/behaviors`** β€” 15 composable interaction, focus, motion, and overlay primitives (`createPressBehavior`, `createRovingFocus`, `createDismissableLayer`, `createFocusRecovery`, `createShortcuts`, `createDisclosureBehavior`, `createPopupPositioner`, `createPresenceBehavior`, `prefersReducedMotion`, `createSelectionBehavior`, `createReorderBehavior`, `highlightMatch`, `announce`, `setHostState`, `isRTL`).
  114. * **`@wcomp/elementum/agent`** β€” Shadow-DOM-piercing `snapshot(root)` and `act(root, command)` so AI agents can inspect live UI state and execute semantic actions (`click`, `type`, `toggle`, `open`, `close`) without brittle DOM scraping.
  115. * **`@wcomp/elementum/testing`** β€” Reusable WAI-ARIA APG (`checkAriaPattern`), provider-free RTL (`checkDirection`), and DSD SSR (`checkServerRender`) contract validators.
  116. See [docs/behaviors-and-agent.md](https://github.com/pinguxx/Elementum/blob/main/docs/behaviors-and-agent.md) for full API examples.
  117. ## Design Engineering & Agent Guides
  118. ### Installable Agent Skills (`npx skills add`)
  119. Install Elementum's modular AI coding skills directly into Antigravity, Claude Code, Cursor, or Gemini CLI (configured via [skills.sh.json](https://github.com/pinguxx/Elementum/blob/main/skills.sh.json)):
  120. ```
  121. npx skills@latest add pinguxx/Elementum --skill elementum
  122. ```
  123. Included skills under [skills/](https://github.com/pinguxx/Elementum/tree/main/skills):
  124. * **`elementum`**: Canonical platform skill covering components, `unstyled` mode, `@wcomp/elementum/behaviors`, `@wcomp/elementum/agent`, `@wcomp/elementum/testing`, and DSD SSR.
  125. * **`elementum-ui`**: Composing Elementum's 109 Web Components, signals, FACE forms, and AG-UI streams.
  126. * **`elementum-motion`**: Shadow DOM motion physics, sub-300ms `ease-out`, origin-aware overlays, and reduced-motion standards.
  127. * **`elementum-break-ui`**: Adversarial stress-testing checklist (320px mobile, dark mode hover contrast, keyboard-only, extreme content).
  128. * **`elementum-mobile`**: Mobile-native CSS standards (`touch-action`, `100dvh`, safe areas, `overscroll-behavior`, iOS 16px input zoom prevention).
  129. * **`elementum-penpot`**: Two-way Penpot MCP design system sync and Penpot-to-Elementum app codegen.
  130. * [docs/behaviors-and-agent.md](https://github.com/pinguxx/Elementum/blob/main/docs/behaviors-and-agent.md): API reference for `@wcomp/elementum/behaviors`, `@wcomp/elementum/agent`, and `@wcomp/elementum/testing`.
  131. * [docs/penpot-workflow.md](https://github.com/pinguxx/Elementum/blob/main/docs/penpot-workflow.md): Free & open-source design token workflow with Penpot (W3C DTCG JSON) and automated compilation.
  132. * [docs/agent-craft-guide.md](https://github.com/pinguxx/Elementum/blob/main/docs/agent-craft-guide.md): Guide and system prompt rules for AI coding agents to banish generic AI look and adhere to high-craft standards.
  133. * [docs/theming.md](https://github.com/pinguxx/Elementum/blob/main/docs/theming.md): Complete design tokens, CSS custom properties, and `::part()` customization guide.
  134. ## Framework Integration
  135. `@wcomp/elementum` works natively in vanilla HTML, React 19, Vue 3, Svelte 5, and Next.js. See [docs/framework-integration.md](https://github.com/pinguxx/Elementum/blob/main/docs/framework-integration.md) for complete setup instructions and TypeScript configuration.
  136. ## Project Structure
  137. ```
  138. Elementum/
  139. β”œβ”€β”€ .github/workflows/
  140. β”‚ β”œβ”€β”€ ci.yml # Multi-OS/Node CI: coverage >= 95%, strict TS, size budgets, tarball & 3-browser E2E
  141. β”‚ └── publish.yml # OIDC Trusted Publishing with provenance on GitHub release
  142. β”œβ”€β”€ api/
  143. β”‚ β”œβ”€β”€ mcp.js # Vercel Serverless Streamable HTTP MCP endpoint (/mcp)
  144. β”‚ └── ssr.js # Vercel Serverless Declarative Shadow DOM SSR endpoint (/ssr)
  145. β”œβ”€β”€ src/
  146. β”‚ β”œβ”€β”€ signal.js # Fine-grained signals with cycle detection & re-entrancy guards
  147. β”‚ β”œβ”€β”€ template.js # Tagged template engine (html, svg, css, surgical DOM parts)
  148. β”‚ β”œβ”€β”€ elementum.js # Base class: Shadow DOM, Constructable Stylesheets, unstyled mode, FACE
  149. β”‚ β”œβ”€β”€ ssr.js # Pure Node.js Declarative Shadow DOM SSR
  150. β”‚ β”œβ”€β”€ ag-ui.js # AG-UI streaming event store & RFC 6902 JSON Patch
  151. β”‚ β”œβ”€β”€ behaviors/index.js # 15 composable headless interaction, focus, motion & overlay behaviors
  152. β”‚ β”œβ”€β”€ agent/index.js # Shadow-DOM-piercing agent runtime bridge (snapshot, act)
  153. β”‚ β”œβ”€β”€ testing/index.js # WAI-ARIA APG, RTL & DSD SSR contract validators
  154. β”‚ β”œβ”€β”€ tokens.css # Light & Dark W3C DTCG CSS custom properties
  155. β”‚ β”œβ”€β”€ index.js / index.d.ts # Public exports & strict TypeScript definitions
  156. β”‚ └── components/ # 109 zero-dependency Custom Elements (avg 2.19 KB gzip)
  157. β”œβ”€β”€ docs/ # behaviors-and-agent.md, theming.md, framework-integration.md, penpot-workflow.md
  158. β”œβ”€β”€ skills/ & skills.sh.json # Installable AI agent skills (npx skills@latest add pinguxx/Elementum)
  159. β”œβ”€β”€ mcp/server.js # Hardened Model Context Protocol stdio & HTTP server (elementum-mcp)
  160. β”œβ”€β”€ tools/ # check-size.js, verify-consumer.js, generate-quality-report.js, audit-catalog-diff.js, benchmark.js
  161. β”œβ”€β”€ size-budget.json # Per-entrypoint gzipped byte budgets enforced in CI
  162. β”œβ”€β”€ custom-elements.json # W3C Custom Elements Manifest (109 tags)
  163. β”œβ”€β”€ QUALITY.md # Auto-generated evidence-based per-component maturity matrix
  164. β”œβ”€β”€ e2e/ # Playwright + @axe-core/playwright real-browser tests
  165. └── test/ # 226+ Node.js unit, fuzz, behavior, contract & security tests
  166. ```
  167. ## 🎨 Theming & Accessibility (WCAG 2.2)
  168. * **Theming Guide**: See [docs/theming.md](https://github.com/pinguxx/Elementum/blob/main/docs/theming.md) for the full catalog of design tokens and exposed CSS `::part()` selectors.
  169. * **Agent Guide**: See [AGENT\_GUIDE.md](https://github.com/pinguxx/Elementum/blob/main/AGENT_GUIDE.md) for guidelines on building, testing, and reviewing Elementum components.
  170. * **Framework Integration**: See [docs/framework-integration.md](https://github.com/pinguxx/Elementum/blob/main/docs/framework-integration.md) for React, Vue, Svelte, and Angular setup.
  171. ## πŸš€ Declarative Shadow DOM (DSD) SSR
  172. Elementum includes built-in server-side rendering support emitting standard `<template shadowrootmode="open">` for zero-CLS first paint in Next.js, Nuxt, Astro, and Node.js:
  173. ```
  174. import { renderComponentToDSD } from '@wcomp/elementum/ssr';
  175. import { ElButton } from '@wcomp/elementum';
  176. // Outputs HTML with Declarative Shadow DOM and encapsulated styles
  177. const html = renderComponentToDSD('el-button', ElButton, { variant: 'primary' }, 'Submit');
  178. ```
  179. Run the live zero-dependency Node.js SSR server (`?hydrate=0` for pure Zero-JS DSD, `?hydrate=1` for progressive hydration) or view the pre-rendered snapshot [examples/ssr-demo.html](https://github.com/pinguxx/Elementum/blob/main/examples/ssr-demo.html):
  180. ```
  181. npm run ssr
  182. ```
  183. ## Penpot & Figma Design System Sync
  184. ### Code β†’ Penpot (MCP Server Sync)
  185. Generate all **54 W3C DTCG tokens** (Core, Light, Dark sets), **28 library colors**, and **105 Master Components** (across 8 categories) directly inside an open [**Penpot**](https://design.penpot.app) file connected via the Penpot MCP Plugin:
  186. ```
  187. npm run penpot:mcp -- --url "https://design.penpot.app/mcp/stream?userToken=<YOUR_TOKEN>"
  188. # Or via environment variable:
  189. PENPOT_MCP_URL="https://design.penpot.app/mcp/stream?userToken=<YOUR_TOKEN>" npm run penpot:mcp
  190. ```
  191. ### Penpot / Figma β†’ Code (Token Compiler)
  192. Synchronize exported W3C DTCG tokens from `tokens/penpot-tokens.json` (or `tokens/figma-tokens.json`) into `src/tokens.css`:
  193. ```
  194. npm run tokens:sync tokens/penpot-tokens.json
  195. ```
  196. See [docs/penpot-workflow.md](https://github.com/pinguxx/Elementum/blob/main/docs/penpot-workflow.md) for full setup instructions, CLI flags (`--url`, `--token`, `--dry-run`), and Penpot MCP security notes.
  197. ## Agent MCP Server
  198. ### Remote (Streamable HTTP β€” no install required)
  199. Connect any HTTP-capable MCP client (Cursor, Claude, VS Code) to:
  200. `https://elementum-sage.vercel.app/mcp`
  201. Or proxy from a stdio-only client:
  202. ```
  203. npx mcp-remote https://elementum-sage.vercel.app/mcp
  204. ```
  205. ### Local (stdio)
  206. Run the built-in MCP server locally for AI coding agents:
  207. ```
  208. node mcp/server.js
  209. # Or via package bin
  210. npx elementum-mcp
  211. ```
  212. Exposed tools:
  213. * `list_components`: Lists all 109 components in Elementum
  214. * `get_component_doc`: Retrieves attributes, slots, events, and CSS parts from `custom-elements.json`
  215. * `get_component_maturity`: Reports evidence-based maturity tier (`production-verified`, `stable`, `experimental`)
  216. * `suggest_component`: Recommends components for a given UI goal
  217. * `validate_component_usage`: Checks HTML markup against declared attributes and slots
  218. * `list_tokens`: Queries design tokens by category (color, spacing, radius)
  219. * `generate_snippet`: Generates valid HTML markup matching variants
  220. * `scaffold_component`: Scaffolds standard boilerplate code for new components
  221. * `lint_accessibility`: Static HTML accessibility linter (`static-html-lint`; pair with Playwright `axe-core` for full WCAG verification)
  222. ## Contributing & License
  223. Issues and pull requests are welcome on [GitHub](https://github.com/pinguxx/Elementum/issues).
  224. Licensed under the [MIT License](https://github.com/pinguxx/Elementum/blob/main/LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.