@purestack/ts-render 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ahmed Yasin Koculu
+
+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

@@ -0,0 +1,8 @@
+# @purestack/ts-render
+
+Server-side rendering for PureStack's Regor components. `renderApp` takes HTML,
+a component set, and a `TsSsgContext`, then returns rendered HTML with any
+required component scripts attached.
+
+`componentRegistry` lets custom build pipelines register components by name.
+The site generator uses this package to turn page markup into static output.

package/dist/ts-render.d.mts

@@ -0,0 +1,24 @@
+/*! @purestack/ts-render v1.1.0 | (c) 2026 Ahmed Yasin Koculu | MIT License */
+
+import { Component } from "regor";
+import { TsSsgContext } from "@purestack/ts-common";
+//#region packages/ts-render/src/componentRegistry.d.ts
+export declare const componentRegistry: {
+  register(name: string, component: Component<never>): void;
+  registerMany<TComponents>(...components: (TComponents | object)[]): void;
+  getAll(): Record<string, Component>;
+  hasComponentName(name: string): boolean;
+  snapshot(): Map<string, Component<never>>;
+  restore(snapshot: Map<string, Component<never>>): void;
+  clear(): void;
+};
+//#endregion
+//#region packages/ts-render/src/renderApp.d.ts
+interface RenderAppOptions<TContext extends TsSsgContext> {
+  components: unknown;
+  context: TContext;
+}
+export declare const renderApp: <TContext extends TsSsgContext>(html: string, options: RenderAppOptions<TContext>) => string;
+//#endregion
+export type { RenderAppOptions };
+//# sourceMappingURL=ts-render.d.mts.map

package/dist/ts-render.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-render.d.mts","names":[],"sources":["../src/componentRegistry.ts","../src/renderApp.ts"],"mappings":";;;qBAKa;EACX,SAAQ,cAAa,WAAa;EAGlC,aAAa,gBAAW,aAAkB;EAQ1C,UAAU,eAAe;EAGzB,iBAAgB;EAGhB,YAAY,YAAY;EAGxB,QAAO,UAAW,YAAY;EAM9B;;;;UC1Be,iBAAiB,iBAAiB;EACjD;EACA,SAAS;;qBAGE,YAAa,iBAAiB,cAAY,cACzC,SACH,iBAAiB"}

package/dist/ts-render.mjs

@@ -0,0 +1,115 @@
+/*! @purestack/ts-render v1.1.0 | (c) 2026 Ahmed Yasin Koculu | MIT License */
+
+import { isPlainObject } from "@purestack/ts-util";
+import { createDom } from "@purestack/ts-minidom";
+import { buildModalScript, buildTabsScript } from "@purestack/ts-page-scripts";
+import { createApp } from "regor";
+
+//#region packages/ts-render/src/componentRegistry.ts
+const registry = /* @__PURE__ */ new Map();
+const componentRegistry = {
+	register(name, component) {
+		registry.set(name, component);
+	},
+	registerMany(...components) {
+		for (const compSet of components) {
+			if (!isPlainObject(compSet)) continue;
+			for (const [name, component] of Object.entries(compSet)) registry.set(name, component);
+		}
+	},
+	getAll() {
+		return Object.fromEntries(registry.entries());
+	},
+	hasComponentName(name) {
+		return hasComponentName(name, registry);
+	},
+	snapshot() {
+		return new Map(registry);
+	},
+	restore(snapshot) {
+		registry.clear();
+		for (const [name, component] of snapshot) registry.set(name, component);
+	},
+	clear() {
+		registry.clear();
+	}
+};
+function hasComponentName(input, source) {
+	const normalizedInput = normalizeComponentName(input);
+	if (!normalizedInput) return false;
+	for (const key of source.keys()) {
+		const normalizedKey = normalizeComponentName(key);
+		if (!normalizedKey) continue;
+		if (normalizedKey === normalizedInput) return true;
+	}
+	return false;
+}
+function normalizeComponentName(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return "";
+	return trimmed.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+
+//#endregion
+//#region packages/ts-render/src/renderApp.ts
+const renderApp = (html, options) => {
+	const normalizedHtml = html.trimStart();
+	const isDocument = normalizedHtml.startsWith("<!DOCTYPE html>") || normalizedHtml.startsWith("<!doctype html>") || normalizedHtml.startsWith("<html");
+	const htmlToParse = isDocument ? normalizedHtml : `<!DOCTYPE html><html><body>${html}</body></html>`;
+	const cleanup = createDom(htmlToParse);
+	const snapshot = componentRegistry.snapshot();
+	const runtimeEmbeds = /* @__PURE__ */ new Map();
+	const baseContext = options.context;
+	const tsSsgContext = {
+		...baseContext,
+		recordRuntimeEmbed: (name, position) => {
+			const normalized = name.trim().toLowerCase();
+			if (normalized.length > 0) runtimeEmbeds.set(normalized, position);
+			baseContext.recordRuntimeEmbed(name, position);
+		}
+	};
+	try {
+		if (options.components) componentRegistry.registerMany(options.components);
+		const components = { ...componentRegistry.getAll() };
+		createApp({
+			components,
+			tsSsgContext
+		}, { element: document.body });
+		appendEmbeddedScriptsToDom(runtimeEmbeds, tsSsgContext);
+		if (isDocument) return `<!DOCTYPE html>${document.documentElement?.outerHTML ?? ""}`;
+		return document.body?.innerHTML ?? "";
+	} finally {
+		componentRegistry.restore(snapshot);
+		cleanup();
+	}
+};
+function appendEmbeddedScriptsToDom(runtimeEmbeds, context) {
+	appendRuntimeScript(resolveTabsEmbedPosition(runtimeEmbeds, context), buildTabsScript);
+	appendRuntimeScript(resolveModalEmbedPosition(runtimeEmbeds, context), buildModalScript);
+}
+function appendRuntimeScript(position, scriptBuilder) {
+	if (!position) return;
+	const targetParent = ensureScriptParent(position);
+	if (!targetParent) return;
+	const script = document.createElement("script");
+	script.textContent = scriptBuilder();
+	targetParent.appendChild(script);
+}
+function ensureScriptParent(position) {
+	if (position === "body") return document.body;
+	return document.head;
+}
+function resolveTabsEmbedPosition(runtimeEmbeds, context) {
+	const runtimePosition = runtimeEmbeds.get("tabs");
+	if (runtimePosition) return runtimePosition;
+	return context?.pageInfo?.frontmatter?.embed?.tabs;
+}
+function resolveModalEmbedPosition(runtimeEmbeds, context) {
+	const runtimePosition = runtimeEmbeds.get("modal");
+	if (runtimePosition) return runtimePosition;
+	return context?.pageInfo?.frontmatter?.embed?.modal;
+}
+
+//#endregion
+export { componentRegistry, renderApp };
+//# sourceMappingURL=ts-render.mjs.map

package/dist/ts-render.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-render.mjs","names":[],"sources":["../src/componentRegistry.ts","../src/renderApp.ts"],"sourcesContent":["import { isPlainObject } from '@purestack/ts-util'\nimport type { Component } from 'regor'\n\nconst registry = new Map<string, Component<never>>()\n\nexport const componentRegistry = {\n  register(name: string, component: Component<never>) {\n    registry.set(name, component)\n  },\n  registerMany<TComponents>(...components: (TComponents | object)[]) {\n    for (const compSet of components) {\n      if (!isPlainObject(compSet)) continue\n      for (const [name, component] of Object.entries(compSet)) {\n        registry.set(name, component as Component<never>)\n      }\n    }\n  },\n  getAll(): Record<string, Component> {\n    return Object.fromEntries(registry.entries())\n  },\n  hasComponentName(name: string) {\n    return hasComponentName(name, registry)\n  },\n  snapshot(): Map<string, Component<never>> {\n    return new Map(registry)\n  },\n  restore(snapshot: Map<string, Component<never>>) {\n    registry.clear()\n    for (const [name, component] of snapshot) {\n      registry.set(name, component)\n    }\n  },\n  clear() {\n    registry.clear()\n  },\n}\n\nfunction hasComponentName(\n  input: string,\n  source: Map<string, Component<never>>,\n) {\n  const normalizedInput = normalizeComponentName(input)\n  if (!normalizedInput) return false\n  for (const key of source.keys()) {\n    const normalizedKey = normalizeComponentName(key)\n    if (!normalizedKey) continue\n    if (normalizedKey === normalizedInput) return true\n  }\n  return false\n}\n\nfunction normalizeComponentName(value: string) {\n  const trimmed = value.trim()\n  if (!trimmed) return ''\n  return trimmed.toLowerCase().replace(/[^a-z0-9]/g, '')\n}\n","import type { TsSsgContext } from '@purestack/ts-common'\nimport { createDom } from '@purestack/ts-minidom'\nimport { buildModalScript, buildTabsScript } from '@purestack/ts-page-scripts'\nimport { createApp } from 'regor'\nimport { componentRegistry } from './componentRegistry'\n\nexport interface RenderAppOptions<TContext extends TsSsgContext> {\n  components: unknown\n  context: TContext\n}\n\nexport const renderApp = <TContext extends TsSsgContext>(\n  html: string,\n  options: RenderAppOptions<TContext>,\n) => {\n  const normalizedHtml = html.trimStart()\n  const isDocument =\n    normalizedHtml.startsWith('<!DOCTYPE html>') ||\n    normalizedHtml.startsWith('<!doctype html>') ||\n    normalizedHtml.startsWith('<html')\n  const htmlToParse = isDocument\n    ? normalizedHtml\n    : `<!DOCTYPE html><html><body>${html}</body></html>`\n  const cleanup = createDom(htmlToParse)\n  const snapshot = componentRegistry.snapshot()\n  const runtimeEmbeds = new Map<string, 'body' | 'head'>()\n  const baseContext = options.context\n  const tsSsgContext = {\n    ...baseContext,\n    recordRuntimeEmbed: (name: string, position: 'body' | 'head') => {\n      const normalized = name.trim().toLowerCase()\n      if (normalized.length > 0) {\n        runtimeEmbeds.set(normalized, position)\n      }\n      baseContext.recordRuntimeEmbed(name, position)\n    },\n  }\n  try {\n    if (options.components) componentRegistry.registerMany(options.components)\n    const components = {\n      ...componentRegistry.getAll(),\n    }\n    createApp(\n      {\n        components,\n        tsSsgContext,\n      },\n      {\n        element: document.body,\n      },\n    )\n    appendEmbeddedScriptsToDom(runtimeEmbeds, tsSsgContext)\n    if (isDocument) {\n      const documentHtml = document.documentElement?.outerHTML ?? ''\n      return `<!DOCTYPE html>${documentHtml}`\n    }\n    return document.body?.innerHTML ?? ''\n  } finally {\n    componentRegistry.restore(snapshot)\n    cleanup()\n  }\n}\n\nfunction appendEmbeddedScriptsToDom(\n  runtimeEmbeds: Map<string, 'body' | 'head'>,\n  context: TsSsgContext,\n) {\n  appendRuntimeScript(\n    resolveTabsEmbedPosition(runtimeEmbeds, context),\n    buildTabsScript,\n  )\n  appendRuntimeScript(\n    resolveModalEmbedPosition(runtimeEmbeds, context),\n    buildModalScript,\n  )\n}\n\nfunction appendRuntimeScript(\n  position: 'body' | 'head' | undefined,\n  scriptBuilder: () => string,\n) {\n  if (!position) return\n  const targetParent = ensureScriptParent(position)\n  if (!targetParent) return\n  const script = document.createElement('script')\n  script.textContent = scriptBuilder()\n  targetParent.appendChild(script)\n}\n\nfunction ensureScriptParent(position: 'body' | 'head') {\n  if (position === 'body') {\n    return document.body\n  }\n  return document.head\n}\n\nfunction resolveTabsEmbedPosition(\n  runtimeEmbeds: Map<string, 'body' | 'head'>,\n  context: TsSsgContext,\n) {\n  const runtimePosition = runtimeEmbeds.get('tabs')\n  if (runtimePosition) return runtimePosition\n  return context?.pageInfo?.frontmatter?.embed?.tabs\n}\n\nfunction resolveModalEmbedPosition(\n  runtimeEmbeds: Map<string, 'body' | 'head'>,\n  context: TsSsgContext,\n) {\n  const runtimePosition = runtimeEmbeds.get('modal')\n  if (runtimePosition) return runtimePosition\n  return context?.pageInfo?.frontmatter?.embed?.modal\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@purestack/ts-render",
+  "version": "1.1.0",
+  "packageManager": "yarn@4.9.2",
+  "module": "./dist/ts-render.mjs",
+  "types": "./dist/ts-render.d.mts",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PureStackStudio/PureStack.git",
+    "directory": "packages/ts-render"
+  },
+  "homepage": "https://purestack.studio",
+  "bugs": {
+    "url": "https://github.com/PureStackStudio/PureStack/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/ts-render.d.mts",
+      "import": "./dist/ts-render.mjs"
+    }
+  },
+  "license": "MIT",
+  "files": [
+    "dist/*.mjs",
+    "dist/*.mjs.map",
+    "dist/*.d.mts",
+    "dist/*.d.mts.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "biome check ./src --formatter-enabled=false --write",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "@purestack/ts-common": "^1.1.0",
+    "@purestack/ts-minidom": "^1.1.0",
+    "@purestack/ts-page-scripts": "^1.1.0",
+    "@purestack/ts-util": "^1.1.0",
+    "regor": "^1.7.3"
+  }
+}