@ternkit/tern 0.0.0-stage → 0.3.1

package/dist/server/index.d.ts

@@ -0,0 +1,35 @@
+import type { Component } from 'svelte';
+/** The server manifest generated by `tern gen` in .tern/generated/server.js. */
+export interface ServerManifest {
+    layouts: {
+        component: Component<any> | null;
+    }[];
+    routes: Record<string, {
+        layouts: number[];
+        page: Component<any>;
+        errors: {
+            layouts: number;
+            component: Component<any>;
+        }[];
+    }>;
+    fallback: {
+        layouts: number[];
+        errors: {
+            layouts: number;
+            component: Component<any>;
+        }[];
+    };
+}
+/** The result of a server render, as JSON for the Go side. */
+export interface RenderResult {
+    head?: string;
+    body?: string;
+    /** True when the payload is not something the server renders. */
+    skip?: boolean;
+}
+/**
+ * Creates the function the Go server calls to render a page. It takes the
+ * same payload the client receives, so the server and the client render
+ * exactly the same tree and hydration matches.
+ */
+export declare function createRenderer(manifest: ServerManifest): (payload: string, href: string) => string;

package/dist/server/index.js

@@ -0,0 +1,40 @@
+import { render } from 'svelte/server';
+import DefaultError from '../runtime/DefaultError.svelte';
+import Passthrough from '../runtime/Passthrough.svelte';
+import Root from '../runtime/Root.svelte';
+import { revive } from '../runtime/deferred.js';
+import { plan } from '../runtime/select.js';
+import { applyPayloadToPage } from '../runtime/state.svelte.js';
+/**
+ * Creates the function the Go server calls to render a page. It takes the
+ * same payload the client receives, so the server and the client render
+ * exactly the same tree and hydration matches.
+ */
+export function createRenderer(manifest) {
+    const layout = (i) => manifest.layouts[i]?.component ?? Passthrough;
+    return (payloadJSON, href) => {
+        const p = JSON.parse(payloadJSON);
+        // Deferred values are still loading: render their pending state.
+        p.nodes = revive(p.nodes, () => new Promise(() => { }));
+        const what = plan(manifest, p);
+        let components;
+        switch (what.kind) {
+            case 'not-a-page':
+                return JSON.stringify({ skip: true });
+            case 'page':
+                components = [...what.layouts.map(layout), manifest.routes[what.route].page];
+                break;
+            case 'error': {
+                const errors = what.route ? manifest.routes[what.route].errors : manifest.fallback.errors;
+                components = [...what.layouts.map(layout), errors[what.errorIndex].component];
+                break;
+            }
+            case 'default-error':
+                components = [DefaultError];
+        }
+        applyPayloadToPage(p, new URL(href), {}, what.data);
+        const form = p.hasForm ? (p.form ?? null) : null;
+        const out = render(Root, { props: { components, data: what.data, form } });
+        return JSON.stringify({ head: out.head, body: out.body });
+    };
+}

package/dist/server/polyfills.d.ts

@@ -0,0 +1,2 @@
+import 'core-js/actual/url';
+import 'core-js/actual/url-search-params';

package/dist/server/polyfills.js

@@ -0,0 +1,38 @@
+// Web APIs the server-side renderer needs. Tern renders in an embedded
+// JavaScript engine (QuickJS) that only implements the language itself.
+// Each polyfill is skipped where the API already exists, such as in Node
+// during development.
+import 'core-js/actual/url';
+import 'core-js/actual/url-search-params';
+const g = globalThis;
+if (typeof g.queueMicrotask !== 'function') {
+    g.queueMicrotask = (fn) => void Promise.resolve().then(fn);
+}
+if (typeof g.console === 'undefined') {
+    const format = (args) => args
+        .map((a) => {
+        if (typeof a === 'string')
+            return a;
+        if (a instanceof Error)
+            return a.stack ?? a.message;
+        try {
+            return JSON.stringify(a);
+        }
+        catch {
+            return String(a);
+        }
+    })
+        .join(' ');
+    const log = (level) => (...args) => {
+        if (typeof __tern_log === 'function')
+            __tern_log(level, format(args));
+    };
+    g.console = {
+        log: log('info'),
+        info: log('info'),
+        debug: log('debug'),
+        warn: log('warn'),
+        error: log('error'),
+        trace: log('debug')
+    };
+}

package/dist/vite/index.d.ts

@@ -0,0 +1,23 @@
+import { type Options as SvelteOptions } from '@sveltejs/vite-plugin-svelte';
+import type { Plugin } from 'vite';
+export interface TernOptions {
+    /** Options passed to @sveltejs/vite-plugin-svelte. */
+    svelte?: Partial<SvelteOptions>;
+}
+/**
+ * The Vite plugin for Tern apps. It includes the Svelte plugin, so it is
+ * the only plugin a Tern app needs:
+ *
+ * ```js
+ * // vite.config.js
+ * import { tern } from '@ternkit/tern/vite';
+ * import { defineConfig } from 'vite';
+ *
+ * export default defineConfig({ plugins: [tern()] });
+ * ```
+ *
+ * `vite build` builds the client; `vite build --ssr` builds the server
+ * renderer that `tern build` embeds in the Go binary.
+ */
+export declare function tern(options?: TernOptions): Plugin[];
+export default tern;

package/dist/vite/index.js

@@ -0,0 +1,110 @@
+import { svelte } from '@sveltejs/vite-plugin-svelte';
+import path from 'node:path';
+/** Paths shared with the Go code generator; keep in sync with internal/codegen. */
+const CLIENT_ENTRY = '.tern/generated/client.js';
+const SERVER_ENTRY = '.tern/generated/server.js';
+const CLIENT_OUT = '.tern/output/client';
+const SERVER_OUT = '.tern/output/server';
+/** The dev endpoint the Go app calls to server-render a page. */
+const RENDER_PATH = '/__tern/render';
+/**
+ * The Vite plugin for Tern apps. It includes the Svelte plugin, so it is
+ * the only plugin a Tern app needs:
+ *
+ * ```js
+ * // vite.config.js
+ * import { tern } from '@ternkit/tern/vite';
+ * import { defineConfig } from 'vite';
+ *
+ * export default defineConfig({ plugins: [tern()] });
+ * ```
+ *
+ * `vite build` builds the client; `vite build --ssr` builds the server
+ * renderer that `tern build` embeds in the Go binary.
+ */
+export function tern(options = {}) {
+    let root = process.cwd();
+    const plugin = {
+        name: 'tern',
+        config(config, env) {
+            root = path.resolve(config.root ?? process.cwd());
+            const shared = {
+                appType: 'custom',
+                resolve: { alias: { $lib: path.join(root, 'src/lib') } }
+            };
+            if (env.isSsrBuild) {
+                return {
+                    ...shared,
+                    publicDir: false,
+                    build: {
+                        ssr: true,
+                        outDir: SERVER_OUT,
+                        emptyOutDir: true,
+                        minify: true,
+                        target: 'es2023',
+                        rolldownOptions: {
+                            input: path.join(root, SERVER_ENTRY),
+                            output: { format: 'iife', name: '__tern_server', entryFileNames: 'server.js' }
+                        }
+                    },
+                    // One self-contained file: the renderer runs in an embedded engine
+                    // without a module loader or Node built-ins.
+                    ssr: { noExternal: true }
+                };
+            }
+            const vitePort = Number(process.env.TERN_VITE_PORT) || undefined;
+            const appPort = Number(process.env.TERN_APP_PORT) || undefined;
+            return {
+                ...shared,
+                publicDir: 'static',
+                build: {
+                    outDir: CLIENT_OUT,
+                    emptyOutDir: true,
+                    manifest: true,
+                    assetsDir: '_app/immutable',
+                    rolldownOptions: { input: path.join(root, CLIENT_ENTRY) }
+                },
+                server: {
+                    // Bind to IPv4 explicitly: the Go app proxies to 127.0.0.1, and
+                    // Node may resolve "localhost" to ::1 only.
+                    host: vitePort ? '127.0.0.1' : undefined,
+                    port: vitePort,
+                    strictPort: vitePort !== undefined,
+                    // The browser talks to the Go app, which proxies HMR to Vite.
+                    hmr: appPort ? { clientPort: appPort } : undefined,
+                    fs: { allow: [root] }
+                },
+                optimizeDeps: {
+                    entries: [CLIENT_ENTRY, 'src/**/*.svelte'],
+                    exclude: ['@ternkit/tern']
+                }
+            };
+        },
+        configureServer(server) {
+            server.middlewares.use(RENDER_PATH, (req, res) => {
+                void renderInDev(server, req).then((body) => {
+                    res.setHeader('Content-Type', 'application/json');
+                    res.end(body);
+                }, (err) => {
+                    const e = err instanceof Error ? err : new Error(String(err));
+                    server.ssrFixStacktrace(e);
+                    res.statusCode = 500;
+                    res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+                    res.end(e.stack ?? e.message);
+                });
+            });
+        }
+    };
+    async function renderInDev(server, req) {
+        if (req.method !== 'POST')
+            throw new Error('POST required');
+        const chunks = [];
+        for await (const chunk of req)
+            chunks.push(chunk);
+        const { payload, href } = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+        const mod = (await server.ssrLoadModule(path.join(root, SERVER_ENTRY)));
+        return mod.render(payload, href);
+    }
+    return [...svelte(options.svelte), plugin];
+}
+export default tern;

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@ternkit/tern",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.1",
+  "description": "Client runtime and Vite plugin for Tern: Svelte on the client, Go on the server",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Unfield/Tern.git",
+    "directory": "packages/tern"
+  },
+  "homepage": "https://github.com/Unfield/Tern",
+  "bugs": "https://github.com/Unfield/Tern/issues",
+  "keywords": [
+    "svelte",
+    "go",
+    "framework",
+    "vite",
+    "router"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "svelte": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/runtime/client.d.ts",
+      "svelte": "./dist/runtime/client.js",
+      "default": "./dist/runtime/client.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "svelte": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    },
+    "./polyfills": {
+      "types": "./dist/server/polyfills.d.ts",
+      "default": "./dist/server/polyfills.js"
+    },
+    "./vite": {
+      "types": "./dist/vite/index.d.ts",
+      "default": "./dist/vite/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*"
+  ],
+  "scripts": {
+    "build": "svelte-package -i src -o dist",
+    "prepare": "svelte-package -i src -o dist",
+    "typecheck": "svelte-check --tsconfig ./tsconfig.json --fail-on-warnings"
+  },
+  "peerDependencies": {
+    "svelte": "^5.46.4",
+    "vite": "^8.0.0"
+  },
+  "dependencies": {
+    "@sveltejs/vite-plugin-svelte": "^7.3.1",
+    "core-js": "^3.51.0"
+  },
+  "devDependencies": {
+    "@sveltejs/package": "^3.0.2",
+    "@types/node": "^24.0.0",
+    "svelte": "^5.57.3",
+    "svelte-check": "^4.7.8",
+    "typescript": "^6.0.0",
+    "vite": "^8.3.7"
+  }
+}