@ethisyscore/vite-plugin 1.121.0 → 1.122.0

package/dist/index.d.cts

@@ -599,6 +599,30 @@ interface PlatformReactBuildSummary {
  * Runs in `renderChunk`, before the host-verified digest is computed.
  */
 declare function rewriteAliasedExternalImports(): Plugin;
+/**
+ * Fail the BUILD when a bundle emits an externalised specifier in a form the host's
+ * loader cannot rewrite.
+ *
+ * The host fetches a bundle as text, finds its imports with `es-module-lexer`, and
+ * rewrites each import of a REGISTERED specifier into a read from its module registry.
+ * That rewriter deliberately handles only a closed set of forms. It SKIPS:
+ *
+ *   - dynamic `import("spec")`            (`record.d !== -1`)
+ *   - import attributes (`with { … }`)    (`record.a !== -1`)
+ *   - anything no `IMPORT_FORMS` regex matches, notably `export … from "spec"`
+ *
+ * and a skipped statement is left VERBATIM. A bare specifier that survives into a Blob
+ * URL module is unresolvable, so the surface dies at mount, before any plugin code runs
+ * — with no build-time signal and a stack trace that points at the host, not the plugin
+ * that caused it.
+ *
+ * Today no plugin in the estate emits either form, so this guard is quiet. It exists so
+ * that the day someone writes `const { DataGrid } = await import("@mui/x-data-grid")` or
+ * re-exports a host package from a barrel, they get a build error naming the file instead
+ * of a blank surface in production. The check is on EMITTED syntax rather than source,
+ * because whether a source-level re-export survives bundling depends on the entry shape.
+ */
+declare function assertHostResolvableExternals(external: readonly string[]): Plugin;
 /**
  * Synthesise one isolated PlatformReact entry per surface straight from its
  * manifest declaration: `definePluginPage(Page, { …views })`, importing ONLY
@@ -1132,4 +1156,4 @@ interface EthisysPluginOptions {
  */
 declare function ethisysManifestPlugin(options?: EthisysPluginOptions): Plugin;
 
-export { type BuildPlatformReactPagesOptions, CONTRACT_B_IMPORT_MAP_ALLOWLIST, CONTRACT_B_RUNTIME_IMPORTS, CONTRACT_B_SEMANTIC_PRIMITIVES, type ComputePlatformReactPagesInput, type ComputePlatformReactPagesResult, type ContractAManifest, type ContractAPluginOptions, type ContractBManifest, type ContractBPluginOptions, EHX_PLUGIN_CSS_SCOPE, EHX_PLUGIN_ROOT_SCOPE, EHX_PLUGIN_SCOPE_ROOTS, EHX_SCOPED_CSS_LAYERS, type EthisysPluginOptions, type GeneratePlatformReactManifestConfig, type GeneratePlatformReactManifestResult, type IframeBuildContext, type IframeBuildOutputItem, type IframeBuildResult, type IframeSandboxBuildSummary, type IframeSandboxPluginOptions, type IframeViteBuild, type ManifestReactiveRuleRef, type ManifestResourceRef, PLATFORM_REACT_DEDUPE, PLATFORM_REACT_EXTERNALS, type ParsePlatformReactPagesOptions, type PlatformReactAlias, type PlatformReactBuildContext, type PlatformReactBuildSummary, type PlatformReactManifest, type PlatformReactManifestMeta, type PlatformReactManifestPaths, type PlatformReactPageDeclaration, type PlatformReactPageEntry, type PlatformReactPageInput, type PlatformReactPageOverride, type PlatformReactPageSource, type PlatformReactPluginOptions, type PlatformReactViteBuild, type ResolvedPlatformReactPage, type RouteMetaEntry, type ScopePluginCssOptions, type ValidationFailure, type ValidationResult, type ViteBuildFn, buildIframeSandboxPages, buildPlatformReactPages, computePlatformReactPages, ethisysContractAPlugin, ethisysContractBPlugin, ethisysIframeSandboxPlugin, ethisysManifestPlugin, ethisysPlatformReactPagesPlugin, ethisysPlatformReactPlugin, findUnscopedSelectors, formatUnscopedSelectorError, generatePlatformReactManifest, isScopableCssId, parseExportedNames, parsePlatformReactPages, rewriteAliasedExternalImports, scopePluginCss, scopePluginCssPlugin, validateDeclarativeResource, validateReactiveRule, virtualPageEntry };
+export { type BuildPlatformReactPagesOptions, CONTRACT_B_IMPORT_MAP_ALLOWLIST, CONTRACT_B_RUNTIME_IMPORTS, CONTRACT_B_SEMANTIC_PRIMITIVES, type ComputePlatformReactPagesInput, type ComputePlatformReactPagesResult, type ContractAManifest, type ContractAPluginOptions, type ContractBManifest, type ContractBPluginOptions, EHX_PLUGIN_CSS_SCOPE, EHX_PLUGIN_ROOT_SCOPE, EHX_PLUGIN_SCOPE_ROOTS, EHX_SCOPED_CSS_LAYERS, type EthisysPluginOptions, type GeneratePlatformReactManifestConfig, type GeneratePlatformReactManifestResult, type IframeBuildContext, type IframeBuildOutputItem, type IframeBuildResult, type IframeSandboxBuildSummary, type IframeSandboxPluginOptions, type IframeViteBuild, type ManifestReactiveRuleRef, type ManifestResourceRef, PLATFORM_REACT_DEDUPE, PLATFORM_REACT_EXTERNALS, type ParsePlatformReactPagesOptions, type PlatformReactAlias, type PlatformReactBuildContext, type PlatformReactBuildSummary, type PlatformReactManifest, type PlatformReactManifestMeta, type PlatformReactManifestPaths, type PlatformReactPageDeclaration, type PlatformReactPageEntry, type PlatformReactPageInput, type PlatformReactPageOverride, type PlatformReactPageSource, type PlatformReactPluginOptions, type PlatformReactViteBuild, type ResolvedPlatformReactPage, type RouteMetaEntry, type ScopePluginCssOptions, type ValidationFailure, type ValidationResult, type ViteBuildFn, assertHostResolvableExternals, buildIframeSandboxPages, buildPlatformReactPages, computePlatformReactPages, ethisysContractAPlugin, ethisysContractBPlugin, ethisysIframeSandboxPlugin, ethisysManifestPlugin, ethisysPlatformReactPagesPlugin, ethisysPlatformReactPlugin, findUnscopedSelectors, formatUnscopedSelectorError, generatePlatformReactManifest, isScopableCssId, parseExportedNames, parsePlatformReactPages, rewriteAliasedExternalImports, scopePluginCss, scopePluginCssPlugin, validateDeclarativeResource, validateReactiveRule, virtualPageEntry };

package/dist/index.d.ts

@@ -599,6 +599,30 @@ interface PlatformReactBuildSummary {
  * Runs in `renderChunk`, before the host-verified digest is computed.
  */
 declare function rewriteAliasedExternalImports(): Plugin;
+/**
+ * Fail the BUILD when a bundle emits an externalised specifier in a form the host's
+ * loader cannot rewrite.
+ *
+ * The host fetches a bundle as text, finds its imports with `es-module-lexer`, and
+ * rewrites each import of a REGISTERED specifier into a read from its module registry.
+ * That rewriter deliberately handles only a closed set of forms. It SKIPS:
+ *
+ *   - dynamic `import("spec")`            (`record.d !== -1`)
+ *   - import attributes (`with { … }`)    (`record.a !== -1`)
+ *   - anything no `IMPORT_FORMS` regex matches, notably `export … from "spec"`
+ *
+ * and a skipped statement is left VERBATIM. A bare specifier that survives into a Blob
+ * URL module is unresolvable, so the surface dies at mount, before any plugin code runs
+ * — with no build-time signal and a stack trace that points at the host, not the plugin
+ * that caused it.
+ *
+ * Today no plugin in the estate emits either form, so this guard is quiet. It exists so
+ * that the day someone writes `const { DataGrid } = await import("@mui/x-data-grid")` or
+ * re-exports a host package from a barrel, they get a build error naming the file instead
+ * of a blank surface in production. The check is on EMITTED syntax rather than source,
+ * because whether a source-level re-export survives bundling depends on the entry shape.
+ */
+declare function assertHostResolvableExternals(external: readonly string[]): Plugin;
 /**
  * Synthesise one isolated PlatformReact entry per surface straight from its
  * manifest declaration: `definePluginPage(Page, { …views })`, importing ONLY
@@ -1132,4 +1156,4 @@ interface EthisysPluginOptions {
  */
 declare function ethisysManifestPlugin(options?: EthisysPluginOptions): Plugin;
 
-export { type BuildPlatformReactPagesOptions, CONTRACT_B_IMPORT_MAP_ALLOWLIST, CONTRACT_B_RUNTIME_IMPORTS, CONTRACT_B_SEMANTIC_PRIMITIVES, type ComputePlatformReactPagesInput, type ComputePlatformReactPagesResult, type ContractAManifest, type ContractAPluginOptions, type ContractBManifest, type ContractBPluginOptions, EHX_PLUGIN_CSS_SCOPE, EHX_PLUGIN_ROOT_SCOPE, EHX_PLUGIN_SCOPE_ROOTS, EHX_SCOPED_CSS_LAYERS, type EthisysPluginOptions, type GeneratePlatformReactManifestConfig, type GeneratePlatformReactManifestResult, type IframeBuildContext, type IframeBuildOutputItem, type IframeBuildResult, type IframeSandboxBuildSummary, type IframeSandboxPluginOptions, type IframeViteBuild, type ManifestReactiveRuleRef, type ManifestResourceRef, PLATFORM_REACT_DEDUPE, PLATFORM_REACT_EXTERNALS, type ParsePlatformReactPagesOptions, type PlatformReactAlias, type PlatformReactBuildContext, type PlatformReactBuildSummary, type PlatformReactManifest, type PlatformReactManifestMeta, type PlatformReactManifestPaths, type PlatformReactPageDeclaration, type PlatformReactPageEntry, type PlatformReactPageInput, type PlatformReactPageOverride, type PlatformReactPageSource, type PlatformReactPluginOptions, type PlatformReactViteBuild, type ResolvedPlatformReactPage, type RouteMetaEntry, type ScopePluginCssOptions, type ValidationFailure, type ValidationResult, type ViteBuildFn, buildIframeSandboxPages, buildPlatformReactPages, computePlatformReactPages, ethisysContractAPlugin, ethisysContractBPlugin, ethisysIframeSandboxPlugin, ethisysManifestPlugin, ethisysPlatformReactPagesPlugin, ethisysPlatformReactPlugin, findUnscopedSelectors, formatUnscopedSelectorError, generatePlatformReactManifest, isScopableCssId, parseExportedNames, parsePlatformReactPages, rewriteAliasedExternalImports, scopePluginCss, scopePluginCssPlugin, validateDeclarativeResource, validateReactiveRule, virtualPageEntry };
+export { type BuildPlatformReactPagesOptions, CONTRACT_B_IMPORT_MAP_ALLOWLIST, CONTRACT_B_RUNTIME_IMPORTS, CONTRACT_B_SEMANTIC_PRIMITIVES, type ComputePlatformReactPagesInput, type ComputePlatformReactPagesResult, type ContractAManifest, type ContractAPluginOptions, type ContractBManifest, type ContractBPluginOptions, EHX_PLUGIN_CSS_SCOPE, EHX_PLUGIN_ROOT_SCOPE, EHX_PLUGIN_SCOPE_ROOTS, EHX_SCOPED_CSS_LAYERS, type EthisysPluginOptions, type GeneratePlatformReactManifestConfig, type GeneratePlatformReactManifestResult, type IframeBuildContext, type IframeBuildOutputItem, type IframeBuildResult, type IframeSandboxBuildSummary, type IframeSandboxPluginOptions, type IframeViteBuild, type ManifestReactiveRuleRef, type ManifestResourceRef, PLATFORM_REACT_DEDUPE, PLATFORM_REACT_EXTERNALS, type ParsePlatformReactPagesOptions, type PlatformReactAlias, type PlatformReactBuildContext, type PlatformReactBuildSummary, type PlatformReactManifest, type PlatformReactManifestMeta, type PlatformReactManifestPaths, type PlatformReactPageDeclaration, type PlatformReactPageEntry, type PlatformReactPageInput, type PlatformReactPageOverride, type PlatformReactPageSource, type PlatformReactPluginOptions, type PlatformReactViteBuild, type ResolvedPlatformReactPage, type RouteMetaEntry, type ScopePluginCssOptions, type ValidationFailure, type ValidationResult, type ViteBuildFn, assertHostResolvableExternals, buildIframeSandboxPages, buildPlatformReactPages, computePlatformReactPages, ethisysContractAPlugin, ethisysContractBPlugin, ethisysIframeSandboxPlugin, ethisysManifestPlugin, ethisysPlatformReactPagesPlugin, ethisysPlatformReactPlugin, findUnscopedSelectors, formatUnscopedSelectorError, generatePlatformReactManifest, isScopableCssId, parseExportedNames, parsePlatformReactPages, rewriteAliasedExternalImports, scopePluginCss, scopePluginCssPlugin, validateDeclarativeResource, validateReactiveRule, virtualPageEntry };

package/dist/index.js

@@ -936,6 +936,36 @@ var PLATFORM_REACT_EXTERNALS = [
   "react-dom",
   "@mui/material",
   "@mui/icons-material",
+  // MUI X. Every plugin previously shipped its own copy on top of the host's.
+  //
+  // EXACT STRINGS, and that is load-bearing rather than stylistic. Rolldown matches
+  // a string `external` by equality, verified by building an entry that imports both
+  // `date-fns` and `date-fns/addDays` against `external: ["date-fns"]`: the bare
+  // import stayed external, the subpath was bundled. So a prefix or regex matcher
+  // here would externalise `@mui/x-data-grid/style.css` and
+  // `@mui/x-date-pickers/AdapterDayjs` too, which the host does NOT register, and an
+  // external the host does not serve is an unresolvable bare import that kills the
+  // bundle before any plugin code runs. `startsWith("@mui/x-charts")` additionally
+  // swallows `@mui/x-charts-pro`. Add specifiers one at a time; never widen the match.
+  //
+  // THE CONSUMER-SIDE GATE: exact matching makes this safe but PARTIAL. A plugin that
+  // imports the package root AND a subpath of the same package gets TWO module
+  // instances, host-served and bundled, and React context does not cross that seam.
+  // The concrete break is `LocalizationProvider` from "@mui/x-date-pickers" (host)
+  // with `DatePicker` from "@mui/x-date-pickers/DatePicker" (bundled): the picker
+  // cannot see the provider's context and MUI throws "Can not find the date and time
+  // pickers localization context". Every root-exported symbol must therefore be
+  // imported from the ROOT once its package is externalised.
+  //
+  // `@mui/x-date-pickers/AdapterDayjs` is the deliberate exception and stays a
+  // sub-path import, because the root does not re-export it. That is safe here and it
+  // was checked rather than assumed: `LocalizationProvider` validates the adapter with
+  // `if (!dateAdapter.isMUIAdapter)`, a duck-typed flag, so a bundled adapter instance
+  // handed to the host's provider passes. Contrast `instanceof`, which would not.
+  "@mui/x-data-grid",
+  "@mui/x-charts",
+  "@mui/x-charts-pro",
+  "@mui/x-date-pickers",
   "@emotion/react",
   "@emotion/styled",
   "date-fns",
@@ -1027,6 +1057,34 @@ function rewriteAliasedExternalImports() {
     }
   };
 }
+function assertHostResolvableExternals(external) {
+  return {
+    name: "assert-host-resolvable-externals",
+    renderChunk(code, chunk) {
+      const offences = [];
+      for (const spec of external) {
+        const q = escapeRegExp(spec);
+        const reExport = new RegExp(`\\bexport\\s[^;]{0,200}?from\\s*["']${q}["']`);
+        const dynamic = new RegExp(`\\bimport\\s*\\(\\s*["']${q}["']\\s*\\)`);
+        if (reExport.test(code)) {
+          offences.push(`re-export of "${spec}" (export \u2026 from)`);
+        }
+        if (dynamic.test(code)) {
+          offences.push(`dynamic import of "${spec}"`);
+        }
+      }
+      if (offences.length > 0) {
+        throw new Error(
+          `[build-pages] ${chunk.fileName ?? "bundle"} emits host-provided specifiers in a form the host loader cannot rewrite, so the surface would fail to load at mount:
+` + offences.map((o) => `  - ${o}`).join("\n") + `
+
+Use a STATIC top-level import of the package root instead. A dynamic import of a host-provided package is never needed: the host already loads its namespaces on demand, per bundle. For a re-export, import the symbols and export them explicitly.`
+        );
+      }
+      return null;
+    }
+  };
+}
 function virtualPageEntry(page, config) {
   const VIRTUAL_ID = `\0virtual:surface/${page.id}`;
   const views = page.views ?? {};
@@ -1115,7 +1173,9 @@ function makeDefaultBuild(viteBuild) {
         ctx.surfacePlugin,
         ...ctx.plugins,
         scopePluginCssPlugin(),
-        rewriteAliasedExternalImports()
+        rewriteAliasedExternalImports(),
+        // Last, so it sees exactly the bytes the host will fetch.
+        assertHostResolvableExternals(ctx.external)
       ],
       resolve: {
         dedupe: [...ctx.dedupe],
@@ -1346,7 +1406,11 @@ function assertHostOriginRelativePath2(value, label) {
   }
 }
 function ethisysPlatformReactPlugin(options = {}) {
-  return [ethisysPlatformReactPagesPlugin(options), scopePluginCssPlugin()];
+  return [
+    ethisysPlatformReactPagesPlugin(options),
+    scopePluginCssPlugin(),
+    assertHostResolvableExternals([...PLATFORM_REACT_EXTERNALS, "@ethisyscore/host-ui-externals"])
+  ];
 }
 function ethisysPlatformReactPagesPlugin(options = {}) {
   const explicitRoot = options.root;
@@ -2283,6 +2347,6 @@ function ethisysManifestPlugin(options = {}) {
  * comment-free.
  */
 
-export { CONTRACT_B_IMPORT_MAP_ALLOWLIST, CONTRACT_B_RUNTIME_IMPORTS, CONTRACT_B_SEMANTIC_PRIMITIVES, EHX_PLUGIN_CSS_SCOPE, EHX_PLUGIN_ROOT_SCOPE, EHX_PLUGIN_SCOPE_ROOTS, EHX_SCOPED_CSS_LAYERS, PLATFORM_REACT_DEDUPE, PLATFORM_REACT_EXTERNALS, buildIframeSandboxPages, buildPlatformReactPages, computePlatformReactPages, ethisysContractAPlugin, ethisysContractBPlugin, ethisysIframeSandboxPlugin, ethisysManifestPlugin, ethisysPlatformReactPagesPlugin, ethisysPlatformReactPlugin, findUnscopedSelectors, formatUnscopedSelectorError, generatePlatformReactManifest, isScopableCssId, parseExportedNames, parsePlatformReactPages, rewriteAliasedExternalImports, scopePluginCss, scopePluginCssPlugin, validateDeclarativeResource, validateReactiveRule, virtualPageEntry };
+export { CONTRACT_B_IMPORT_MAP_ALLOWLIST, CONTRACT_B_RUNTIME_IMPORTS, CONTRACT_B_SEMANTIC_PRIMITIVES, EHX_PLUGIN_CSS_SCOPE, EHX_PLUGIN_ROOT_SCOPE, EHX_PLUGIN_SCOPE_ROOTS, EHX_SCOPED_CSS_LAYERS, PLATFORM_REACT_DEDUPE, PLATFORM_REACT_EXTERNALS, assertHostResolvableExternals, buildIframeSandboxPages, buildPlatformReactPages, computePlatformReactPages, ethisysContractAPlugin, ethisysContractBPlugin, ethisysIframeSandboxPlugin, ethisysManifestPlugin, ethisysPlatformReactPagesPlugin, ethisysPlatformReactPlugin, findUnscopedSelectors, formatUnscopedSelectorError, generatePlatformReactManifest, isScopableCssId, parseExportedNames, parsePlatformReactPages, rewriteAliasedExternalImports, scopePluginCss, scopePluginCssPlugin, validateDeclarativeResource, validateReactiveRule, virtualPageEntry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map