@modern-js/runtime-utils 2.69.5 → 3.0.0-alpha.0

package/dist/esm-node/browser/deferreds.mjs

@@ -0,0 +1,118 @@
+function invariant(value, message) {
+    if (false === value || null == value) throw new Error(message);
+}
+class AbortedDeferredError extends Error {
+}
+function isTrackedPromise(value) {
+    return value instanceof Promise && true === value._tracked;
+}
+function unwrapTrackedPromise(value) {
+    if (!isTrackedPromise(value)) return value;
+    if (value._error) throw value._error;
+    return value._data;
+}
+class DeferredData {
+    trackPromise(key, value) {
+        if (!(value instanceof Promise)) return value;
+        this.deferredKeys.push(key);
+        this.pendingKeysSet.add(key);
+        const promise = Promise.race([
+            value,
+            this.abortPromise
+        ]).then((data)=>this.onSettle(promise, key, void 0, data), (error)=>this.onSettle(promise, key, error));
+        promise.catch(()=>{});
+        Object.defineProperty(promise, '_tracked', {
+            get: ()=>true
+        });
+        return promise;
+    }
+    onSettle(promise, key, error, data) {
+        if (this.controller.signal.aborted && error instanceof AbortedDeferredError) {
+            this.unlistenAbortSignal();
+            Object.defineProperty(promise, '_error', {
+                get: ()=>error
+            });
+            return Promise.reject(error);
+        }
+        this.pendingKeysSet.delete(key);
+        if (this.done) this.unlistenAbortSignal();
+        if (void 0 === error && void 0 === data) {
+            const undefinedError = new Error(`Deferred data for key "${key}" resolved/rejected with \`undefined\`, you must resolve/reject with a value or \`null\`.`);
+            Object.defineProperty(promise, '_error', {
+                get: ()=>undefinedError
+            });
+            this.emit(false, key);
+            return Promise.reject(undefinedError);
+        }
+        if (void 0 === data) {
+            Object.defineProperty(promise, '_error', {
+                get: ()=>error
+            });
+            this.emit(false, key);
+            return Promise.reject(error);
+        }
+        Object.defineProperty(promise, '_data', {
+            get: ()=>data
+        });
+        this.emit(false, key);
+        return data;
+    }
+    emit(aborted, settledKey) {
+        this.subscribers.forEach((subscriber)=>subscriber(aborted, settledKey));
+    }
+    subscribe(fn) {
+        this.subscribers.add(fn);
+        return ()=>this.subscribers.delete(fn);
+    }
+    cancel() {
+        this.controller.abort();
+        this.pendingKeysSet.forEach((v, k)=>this.pendingKeysSet.delete(k));
+        this.emit(true);
+    }
+    async resolveData(signal) {
+        let aborted = false;
+        if (!this.done) {
+            const onAbort = ()=>this.cancel();
+            signal.addEventListener('abort', onAbort);
+            aborted = await new Promise((resolve)=>{
+                this.subscribe((aborted)=>{
+                    signal.removeEventListener('abort', onAbort);
+                    if (aborted || this.done) resolve(aborted);
+                });
+            });
+        }
+        return aborted;
+    }
+    get done() {
+        return 0 === this.pendingKeysSet.size;
+    }
+    get unwrappedData() {
+        invariant(null !== this.data && this.done, 'Can only unwrap data on initialized and settled deferreds');
+        return Object.entries(this.data).reduce((acc, [key, value])=>Object.assign(acc, {
+                [key]: unwrapTrackedPromise(value)
+            }), {});
+    }
+    get pendingKeys() {
+        return Array.from(this.pendingKeysSet);
+    }
+    constructor(data, responseInit){
+        this.pendingKeysSet = new Set();
+        this.subscribers = new Set();
+        this.__modern_deferred = true;
+        this.deferredKeys = [];
+        invariant(data && 'object' == typeof data && !Array.isArray(data), 'defer() only accepts plain objects');
+        let reject;
+        this.abortPromise = new Promise((_, r)=>reject = r);
+        this.controller = new AbortController();
+        const onAbort = ()=>reject(new AbortedDeferredError('Deferred data aborted'));
+        this.unlistenAbortSignal = ()=>this.controller.signal.removeEventListener('abort', onAbort);
+        this.controller.signal.addEventListener('abort', onAbort);
+        this.data = Object.entries(data).reduce((acc, [key, value])=>Object.assign(acc, {
+                [key]: this.trackPromise(key, value)
+            }), {});
+        if (this.done) this.unlistenAbortSignal();
+        this.init = responseInit;
+    }
+}
+const activeDeferreds = new Map();
+export { AbortedDeferredError, DeferredData, activeDeferreds, invariant };

package/dist/esm-node/browser/index.mjs

@@ -0,0 +1,2 @@
+export * from "./nestedRoutes.mjs";
+export * from "./deferreds.mjs";

package/dist/esm-node/browser/nestedRoutes.mjs

@@ -0,0 +1,104 @@
+import { jsx } from "react/jsx-runtime";
+import { LOADER_REPORTER_NAME } from "@modern-js/utils/universal/constants";
+import { Suspense } from "react";
+import { Outlet, Route, createRoutesFromElements } from "react-router";
+import { time } from "../time.mjs";
+import { getAsyncLocalStorage } from "../universal/async_storage.mjs";
+import { DeferredData, activeDeferreds as external_deferreds_mjs_activeDeferreds } from "./deferreds.mjs";
+const privateDefer = (data)=>new DeferredData(data);
+const transformNestedRoutes = (routes)=>{
+    const routeElements = [];
+    for (const route of routes){
+        const routeElement = renderNestedRoute(route);
+        routeElements.push(routeElement);
+    }
+    return createRoutesFromElements(routeElements);
+};
+const renderNestedRoute = (nestedRoute, options = {})=>{
+    const { children, index, id, component, isRoot, lazyImport, config, handle } = nestedRoute;
+    const Component = component;
+    const { parent, props = {} } = options;
+    const routeProps = {
+        caseSensitive: nestedRoute.caseSensitive,
+        path: nestedRoute.path,
+        id: nestedRoute.id,
+        loader: createLoader(nestedRoute),
+        action: nestedRoute.action,
+        hasErrorBoundary: nestedRoute.hasErrorBoundary,
+        shouldRevalidate: nestedRoute.shouldRevalidate,
+        handle: {
+            ...handle,
+            ...'object' == typeof config ? config?.handle : {}
+        },
+        index: nestedRoute.index,
+        element: nestedRoute.element,
+        errorElement: nestedRoute.errorElement
+    };
+    if (nestedRoute.error) {
+        const errorElement = /*#__PURE__*/ jsx(nestedRoute.error, {});
+        routeProps.errorElement = errorElement;
+    }
+    let element;
+    if (Component) if (parent?.loading && lazyImport) {
+        const Loading = parent.loading;
+        element = isLoadableComponent(Component) ? /*#__PURE__*/ jsx(Component, {
+            fallback: /*#__PURE__*/ jsx(Loading, {})
+        }) : /*#__PURE__*/ jsx(Suspense, {
+            fallback: /*#__PURE__*/ jsx(Loading, {}),
+            children: /*#__PURE__*/ jsx(Component, {})
+        });
+    } else element = isLoadableComponent(Component) && lazyImport ? /*#__PURE__*/ jsx(Component, {}) : isRoot ? /*#__PURE__*/ jsx(Component, {
+        ...props
+    }) : lazyImport ? /*#__PURE__*/ jsx(Suspense, {
+        fallback: null,
+        children: /*#__PURE__*/ jsx(Component, {})
+    }) : /*#__PURE__*/ jsx(Component, {});
+    else {
+        nestedRoute.loading = parent?.loading;
+        routeProps.element = /*#__PURE__*/ jsx(Outlet, {});
+    }
+    if (element) routeProps.element = element;
+    const childElements = children?.map((childRoute)=>renderNestedRoute(childRoute, {
+            parent: nestedRoute
+        }));
+    const routeElement = index ? /*#__PURE__*/ jsx(Route, {
+        ...routeProps,
+        index: true
+    }, id) : /*#__PURE__*/ jsx(Route, {
+        ...routeProps,
+        index: false,
+        children: childElements
+    }, id);
+    return routeElement;
+};
+function isPlainObject(value) {
+    return null != value && 'object' == typeof value && Object.getPrototypeOf(value) === Object.prototype;
+}
+function createLoader(route) {
+    const { loader } = route;
+    if (loader) return async (args)=>{
+        if ('function' == typeof route.lazyImport) route.lazyImport();
+        const end = time();
+        const res = await loader(args);
+        let activeDeferreds = null;
+        activeDeferreds = "u" < typeof document ? (await getAsyncLocalStorage())?.useContext()?.activeDeferreds : external_deferreds_mjs_activeDeferreds;
+        if (isPlainObject(res)) {
+            const deferredData = privateDefer(res);
+            activeDeferreds.set(route.id, deferredData);
+        }
+        const cost = end();
+        if ("u" < typeof document) {
+            const storage = await getAsyncLocalStorage();
+            storage?.useContext().monitors?.timing(`${LOADER_REPORTER_NAME}-${route.id?.replace(/\//g, '_')}`, cost);
+        }
+        return res;
+    };
+    return ()=>{
+        if ('function' == typeof route.lazyImport) route.lazyImport();
+        return null;
+    };
+}
+function isLoadableComponent(component) {
+    return component && 'Loadable' === component.displayName && component.preload && 'function' == typeof component.preload;
+}
+export { renderNestedRoute, transformNestedRoutes };

package/dist/esm-node/merge.mjs

@@ -0,0 +1,26 @@
+function isObject(obj) {
+    return obj && 'object' == typeof obj && !Array.isArray(obj);
+}
+function isComplexInstance(obj) {
+    if (!isObject(obj)) return false;
+    const hasMethods = 'function' == typeof obj.init || 'function' == typeof obj.changeLanguage || 'function' == typeof obj.t;
+    const hasInternalProps = void 0 !== obj.isInitialized || void 0 !== obj.language || void 0 !== obj.store;
+    return hasMethods || hasInternalProps;
+}
+function merge(target, ...sources) {
+    if (!sources.length) return target;
+    const source = sources.shift();
+    if (isObject(target) && isObject(source)) for(const key in source)if (isComplexInstance(source[key])) Object.assign(target, {
+        [key]: source[key]
+    });
+    else if (isObject(source[key])) {
+        if (!target[key]) Object.assign(target, {
+            [key]: {}
+        });
+        merge(target[key], source[key]);
+    } else Object.assign(target, {
+        [key]: source[key]
+    });
+    return merge(target, ...sources);
+}
+export { merge };

package/dist/esm-node/node/fileReader.mjs

@@ -0,0 +1,47 @@
+import fs_extra from "@modern-js/utils/fs-extra";
+import { createMemoryStorage } from "./storer/index.mjs";
+class FileReader {
+    async readFile(path, encoding = 'utf-8') {
+        const { fs } = this;
+        const _readfile = this._readFileFactory(fs);
+        return _readfile(path, encoding);
+    }
+    async readFileFromSystem(path, encoding = 'utf-8') {
+        const _readfile = this._readFileFactory(fs_extra);
+        return _readfile(path, encoding);
+    }
+    _readFileFactory(fs) {
+        return async (path, encoding = 'utf-8')=>{
+            const cache = await this.storage.get(path);
+            if (null === cache) return null;
+            if (cache) return this.encodingContent(cache, encoding);
+            const isExistFile = await new Promise((resolve)=>{
+                fs.stat(path, (err, stats)=>{
+                    if (err) return void resolve(false);
+                    stats.isFile() ? resolve(true) : resolve(false);
+                });
+            });
+            if (isExistFile) {
+                const content = await fs.promises.readFile(path);
+                this.storage.set(path, content);
+                return this.encodingContent(content, encoding);
+            }
+            this.storage.set(path, null);
+            return null;
+        };
+    }
+    reset(fs) {
+        fs && (this.fs = fs);
+        return this.storage.clear?.();
+    }
+    encodingContent(value, encoding) {
+        if ('utf-8' === encoding) return value.toString();
+        return value;
+    }
+    constructor(storage){
+        this.fs = fs_extra;
+        this.storage = storage;
+    }
+}
+const fileReader = new FileReader(createMemoryStorage('__file__system'));
+export { FileReader, fileReader };

package/dist/esm-node/node/index.mjs

@@ -0,0 +1,5 @@
+import { storage } from "../universal/async_storage.server.mjs";
+import { serializeJson } from "./serialize.mjs";
+export * from "./loaderContext/index.mjs";
+export * from "./stream.mjs";
+export { serializeJson, storage };

package/dist/esm-node/node/loaderContext/createLoaderCtx.mjs

@@ -0,0 +1,14 @@
+class LoaderContext {
+    getDefaultValue() {
+        if (!this.defaultValue) throw new Error("Can't get defaultValue before initialed");
+        return this.defaultValue;
+    }
+    constructor(defaultValue){
+        this.defaultValue = defaultValue;
+        this.symbol = Symbol('loaderContext');
+    }
+}
+function createLoaderContext(defaultValue) {
+    return new LoaderContext(defaultValue);
+}
+export { LoaderContext, createLoaderContext };

package/dist/esm-node/node/loaderContext/createRequestCtx.mjs

@@ -0,0 +1,16 @@
+function createRequestContext(context) {
+    const _context = context || new Map();
+    function get(key) {
+        if ('string' == typeof key) return _context.get(key);
+        return _context.get(key.symbol) || key.getDefaultValue();
+    }
+    function set(key, value) {
+        if ('string' == typeof key) _context.set(key, value);
+        else _context.set(key.symbol, value);
+    }
+    return {
+        set,
+        get
+    };
+}
+export { createRequestContext };

package/dist/esm-node/node/loaderContext/index.mjs

@@ -0,0 +1,4 @@
+import { createLoaderContext } from "./createLoaderCtx.mjs";
+import { createRequestContext } from "./createRequestCtx.mjs";
+const reporterCtx = createLoaderContext();
+export { createRequestContext, reporterCtx };

package/dist/esm-node/node/serialize.mjs

@@ -0,0 +1,5 @@
+import serialize_javascript from "serialize-javascript";
+const serializeJson = (data)=>serialize_javascript(data, {
+        isJSON: true
+    });
+export { serializeJson };

package/dist/esm-node/node/storer/container.mjs

@@ -0,0 +1,38 @@
+import { LRUCache } from "lru-cache";
+class MemoryContainer {
+    async get(key) {
+        return this.cache.get(key);
+    }
+    async set(key, value) {
+        this.cache.set(key, value);
+        return this;
+    }
+    async has(key) {
+        return this.cache.has(key);
+    }
+    async delete(key) {
+        const exist = await this.has(key);
+        if (exist) this.cache.delete(key);
+        return exist;
+    }
+    forEach(callbackFn) {
+        this.cache.forEach((value, key)=>{
+            callbackFn(value, key, this);
+        });
+    }
+    constructor({ max, maxAge } = {}){
+        this.cache = new LRUCache({
+            maxSize: (max || 256) * MemoryContainer.MB,
+            ttl: maxAge || MemoryContainer.hour,
+            sizeCalculation: (value, key)=>JSON.stringify(value).length
+        });
+    }
+}
+MemoryContainer.BYTE = 1;
+MemoryContainer.KB = 1024 * MemoryContainer.BYTE;
+MemoryContainer.MB = 1024 * MemoryContainer.KB;
+MemoryContainer.ms = 1;
+MemoryContainer.second = 1000 * MemoryContainer.ms;
+MemoryContainer.minute = 60 * MemoryContainer.second;
+MemoryContainer.hour = 60 * MemoryContainer.minute;
+export { MemoryContainer };

package/dist/esm-node/node/storer/index.mjs

@@ -0,0 +1,7 @@
+import { MemoryContainer } from "./container.mjs";
+import { Storage } from "./storage.mjs";
+const memoryContainer = new MemoryContainer();
+function createMemoryStorage(namespace) {
+    return new Storage(namespace, memoryContainer);
+}
+export { Storage, createMemoryStorage };

package/dist/esm-node/node/storer/storage.mjs

@@ -0,0 +1,53 @@
+class Storage {
+    async keys() {
+        const _keys = [];
+        this.forEach?.((_, k)=>{
+            _keys.push(k);
+        });
+        return _keys;
+    }
+    async values() {
+        const _values = [];
+        this.forEach?.((v)=>{
+            _values.push(v);
+        });
+        return _values;
+    }
+    get(key) {
+        const uniqueKey = this.computedUniqueKey(key);
+        return this.container.get(uniqueKey);
+    }
+    async set(key, value) {
+        const uniqueKey = this.computedUniqueKey(key);
+        await this.container.set(uniqueKey, value);
+        return this;
+    }
+    has(key) {
+        const uniqueKey = this.computedUniqueKey(key);
+        return this.container.has(uniqueKey);
+    }
+    delete(key) {
+        const uniqueKey = this.computedUniqueKey(key);
+        return this.container.delete(uniqueKey);
+    }
+    async clear() {
+        const keys = await this.keys?.();
+        await Promise.all(keys?.map(async (key)=>this.container.delete(key)) || []);
+    }
+    forEach(fallbackFn) {
+        this.container.forEach?.((v, k)=>{
+            if (this.checkIsOwnkey(k)) fallbackFn(v, k, this);
+        });
+    }
+    computedUniqueKey(k) {
+        return `${this.namespace}:${k}`;
+    }
+    checkIsOwnkey(k) {
+        return k.startsWith(this.namespace);
+    }
+    constructor(namespace, container){
+        this.namespace = namespace;
+        this.container = container;
+    }
+}
+export { Storage };

package/dist/esm-node/node/stream.mjs

@@ -0,0 +1,68 @@
+import { Stream } from "stream";
+const createReadableStreamFromReadable = (source)=>{
+    const pump = new StreamPump(source);
+    const stream = new ReadableStream(pump, pump);
+    return stream;
+};
+class StreamPump {
+    size(chunk) {
+        return chunk?.byteLength || 0;
+    }
+    start(controller) {
+        this.controller = controller;
+        this.stream.on('data', this.enqueue);
+        this.stream.once('error', this.error);
+        this.stream.once('end', this.close);
+        this.stream.once('close', this.close);
+    }
+    pull() {
+        this.resume();
+    }
+    cancel(reason) {
+        if (this.stream.destroy) this.stream.destroy(reason);
+        process.nextTick(()=>{
+            this.stream.off('data', this.enqueue);
+            this.stream.off('error', this.error);
+            this.stream.off('end', this.close);
+            this.stream.off('close', this.close);
+        });
+    }
+    enqueue(chunk) {
+        if (this.controller) try {
+            const bytes = chunk instanceof Uint8Array ? chunk : Buffer.from(chunk);
+            const available = (this.controller.desiredSize || 0) - bytes.byteLength;
+            this.controller.enqueue(bytes);
+            if (available <= 0) this.pause();
+        } catch (error) {
+            this.controller.error(new Error('Could not create Buffer, chunk must be of type string or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object'));
+            this.cancel();
+        }
+    }
+    pause() {
+        if (this.stream.pause) this.stream.pause();
+    }
+    resume() {
+        if (this.stream.readable && this.stream.resume) this.stream.resume();
+    }
+    close() {
+        if (this.controller) {
+            this.controller.close();
+            delete this.controller;
+        }
+    }
+    error(error) {
+        if (this.controller) {
+            this.controller.error(error);
+            delete this.controller;
+        }
+    }
+    constructor(stream){
+        this.highWaterMark = stream.readableHighWaterMark || new Stream.Readable().readableHighWaterMark;
+        this.accumalatedSize = 0;
+        this.stream = stream;
+        this.enqueue = this.enqueue.bind(this);
+        this.error = this.error.bind(this);
+        this.close = this.close.bind(this);
+    }
+}
+export { createReadableStreamFromReadable };

package/dist/esm-node/parsed.mjs

@@ -0,0 +1,12 @@
+const parsedJSONFromElement = (id)=>{
+    const elements = document.querySelectorAll(`#${id}`);
+    if (0 === elements.length) return;
+    const element = elements[elements.length - 1];
+    if (element) try {
+        const parsed = JSON.parse(element?.textContent || '');
+        return parsed;
+    } catch (e) {
+        console.error(`parse ${id} error`, e);
+    }
+};
+export { parsedJSONFromElement };

package/dist/esm-node/router.mjs

@@ -0,0 +1,18 @@
+export * from "react-router";
+const DEFERRED_SYMBOL = Symbol('deferred');
+const json = (data, init)=>{
+    const responseInit = init ? 'number' == typeof init ? {
+        status: init
+    } : init : void 0;
+    return new Response(JSON.stringify(data), responseInit);
+};
+const defer = (data, init)=>{
+    if (void 0 === init) return data;
+    {
+        const responseInit = init ? 'number' == typeof init ? {
+            status: init
+        } : init : void 0;
+        return new Response(JSON.stringify(data), responseInit);
+    }
+};
+export { DEFERRED_SYMBOL, defer, json };

package/dist/esm-node/rsc.mjs

@@ -0,0 +1 @@
+export * from "react-router";

package/dist/esm-node/server/index.mjs

@@ -0,0 +1 @@
+export * from "./nestedRoutes.mjs";

package/dist/esm-node/server/nestedRoutes.mjs

@@ -0,0 +1,15 @@
+function sortByUrlPath(entries) {
+    entries.sort(function(a, b) {
+        const length1 = a.urlPath.length;
+        const length2 = b.urlPath.length;
+        if (length1 < length2) return 1;
+        if (length1 > length2) return -1;
+        return 0;
+    });
+    return entries;
+}
+const matchEntry = (pathname, entries)=>{
+    sortByUrlPath(entries);
+    return entries.find((entry)=>pathname.startsWith(entry.urlPath));
+};
+export { matchEntry };

package/dist/esm-node/time.mjs

@@ -0,0 +1,27 @@
+function processHrtime(previousTimestamp) {
+    const now = new Date().getTime();
+    const clocktime = 1e-3 * now;
+    let seconds = Math.floor(clocktime);
+    let nanoseconds = Math.floor(clocktime % 1 * 1e9);
+    if (previousTimestamp) {
+        seconds -= previousTimestamp[0];
+        nanoseconds -= previousTimestamp[1];
+        if (nanoseconds < 0) {
+            seconds--;
+            nanoseconds += 1e9;
+        }
+    }
+    return [
+        seconds,
+        nanoseconds
+    ];
+}
+const getLatency = (hrtime)=>{
+    const [s, ns] = processHrtime(hrtime);
+    return 1e3 * s + ns / 1e6;
+};
+const time = ()=>{
+    const hrtime = processHrtime();
+    return ()=>getLatency(hrtime);
+};
+export { time };

package/dist/esm-node/universal/async_storage.mjs

@@ -0,0 +1,24 @@
+const isBrowser = "u" > typeof window && void 0 !== window.document;
+const IS_WEB_FALLBACK = "u" > typeof IS_WEB ? IS_WEB : isBrowser;
+const getAsyncLocalStorage = async ()=>{
+    if (isBrowser) {
+        console.error('You should not get async storage in browser');
+        return null;
+    }
+    if (!IS_WEB_FALLBACK) try {
+        const serverStorage = await import("./async_storage.server.mjs");
+        return serverStorage.getAsyncLocalStorage();
+    } catch (extensionError) {
+        try {
+            const serverStorage = await import("./async_storage.server");
+            return serverStorage.getAsyncLocalStorage();
+        } catch (fallbackError) {
+            console.error('Failed to load server async storage', {
+                extensionError: extensionError instanceof Error ? extensionError.message : extensionError,
+                fallbackError: fallbackError instanceof Error ? fallbackError.message : fallbackError
+            });
+        }
+    }
+    return null;
+};
+export { getAsyncLocalStorage };

package/dist/esm-node/universal/async_storage.server.mjs

@@ -0,0 +1,32 @@
+import { AsyncLocalStorage } from "async_hooks";
+const createStorage = ()=>{
+    let storage;
+    if (void 0 !== AsyncLocalStorage) storage = new AsyncLocalStorage();
+    const run = (context, cb)=>{
+        if (!storage) throw new Error(`Unable to use async_hook, please confirm the node version >= 12.17
+        `);
+        return new Promise((resolve, reject)=>{
+            storage.run(context, ()=>{
+                try {
+                    return resolve(cb());
+                } catch (error) {
+                    return reject(error);
+                }
+            });
+        });
+    };
+    const useContext = ()=>{
+        if (!storage) throw new Error(`Unable to use async_hook, please confirm the node version >= 12.17
+        `);
+        const context = storage?.getStore();
+        if (!context) throw new Error("Can't call useContext out of scope, make sure @modern-js/runtime-utils is a single version in node_modules");
+        return context;
+    };
+    return {
+        run,
+        useContext
+    };
+};
+const async_storage_server_storage = createStorage();
+const getAsyncLocalStorage = async ()=>async_storage_server_storage;
+export { getAsyncLocalStorage, async_storage_server_storage as storage };