@ethisyscore/vite-plugin

The Vite plugin collection for EthisysCore plugin-side builds. It provides the build passes for every UI render mode the platform supports — manifest-driven HTML entries, Contract A SDUI schema validation and emission, the Contract B worker bundle, the PlatformReact multi-page bundle orchestrator, and the Tier U iframe-sandbox pass — plus the codegen that derives manifests from a plugin's routeMeta.json.

For the render-mode / trust-tier overview see the top-level README. For the per-contract authoring walkthroughs see docs/authoring/.

Export surface

Each Vite plugin factory returns a standard Vite Plugin; wire the one(s) that match your render mode into vite.config.ts.

| Export | Purpose | |---|---| | ethisysContractAPlugin | Contract A pass — validates the SDUI tree against the closed vocabulary and emits declarative resources / reactive rules at build time | | validateDeclarativeResource, validateReactiveRule | Standalone SDUI + reactive-rule validators (ValidationResult / ValidationFailure) for tests and tooling | | ethisysContractBPlugin | Contract B pass — emits the Web Worker bundle and its import map (CONTRACT_B_SEMANTIC_PRIMITIVES, CONTRACT_B_RUNTIME_IMPORTS, CONTRACT_B_IMPORT_MAP_ALLOWLIST) | | ethisysPlatformReactPlugin | PlatformReact pass — builds one ESM bundle per declared page | | buildPlatformReactPages, rewriteAliasedExternalImports, virtualPageEntry | Multi-bundle orchestrator: one isolated Vite sub-build per page, with host-externals dedupe (PLATFORM_REACT_EXTERNALS, PLATFORM_REACT_DEDUPE) and host-loader import rewriting | | generatePlatformReactManifest, computePlatformReactPages | Build-step codegen — derive feature.manifest.json + the extension.manifest.json overlay from routeMeta.json | | parsePlatformReactPages | Test helper for snapshot-testing PlatformReact page declarations | | ethisysIframeSandboxPlugin, buildIframeSandboxPages | Tier U iframe-sandbox pass — cross-origin sandboxed pages with SHA-256 digest emission | | ethisysManifestPlugin | Legacy manifest-driven pass — auto-generates index.html for pages/surfaces that declare a source field |

Typical usage

// vite.config.ts for a PlatformReact plugin
import { defineConfig } from "vite";
import { ethisysPlatformReactPlugin } from "@ethisyscore/vite-plugin";

export default defineConfig({
  plugins: [ethisysPlatformReactPlugin({ /* manifest + page options */ })],
});

Most plugins never call these directly — cc package drives the correct pass for the plugin's declared render mode. Reach for the factories when you maintain a bespoke build or need the validators/codegen in tests.

Build and test

npm ci && npm run build && npm test

Last Updated: 2026-07-10