@jasonshimmy/custom-elements-runtime 3.0.0 → 3.1.0

package/dist/vite-plugin.d.ts

@@ -1,10 +1,18 @@
 /**
- * Vite plugin for build-time JIT CSS generation.
+ * Vite plugins for build-time JIT CSS generation and SSR configuration.
  *
- * Scans source files for utility class names and emits pre-generated CSS,
- * eliminating all runtime parsing cost for projects with static class lists.
+ * Two plugins are exported:
  *
- * @example
+ * - **`cerJITCSS`** — Scans source files for utility class names and emits
+ *   pre-generated CSS, eliminating all runtime parsing cost for projects with
+ *   static class lists.
+ *
+ * - **`cerPlugin`** — All-in-one plugin combining `cerJITCSS` with SSR
+ *   configuration. Exposes a `virtual:cer-ssr-config` module containing the
+ *   resolved SSR render options so server entry files can import and use them
+ *   without duplication.
+ *
+ * @example cerJITCSS only
  * ```ts
  * // vite.config.ts
  * import { defineConfig } from 'vite';
@@ -20,6 +28,33 @@
  *   ],
  * });
  * ```
+ *
+ * @example cerPlugin with SSR
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import { cerPlugin } from '@jasonshimmy/custom-elements-runtime/vite-plugin';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     cerPlugin({
+ *       content: ['./src/**\/*.{ts,tsx,html}'],
+ *       ssr: {
+ *         dsd: true,
+ *         jit: { extendedColors: true },
+ *       },
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * Then in your server entry:
+ * ```ts
+ * import ssrConfig from 'virtual:cer-ssr-config';
+ * import { renderToStringWithJITCSS } from '@jasonshimmy/custom-elements-runtime/ssr';
+ *
+ * const { htmlWithStyles } = renderToStringWithJITCSS(appVNode, ssrConfig);
+ * ```
  */
 import type { Plugin } from 'vite';
 import { type JITCSSOptions } from './runtime/style';
@@ -45,6 +80,61 @@ export interface CerJITCSSPluginOptions extends JITCSSOptions {
      */
     virtualModule?: boolean;
 }
+/**
+ * SSR render options exposed via `virtual:cer-ssr-config`.
+ */
+export interface CerSSROptions {
+    /**
+     * Emit Declarative Shadow DOM output for registered custom elements.
+     * @default true
+     */
+    dsd?: boolean;
+    /**
+     * Append the DSD polyfill `<script>` for browsers without native support.
+     * @default true
+     */
+    dsdPolyfill?: boolean;
+    /**
+     * JIT CSS options forwarded to the SSR render pass.
+     */
+    jit?: JITCSSOptions;
+}
+/**
+ * Options for the combined {@link cerPlugin}.
+ */
+export interface CerPluginOptions extends Partial<CerJITCSSPluginOptions> {
+    /**
+     * SSR configuration. When provided, a `virtual:cer-ssr-config` module is
+     * registered so server entry files can import the resolved render options:
+     *
+     * ```ts
+     * import ssrConfig from 'virtual:cer-ssr-config';
+     * import { renderToStringWithJITCSS } from '@jasonshimmy/custom-elements-runtime/ssr';
+     *
+     * const { htmlWithStyles } = renderToStringWithJITCSS(appVNode, ssrConfig);
+     * ```
+     */
+    ssr?: CerSSROptions;
+}
+/**
+ * All-in-one Vite plugin combining build-time JIT CSS generation with SSR
+ * configuration. Returns an array of plugins so it can be spread directly
+ * into the `plugins` array without nesting.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * export default defineConfig({
+ *   plugins: [
+ *     cerPlugin({
+ *       content: ['./src/**\/*.{ts,html}'],
+ *       ssr: { dsd: true, jit: { extendedColors: true } },
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function cerPlugin(options: CerPluginOptions): Plugin[];
 /**
  * Vite plugin that performs a build-time scan of source files and emits
  * pre-generated JIT CSS as a file and/or `virtual:cer-jit-css` module.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jasonshimmy/custom-elements-runtime",
   "description": "A powerful, modern, and lightweight runtime for creating reactive web components with TypeScript",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "type": "module",
   "keywords": [
     "web-components",
@@ -164,6 +164,11 @@
       "types": "./dist/vite-plugin.d.ts",
       "import": "./dist/custom-elements-runtime.vite-plugin.es.js",
       "require": "./dist/custom-elements-runtime.vite-plugin.cjs.js"
+    },
+    "./ssr-middleware": {
+      "types": "./dist/ssr-middleware.d.ts",
+      "import": "./dist/custom-elements-runtime.ssr-middleware.es.js",
+      "require": "./dist/custom-elements-runtime.ssr-middleware.cjs.js"
     }
   },
   "publishConfig": {