main repo

node_modules/use-sidecar/dist/es2015/config.d.ts

@@ -0,0 +1,5 @@
+export interface IConfig {
+    onError(e: Error): void;
+}
+export declare const config: IConfig;
+export declare const setConfig: (conf: Partial<IConfig>) => void;

node_modules/use-sidecar/dist/es2015/config.js

@@ -0,0 +1,6 @@
+export var config = {
+    onError: function (e) { return console.error(e); },
+};
+export var setConfig = function (conf) {
+    Object.assign(config, conf);
+};

node_modules/use-sidecar/dist/es2015/env.d.ts

@@ -0,0 +1,4 @@
+export declare const env: {
+    isNode: boolean;
+    forceCache: boolean;
+};

node_modules/use-sidecar/dist/es2015/env.js

@@ -0,0 +1,5 @@
+import { isNode } from 'detect-node-es';
+export var env = {
+    isNode: isNode,
+    forceCache: false,
+};

node_modules/use-sidecar/dist/es2015/exports.d.ts

@@ -0,0 +1,3 @@
+import * as React from 'react';
+import { SideCarComponent, SideCarMedium } from './types';
+export declare function exportSidecar<T>(medium: SideCarMedium<T>, exported: React.ComponentType<T>): SideCarComponent<T>;

node_modules/use-sidecar/dist/es2015/exports.js

@@ -0,0 +1,18 @@
+import { __assign, __rest } from "tslib";
+import * as React from 'react';
+var SideCar = function (_a) {
+    var sideCar = _a.sideCar, rest = __rest(_a, ["sideCar"]);
+    if (!sideCar) {
+        throw new Error('Sidecar: please provide `sideCar` property to import the right car');
+    }
+    var Target = sideCar.read();
+    if (!Target) {
+        throw new Error('Sidecar medium not found');
+    }
+    return React.createElement(Target, __assign({}, rest));
+};
+SideCar.isSideCarExport = true;
+export function exportSidecar(medium, exported) {
+    medium.useMedium(exported);
+    return SideCar;
+}

node_modules/use-sidecar/dist/es2015/hoc.d.ts

@@ -0,0 +1,3 @@
+import * as React from 'react';
+import { Importer, SideCarHOC } from './types';
+export declare function sidecar<T>(importer: Importer<T>, errorComponent?: React.ReactNode): React.FunctionComponent<Omit<T, 'sideCar'> & SideCarHOC<Omit<T, 'sideCar'>>>;

node_modules/use-sidecar/dist/es2015/hoc.js

@@ -0,0 +1,15 @@
+import { __assign } from "tslib";
+import * as React from 'react';
+import { useSidecar } from './hook';
+// eslint-disable-next-line @typescript-eslint/ban-types
+export function sidecar(importer, errorComponent) {
+    var ErrorCase = function () { return errorComponent; };
+    return function Sidecar(props) {
+        var _a = useSidecar(importer, props.sideCar), Car = _a[0], error = _a[1];
+        if (error && errorComponent) {
+            return ErrorCase;
+        }
+        // @ts-expect-error type shenanigans
+        return Car ? React.createElement(Car, __assign({}, props)) : null;
+    };
+}

node_modules/use-sidecar/dist/es2015/hook.d.ts

@@ -0,0 +1,2 @@
+import { Importer, SideMedium } from './types';
+export declare function useSidecar<T>(importer: Importer<T>, effect?: SideMedium<any>): [React.ComponentType<T> | null, Error | null];

node_modules/use-sidecar/dist/es2015/hook.js

@@ -0,0 +1,41 @@
+import { useState, useEffect } from 'react';
+import { env } from './env';
+var cache = new WeakMap();
+var NO_OPTIONS = {};
+export function useSidecar(importer, effect) {
+    var options = (effect && effect.options) || NO_OPTIONS;
+    if (env.isNode && !options.ssr) {
+        return [null, null];
+    }
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    return useRealSidecar(importer, effect);
+}
+function useRealSidecar(importer, effect) {
+    var options = (effect && effect.options) || NO_OPTIONS;
+    var couldUseCache = env.forceCache || (env.isNode && !!options.ssr) || !options.async;
+    var _a = useState(couldUseCache ? function () { return cache.get(importer); } : undefined), Car = _a[0], setCar = _a[1];
+    var _b = useState(null), error = _b[0], setError = _b[1];
+    useEffect(function () {
+        if (!Car) {
+            importer().then(function (car) {
+                var resolved = effect ? effect.read() : car.default || car;
+                if (!resolved) {
+                    console.error('Sidecar error: with importer', importer);
+                    var error_1;
+                    if (effect) {
+                        console.error('Sidecar error: with medium', effect);
+                        error_1 = new Error('Sidecar medium was not found');
+                    }
+                    else {
+                        error_1 = new Error('Sidecar was not found in exports');
+                    }
+                    setError(function () { return error_1; });
+                    throw error_1;
+                }
+                cache.set(importer, resolved);
+                setCar(function () { return resolved; });
+            }, function (e) { return setError(function () { return e; }); });
+        }
+    }, []);
+    return [Car, error];
+}

node_modules/use-sidecar/dist/es2015/index.d.ts

@@ -0,0 +1,7 @@
+export { sidecar } from './hoc';
+export { useSidecar } from './hook';
+export { setConfig } from './config';
+export { createMedium, createSidecarMedium } from './medium';
+export { renderCar } from './renderProp';
+export { exportSidecar } from './exports';
+export type { SideCarComponent } from './types';

node_modules/use-sidecar/dist/es2015/index.js

@@ -0,0 +1,6 @@
+export { sidecar } from './hoc';
+export { useSidecar } from './hook';
+export { setConfig } from './config';
+export { createMedium, createSidecarMedium } from './medium';
+export { renderCar } from './renderProp';
+export { exportSidecar } from './exports';

node_modules/use-sidecar/dist/es2015/medium.d.ts

@@ -0,0 +1,3 @@
+import { MiddlewareCallback, SideCarMedium, SideCarMediumOptions, SideMedium } from './types';
+export declare function createMedium<T>(defaults?: T, middleware?: MiddlewareCallback<T>): Readonly<SideMedium<T>>;
+export declare function createSidecarMedium<T = {}>(options?: SideCarMediumOptions): Readonly<SideCarMedium<T>>;

node_modules/use-sidecar/dist/es2015/medium.js

@@ -0,0 +1,78 @@
+import { __assign } from "tslib";
+function ItoI(a) {
+    return a;
+}
+function innerCreateMedium(defaults, middleware) {
+    if (middleware === void 0) { middleware = ItoI; }
+    var buffer = [];
+    var assigned = false;
+    var medium = {
+        read: function () {
+            if (assigned) {
+                throw new Error('Sidecar: could not `read` from an `assigned` medium. `read` could be used only with `useMedium`.');
+            }
+            if (buffer.length) {
+                return buffer[buffer.length - 1];
+            }
+            return defaults;
+        },
+        useMedium: function (data) {
+            var item = middleware(data, assigned);
+            buffer.push(item);
+            return function () {
+                buffer = buffer.filter(function (x) { return x !== item; });
+            };
+        },
+        assignSyncMedium: function (cb) {
+            assigned = true;
+            while (buffer.length) {
+                var cbs = buffer;
+                buffer = [];
+                cbs.forEach(cb);
+            }
+            buffer = {
+                push: function (x) { return cb(x); },
+                filter: function () { return buffer; },
+            };
+        },
+        assignMedium: function (cb) {
+            assigned = true;
+            var pendingQueue = [];
+            if (buffer.length) {
+                var cbs = buffer;
+                buffer = [];
+                cbs.forEach(cb);
+                pendingQueue = buffer;
+            }
+            var executeQueue = function () {
+                var cbs = pendingQueue;
+                pendingQueue = [];
+                cbs.forEach(cb);
+            };
+            var cycle = function () { return Promise.resolve().then(executeQueue); };
+            cycle();
+            buffer = {
+                push: function (x) {
+                    pendingQueue.push(x);
+                    cycle();
+                },
+                filter: function (filter) {
+                    pendingQueue = pendingQueue.filter(filter);
+                    return buffer;
+                },
+            };
+        },
+    };
+    return medium;
+}
+export function createMedium(defaults, middleware) {
+    if (middleware === void 0) { middleware = ItoI; }
+    return innerCreateMedium(defaults, middleware);
+}
+// eslint-disable-next-line @typescript-eslint/ban-types
+export function createSidecarMedium(options) {
+    if (options === void 0) { options = {}; }
+    var medium = innerCreateMedium(null);
+    medium.options = __assign({ async: true, ssr: false }, options);
+    return medium;
+}

node_modules/use-sidecar/dist/es2015/renderProp.d.ts

@@ -0,0 +1,8 @@
+import * as React from 'react';
+import { SideCarHOC } from './types';
+declare type CombinedProps<T extends any[], K> = {
+    children: (...prop: T) => any;
+} & K;
+declare type RenderPropComponent<T extends any[], K> = React.ComponentType<CombinedProps<T, K>>;
+export declare function renderCar<T extends any[], K, C = RenderPropComponent<T, K & Partial<SideCarHOC>>>(WrappedComponent: C, defaults: (props: K) => T): (props: CombinedProps<T, K>) => JSX.Element;
+export {};

node_modules/use-sidecar/dist/es2015/renderProp.js

@@ -0,0 +1,35 @@
+import { __assign } from "tslib";
+import * as React from 'react';
+import { useState, useCallback, useEffect, useLayoutEffect } from 'react';
+export function renderCar(WrappedComponent, defaults) {
+    function State(_a) {
+        var stateRef = _a.stateRef, props = _a.props;
+        var renderTarget = useCallback(function SideTarget() {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            useLayoutEffect(function () {
+                stateRef.current(args);
+            });
+            return null;
+        }, []);
+        // @ts-ignore
+        return React.createElement(WrappedComponent, __assign({}, props, { children: renderTarget }));
+    }
+    var Children = React.memo(function (_a) {
+        var stateRef = _a.stateRef, defaultState = _a.defaultState, children = _a.children;
+        var _b = useState(defaultState.current), state = _b[0], setState = _b[1];
+        useEffect(function () {
+            stateRef.current = setState;
+        }, []);
+        return children.apply(void 0, state);
+    }, function () { return true; });
+    return function Combiner(props) {
+        var defaultState = React.useRef(defaults(props));
+        var ref = React.useRef(function (state) { return (defaultState.current = state); });
+        return (React.createElement(React.Fragment, null,
+            React.createElement(State, { stateRef: ref, props: props }),
+            React.createElement(Children, { stateRef: ref, defaultState: defaultState, children: props.children })));
+    };
+}

node_modules/use-sidecar/dist/es2015/types.d.ts

@@ -0,0 +1,47 @@
+import * as React from 'react';
+export declare type removeCb = () => void;
+export declare type MediumCallback<T> = (data: T) => any;
+export declare type MiddlewareCallback<T> = (data: T, assigned: boolean) => T;
+export declare type SidePush<T> = {
+    length?: number;
+    push(data: T): void;
+    filter(cb: (x: T) => boolean): SidePush<T>;
+};
+/**
+ * An object describing side medium
+ */
+export interface SideMedium<T> {
+    /**
+     * Pushes effect to the medium
+     * @param effect any information for real handler
+     */
+    useMedium(effect: T): removeCb;
+    /**
+     * Assigns effect handler to the medium
+     * @param {Function(effect: T)} handler effect handler
+     */
+    assignMedium(handler: MediumCallback<T>): void;
+    /**
+     * Assigns a synchronous effect handler to the medium, which would be executed right on call
+     * @param {Function(effect: T)} handler effect handler
+     */
+    assignSyncMedium(handler: MediumCallback<T>): void;
+    /**
+     * reads the data stored in the medium
+     */
+    read(): T | undefined;
+    options?: Record<string, any>;
+}
+export declare type DefaultOrNot<T> = {
+    default: T;
+} | T;
+export declare type Importer<T> = () => Promise<DefaultOrNot<React.ComponentType<T>>>;
+export declare type SideCarMedium<T = {}> = SideMedium<React.ComponentType<T>>;
+export declare type SideCarHOC<T = {}> = {
+    readonly sideCar: SideCarMedium<T>;
+};
+export declare type SideCarComponent<T> = React.FunctionComponent<T & SideCarHOC<T>>;
+export declare type SideCarMediumOptions = {
+    async?: boolean;
+    ssr?: boolean;
+};

node_modules/use-sidecar/dist/es2015/types.js

@@ -0,0 +1 @@
+export {};