@master/css-server 2.0.0-rc.8 → 2.0.0-rc.81

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) Aoyue Design LLC.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -10,7 +10,7 @@
         </picture>
     </a>
 </p>
-<p align="center">Generate Master CSS text from markup on the server</p>
+<p align="center">Server-side HTML renderer for Master CSS</p>
 
 <p align="center">
     <a aria-label="GitHub release (latest by date including pre-releases)" href="https://github.com/master-co/css/releases">
@@ -41,16 +41,58 @@
             <img alt="Follow @mastercorg" src="https://img.shields.io/static/v1?label=%20&message=twitter&color=f6f7f8&logo=twitter&style=for-the-badge">
         </picture>
     </a>
-    <a aria-label="Github Actions" href="https://github.com/1aron/repo/actions/workflows/release.yml">
+    <a aria-label="Github Actions" href="https://github.com/master-co/css/actions/workflows/ci-release.yml">
         <picture>
-            <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/actions/workflow/status/master-co/css/release.yml?branch=rc&label=%20&message=twitter&color=212022&logo=githubactions&style=for-the-badge">
-            <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/actions/workflow/status/master-co/css/release.yml?branch=rc&label=%20&message=twitter&color=f6f7f8&logo=githubactions&style=for-the-badge&logoColor=%23000">
-            <img alt="Github release actions" src="https://img.shields.io/github/actions/workflow/status/master-co/css/release.yml?branch=rc&label=%20&message=twitter&color=f6f7f8&logo=githubactions&style=for-the-badge&logoColor=%23000">
+            <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/actions/workflow/status/master-co/css/ci-release.yml?branch=rc&label=%20&message=twitter&color=212022&logo=githubactions&style=for-the-badge">
+            <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/actions/workflow/status/master-co/css/ci-release.yml?branch=rc&label=%20&message=twitter&color=f6f7f8&logo=githubactions&style=for-the-badge&logoColor=%23000">
+            <img alt="Github release actions" src="https://img.shields.io/github/actions/workflow/status/master-co/css/ci-release.yml?branch=rc&label=%20&message=twitter&color=f6f7f8&logo=githubactions&style=for-the-badge&logoColor=%23000">
         </picture>
     </a>
 </p>
 
 </div>
 
-## Documentation
-Check out the official [documentation](https://rc.css.master.co/docs/server).
+## Installation
+
+```bash
+npm install @master/css-server
+```
+
+`@master/css-server` renders required Master CSS from HTML. It parses HTML, extracts class names, creates a `MasterCSS` instance, and injects or updates `<style id="master-css">`.
+
+## API
+
+### `render()`
+
+Render HTML and inject generated CSS.
+
+```ts
+import { render } from '@master/css-server'
+
+const result = render('<div class="text:center"></div>', manifest)
+
+console.log(result.html)
+console.log(result.css.text)
+```
+
+### `renderCSS()`
+
+Render only the CSS needed by an HTML string.
+
+```ts
+import { renderCSS } from '@master/css-server'
+
+const css = renderCSS('<div class="text:center"></div>', manifest)
+```
+
+### `parseHTML()`
+
+Parse HTML into the lightweight DOM representation used by the server renderer.
+
+```ts
+import { parseHTML } from '@master/css-server'
+
+const document = parseHTML('<html><head></head><body></body></html>')
+```
+
+Use official framework integrations when possible; they compose this package with manifest loading, source scanning, and runtime hydration.

package/dist/create-server-css.d.ts

@@ -0,0 +1,2 @@
+import { createCSSWithNativeDeclarations } from "@master/css-validator";
+export { createCSSWithNativeDeclarations as default };

package/dist/create-server-css.js

@@ -0,0 +1,5 @@
+import { createCSSWithNativeDeclarations } from "@master/css-validator";
+//#region src/create-server-css.ts
+var create_server_css_default = createCSSWithNativeDeclarations;
+//#endregion
+export { create_server_css_default as default };

package/dist/decode-html.d.ts

@@ -1 +1,4 @@
-export default function decodeHTML(html: string): string;
+//#region src/decode-html.d.ts
+declare function decodeHTML(html: string): string;
+//#endregion
+export { decodeHTML as default };

package/dist/decode-html.js

@@ -1 +1,17 @@
-"use strict";var u=Object.defineProperty;var n=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var l=(t,e)=>{for(var r in e)u(t,r,{get:e[r],enumerable:!0})},d=(t,e,r,c)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of o(e))!p.call(t,a)&&a!==r&&u(t,a,{get:()=>e[a],enumerable:!(c=n(e,a))||c.enumerable});return t};var g=t=>d(u({},"__esModule",{value:!0}),t);var f={};l(f,{default:()=>s});module.exports=g(f);function s(t){return t.replace(/&(amp|apos|#39|#x27|quot|lt|gt);/g,(e,r)=>{switch(r){case"amp":return"&";case"apos":case"#39":case"#x27":return"'";case"quot":return'"';case"lt":return"<";case"gt":return">";default:return e}})}
+//#region src/decode-html.ts
+function decodeHTML(html) {
+	return html.replace(/&(amp|apos|#39|#x27|quot|lt|gt);/g, (match, entity) => {
+		switch (entity) {
+			case "amp": return "&";
+			case "apos":
+			case "#39":
+			case "#x27": return "'";
+			case "quot": return "\"";
+			case "lt": return "<";
+			case "gt": return ">";
+			default: return match;
+		}
+	});
+}
+//#endregion
+export { decodeHTML as default };

package/dist/default-manifest.d.ts

@@ -0,0 +1,6 @@
+import { MasterCSSManifest } from "@master/css-schema/manifest";
+
+//#region src/default-manifest.d.ts
+declare function getDefaultManifest(): MasterCSSManifest;
+//#endregion
+export { getDefaultManifest as default };

package/dist/default-manifest.js

@@ -0,0 +1,8 @@
+import defaultManifestJSON from "@master/css-preset/default-manifest.json" with { type: "json" };
+//#region src/default-manifest.ts
+const defaultManifest = defaultManifestJSON;
+function getDefaultManifest() {
+	return defaultManifest;
+}
+//#endregion
+export { getDefaultManifest as default };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
-export { default as render } from './render';
-export { default as renderCSS } from './render-css';
-export { default as parseHTML } from './parse-html';
+import render, { RenderHydrationManifestOption, RenderOptions, RenderResult } from "./render.js";
+import renderCSS from "./render-css.js";
+import parseHTML from "./parse-html.js";
+import createServerCSS from "./create-server-css.js";
+export { type RenderHydrationManifestOption, type RenderOptions, type RenderResult, createServerCSS, parseHTML, render, renderCSS };

package/dist/index.js

@@ -1 +1,5 @@
-"use strict";var u=Object.create;var o=Object.defineProperty;var x=Object.getOwnPropertyDescriptor;var n=Object.getOwnPropertyNames;var S=Object.getPrototypeOf,C=Object.prototype.hasOwnProperty;var H=(e,r)=>{for(var a in r)o(e,a,{get:r[a],enumerable:!0})},p=(e,r,a,d)=>{if(r&&typeof r=="object"||typeof r=="function")for(let f of n(r))!C.call(e,f)&&f!==a&&o(e,f,{get:()=>r[f],enumerable:!(d=x(r,f))||d.enumerable});return e};var t=(e,r,a)=>(a=e!=null?u(S(e)):{},p(r||!e||!e.__esModule?o(a,"default",{value:e,enumerable:!0}):a,e)),L=e=>p(o({},"__esModule",{value:!0}),e);var M={};H(M,{parseHTML:()=>m.default,render:()=>s.default,renderCSS:()=>l.default});module.exports=L(M);var s=t(require("./render")),l=t(require("./render-css")),m=t(require("./parse-html"));0&&(module.exports={parseHTML,render,renderCSS});
+import create_server_css_default from "./create-server-css.js";
+import parseHTML from "./parse-html.js";
+import render from "./render.js";
+import renderCSS from "./render-css.js";
+export { create_server_css_default as createServerCSS, parseHTML, render, renderCSS };

package/dist/parse-html.d.ts

@@ -1,12 +1,16 @@
-import type { ChildNode, Element } from 'domhandler';
+import { ChildNode, Element } from "domhandler";
+
+//#region src/parse-html.d.ts
 /**
  * @param html
  * @returns {classes from html, root element}
  */
-export default function parseHTML(html: string): {
-    classes: string[];
-    nodes: ChildNode[];
-    htmlElement: Element | null;
-    headElement: Element | null;
-    styleElement: Element | null;
+declare function parseHTML(html: string): {
+  classes: string[];
+  nodes: ChildNode[];
+  htmlElement: Element | null;
+  headElement: Element | null;
+  styleElement: Element | null;
 };
+//#endregion
+export { parseHTML as default };

package/dist/parse-html.js

@@ -1 +1,43 @@
-"use strict";var f=Object.create;var i=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var p=Object.getPrototypeOf,b=Object.prototype.hasOwnProperty;var y=(e,l)=>{for(var t in l)i(e,t,{get:l[t],enumerable:!0})},u=(e,l,t,r)=>{if(l&&typeof l=="object"||typeof l=="function")for(let s of c(l))!b.call(e,s)&&s!==t&&i(e,s,{get:()=>l[s],enumerable:!(r=h(l,s))||r.enumerable});return e};var g=(e,l,t)=>(t=e!=null?f(p(e)):{},u(l||!e||!e.__esModule?i(t,"default",{value:e,enumerable:!0}):t,e)),k=e=>u(i({},"__esModule",{value:!0}),e);var w={};y(w,{default:()=>E});module.exports=k(w);var o=require("htmlparser2"),m=g(require("./decode-html"));function E(e){const l=[];let t=null,r=null,s=null;const a=new o.DomHandler(void 0,{},n=>{if(n.type==="tag")switch(n.name){case"html":t=n;break;case"head":r=n;break;default:break}else n.type==="style"&&n.attribs.id==="master"&&(s=n);n.attribs.class&&n.attribs.class.split(" ").forEach(d=>{d=(0,m.default)(d),l.includes(d)||l.push(d)})});return new o.Parser(a,{decodeEntities:!1}).end(e),{classes:l,nodes:a.root.childNodes,htmlElement:t,headElement:r,styleElement:s}}
+import decodeHTML from "./decode-html.js";
+import { MASTER_CSS_RUNTIME_STYLE_ID } from "@master/css-schema/runtime-style";
+import { DomHandler, Parser } from "htmlparser2";
+//#region src/parse-html.ts
+/**
+* @param html
+* @returns {classes from html, root element}
+*/
+function parseHTML(html) {
+	const classes = [];
+	let htmlElement = null;
+	let headElement = null;
+	let styleElement = null;
+	const handler = new DomHandler(void 0, {}, (element) => {
+		if (element.type === "tag") switch (element.name) {
+			case "html":
+				htmlElement = element;
+				break;
+			case "head":
+				headElement = element;
+				break;
+			default: break;
+		}
+		else if (element.type === "style") {
+			if (element.attribs.id === MASTER_CSS_RUNTIME_STYLE_ID) styleElement = element;
+		}
+		if (element.attribs.class) element.attribs.class.trim().split(/\s+/).forEach((className) => {
+			if (!className) return;
+			className = decodeHTML(className);
+			if (!classes.includes(className)) classes.push(className);
+		});
+	});
+	new Parser(handler, { decodeEntities: false }).end(html);
+	return {
+		classes,
+		nodes: handler.root.childNodes,
+		htmlElement,
+		headElement,
+		styleElement
+	};
+}
+//#endregion
+export { parseHTML as default };

package/dist/render-css.d.ts

@@ -1,8 +1,13 @@
-import MasterCSS, { Config } from '@master/css';
+import { MasterCSS } from "@master/css";
+import { MasterCSSManifest } from "@master/css-schema/manifest";
+
+//#region src/render-css.d.ts
 /**
  * Renders the Master CSS string from HTML
  * @param html
- * @param config
+ * @param manifest
  * @returns MasterCSS
  */
-export default function renderCSS(html: string, config?: Config): MasterCSS | undefined;
+declare function renderCSS(html: string, manifest?: MasterCSSManifest): MasterCSS | undefined;
+//#endregion
+export { renderCSS as default };

package/dist/render-css.js

@@ -1 +1,20 @@
-"use strict";var u=Object.create;var s=Object.defineProperty;var S=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var g=Object.getPrototypeOf,p=Object.prototype.hasOwnProperty;var m=(r,e)=>{for(var n in e)s(r,n,{get:e[n],enumerable:!0})},f=(r,e,n,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of C(e))!p.call(r,t)&&t!==n&&s(r,t,{get:()=>e[t],enumerable:!(o=S(e,t))||o.enumerable});return r};var i=(r,e,n)=>(n=r!=null?u(g(r)):{},f(e||!r||!r.__esModule?s(n,"default",{value:r,enumerable:!0}):n,r)),M=r=>f(s({},"__esModule",{value:!0}),r);var l={};m(l,{default:()=>d});module.exports=M(l);var a=i(require("./parse-html")),c=i(require("@master/css"));function d(r,e){if(!r)return;const{classes:n}=(0,a.default)(r);if(!n.length)return;const o=new c.default(e);return n.forEach(t=>o.add(t)),o}
+import create_server_css_default from "./create-server-css.js";
+import getDefaultManifest from "./default-manifest.js";
+import parseHTML from "./parse-html.js";
+//#region src/render-css.ts
+/**
+* Renders the Master CSS string from HTML
+* @param html
+* @param manifest
+* @returns MasterCSS
+*/
+function renderCSS(html, manifest) {
+	if (!html) return;
+	const { classes } = parseHTML(html);
+	if (!classes.length) return;
+	const css = create_server_css_default(manifest || getDefaultManifest());
+	classes.forEach((eachClass) => css.ensureClassRules(eachClass));
+	return css;
+}
+//#endregion
+export { renderCSS as default };

package/dist/render.d.ts

@@ -1,16 +1,33 @@
-import MasterCSS, { Config } from '@master/css';
-import { Element, ChildNode } from 'domhandler';
+import { MasterCSS } from "@master/css";
+import { MasterCSSHydrationManifest } from "@master/css-schema/hydration-manifest";
+import { ChildNode, Element } from "domhandler";
+import { MasterCSSManifest } from "@master/css-schema/manifest";
+
+//#region src/render.d.ts
+type RenderExternalHydrationManifestSource = string | ((json: string, hydrationManifest: MasterCSSHydrationManifest) => string);
+interface RenderExternalHydrationManifestOption {
+  type: 'external';
+  src: RenderExternalHydrationManifestSource;
+}
+type RenderHydrationManifestOption = 'return' | 'inject' | false | RenderExternalHydrationManifestOption;
+interface RenderOptions {
+  hydrationManifest?: RenderHydrationManifestOption;
+}
+interface RenderResult {
+  html: string;
+  css?: MasterCSS;
+  classes: string[];
+  nodes: ChildNode[];
+  htmlElement: Element | null;
+  headElement: Element | null;
+  styleElement: Element | null;
+  hydrationManifest?: MasterCSSHydrationManifest;
+}
 /**
  * Renders the page-required and sorted CSS text from HTML and injected it back into HTML
  * @param html
- * @param config
+ * @param manifest
  */
-export default function render(html: string, config?: Config): {
-    html: string;
-    css?: MasterCSS;
-    classes: string[];
-    nodes: ChildNode[];
-    htmlElement: Element | null;
-    headElement: Element | null;
-    styleElement: Element | null;
-};
+declare function render(html: string, manifest?: MasterCSSManifest, options?: RenderOptions): RenderResult;
+//#endregion
+export { RenderExternalHydrationManifestOption, RenderExternalHydrationManifestSource, RenderHydrationManifestOption, RenderOptions, RenderResult, render as default };

package/dist/render.js

@@ -1 +1,165 @@
-"use strict";var C=Object.create;var f=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var N=Object.getPrototypeOf,S=Object.prototype.hasOwnProperty;var y=(e,t)=>{for(var n in t)f(e,n,{get:t[n],enumerable:!0})},a=(e,t,n,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of x(t))!S.call(e,s)&&s!==n&&f(e,s,{get:()=>t[s],enumerable:!(i=w(t,s))||i.enumerable});return e};var h=(e,t,n)=>(n=e!=null?C(N(e)):{},a(t||!e||!e.__esModule?f(n,"default",{value:e,enumerable:!0}):n,e)),M=e=>a(f({},"__esModule",{value:!0}),e);var T={};y(T,{default:()=>p});module.exports=M(T);var c=h(require("@master/css")),E=h(require("./parse-html")),r=require("domhandler"),u=h(require("dom-serializer"));function p(e,t){const n=(0,E.default)(e),{classes:i,nodes:s,htmlElement:d}=n;let{headElement:o,styleElement:l}=n;if(!i.length)return{html:e,classes:i,nodes:s,htmlElement:d,headElement:o,styleElement:l};const m=new c.default(t);return i.forEach(g=>m.add(g)),l?l.childNodes=[new r.Text(m.text)]:(l=new r.Element("style",{id:"master"},[new r.Text(m.text)]),o?o.childNodes.push(l):d?(o=new r.Element("head",{},[l]),d.childNodes.unshift(o)):s.unshift(l)),{html:(0,u.default)(s,{decodeEntities:!1,encodeEntities:!1}),css:m,classes:i,nodes:s,htmlElement:d,headElement:o,styleElement:l}}
+import create_server_css_default from "./create-server-css.js";
+import getDefaultManifest from "./default-manifest.js";
+import parseHTML from "./parse-html.js";
+import { createHydrationManifest } from "@master/css";
+import { MASTER_CSS_HYDRATION_MANIFEST_ATTR, MASTER_CSS_HYDRATION_MANIFEST_SCRIPT_ID, serializeMasterCSSHydrationManifest } from "@master/css-schema/hydration-manifest";
+import { MASTER_CSS_RUNTIME_STYLE_ID } from "@master/css-schema/runtime-style";
+import { Element, Text } from "domhandler";
+import serialize from "dom-serializer";
+//#region src/render.ts
+function createHydrationManifestScript(hydrationManifest) {
+	return new Element("script", {
+		type: "application/json",
+		id: MASTER_CSS_HYDRATION_MANIFEST_SCRIPT_ID
+	}, [new Text(serializeMasterCSSHydrationManifest(hydrationManifest))]);
+}
+function isHydrationManifestScript(node) {
+	return node.type === "script" && node.name === "script" && node.attribs.id === MASTER_CSS_HYDRATION_MANIFEST_SCRIPT_ID;
+}
+function setHydrationManifestScript(element, hydrationManifest) {
+	element.attribs.type = "application/json";
+	element.attribs.id = MASTER_CSS_HYDRATION_MANIFEST_SCRIPT_ID;
+	element.childNodes = [new Text(serializeMasterCSSHydrationManifest(hydrationManifest))];
+}
+function isExternalHydrationManifestOption(hydrationManifest) {
+	return typeof hydrationManifest === "object" && hydrationManifest?.type === "external";
+}
+function getExternalHydrationManifestSource(option, hydrationManifest) {
+	const json = serializeMasterCSSHydrationManifest(hydrationManifest);
+	return typeof option.src === "function" ? option.src(json, hydrationManifest) : option.src;
+}
+function findHydrationManifestScripts(childNodes, matches = []) {
+	for (let index = 0; index < childNodes.length; index++) {
+		const node = childNodes[index];
+		if (isHydrationManifestScript(node)) matches.push({
+			element: node,
+			childNodes,
+			index
+		});
+		if ("childNodes" in node) findHydrationManifestScripts(node.childNodes, matches);
+	}
+	return matches;
+}
+function removeNode(nodes, target) {
+	const index = nodes.indexOf(target);
+	if (index !== -1) {
+		nodes.splice(index, 1);
+		return true;
+	}
+	for (const node of nodes) if ("childNodes" in node && removeNode(node.childNodes, target)) return true;
+	return false;
+}
+function removeHydrationManifestScripts(nodes) {
+	const existingScripts = findHydrationManifestScripts(nodes);
+	for (let index = existingScripts.length - 1; index >= 0; index--) {
+		const script = existingScripts[index];
+		script.childNodes.splice(script.index, 1);
+	}
+	return existingScripts.length > 0;
+}
+function removeExternalHydrationManifest(styleElement) {
+	if (styleElement) delete styleElement.attribs[MASTER_CSS_HYDRATION_MANIFEST_ATTR];
+}
+function injectExternalHydrationManifest(nodes, styleElement, src) {
+	removeHydrationManifestScripts(nodes);
+	if (styleElement) styleElement.attribs[MASTER_CSS_HYDRATION_MANIFEST_ATTR] = src;
+}
+function injectHydrationManifest(nodes, htmlElement, headElement, styleElement, hydrationManifest) {
+	removeExternalHydrationManifest(styleElement);
+	const existingScripts = findHydrationManifestScripts(nodes);
+	if (existingScripts.length) {
+		const [firstScript, ...duplicateScripts] = existingScripts;
+		setHydrationManifestScript(firstScript.element, hydrationManifest);
+		for (let index = duplicateScripts.length - 1; index >= 0; index--) {
+			const script = duplicateScripts[index];
+			script.childNodes.splice(script.index, 1);
+		}
+		return;
+	}
+	const scriptElement = createHydrationManifestScript(hydrationManifest);
+	if (headElement) headElement.childNodes.push(scriptElement);
+	else if (htmlElement) {
+		headElement = new Element("head", {}, [scriptElement]);
+		htmlElement.childNodes.unshift(headElement);
+	} else {
+		const styleElementIndex = styleElement ? nodes.indexOf(styleElement) : -1;
+		if (styleElementIndex === -1) nodes.unshift(scriptElement);
+		else nodes.splice(styleElementIndex + 1, 0, scriptElement);
+	}
+}
+/**
+* Renders the page-required and sorted CSS text from HTML and injected it back into HTML
+* @param html
+* @param manifest
+*/
+function render(html, manifest, options = {}) {
+	const context = parseHTML(html);
+	const { classes, nodes, htmlElement } = context;
+	let { headElement, styleElement } = context;
+	const externalHydrationManifestOption = isExternalHydrationManifestOption(options.hydrationManifest) ? options.hydrationManifest : void 0;
+	if (!classes.length && externalHydrationManifestOption) {
+		removeHydrationManifestScripts(nodes);
+		removeExternalHydrationManifest(styleElement);
+	}
+	if (!classes.length) return {
+		html: externalHydrationManifestOption ? serialize(nodes, {
+			decodeEntities: false,
+			encodeEntities: false
+		}) : html,
+		classes,
+		nodes,
+		htmlElement,
+		headElement,
+		styleElement
+	};
+	const css = create_server_css_default(manifest || getDefaultManifest());
+	classes.forEach((eachClass) => css.ensureClassRules(eachClass));
+	const hydrationManifest = options.hydrationManifest === false ? void 0 : createHydrationManifest(css);
+	if (!css.text) {
+		if ((options.hydrationManifest === "inject" || externalHydrationManifestOption) && styleElement) {
+			removeNode(nodes, styleElement);
+			styleElement = null;
+		}
+		if (externalHydrationManifestOption) removeHydrationManifestScripts(nodes);
+		return {
+			html: serialize(nodes, {
+				decodeEntities: false,
+				encodeEntities: false
+			}),
+			css,
+			classes,
+			hydrationManifest,
+			nodes,
+			htmlElement,
+			headElement,
+			styleElement
+		};
+	}
+	if (styleElement) styleElement.childNodes = [new Text(css.text)];
+	else {
+		styleElement = new Element("style", { id: MASTER_CSS_RUNTIME_STYLE_ID }, [new Text(css.text)]);
+		if (headElement) headElement.childNodes.push(styleElement);
+		else if (htmlElement) {
+			headElement = new Element("head", {}, [styleElement]);
+			htmlElement.childNodes.unshift(headElement);
+		} else nodes.unshift(styleElement);
+	}
+	if (options.hydrationManifest === "inject" && hydrationManifest?.rules.length) injectHydrationManifest(nodes, htmlElement, headElement, styleElement, hydrationManifest);
+	else if (externalHydrationManifestOption && hydrationManifest?.rules.length) injectExternalHydrationManifest(nodes, styleElement, getExternalHydrationManifestSource(externalHydrationManifestOption, hydrationManifest));
+	else removeExternalHydrationManifest(styleElement);
+	return {
+		html: serialize(nodes, {
+			decodeEntities: false,
+			encodeEntities: false
+		}),
+		css,
+		classes,
+		hydrationManifest,
+		nodes,
+		htmlElement,
+		headElement,
+		styleElement
+	};
+}
+//#endregion
+export { render as default };

package/package.json

@@ -1 +1,66 @@
-{"name":"@master/css-server","scripts":{"build":"techor pack \"./src/**/*.ts\" --platform node --declare","dev":"pnpm run build --watch","lint":"eslint ./src","type-check":"tsc --noEmit","test":"jest"},"license":"MIT","description":"Generate Master CSS text from markup on the server","author":"Aoyue Design LLC.","funding":"https://css.master.co/docs/donate","homepage":"https://css.master.co","bugs":{"url":"https://github.com/master-co/css/issues"},"repository":{"type":"git","url":"https://github.com/master-co/css.git","directory":"packages/server"},"keywords":["server","static","html","markup","dom","css","mastercss"],"sideEffects":false,"main":"./dist/index.js","module":"./dist/index.mjs","jsnext:main":"./dist/index.mjs","esnext":"./dist/index.mjs","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/index.mjs","require":"./dist/index.js","types":"./dist/index.d.ts"}},"files":["dist"],"publishConfig":{"access":"public"},"dependencies":{"@master/css":"^2.0.0-rc.8","htmlparser2":"^9.0.0"},"version":"2.0.0-rc.8"}
+{
+  "name": "@master/css-server",
+  "type": "module",
+  "license": "MIT",
+  "description": "Server-side HTML renderer for Master CSS",
+  "author": "Aoyue Design LLC.",
+  "funding": "https://rc.css.master.co/sponsor",
+  "homepage": "https://css.master.co",
+  "bugs": {
+    "url": "https://github.com/master-co/css/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/master-co/css.git",
+    "directory": "packages/server"
+  },
+  "keywords": [
+    "server",
+    "static",
+    "html",
+    "markup",
+    "dom",
+    "css",
+    "mastercss"
+  ],
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "jsnext:main": "./dist/index.js",
+  "esnext": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "dom-serializer": "^3.1.1",
+    "domhandler": "^6.0.1",
+    "htmlparser2": "^12.0.0",
+    "@master/css": "^2.0.0-rc.81",
+    "@master/css-preset": "^2.0.0-rc.81",
+    "@master/css-schema": "^2.0.0-rc.81",
+    "@master/css-validator": "^2.0.0-rc.81"
+  },
+  "devDependencies": {
+    "@master/css-compiler": "^2.0.0-rc.81"
+  },
+  "version": "2.0.0-rc.81",
+  "scripts": {
+    "build": "tsdown --config ../../shared/tsdown-package.config.ts && node scripts/restore-json-import-attributes.js",
+    "dev": "tsdown --config ../../shared/tsdown-package.config.ts --watch",
+    "lint": "eslint",
+    "type-check": "tsc -b tsconfig.typecheck.json",
+    "test": "vitest"
+  }
+}

package/dist/decode-html.mjs

@@ -1 +0,0 @@
-function a(e){return e.replace(/&(amp|apos|#39|#x27|quot|lt|gt);/g,(t,r)=>{switch(r){case"amp":return"&";case"apos":case"#39":case"#x27":return"'";case"quot":return'"';case"lt":return"<";case"gt":return">";default:return t}})}export{a as default};

package/dist/index.mjs

@@ -1 +0,0 @@
-import{default as a}from"./render.mjs";import{default as o}from"./render-css.mjs";import{default as d}from"./parse-html.mjs";export{d as parseHTML,a as render,o as renderCSS};

package/dist/parse-html.mjs

@@ -1 +0,0 @@
-import{DomHandler as o,Parser as a}from"htmlparser2";import u from"./decode-html.mjs";function m(i){const t=[];let n=null,s=null,r=null;const d=new o(void 0,{},e=>{if(e.type==="tag")switch(e.name){case"html":n=e;break;case"head":s=e;break;default:break}else e.type==="style"&&e.attribs.id==="master"&&(r=e);e.attribs.class&&e.attribs.class.split(" ").forEach(l=>{l=u(l),t.includes(l)||t.push(l)})});return new a(d,{decodeEntities:!1}).end(i),{classes:t,nodes:d.root.childNodes,htmlElement:n,headElement:s,styleElement:r}}export{m as default};

package/dist/render-css.mjs

@@ -1 +0,0 @@
-import s from"./parse-html.mjs";import f from"@master/css";function i(r,t){if(!r)return;const{classes:e}=s(r);if(!e.length)return;const n=new f(t);return e.forEach(o=>n.add(o)),n}export{i as default};

package/dist/render.mjs

@@ -1 +0,0 @@
-import a from"@master/css";import c from"./parse-html.mjs";import{Element as d,Text as m}from"domhandler";import E from"dom-serializer";function u(o,f){const r=c(o),{classes:n,nodes:s,htmlElement:l}=r;let{headElement:t,styleElement:e}=r;if(!n.length)return{html:o,classes:n,nodes:s,htmlElement:l,headElement:t,styleElement:e};const i=new a(f);return n.forEach(h=>i.add(h)),e?e.childNodes=[new m(i.text)]:(e=new d("style",{id:"master"},[new m(i.text)]),t?t.childNodes.push(e):l?(t=new d("head",{},[e]),l.childNodes.unshift(t)):s.unshift(e)),{html:E(s,{decodeEntities:!1,encodeEntities:!1}),css:i,classes:n,nodes:s,htmlElement:l,headElement:t,styleElement:e}}export{u as default};