@homepages/template-kit 0.7.0 → 0.8.0-dev-20260717154644

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @homepages/template-kit
 
+## 0.8.0-dev-20260717154644
+
+### Minor Changes
+
+- 3f9d98e: `renderSectionHtml` now emits hydration-ready markup (`renderToString`) instead of
+  static markup. Sections carrying a `"use client"` island could not hydrate in
+  `template-kit dev`, because static markup strips the markers the island runtime
+  needs. Rendered HTML gains React's `<!-- -->` text separators, so any test
+  asserting exact HTML from `@homepages/template-kit/ssr` — or from `template-kit
+check` — needs its expectation updated.
+
 ## 0.7.0
 
 ### Minor Changes

package/dist/cli/check/stages/render.js

@@ -1,14 +1,10 @@
 import { FixtureModuleShape, buildInvariantFixtures } from "../../../schema/fixture-schema.js";
 import { loadSection } from "../loader.js";
 import { flattenLayout } from "../../../schema/rows.js";
+import { renderSectionHtml } from "../../../ssr.js";
 import { checkRenderInvariants } from "../render-invariants.js";
-import { createElement } from "react";
-import { renderToStaticMarkup } from "react-dom/server";
 
 //#region src/cli/check/stages/render.ts
-function renderSectionHtml(renderer, props) {
-	return renderToStaticMarkup(createElement(renderer, props));
-}
 const SLOT_ID_RE = /data-slot-id="([^"]*)"/g;
 function renderSlotOrder(html) {
 	const seen = /* @__PURE__ */ new Set();
@@ -98,4 +94,4 @@ async function renderStage(workspaceRoot, template) {
 }
 
 //#endregion
-export { checkSidebarOrder, renderSectionHtml, renderStage };
+export { checkSidebarOrder, renderStage };

package/dist/cli/check/stages/validate/nav-contract.js

@@ -1,13 +1,12 @@
 import { FixtureModuleShape, buildFixtureSet } from "../../../../schema/fixture-schema.js";
 import { TemplateManifest } from "../../../../schema/manifest.js";
 import { loadSection } from "../../loader.js";
+import { renderSectionHtml } from "../../../../ssr.js";
 import { resolveSectionRef } from "../../../../schema/resolve-section-ref.js";
 import { materializeSection } from "./orchestrator.js";
 import { resolveAnchorMap } from "../../../../schema/section-nav.js";
-import { createElement } from "react";
 import { join } from "node:path";
 import { readFile } from "node:fs/promises";
-import { renderToStaticMarkup } from "react-dom/server";
 
 //#region src/cli/check/stages/validate/nav-contract.ts
 const ALLOWED_EXTERNAL_ANCHORS = ["#privacy-policy"];
@@ -75,7 +74,7 @@ async function assertNavContract(workspaceRoot, template) {
 			selfAnchor: anchor
 		}).find((f) => f.id === "typical");
 		if (!base) throw new Error(`Template "${template.key}": section "${section.name}" has no "typical" base fixture.`);
-		html += renderToStaticMarkup(createElement(rendererByName.get(section.name), {
+		html += renderSectionHtml(rendererByName.get(section.name), {
 			slots: base.props.slots,
 			options: base.props.options,
 			nav: {
@@ -83,7 +82,7 @@ async function assertNavContract(workspaceRoot, template) {
 				anchors
 			},
 			variants: base.props.variants
-		}));
+		});
 	}
 	const violations = collectNavViolations(html, ALLOWED_EXTERNAL_ANCHORS);
 	if (violations.length > 0) throw new Error(`Template "${template.key}": nav link(s) resolve to no composed section id: ${violations.join(", ")}.`);

package/dist/cli/dev/structure-summary.js

@@ -30,6 +30,7 @@ function decode(s) {
 	return s.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, "\"").replace(/&#39;/g, "'");
 }
 function parseHtml(html) {
+	html = html.replace(/<!--[\s\S]*?-->/g, "");
 	const root = {
 		tag: "#root",
 		classes: [],

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.7.0";
+var version = "0.8.0-dev-20260717154644";
 
 //#endregion
 export { version };

package/dist/ssr.d.ts

@@ -25,7 +25,10 @@ declare const nativeSectionLoader: SectionModuleLoader;
  * contract files; it defaults to native dynamic import.
  */
 declare function loadSectionBundle(dir: string, load?: SectionModuleLoader): Promise<LoadedSection>;
-/** Render a resolved fixture's props to static markup — the byte-for-byte page render. */
+/**
+ * Render a resolved fixture's props to hydration-ready HTML — the byte-for-byte
+ * page render.
+ */
 declare function renderSectionHtml(renderer: ComponentType<Record<string, unknown>>, props: Record<string, unknown>): string;
 //#endregion
 export { LoadedSection, SectionModuleLoader, findSectionIslands, hasClientDirective, isClientComponentFile, islandKey, islandTransformEsbuildPlugin, loadSectionBundle, nativeSectionLoader, renderSectionHtml, wrapClientModuleSource };

package/dist/ssr.js

@@ -1,13 +1,13 @@
 import { FixtureModuleShape, buildFixtureSet, buildInvariantFixtures } from "./schema/fixture-schema.js";
 import { hasClientDirective } from "./eslint/is-client-file.js";
 import { isClientComponentFile, islandKey } from "./islands/detect.js";
-import { findSectionIslands } from "./islands/discover.js";
 import { wrapClientModuleSource } from "./islands/wrap.js";
+import { findSectionIslands } from "./islands/discover.js";
 import { islandTransformEsbuildPlugin } from "./islands/esbuild-plugin.js";
 import { createElement } from "react";
 import { basename, join } from "node:path";
 import { pathToFileURL } from "node:url";
-import { renderToStaticMarkup } from "react-dom/server";
+import { renderToString } from "react-dom/server";
 
 //#region src/ssr/index.ts
 const nativeSectionLoader = (dir, file) => import(pathToFileURL(join(dir, file)).href);
@@ -37,9 +37,12 @@ async function loadSectionBundle(dir, load = nativeSectionLoader) {
 		schemaSlots: schemaMod.schema.slots
 	};
 }
-/** Render a resolved fixture's props to static markup — the byte-for-byte page render. */
+/**
+* Render a resolved fixture's props to hydration-ready HTML — the byte-for-byte
+* page render.
+*/
 function renderSectionHtml(renderer, props) {
-	return renderToStaticMarkup(createElement(renderer, props));
+	return renderToString(createElement(renderer, props));
 }
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homepages/template-kit",
-  "version": "0.7.0",
+  "version": "0.8.0-dev-20260717154644",
   "description": "Authoring kit for HomePages marketing-section templates: schema system, contract primitives, theme tokens, and the template-kit CLI.",
   "license": "UNLICENSED",
   "type": "module",