twynejs 1.0.0

package/dist/jsx-runtime.d.ts

@@ -0,0 +1,20 @@
+declare const HTML: unique symbol;
+export interface HtmlValue {
+    readonly [HTML]: true;
+    readonly value: string;
+    toString(): string;
+}
+export declare function jsx(tag: string | ((props: any) => any), props: Record<string, any> | null, ...children: any[]): HtmlValue | string;
+export declare function jsxs(tag: string | ((props: any) => any), props: Record<string, any> | null): HtmlValue | string;
+export declare function Fragment(props: {
+    children?: any[];
+}): HtmlValue;
+export declare function escapeHtml(value: string): string;
+/**
+ * Erzeugt einen HtmlValue aus rohem String OHNE Escaping.
+ * Nur für vertrauenswürdigen Inhalt verwenden (eigenes CSS/JS, nie User-Input!).
+ * Damit lässt sich z.B. ein <script>{raw(js)}</script> einbetten, ohne
+ * dass `<`/`>`/`&` im JS/CSS kaputt escaped werden.
+ */
+export declare function raw(value: string): HtmlValue;
+export {};

package/dist/jsx-runtime.js

@@ -0,0 +1,132 @@
+// Custom JSX Runtime for the SSG Pages Plugin
+const HTML = Symbol("html");
+function renderChildren(children) {
+    return children
+        .flat(Infinity)
+        .filter((child) => child != null && child !== false)
+        .map((child) => {
+        if (isHtml(child)) {
+            return child.value;
+        }
+        return escapeText(String(child));
+    })
+        .join("");
+}
+export function jsx(tag, props, ...children) {
+    // Automatic JSX runtime: children kommen als props.children (Array) rein.
+    if (Array.isArray(props?.children)) {
+        children = props.children;
+        props = { ...props };
+        delete props.children;
+    }
+    if (typeof tag === "function") {
+        return tag({
+            ...(props ?? {}),
+            children,
+        });
+    }
+    const booleanHtmlAttributes = new Set([
+        "disabled",
+        "checked",
+        "selected",
+        "readonly",
+        "required",
+        "multiple",
+        "hidden",
+        "autofocus",
+        "open",
+    ]);
+    const attributes = Object.entries(props ?? {})
+        .filter(([key]) => key !== "children" && key !== "key")
+        .map(([key, value]) => {
+        if (value == null) {
+            return "";
+        }
+        const attribute = key === "className" ? "class" : key;
+        // Echte HTML-Boolean-Attribute: Präsenz = wahr, sonst weglassen.
+        if (typeof value === "boolean" && booleanHtmlAttributes.has(attribute)) {
+            return value ? ` ${attribute}` : "";
+        }
+        // Alles andere (inkl. data-*/aria-*) bekommt immer einen expliziten
+        // String-Wert, damit z.B. dataset.nested === "false" verlässlich geht.
+        if (typeof value === "boolean") {
+            return ` ${attribute}="${value}"`;
+        }
+        if (value === false) {
+            return "";
+        }
+        return ` ${attribute}="${escapeAttribute(String(value))}"`;
+    })
+        .join("");
+    const content = renderChildren(children);
+    const voidElements = new Set([
+        "area",
+        "base",
+        "br",
+        "col",
+        "embed",
+        "hr",
+        "img",
+        "input",
+        "link",
+        "meta",
+        "param",
+        "source",
+        "track",
+        "wbr",
+    ]);
+    const html = voidElements.has(tag)
+        ? `<${tag}${attributes}>`
+        : `<${tag}${attributes}>${content}</${tag}>`;
+    return createHtml(html);
+}
+// Automatic JSX runtime nutzt jsxs für statische Elemente (gleiche Semantik).
+export function jsxs(tag, props) {
+    return jsx(tag, props);
+}
+export function Fragment(props) {
+    const content = renderChildren(props.children ?? []);
+    return createHtml(content);
+}
+function createHtml(value) {
+    return {
+        [HTML]: true,
+        value,
+        toString() {
+            return value;
+        },
+    };
+}
+function isHtml(value) {
+    return typeof value === "object" && value !== null && HTML in value;
+}
+function escapeAttribute(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/"/g, "&quot;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+function escapeText(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+export function escapeHtml(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#039;");
+}
+/**
+ * Erzeugt einen HtmlValue aus rohem String OHNE Escaping.
+ * Nur für vertrauenswürdigen Inhalt verwenden (eigenes CSS/JS, nie User-Input!).
+ * Damit lässt sich z.B. ein <script>{raw(js)}</script> einbetten, ohne
+ * dass `<`/`>`/`&` im JS/CSS kaputt escaped werden.
+ */
+export function raw(value) {
+    return createHtml(value);
+}

package/dist/styles.d.ts

@@ -0,0 +1 @@
+export declare function loadStyles(styles: string[]): void;

package/dist/styles.js

@@ -0,0 +1,17 @@
+// Function is from the lib thats why it in jsx runtime
+export function loadStyles(styles) {
+    if (import.meta.env.DEV) {
+        console.log("[pages] loading styles:", styles);
+    }
+    for (const href of styles) {
+        const url = new URL(href, import.meta.url).href;
+        if (document.head.querySelector(`link[data-page-style="${CSS.escape(url)}"]`)) {
+            continue;
+        }
+        const link = document.createElement("link");
+        link.rel = "stylesheet";
+        link.href = url;
+        link.dataset.pageStyle = url;
+        document.head.appendChild(link);
+    }
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "twynejs",
+  "version": "1.0.0",
+  "description": "twine A Vite SSG plugin that turns .ts/.tsx pages, Markdown docs and Liquid/EJS templates into a multi-page static build with a virtual:pages module.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./jsx-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "import": "./dist/jsx-runtime.js"
+    },
+    "./styles": {
+      "types": "./dist/styles.d.ts",
+      "import": "./dist/styles.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "vite",
+    "plugin",
+    "ssg",
+    "static-site",
+    "pages",
+    "markdown",
+    "liquid",
+    "ejs"
+  ],
+  "author": "Shadowdara",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shadowdara/finder",
+    "directory": "npm/pages-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/shadowdara/finder/issues"
+  },
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "dependencies": {
+    "@shadowdara/dlib": "^0.0.4",
+    "ejs": "^6.0.1",
+    "highlight.js": "^11.12.0",
+    "html-minifier-terser": "^7.2.0",
+    "liquidjs": "^10.29.0",
+    "tsx": "^4.23.13"
+  },
+  "devDependencies": {
+    "@types/ejs": "^3.1.5",
+    "@types/html-minifier-terser": "^7.0.2",
+    "@types/node": "^26.5.0",
+    "typescript": "^5.5.0",
+    "vite": "6.4.3"
+  }
+}