@superbuilders/prompt 0.1.0

package/LICENSE

@@ -0,0 +1,12 @@
+Copyright © 2025 Bjorn Pagen <11238136+bjornpagen@users.noreply.github.com>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,28 @@
+# @superbuilders/prompt
+
+JSX runtime for authoring structured LLM prompts as components. Declare a per-file pragma and write prompts as composable JSX:
+
+```tsx
+/** @jsxImportSource @superbuilders/prompt */
+
+export function SystemPrompt(props: { role: string }) {
+	return (
+		<system>
+			You are {props.role}.
+		</system>
+	)
+}
+```
+
+Built for bare-Node type stripping: internal imports are `#` subpath imports resolved through the package's conditional map (`types` → `src`, `default` → `dist`), emitted per-file by tsgo with declarations and source maps.
+
+## Scripts
+
+- `pnpm build` — `tsgo -p tsconfig.build.json` into `dist/`
+- `pnpm typecheck` — `tsgo --noEmit`
+- `pnpm lint` — `biome check .`
+
+## Exports
+
+- `@superbuilders/prompt` — the component/runtime API
+- `@superbuilders/prompt/jsx-runtime`, `@superbuilders/prompt/jsx-dev-runtime` — automatic-runtime entry points consumed via the `@jsxImportSource` pragma

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+type PromptPrimitive = string | number | boolean;
+type PromptAttrValue = PromptPrimitive | null | undefined | false;
+type PromptNode = PromptElement | PromptPrimitive | null | undefined | false | readonly PromptNode[];
+type PromptElement = {
+    tag: string;
+    attrs: Record<string, PromptAttrValue>;
+    children: readonly PromptNode[];
+};
+type PromptComponentProps = Record<string, unknown> & {
+    children?: PromptNode;
+};
+type PromptComponent = (props: PromptComponentProps) => PromptNode;
+declare function render(node: PromptNode): string;
+export type { PromptAttrValue, PromptComponent, PromptComponentProps, PromptElement, PromptNode };
+export { render };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAChD,KAAK,eAAe,GAAG,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAAA;AACjE,KAAK,UAAU,GAAG,aAAa,GAAG,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,UAAU,EAAE,CAAA;AAEpG,KAAK,aAAa,GAAG;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IACtC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAA;CAC/B,CAAA;AAED,KAAK,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,UAAU,CAAA;CAAE,CAAA;AAC/E,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,oBAAoB,KAAK,UAAU,CAAA;AAsFlE,iBAAS,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAQxC;AAED,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,UAAU,EAAE,CAAA;AACjG,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/index.js

@@ -0,0 +1,87 @@
+function isPromptElement(value) {
+    return typeof value === "object" && value !== null && "tag" in value && "attrs" in value && "children" in value;
+}
+function escapeText(value) {
+    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function escapeAttr(value) {
+    return escapeText(value).replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function renderAttrs(attrs) {
+    const parts = [];
+    for (const key in attrs) {
+        const value = attrs[key];
+        if (value === undefined || value === null || value === false) {
+            continue;
+        }
+        parts.push(` ${key}="${escapeAttr(String(value))}"`);
+    }
+    return parts.join("");
+}
+function childIsInline(node) {
+    if (node === undefined || node === null || node === false) {
+        return true;
+    }
+    if (Array.isArray(node)) {
+        return node.every(childIsInline);
+    }
+    return !isPromptElement(node);
+}
+function renderInline(node) {
+    if (node === undefined || node === null || node === false) {
+        return "";
+    }
+    if (Array.isArray(node)) {
+        return node.map(renderInline).join("");
+    }
+    if (isPromptElement(node)) {
+        return renderElement(node, 0);
+    }
+    return escapeText(String(node));
+}
+function renderChild(node, level) {
+    if (node === undefined || node === null || node === false) {
+        return "";
+    }
+    if (Array.isArray(node)) {
+        return node
+            .map(function renderArrayChild(child) {
+            return renderChild(child, level);
+        })
+            .join("");
+    }
+    if (isPromptElement(node)) {
+        return `${"  ".repeat(level)}${renderElement(node, level)}\n`;
+    }
+    const text = escapeText(String(node));
+    if (text.includes("\n")) {
+        return `${text}\n`;
+    }
+    return `${"  ".repeat(level)}${text}\n`;
+}
+function renderElement(element, level) {
+    const attrs = renderAttrs(element.attrs);
+    if (element.children.length === 0) {
+        return `<${element.tag}${attrs}></${element.tag}>`;
+    }
+    if (element.children.every(childIsInline)) {
+        return `<${element.tag}${attrs}>${element.children.map(renderInline).join("")}</${element.tag}>`;
+    }
+    const children = element.children
+        .map(function renderNestedChild(child) {
+        return renderChild(child, level + 1);
+    })
+        .join("");
+    return `<${element.tag}${attrs}>\n${children}${"  ".repeat(level)}</${element.tag}>`;
+}
+function render(node) {
+    if (Array.isArray(node)) {
+        return node.map(render).join("\n\n");
+    }
+    if (isPromptElement(node)) {
+        return renderElement(node, 0);
+    }
+    return renderInline(node);
+}
+export { render };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/jsx-dev-runtime.d.ts

@@ -0,0 +1,3 @@
+export type { JSX } from "#jsx-runtime.ts";
+export { Fragment, jsx, jsx as jsxDEV, jsxs } from "#jsx-runtime.ts";
+//# sourceMappingURL=jsx-dev-runtime.d.ts.map

package/dist/jsx-dev-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.d.ts","sourceRoot":"","sources":["../src/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,MAAM,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/jsx-dev-runtime.js

@@ -0,0 +1,2 @@
+export { Fragment, jsx, jsx as jsxDEV, jsxs } from "#jsx-runtime.ts";
+//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/jsx-dev-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.js","sourceRoot":"","sources":["../src/jsx-dev-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,MAAM,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/jsx-runtime.d.ts

@@ -0,0 +1,28 @@
+import type { PromptComponentProps, PromptNode } from "#index.ts";
+type JsxComponent<P extends PromptComponentProps = PromptComponentProps> = (props: P) => PromptNode;
+declare function jsx<P extends PromptComponentProps>(tag: JsxComponent<P>, props: P): PromptNode;
+declare function jsx(tag: string, props?: PromptComponentProps): PromptNode;
+declare function jsxs<P extends PromptComponentProps>(tag: JsxComponent<P>, props: P): PromptNode;
+declare function jsxs(tag: string, props?: PromptComponentProps): PromptNode;
+declare function Fragment(props: {
+    children?: PromptNode;
+}): PromptNode;
+export declare namespace JSX {
+    type Element = PromptNode;
+    type ElementType = string | ((props: never) => PromptNode);
+    type ElementChildrenAttribute = {
+        children: unknown;
+    };
+    type IntrinsicAttributes = {
+        key?: string | number;
+    };
+    type IntrinsicElements = {
+        [tag: string]: {
+            children?: PromptNode;
+            key?: string | number;
+            [attr: string]: PromptNode | string | number | boolean | null | undefined;
+        };
+    };
+}
+export { Fragment, jsx, jsxs };
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,oBAAoB,EAAiB,UAAU,EAAE,MAAM,WAAW,CAAA;AAEjG,KAAK,YAAY,CAAC,CAAC,SAAS,oBAAoB,GAAG,oBAAoB,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,UAAU,CAAA;AA0CnG,iBAAS,GAAG,CAAC,CAAC,SAAS,oBAAoB,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAAA;AACxF,iBAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,oBAAoB,GAAG,UAAU,CAAA;AAiBnE,iBAAS,IAAI,CAAC,CAAC,SAAS,oBAAoB,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAAA;AACzF,iBAAS,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,oBAAoB,GAAG,UAAU,CAAA;AAiBpE,iBAAS,QAAQ,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,UAAU,CAE9D;AAED,yBAAiB,GAAG,CAAC;IACpB,KAAY,OAAO,GAAG,UAAU,CAAA;IAChC,KAAY,WAAW,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,UAAU,CAAC,CAAA;IACjE,KAAY,wBAAwB,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAA;IAC5D,KAAY,mBAAmB,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;IAC3D,KAAY,iBAAiB,GAAG;QAC/B,CAAC,GAAG,EAAE,MAAM,GAAG;YACd,QAAQ,CAAC,EAAE,UAAU,CAAA;YACrB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;YACrB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;SACzE,CAAA;KACD,CAAA;CACD;AAED,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA"}

package/dist/jsx-runtime.js

@@ -0,0 +1,71 @@
+import * as errors from "@superbuilders/errors";
+/**
+ * Attributes must be primitives (string/number/boolean/null/undefined). A
+ * non-primitive attr (object, array, function) is a caller bug and THROWS —
+ * for a library whose whole job is "the same bytes render every run", a
+ * silently dropped attr would be an invisible prompt mutation.
+ */
+function attrsFromProps(props) {
+    const attrs = {};
+    for (const key in props) {
+        if (key === "children" || key === "key") {
+            continue;
+        }
+        const value = props[key];
+        if (typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean" ||
+            value === null ||
+            value === undefined) {
+            attrs[key] = value;
+            continue;
+        }
+        throw errors.new(`prompt attr '${key}' must be a primitive, got ${typeof value}`);
+    }
+    return attrs;
+}
+function childrenFromProps(props) {
+    const children = props.children;
+    if (children === undefined) {
+        return [];
+    }
+    if (Array.isArray(children)) {
+        return children;
+    }
+    return [children];
+}
+function jsx(tag, props) {
+    let safeProps = {};
+    if (props !== undefined) {
+        safeProps = props;
+    }
+    if (typeof tag === "function") {
+        return tag(safeProps);
+    }
+    const element = {
+        tag,
+        attrs: attrsFromProps(safeProps),
+        children: childrenFromProps(safeProps)
+    };
+    return element;
+}
+function jsxs(tag, props) {
+    let safeProps = {};
+    if (props !== undefined) {
+        safeProps = props;
+    }
+    if (typeof tag === "function") {
+        return tag(safeProps);
+    }
+    const element = {
+        tag,
+        attrs: attrsFromProps(safeProps),
+        children: childrenFromProps(safeProps)
+    };
+    return element;
+}
+function Fragment(props) {
+    return props.children;
+}
+export { Fragment, jsx, jsxs };
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.js","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAA;AAM/C;;;;;GAKG;AACH,SAAS,cAAc,CAAC,KAA2B;IAClD,MAAM,KAAK,GAAoC,EAAE,CAAA;IACjD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YACzC,SAAQ;QACT,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;QACxB,IACC,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,KAAK,KAAK,SAAS;YAC1B,KAAK,KAAK,IAAI;YACd,KAAK,KAAK,SAAS,EAClB,CAAC;YACF,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;YAClB,SAAQ;QACT,CAAC;QACD,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,GAAG,8BAA8B,OAAO,KAAK,EAAE,CAAC,CAAA;IAClF,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA2B;IACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;IAC/B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAA;IACV,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAA;IAChB,CAAC;IACD,OAAO,CAAC,QAAQ,CAAC,CAAA;AAClB,CAAC;AAID,SAAS,GAAG,CAAC,GAAW,EAAE,KAA4B;IACrD,IAAI,SAAS,GAAyB,EAAE,CAAA;IACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,SAAS,GAAG,KAAK,CAAA;IAClB,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC,SAAS,CAAC,CAAA;IACtB,CAAC;IACD,MAAM,OAAO,GAAkB;QAC9B,GAAG;QACH,KAAK,EAAE,cAAc,CAAC,SAAS,CAAC;QAChC,QAAQ,EAAE,iBAAiB,CAAC,SAAS,CAAC;KACtC,CAAA;IACD,OAAO,OAAO,CAAA;AACf,CAAC;AAID,SAAS,IAAI,CAAC,GAAW,EAAE,KAA4B;IACtD,IAAI,SAAS,GAAyB,EAAE,CAAA;IACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,SAAS,GAAG,KAAK,CAAA;IAClB,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC,SAAS,CAAC,CAAA;IACtB,CAAC;IACD,MAAM,OAAO,GAAkB;QAC9B,GAAG;QACH,KAAK,EAAE,cAAc,CAAC,SAAS,CAAC;QAChC,QAAQ,EAAE,iBAAiB,CAAC,SAAS,CAAC;KACtC,CAAA;IACD,OAAO,OAAO,CAAA;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,KAAgC;IACjD,OAAO,KAAK,CAAC,QAAQ,CAAA;AACtB,CAAC;AAgBD,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@superbuilders/prompt",
+  "version": "0.1.0",
+  "description": "Tiny JSX prompt rendering primitives for Superbuilders applications",
+  "type": "module",
+  "imports": {
+    "#*.ts": {
+      "types": "./src/*.ts",
+      "default": "./dist/*.js"
+    },
+    "#*.tsx": {
+      "types": "./src/*.tsx",
+      "default": "./dist/*.js"
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./jsx-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "import": "./dist/jsx-runtime.js"
+    },
+    "./jsx-dev-runtime": {
+      "types": "./dist/jsx-dev-runtime.d.ts",
+      "import": "./dist/jsx-dev-runtime.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@superbuilders/errors": "^3.0.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.2",
+    "@types/node": "^26.1.0",
+    "@typescript/native-preview": "7.0.0-dev.20260702.3",
+    "typescript": "^6.0.3"
+  },
+  "keywords": [
+    "jsx",
+    "prompt",
+    "xml",
+    "superbuilders"
+  ],
+  "license": "0BSD",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsgo -p tsconfig.build.json",
+    "typecheck": "tsgo --noEmit",
+    "lint": "biome check ."
+  }
+}

package/src/index.ts

@@ -0,0 +1,109 @@
+type PromptPrimitive = string | number | boolean
+type PromptAttrValue = PromptPrimitive | null | undefined | false
+type PromptNode = PromptElement | PromptPrimitive | null | undefined | false | readonly PromptNode[]
+
+type PromptElement = {
+	tag: string
+	attrs: Record<string, PromptAttrValue>
+	children: readonly PromptNode[]
+}
+
+type PromptComponentProps = Record<string, unknown> & { children?: PromptNode }
+type PromptComponent = (props: PromptComponentProps) => PromptNode
+
+function isPromptElement(value: unknown): value is PromptElement {
+	return typeof value === "object" && value !== null && "tag" in value && "attrs" in value && "children" in value
+}
+
+function escapeText(value: string): string {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;")
+}
+
+function escapeAttr(value: string): string {
+	return escapeText(value).replace(/"/g, "&quot;").replace(/'/g, "&apos;")
+}
+
+function renderAttrs(attrs: Record<string, PromptAttrValue>): string {
+	const parts: string[] = []
+	for (const key in attrs) {
+		const value = attrs[key]
+		if (value === undefined || value === null || value === false) {
+			continue
+		}
+		parts.push(` ${key}="${escapeAttr(String(value))}"`)
+	}
+	return parts.join("")
+}
+
+function childIsInline(node: PromptNode): boolean {
+	if (node === undefined || node === null || node === false) {
+		return true
+	}
+	if (Array.isArray(node)) {
+		return node.every(childIsInline)
+	}
+	return !isPromptElement(node)
+}
+
+function renderInline(node: PromptNode): string {
+	if (node === undefined || node === null || node === false) {
+		return ""
+	}
+	if (Array.isArray(node)) {
+		return node.map(renderInline).join("")
+	}
+	if (isPromptElement(node)) {
+		return renderElement(node, 0)
+	}
+	return escapeText(String(node))
+}
+
+function renderChild(node: PromptNode, level: number): string {
+	if (node === undefined || node === null || node === false) {
+		return ""
+	}
+	if (Array.isArray(node)) {
+		return node
+			.map(function renderArrayChild(child) {
+				return renderChild(child, level)
+			})
+			.join("")
+	}
+	if (isPromptElement(node)) {
+		return `${"  ".repeat(level)}${renderElement(node, level)}\n`
+	}
+	const text = escapeText(String(node))
+	if (text.includes("\n")) {
+		return `${text}\n`
+	}
+	return `${"  ".repeat(level)}${text}\n`
+}
+
+function renderElement(element: PromptElement, level: number): string {
+	const attrs = renderAttrs(element.attrs)
+	if (element.children.length === 0) {
+		return `<${element.tag}${attrs}></${element.tag}>`
+	}
+	if (element.children.every(childIsInline)) {
+		return `<${element.tag}${attrs}>${element.children.map(renderInline).join("")}</${element.tag}>`
+	}
+	const children = element.children
+		.map(function renderNestedChild(child) {
+			return renderChild(child, level + 1)
+		})
+		.join("")
+	return `<${element.tag}${attrs}>\n${children}${"  ".repeat(level)}</${element.tag}>`
+}
+
+function render(node: PromptNode): string {
+	if (Array.isArray(node)) {
+		return node.map(render).join("\n\n")
+	}
+	if (isPromptElement(node)) {
+		return renderElement(node, 0)
+	}
+	return renderInline(node)
+}
+
+export type { PromptAttrValue, PromptComponent, PromptComponentProps, PromptElement, PromptNode }
+export { render }

package/src/jsx-dev-runtime.ts

@@ -0,0 +1,2 @@
+export type { JSX } from "#jsx-runtime.ts"
+export { Fragment, jsx, jsx as jsxDEV, jsxs } from "#jsx-runtime.ts"

package/src/jsx-runtime.ts

@@ -0,0 +1,100 @@
+import * as errors from "@superbuilders/errors"
+import type { PromptAttrValue, PromptComponentProps, PromptElement, PromptNode } from "#index.ts"
+
+type JsxComponent<P extends PromptComponentProps = PromptComponentProps> = (props: P) => PromptNode
+type JsxTag<P extends PromptComponentProps = PromptComponentProps> = string | JsxComponent<P>
+
+/**
+ * Attributes must be primitives (string/number/boolean/null/undefined). A
+ * non-primitive attr (object, array, function) is a caller bug and THROWS —
+ * for a library whose whole job is "the same bytes render every run", a
+ * silently dropped attr would be an invisible prompt mutation.
+ */
+function attrsFromProps(props: PromptComponentProps): Record<string, PromptAttrValue> {
+	const attrs: Record<string, PromptAttrValue> = {}
+	for (const key in props) {
+		if (key === "children" || key === "key") {
+			continue
+		}
+		const value = props[key]
+		if (
+			typeof value === "string" ||
+			typeof value === "number" ||
+			typeof value === "boolean" ||
+			value === null ||
+			value === undefined
+		) {
+			attrs[key] = value
+			continue
+		}
+		throw errors.new(`prompt attr '${key}' must be a primitive, got ${typeof value}`)
+	}
+	return attrs
+}
+
+function childrenFromProps(props: PromptComponentProps): readonly PromptNode[] {
+	const children = props.children
+	if (children === undefined) {
+		return []
+	}
+	if (Array.isArray(children)) {
+		return children
+	}
+	return [children]
+}
+
+function jsx<P extends PromptComponentProps>(tag: JsxComponent<P>, props: P): PromptNode
+function jsx(tag: string, props?: PromptComponentProps): PromptNode
+function jsx(tag: JsxTag, props?: PromptComponentProps): PromptNode {
+	let safeProps: PromptComponentProps = {}
+	if (props !== undefined) {
+		safeProps = props
+	}
+	if (typeof tag === "function") {
+		return tag(safeProps)
+	}
+	const element: PromptElement = {
+		tag,
+		attrs: attrsFromProps(safeProps),
+		children: childrenFromProps(safeProps)
+	}
+	return element
+}
+
+function jsxs<P extends PromptComponentProps>(tag: JsxComponent<P>, props: P): PromptNode
+function jsxs(tag: string, props?: PromptComponentProps): PromptNode
+function jsxs(tag: JsxTag, props?: PromptComponentProps): PromptNode {
+	let safeProps: PromptComponentProps = {}
+	if (props !== undefined) {
+		safeProps = props
+	}
+	if (typeof tag === "function") {
+		return tag(safeProps)
+	}
+	const element: PromptElement = {
+		tag,
+		attrs: attrsFromProps(safeProps),
+		children: childrenFromProps(safeProps)
+	}
+	return element
+}
+
+function Fragment(props: { children?: PromptNode }): PromptNode {
+	return props.children
+}
+
+export namespace JSX {
+	export type Element = PromptNode
+	export type ElementType = string | ((props: never) => PromptNode)
+	export type ElementChildrenAttribute = { children: unknown }
+	export type IntrinsicAttributes = { key?: string | number }
+	export type IntrinsicElements = {
+		[tag: string]: {
+			children?: PromptNode
+			key?: string | number
+			[attr: string]: PromptNode | string | number | boolean | null | undefined
+		}
+	}
+}
+
+export { Fragment, jsx, jsxs }