crelte 0.5.8 → 0.5.10

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,cAAc,CAAC;AACzC,OAAO,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,mBAAmB,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EACN,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,IAAI,EACJ,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,SAAS,GACT,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,cAAc,CAAC;AACzC,OAAO,YAAY,EAAE,EACpB,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,mBAAmB,EAAE,EAC3B,KAAK,0BAA0B,EAC/B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,IAAI,EACJ,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,SAAS,GACT,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,mBAAmB,EACnB,0BAA0B,EAC1B,YAAY,EACZ,aAAa,EACb,OAAO,EACP,aAAa,GACb,CAAC"}

package/dist/server/index.js

@@ -2,4 +2,4 @@ import ServerRequest from './Request.js';
 import ServerRouter from './ServerRouter.js';
 import CrelteServerRequest from './CrelteServer.js';
 export { main, mainError, } from '../init/server.js';
-export { CrelteServerRequest, ServerRouter, ServerRequest };
+export { CrelteServerRequest, ServerRouter, ServerRequest, };

package/dist/server/shared.d.ts

@@ -1,4 +1,5 @@
 import { Platform } from './platform.js';
+import { SiteFromGraphQl } from '../routing/Site.js';
 export type ServerOptions = {
     ts?: boolean;
 };
@@ -15,22 +16,14 @@ export type EnvData = {
     craftWebUrl: string;
     frontendUrl: string;
     viteEnv: Map<string, string>;
-    sites: SiteFromGraphQl[];
-};
-export declare function initEnvData(os: Platform, cache?: SitesCache): Promise<EnvData>;
-export type SiteFromGraphQl = {
-    id: number;
-    baseUrl: string;
-    language: string;
-    name: string | null;
-    handle: string;
-    primary: boolean;
 };
+export declare function initEnvData(os: Platform): Promise<EnvData>;
 export type SitesCache = {
     enabled: boolean;
     readSitesCache?: () => Promise<any>;
     writeSitesCache?: (data: any) => Promise<void>;
 };
+export declare function initSites(env: EnvData, cache?: SitesCache): Promise<SiteFromGraphQl[]>;
 export type ModRenderOptions = {
     ssrManifest?: Record<string, string[]>;
 };
@@ -45,7 +38,7 @@ export type RenderRequest = {
     sites: SiteFromGraphQl[];
     headers: Headers;
 };
-export declare function modRender(env: EnvData, mod: any, template: string, req: Request, opts?: ModRenderOptions): Promise<Response>;
+export declare function modRender(env: EnvData, sites: SiteFromGraphQl[], mod: any, template: string, req: Request, opts?: ModRenderOptions): Promise<Response>;
 export type RenderErrorRequest = {
     url: string;
     htmlTemplate: string;
@@ -55,7 +48,8 @@ export type RenderErrorRequest = {
     craftWeb: string;
     frontend: string;
     viteEnv: Map<string, string>;
-    sites: SiteFromGraphQl[];
 };
-export declare function modRenderError(env: EnvData, mod: any, thrownError: Error, template: string, req: Request, opts?: ModRenderOptions): Promise<Response>;
+export declare function modRenderError(env: EnvData, mod: any, thrownError: Error, template: string, req: Request, opts?: ModRenderOptions & {
+    debugError?: boolean;
+}): Promise<Response>;
 //# sourceMappingURL=shared.d.ts.map

package/dist/server/shared.d.ts.map

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

package/dist/server/shared.js

@@ -1,7 +1,8 @@
 import Queries from '../queries/Queries.js';
 import { SsrCache } from '../ssr/index.js';
 import { gql } from '../queries/index.js';
-export async function initEnvData(os, cache) {
+import { isQueryError } from '../queries/QueryError.js';
+export async function initEnvData(os) {
     const envPath = '../craft/.env';
     let env;
     try {
@@ -22,10 +23,6 @@ export async function initEnvData(os, cache) {
         throw new Error('FRONTEND_URL not set');
     // parse all vite related env variables
     const viteEnv = new Map(Array.from(env).filter(([key]) => key.startsWith('VITE_')));
-    const queries = Queries.new(endpointUrl, frontendUrl, new SsrCache(), {
-        bearerToken: endpointToken,
-    });
-    const sites = await loadSites(queries, cache);
     return {
         env,
         endpointUrl,
@@ -33,9 +30,12 @@ export async function initEnvData(os, cache) {
         craftWebUrl,
         frontendUrl,
         viteEnv,
-        sites,
     };
 }
+export async function initSites(env, cache) {
+    const queries = Queries.new(env.endpointUrl, env.frontendUrl, new SsrCache(), { bearerToken: env.endpointToken });
+    return await loadSites(queries, cache);
+}
 // requires, GraphQl, SsrCache
 async function loadSites(queries, cache) {
     if ('CRAFT_SITES_CACHED' in globalThis) {
@@ -73,9 +73,7 @@ async function loadSites(queries, cache) {
     }
     return resp.crelteSites;
 }
-export async function modRender(env, mod, template, req, opts = {}) {
-    // const acceptLang = req.headers.get('accept-language') ?? null;
-    // const cookies = req.headers.get('cookie') ?? '';
+export async function modRender(env, sites, mod, template, req, opts = {}) {
     const { status, location, html, headers: nHeaders, } = await mod.render({
         url: req.url,
         htmlTemplate: template,
@@ -84,7 +82,7 @@ export async function modRender(env, mod, template, req, opts = {}) {
         craftWeb: env.craftWebUrl,
         frontend: env.frontendUrl,
         viteEnv: env.viteEnv,
-        sites: env.sites,
+        sites,
         headers: req.headers,
         ...opts,
     });
@@ -102,10 +100,13 @@ export async function modRenderError(env, mod, thrownError, template, req, opts
         status: 500,
         message: thrownError.message,
     };
-    if (typeof thrownError.__isGraphQlError__ === 'function')
+    if (isQueryError(thrownError)) {
         error.status = thrownError.status();
+    }
     // todo is the process.env.NODE_ENV the correct check?
-    if (error.status !== 503 && process.env.NODE_ENV === 'development') {
+    if (error.status !== 503 &&
+        !opts.debugError &&
+        process.env.NODE_ENV === 'development') {
         throw thrownError;
     }
     const { status, html } = await mod.renderError(error, {
@@ -117,14 +118,11 @@ export async function modRenderError(env, mod, thrownError, template, req, opts
         craftWeb: env.craftWebUrl,
         frontend: env.frontendUrl,
         viteEnv: env.viteEnv,
-        sites: env.sites,
         ...opts,
     });
     return new Response(html, {
         status,
-        headers: {
-            'Content-Type': 'text/html',
-        },
+        headers: { 'Content-Type': 'text/html' },
     });
 }
 /**

package/dist/ssr/SsrCache.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Calculates a key based on the json representation of the data
+ *
+ * If available hashes the data using SHA-1
+ */
 export declare function calcKey(data: any): Promise<string>;
 /**
  * A simple cache for server side rendering
@@ -9,9 +14,9 @@ export default class SsrCache {
     private store;
     constructor();
     /**
-     * check if the value is in the cache else calls the fn
+     * Check if a key exists in the cache
      */
-    load<T>(key: string, fn: () => Promise<T>): Promise<any>;
+    has(key: string): boolean;
     /**
      * Get a value from the cache
      */
@@ -20,10 +25,57 @@ export default class SsrCache {
      * Set a value in the cache
      */
     set<T>(key: string, val: T): T;
+    /**
+     * check if the value is in the cache else calls the fn
+     *
+     * See also {@link getOrInsertLoaded}
+     */
+    getOrInsertComputed<T>(key: string, fn: () => T): T;
+    /**
+     * check if the value is in the cache else calls the fn
+     *
+     * See also {@link getOrInsertComputed}
+     *
+     * @deprecated use {@link getOrInsertLoaded} instead
+     */
+    load<T>(key: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * check if the value is in the cache else calls the fn
+     *
+     * See also {@link getOrInsertComputed}
+     */
+    getOrInsertLoaded<T>(key: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * One-shot SSR handoff value.
+     *
+     * Intended use: call this once per request (per key) during SSR to generate
+     * a value that must match between server render and client hydration.
+     *
+     * On the server, the value is generated once per key and stored for hydration.
+     * Subsequent calls with the same key during SSR currently return the same value,
+     * but this behaviour is an implementation detail and may change in the future.
+     * Consumers should rely on calling this at most once per key during SSR.
+     *
+     * On the client, the stored value is returned exactly once and removed.
+     * Subsequent calls return a fresh value and are not cached.
+     *
+     * Warning: this function is designed to be called once per key during SSR.
+     * Calling it multiple times may lead to unexpected behaviour if the server-side
+     * implementation changes.
+     *
+     * See also {@link getOrInsertComputed}
+     */
+    takeOnce<T>(key: string, fn: () => T): T;
+    /**
+     * Remove a value from the cache and return it
+     */
+    remove<T>(key: string): T | null;
+    /** @hidden */
+    z_clear(): void;
     /** @hidden */
-    clear(): void;
+    z_importFromHead(): void;
     private exportAsJson;
     /** @hidden */
-    exportToHead(): string;
+    z_exportToHead(): string;
 }
 //# sourceMappingURL=SsrCache.d.ts.map

package/dist/ssr/SsrCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SsrCache.d.ts","sourceRoot":"","sources":["../../src/ssr/SsrCache.ts"],"names":[],"mappings":"AAAA,wBAAsB,OAAO,CAAC,IAAI,EAAE,GAAG,mBAoBtC;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,QAAQ;IAC5B,OAAO,CAAC,KAAK,CAAsB;;IAYnC;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;IAO/C;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAI7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;IAI9B,cAAc;IACd,KAAK;IAIL,OAAO,CAAC,YAAY;IAIpB,cAAc;IACd,YAAY,IAAI,MAAM;CAGtB"}
+{"version":3,"file":"SsrCache.d.ts","sourceRoot":"","sources":["../../src/ssr/SsrCache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBxD;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,QAAQ;IAC5B,OAAO,CAAC,KAAK,CAAmB;;IAMhC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAI7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;IAK9B;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAKnD;;;;;;OAMG;IACG,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5D;;;;OAIG;IACG,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKzE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAcxC;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAMhC,cAAc;IACd,OAAO;IAIP,cAAc;IACd,gBAAgB;IAOhB,OAAO,CAAC,YAAY;IAOpB,cAAc;IACd,cAAc,IAAI,MAAM;CAGxB"}

package/dist/ssr/SsrCache.js

@@ -1,3 +1,8 @@
+/**
+ * Calculates a key based on the json representation of the data
+ *
+ * If available hashes the data using SHA-1
+ */
 export async function calcKey(data) {
     const json = JSON.stringify(data);
     // this should only happen in an unsecure context
@@ -25,44 +30,113 @@ export async function calcKey(data) {
 export default class SsrCache {
     store;
     constructor() {
-        this.store = {};
-        // @ts-ignore
-        if (typeof window !== 'undefined' && window.SSR_STORE) {
-            // @ts-ignore
-            this.store = window.SSR_STORE;
-        }
+        this.store = new Map();
     }
     /**
-     * check if the value is in the cache else calls the fn
+     * Check if a key exists in the cache
      */
-    async load(key, fn) {
-        if (key in this.store)
-            return this.store[key];
-        const v = await fn();
-        this.set(key, v);
-        return v;
+    has(key) {
+        return this.store.has(key);
     }
     /**
      * Get a value from the cache
      */
     get(key) {
-        return this.store[key] ?? null;
+        return this.store.get(key) ?? null;
     }
     /**
      * Set a value in the cache
      */
     set(key, val) {
-        return (this.store[key] = val);
+        this.store.set(key, val);
+        return val;
+    }
+    /**
+     * check if the value is in the cache else calls the fn
+     *
+     * See also {@link getOrInsertLoaded}
+     */
+    getOrInsertComputed(key, fn) {
+        if (this.store.has(key))
+            return this.store.get(key);
+        return this.set(key, fn());
+    }
+    /**
+     * check if the value is in the cache else calls the fn
+     *
+     * See also {@link getOrInsertComputed}
+     *
+     * @deprecated use {@link getOrInsertLoaded} instead
+     */
+    async load(key, fn) {
+        return this.getOrInsertLoaded(key, fn);
+    }
+    /**
+     * check if the value is in the cache else calls the fn
+     *
+     * See also {@link getOrInsertComputed}
+     */
+    async getOrInsertLoaded(key, fn) {
+        if (this.store.has(key))
+            return this.store.get(key);
+        return this.set(key, await fn());
+    }
+    /**
+     * One-shot SSR handoff value.
+     *
+     * Intended use: call this once per request (per key) during SSR to generate
+     * a value that must match between server render and client hydration.
+     *
+     * On the server, the value is generated once per key and stored for hydration.
+     * Subsequent calls with the same key during SSR currently return the same value,
+     * but this behaviour is an implementation detail and may change in the future.
+     * Consumers should rely on calling this at most once per key during SSR.
+     *
+     * On the client, the stored value is returned exactly once and removed.
+     * Subsequent calls return a fresh value and are not cached.
+     *
+     * Warning: this function is designed to be called once per key during SSR.
+     * Calling it multiple times may lead to unexpected behaviour if the server-side
+     * implementation changes.
+     *
+     * See also {@link getOrInsertComputed}
+     */
+    takeOnce(key, fn) {
+        if (import.meta.env.SSR) {
+            if (this.store.has(key)) {
+                console.warn(`SsrCache.takeOnce called multiple times for key "${key}" during SSR.`);
+                return this.store.get(key);
+            }
+            return this.set(key, fn());
+        }
+        if (this.store.has(key))
+            return this.remove(key);
+        return fn();
+    }
+    /**
+     * Remove a value from the cache and return it
+     */
+    remove(key) {
+        const val = this.get(key);
+        this.store.delete(key);
+        return val;
     }
     /** @hidden */
-    clear() {
-        this.store = {};
+    z_clear() {
+        this.store.clear();
+    }
+    /** @hidden */
+    z_importFromHead() {
+        // @ts-ignore
+        this.store = new Map(window._SSR_STORE ?? []);
+        // @ts-ignore
+        delete window._SSR_STORE;
     }
     exportAsJson() {
-        return JSON.stringify(this.store).replace(/</g, '\\u003c');
+        return JSON.stringify(Array.from(this.store.entries())).replace(/</g, '\\u003c');
     }
     /** @hidden */
-    exportToHead() {
-        return `\n\t\t<script>window.SSR_STORE = ${this.exportAsJson()};</script>`;
+    z_exportToHead() {
+        return `\n\t\t<script>window._SSR_STORE = ${this.exportAsJson()};</script>`;
     }
 }

package/dist/std/index.d.ts

@@ -1,3 +1,16 @@
+/**
+ * @packageDocumentation
+ *
+ * Crelte Standard library
+ *
+ * Provides standard utility functions and types for Crelte applications.
+ *
+ * ### Modules:
+ * - {@link std/intl}
+ * - {@link std/stores}
+ * - {@link std/sync}
+ * - {@link std/rand}
+ */
 /**
  * Delays for a specified amount of time.
  *

package/dist/std/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/std/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjD;AAED,MAAM,WAAW,SAAS;IACzB,KAAK,IAAI,IAAI,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC7B,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,CAAC;AAEb;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,oBAAoB,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAIjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/std/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjD;AAED,MAAM,WAAW,SAAS;IACzB,KAAK,IAAI,IAAI,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC7B,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,CAAC;AAEb;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,oBAAoB,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAIjE"}

package/dist/std/index.js

@@ -1,3 +1,16 @@
+/**
+ * @packageDocumentation
+ *
+ * Crelte Standard library
+ *
+ * Provides standard utility functions and types for Crelte applications.
+ *
+ * ### Modules:
+ * - {@link std/intl}
+ * - {@link std/stores}
+ * - {@link std/sync}
+ * - {@link std/rand}
+ */
 /**
  * Delays for a specified amount of time.
  *

package/dist/std/rand/index.d.ts

@@ -0,0 +1,34 @@
+import { Crelte } from '../../crelte.js';
+/**
+ * Returns a random number between 0 (inclusive) and 1 (exclusive).
+ *
+ * In SSR mode, the same key will always return the same random number.
+ * In client mode, the first call will return the number generated during SSR.
+ */
+export declare function random(key: string, crelte?: Crelte): number;
+/**
+ * Create a deterministic random number generator.
+ *
+ * Intended use: create this once during component initialization when a sequence
+ * of random values must be consistent between server-side rendering and client
+ * hydration.
+ *
+ * The generator is seeded during SSR using the provided key. During hydration,
+ * the same seed is reused so that the client produces the same sequence of random
+ * numbers as the server for the initial render.
+ *
+ * After hydration, the generator continues independently on the client.
+ *
+ * @returns A function that returns a pseudo-random number in the range
+ *          [0, 1).
+ *
+ * #### Example
+ * ```ts
+ * const rng = createRng('lucky-number');
+ *
+ * const val1 = rng(); // same on server and client
+ * const val2 = rng(); // same on server and client
+ * ```
+ */
+export declare function createRng(key: string, crelte?: Crelte): () => number;
+//# sourceMappingURL=index.d.ts.map

package/dist/std/rand/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/std/rand/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAoB,GAAG,MAAM,CAExE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,CACxB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAoB,GAC1B,MAAM,MAAM,CAcd"}

package/dist/std/rand/index.js

@@ -0,0 +1,45 @@
+import { getCrelte } from '../../index.js';
+/**
+ * Returns a random number between 0 (inclusive) and 1 (exclusive).
+ *
+ * In SSR mode, the same key will always return the same random number.
+ * In client mode, the first call will return the number generated during SSR.
+ */
+export function random(key, crelte = getCrelte()) {
+    return crelte.ssrCache.takeOnce('_rand_' + key, () => Math.random());
+}
+/**
+ * Create a deterministic random number generator.
+ *
+ * Intended use: create this once during component initialization when a sequence
+ * of random values must be consistent between server-side rendering and client
+ * hydration.
+ *
+ * The generator is seeded during SSR using the provided key. During hydration,
+ * the same seed is reused so that the client produces the same sequence of random
+ * numbers as the server for the initial render.
+ *
+ * After hydration, the generator continues independently on the client.
+ *
+ * @returns A function that returns a pseudo-random number in the range
+ *          [0, 1).
+ *
+ * #### Example
+ * ```ts
+ * const rng = createRng('lucky-number');
+ *
+ * const val1 = rng(); // same on server and client
+ * const val2 = rng(); // same on server and client
+ * ```
+ */
+export function createRng(key, crelte = getCrelte()) {
+    const seed = crelte.ssrCache.takeOnce('_rng_' + key, () => Math.random());
+    // park miller algorithm
+    const MOD = 2147483647;
+    const MUL = 16807;
+    let state = Math.floor(seed * (MOD - 1)) + 1;
+    return () => {
+        state = (state * MUL) % MOD;
+        return (state - 1) / (MOD - 1);
+    };
+}

package/dist/std/rand/internal.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generates a random token of a specified length.
+ *
+ * @param length - The desired length of the token.
+ * @returns A random token.
+ */
+export declare function randomToken(length?: number): string;
+//# sourceMappingURL=internal.d.ts.map

package/dist/std/rand/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../src/std/rand/internal.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAE,MAAU,GAAG,MAAM,CAMtD"}

package/dist/std/rand/internal.js

@@ -0,0 +1,15 @@
+const ALPHABET = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+const ALPHABET_LENGTH = ALPHABET.length;
+/**
+ * Generates a random token of a specified length.
+ *
+ * @param length - The desired length of the token.
+ * @returns A random token.
+ */
+export function randomToken(length = 8) {
+    let s = '';
+    for (let i = 0; i < length; i++) {
+        s += ALPHABET[Math.floor(Math.random() * ALPHABET_LENGTH)];
+    }
+    return s;
+}

package/dist/std/stores/Writable.d.ts

@@ -20,7 +20,7 @@ export default class Writable<T> {
      * The function get's called once with the current value and then when the
      * values changes
      *
-     * ## Note
+     * #### Note
      * This does not check for equality like svelte.
      *
      * @return a function which should be called to unsubscribe

package/dist/std/stores/Writable.js

@@ -23,7 +23,7 @@ export default class Writable {
      * The function get's called once with the current value and then when the
      * values changes
      *
-     * ## Note
+     * #### Note
      * This does not check for equality like svelte.
      *
      * @return a function which should be called to unsubscribe

package/dist/translations/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @packageDocumentation
+ *
+ * ## Unstable
+ * The translations module is not yet stable. APIs may change without a major version bump.
+ */
+import { createFileLoader } from './loader/fileLoader/fileLoader.js';
+import { createGlobalLoader } from './loader/GlobalLoader.js';
+import { type TranslationsLoader, type LoaderCreator } from './loader/index.js';
+import loadTranslations from './loadTranslations.js';
+import { createTranslations, getTranslationsPlugin, type TranslateFunction, type TranslateStore, type Translations, TranslationsPlugin, type TranslationsPluginOptions } from './translationsPlugin.js';
+/**
+ * Creates a translate store for the given namespace.
+ *
+ * #### Example
+ * ```svelte
+ * <script>
+ * 	import { getTranslations } from 'crelte/translations';
+ *
+ * 	const t = getTranslations();
+ * </script>
+ *
+ * <h1>{$t('welcome_message')}</h1>
+ * ```
+ */
+declare function getTranslations(namespace?: string): TranslateStore;
+export { createTranslations, TranslationsPluginOptions, loadTranslations, getTranslations, getTranslationsPlugin, Translations, TranslationsPlugin, TranslationsLoader, LoaderCreator, TranslateStore, TranslateFunction, createFileLoader, createGlobalLoader, };
+//# sourceMappingURL=index.d.ts.map

package/dist/translations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/translations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACN,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;GAaG;AACH,iBAAS,eAAe,CAAC,SAAS,GAAE,MAAiB,GAAG,cAAc,CAGrE;AAED,OAAO,EACN,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,iBAAiB,EAEjB,gBAAgB,EAChB,kBAAkB,GAClB,CAAC"}

package/dist/translations/index.js

@@ -0,0 +1,31 @@
+/**
+ * @packageDocumentation
+ *
+ * ## Unstable
+ * The translations module is not yet stable. APIs may change without a major version bump.
+ */
+import { createFileLoader } from './loader/fileLoader/fileLoader.js';
+import { createGlobalLoader } from './loader/GlobalLoader.js';
+import loadTranslations from './loadTranslations.js';
+import { createTranslations, getTranslationsPlugin, TranslationsPlugin, } from './translationsPlugin.js';
+/**
+ * Creates a translate store for the given namespace.
+ *
+ * #### Example
+ * ```svelte
+ * <script>
+ * 	import { getTranslations } from 'crelte/translations';
+ *
+ * 	const t = getTranslations();
+ * </script>
+ *
+ * <h1>{$t('welcome_message')}</h1>
+ * ```
+ */
+function getTranslations(namespace = 'common') {
+    const plugin = getTranslationsPlugin();
+    return plugin.z_createTranslateStore(namespace);
+}
+export { createTranslations, loadTranslations, getTranslations, getTranslationsPlugin, TranslationsPlugin, 
+// loaders
+createFileLoader, createGlobalLoader, };

package/dist/translations/loadTranslations.d.ts

@@ -0,0 +1,23 @@
+import { CrelteRequest } from '../crelte.js';
+import { TranslateStore } from './translationsPlugin.js';
+/**
+ * Creates a translate store and loads the specified namespace.
+ *
+ * #### Example
+ * ```svelte
+ * <script module>
+ * 	import { loadTranslations } from 'crelte/translations';
+ * 	export const loadData = {
+ * 		t: cr => loadTranslations(cr, 'customNamespace')
+ * 	};
+ * </script>
+ *
+ * <script>
+ * 	let { t } = $props();
+ * </script>
+ *
+ * <h1>{$t('welcome_message')}</h1>
+ * ```
+ */
+export default function loadTranslations(cr: CrelteRequest, namespace: string): Promise<TranslateStore>;
+//# sourceMappingURL=loadTranslations.d.ts.map

package/dist/translations/loadTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadTranslations.d.ts","sourceRoot":"","sources":["../../src/translations/loadTranslations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAyB,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAA8B,gBAAgB,CAC7C,EAAE,EAAE,aAAa,EACjB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAOzB"}