@cleanweb/react 1.1.1-beta.8 → 2.0.1-beta.0

package/build/base/state.d.ts

@@ -1,29 +0,0 @@
-/**
- * Returns a value that is false before the component has been mounted,
- * then true during all subsequent rerenders.
- */
-export declare const useMountState: () => boolean;
-type PutState<TState extends object> = {
-    [Key in keyof TState]: React.Dispatch<React.SetStateAction<TState[Key]>>;
-};
-declare class CleanStateBase<TState extends Record<string, any>> {
-    reservedKeys: string[];
-    valueKeys: string[];
-    private _values_;
-    private _initialValues_;
-    private _setters_;
-    constructor(initialState: TState);
-    static update: <TState_1 extends object>(this: CleanStateBase<TState_1>) => void;
-    get put(): PutState<TState>;
-    get initialState(): TState;
-    putMany: (newValues: Partial<TState>) => void;
-}
-type TCleanStateInstance<TState extends object> = TState & CleanStateBase<TState>;
-export type TCleanState<TState extends object> = TCleanStateInstance<TState>;
-export type TState<YourCleanState extends CleanStateBase<{}>> = Omit<YourCleanState, keyof CleanStateBase<{}>>;
-type StateInitFunction = (...args: any[]) => object;
-type StateInit = object | StateInitFunction;
-type TInitialState<Initializer extends StateInit> = Initializer extends (...args: any[]) => (infer TState extends object) ? TState : Initializer;
-type TUseCleanState = <TInit extends StateInit>(_initialState: TInit, ...props: TInit extends (...args: infer TProps extends any[]) => (infer TState extends object) ? TProps : []) => TCleanStateInstance<TInitialState<TInit>>;
-export declare const useCleanState: TUseCleanState;
-export {};

package/build/classy/class.d.ts

@@ -1,22 +0,0 @@
-import type { VoidFunctionComponent } from 'react';
-import type { IComponentInstanceClass } from './instance';
-import { ComponentInstance } from './instance';
-type ComponentClassParams = ConstructorParameters<typeof ClassComponent>;
-type o = object;
-export interface IComponentClass<Instance extends ClassComponent<o, o, o> = ClassComponent, Params extends ComponentClassParams = ComponentClassParams> extends IComponentInstanceClass<Instance, Params> {
-}
-type Extractor = <TComponent extends typeof ClassComponent<o, o, o>>(this: NonNullable<typeof _Component>, _Component?: TComponent & IComponentClass<InstanceType<TComponent>>) => VoidFunctionComponent<InstanceType<TComponent>['props']>;
-export declare class ClassComponent<TProps extends o = EmptyObject, TState extends o = EmptyObject, THooks extends o = EmptyObject> extends ComponentInstance<TProps, TState, THooks> {
-    Render: VoidFunctionComponent<{}>;
-    readonly forceUpdate: VoidFunction;
-    static renderAs: 'component' | 'template';
-    static readonly FC: Extractor;
-}
-interface HookWrapperProps<THookFunction extends AnyFunction> {
-    hook: THookFunction;
-    argumentsList: Parameters<THookFunction>;
-    onUpdate: (output: ReturnType<THookFunction>) => void;
-}
-type ClassComponentHookWrapper = <Hook extends AnyFunction>(props: HookWrapperProps<Hook>) => null;
-export declare const Use: ClassComponentHookWrapper;
-export {};

package/build/classy/class.js

@@ -1,118 +0,0 @@
-"use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Use = exports.ClassComponent = void 0;
-var jsx_runtime_1 = require("react/jsx-runtime");
-var react_1 = require("react");
-var instance_1 = require("./instance");
-/** Provide more useful stack traces for otherwise non-specific function names. */
-var setFunctionName = function (func, newName) {
-    try {
-        // Must use try block, as `name` is not configurable on older browsers, and may yield a TypeError.
-        Object.defineProperty(func, 'name', {
-            writable: true,
-            value: newName,
-        });
-    }
-    catch (error) {
-        console.warn(error);
-    }
-};
-var useRerender = function () {
-    /*
-     * Skip the value, we don't need it.
-     * Grab just the setter function.
-     */
-    var _a = (0, react_1.useState)(Date.now()), _forceRerender = _a[1];
-    var rerender = function () { return _forceRerender(Date.now()); };
-    return rerender;
-};
-;
-var ClassComponent = /** @class */ (function (_super) {
-    __extends(ClassComponent, _super);
-    function ClassComponent() {
-        return _super !== null && _super.apply(this, arguments) || this;
-    }
-    ClassComponent.renderAs = 'component';
-    ClassComponent.FC = function FC(_Component) {
-        var Component = _Component !== null && _Component !== void 0 ? _Component : this;
-        var isClassComponentType = Component.prototype instanceof ClassComponent;
-        if (!Component.getInitialState || !isClassComponentType)
-            throw new Error('Attempted to initialize ClassComponent with invalid Class type. Either pass a class that extends ClassComponent to FC (e.g `export FC(MyComponent);`), or ensure it is called as a method on a ClassComponent constructor type (e.g `export MyComponent.FC()`).');
-        var Wrapper = function (props, context) {
-            var instance = (0, instance_1.useInstance)(Component, props);
-            var Render = instance.Render;
-            var _forceUpdate;
-            // @ts-expect-error (Cannot assign to 'forceUpdate' because it is a read-only property.ts(2540))
-            instance.forceUpdate = (_forceUpdate = useRerender() // Moved this to separate line to allow TS errors. Use proxy local variable to regain some type checking for the assignment.
-            );
-            // Add calling component name to Render function name in stack traces.
-            (0, react_1.useMemo)(function () { return setFunctionName(Render, "".concat(Component.name, ".Render")); }, [Render]);
-            /**
-             * Normally a component can update it's own state in the "before-render" stage to
-             * skip DOM updates and trigger and immediate rerun of the rendering with the new state.
-             *
-             * It may be impossible to do this within the body of Render, if we call it as JSX here,
-             * since technically, the Wrapper component owns the state and not the Render component.
-             * Using it as JSX establishes a component boundary, and React will throw an error if we try to set
-             * state in the "before-render" stage of `Render`, since it will be attempting to update it's parent's
-             * state (i.e `Wrapper` component) rather than it's own state.
-             *
-             * Consider using this as a function call instead of JSX to avoid that. This way, we avoid
-             * establishing a component boundary between `Wrapper` and `Render`.
-             *
-             * Although, since beforeRender() is called earlier from a hook, this is probably
-             * a non-issue. It will only force users to move their logic into `beforeRender` instead
-             * of doing it directly in `Render`. This might mean cleaner Render functions,
-             * so there's probably no real value lost if we keep the component boundary.
-            **/
-            if (Component.renderAs === 'template')
-                return Render({}, context);
-            // With the existence of useContext(),
-            // what exactly does the context argument to FunctionComponent represent?
-            // Do we need to find a way to pass that context value to <Render /> here?
-            return (0, jsx_runtime_1.jsx)(Render, {});
-        };
-        // Include calling component name in wrapper function name on stack traces.
-        setFunctionName(Wrapper, "".concat(Component.name, " < Wrapper")); // ${Wrapper.name}
-        return Wrapper;
-    };
-    return ClassComponent;
-}(instance_1.ComponentInstance));
-exports.ClassComponent = ClassComponent;
-var Use = function (params) {
-    var useGenericHook = params.hook, argumentsList = params.argumentsList, onUpdate = params.onUpdate;
-    var output = useGenericHook.apply(void 0, argumentsList);
-    (0, react_1.useEffect)(function () {
-        onUpdate(output);
-    }, [output]);
-    return null;
-};
-exports.Use = Use;
-testing: {
-    var a = { b: '' };
-    var MyComponentLogic = /** @class */ (function (_super) {
-        __extends(MyComponentLogic, _super);
-        function MyComponentLogic() {
-            return _super !== null && _super.apply(this, arguments) || this;
-        }
-        MyComponentLogic.getInitialState = function () { return ({ a: '' }); };
-        return MyComponentLogic;
-    }(ClassComponent));
-    ;
-    var Template = MyComponentLogic.FC();
-}

package/build/classy/instance.d.ts

@@ -1,60 +0,0 @@
-import { ComponentLogic, IComponentLogicClass } from './logic';
-type AsyncAllowedEffectCallback = () => Awaitable<IVoidFunction>;
-type UseMountCallbacks = <TInstance extends ComponentInstance<any, any, any>>(instance: TInstance) => void;
-export declare const useMountCallbacks: UseMountCallbacks;
-export declare const noOp: () => void;
-export declare class ComponentInstance<TProps extends o = EmptyObject, TState extends o = EmptyObject, THooks extends o = EmptyObject> extends ComponentLogic<TProps, TState, THooks> {
-    /**
-     * Runs only _before_ first render, i.e before the component instance is mounted.
-     * Useful for logic that is involved in determining what to render.
-     *
-     * Updating local state from in here will abort the render cycle early, before changes are committed to the DOM,
-     * and prompt React to immediately rerender the component with the updated state value(s).
-     *
-     * Ignored on subsequent rerenders.
-     */
-    beforeMount: IVoidFunction;
-    /**
-     * Runs only **_after_** first render, i.e after the component instance is mounted.
-     *
-     * Should usually only be used for logic that does not directly take part in determining what to render, like
-     * synchronize your component with some external system.
-     *
-     * Ignored on subsequent rerenders.
-     *
-     * Returns a cleanup function.
-     */
-    onMount: AsyncAllowedEffectCallback;
-    /**
-     * Runs _before_ every render cycle, including the first.
-     * Useful for logic that is involved in determining what to render.
-     *
-     * Updating local state from in here will abort the render cycle early, before changes are committed to the DOM,
-     * and prompt React to immediately rerender the component with the updated state value(s).
-     */
-    beforeRender: IVoidFunction;
-    /**
-     * Runs **_after_** every render cycle, including the first.
-     *
-     * Should usually only be used for logic that does not directly take part in determining what to render, like
-     * synchronize your component with some external system.
-     *
-     * Returns a cleanup function.
-     */
-    onRender: AsyncAllowedEffectCallback;
-    /**
-     * Runs when the component is unmounted.
-     * It is called _after_ the cleanup function returned by onMount.
-     */
-    cleanUp: IVoidFunction;
-}
-type o = object;
-type InstanceClassParams = ConstructorParameters<typeof ComponentInstance<o, o, o>>;
-export interface IComponentInstanceClass<Instance extends ComponentInstance<o, o, o> = ComponentInstance, Params extends InstanceClassParams = InstanceClassParams> extends IComponentLogicClass<Instance, Params> {
-}
-type UseInstance2 = {
-    <Class extends typeof ComponentInstance<EmptyObject, o, o>>(Methods: Class & IComponentInstanceClass<InstanceType<Class>>, ...props: ([] | [EmptyObject])): InstanceType<Class>;
-    <Class extends typeof ComponentInstance<o, o, o>>(Methods: Class & IComponentInstanceClass<InstanceType<Class>>, ...props: [InstanceType<Class>['props']]): InstanceType<Class>;
-};
-export declare const useInstance: UseInstance2;
-export {};

package/build/classy/logic.d.ts

@@ -1,20 +0,0 @@
-import type { TCleanState, TState } from '../base/state';
-export type Empty = EmptyObject;
-type o = object;
-export declare class ComponentLogic<TProps extends o = Empty, TState extends o = Empty, THooks extends o = Empty> {
-    state: TCleanState<TState>;
-    props: TProps;
-    hooks: THooks;
-    static getInitialState: (p?: o) => {};
-    useHooks?: () => THooks;
-}
-type LogicClassParams = ConstructorParameters<typeof ComponentLogic>;
-export interface IComponentLogicClass<Instance extends ComponentLogic<o, o, o> = ComponentLogic, Params extends LogicClassParams = LogicClassParams> extends Constructor<Instance, Params> {
-    getInitialState: (props?: Instance['props']) => TState<Instance['state']>;
-}
-type UseLogic2 = {
-    <Class extends typeof ComponentLogic<Empty, o, o>>(Methods: Class & IComponentLogicClass<InstanceType<Class>>, ...props: ([] | [EmptyObject])): InstanceType<Class>;
-    <Class extends typeof ComponentLogic<o, o, o>>(Methods: Class & IComponentLogicClass<InstanceType<Class>>, ...props: [InstanceType<Class>['props']]): InstanceType<Class>;
-};
-declare const useLogic: UseLogic2;
-export { useLogic };

package/build/classy/logic.js

@@ -1,79 +0,0 @@
-"use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useLogic = exports.ComponentLogic = void 0;
-var react_1 = require("react");
-var state_1 = require("../base/state");
-var ComponentLogic = /** @class */ (function () {
-    function ComponentLogic() {
-    }
-    ComponentLogic.getInitialState = function (p) { return ({}); };
-    return ComponentLogic;
-}());
-exports.ComponentLogic = ComponentLogic;
-;
-var useLogic = function () {
-    var _a, _b;
-    var args = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args[_i] = arguments[_i];
-    }
-    var Methods = args[0], _c = args[1], props = _c === void 0 ? {} : _c;
-    var state = (0, state_1.useCleanState)(Methods.getInitialState, props);
-    var methods = (0, react_1.useRef)((0, react_1.useMemo)(function () {
-        return new Methods();
-    }, [])).current;
-    methods.state = state;
-    methods.props = props;
-    methods.hooks = (_b = (_a = methods.useHooks) === null || _a === void 0 ? void 0 : _a.call(methods)) !== null && _b !== void 0 ? _b : {};
-    return methods;
-};
-exports.useLogic = useLogic;
-testing: {
-    var a = { b: '' };
-    var MyComponentLogic = /** @class */ (function (_super) {
-        __extends(MyComponentLogic, _super);
-        function MyComponentLogic() {
-            var _this = _super !== null && _super.apply(this, arguments) || this;
-            _this.b = _this.state.a;
-            return _this;
-        }
-        MyComponentLogic.getInitialState = function (p) { return ({ a: '' }); };
-        return MyComponentLogic;
-    }(ComponentLogic));
-    ;
-    MyComponentLogic.getInitialState;
-    var self_1 = useLogic(MyComponentLogic);
-}
-testing: {
-    var A = /** @class */ (function (_super) {
-        __extends(C, _super);
-        function C() {
-            return _super !== null && _super.apply(this, arguments) || this;
-        }
-        return C;
-    }(ComponentLogic));
-    A.getInitialState();
-    var self_2 = useLogic(A, { a: 'boo' });
-}
-// export type ComponentClassStatics<Instance extends ComponentLogic<object, object, object>> = {
-// 	getInitialState: (props?: Instance['props']) => TState<Instance['state']>;
-// }
-// export type TComponentClass<
-// 	Instance extends ComponentLogic<object, object, object>,
-// 	Params extends CnstPrm = CnstPrm
-// > = ComponentClassStatics<Instance> & Constructor<Instance, Params>;

package/build/globals.private.d.ts

@@ -1,44 +0,0 @@
-/**
- * @file
- * This file is created specifically to augment the declarations in
- * [globals.d.ts]({@link ./globals.d.ts}).
- *
- * **You should not import this file directly.**
- */
-/** */
-declare const UniqueSecretSymbolKey: unique symbol;
-declare class CEmptyObject2 {
-    [UniqueSecretSymbolKey]?: never;
-}
-declare class CEmptyObject3 {
-    /**
-     * It appears keys of the base `symbol` type are excluded from
-     * excess property checks. This is likely a bug in TypeScript.
-     * Even the "has no properties in common" error disappears if the
-     * value being placed into a variable has a key typed as `symbol`.
-     * This only applies to the base `symbol` type. Specifc `'unique symbol'`
-     * types are unaffected.
-     *
-     * @example
-     * // Consider the following object:
-     * const myUniqueSymbol = Symbol('lkjhgfc');
-     * let myObj = { [myUniqueSymbol]?: 'a string value' };
-     *
-     * // We can attempt to reassign `myObj` with the expectation that TS will
-     * // warn if any key other than `myUniqueSymbol` is used in the new object.
-     * // But this breaks in one specific scenario.
-     *
-     * // No excess property check when this is used as a key.
-     * // Error "no properties in common" also suppressed when this is used as a key.
-     * const differentBasicSymbol = Symbol('qwertiop[') as symbol;
-     * myObj = { [differentBasicSymbol]: 5 };
-     *
-     * // Errors emitted as expected when this is used as a key.
-     * const differentUniqueSymbol = Symbol('zxcvbnm');
-     * myObj = { [differentUniqueSymbol]: 5 };
-     */
-    [key: symbol]: never;
-}
-export declare const EmptyObject2: CEmptyObject2;
-export declare const EmptyObject3: CEmptyObject3;
-export {};

package/build/globals.private.js

@@ -1,34 +0,0 @@
-"use strict";
-/**
- * @file
- * This file is created specifically to augment the declarations in
- * [globals.d.ts]({@link ./globals.d.ts}).
- *
- * **You should not import this file directly.**
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EmptyObject3 = exports.EmptyObject2 = void 0;
-/** */
-var UniqueSecretSymbolKey = Symbol('asdfghjkliuytrewqaxcvb,nb');
-var CEmptyObject2 = /** @class */ (function () {
-    function CEmptyObject2() {
-    }
-    return CEmptyObject2;
-}());
-var CEmptyObject3 = /** @class */ (function () {
-    function CEmptyObject3() {
-    }
-    return CEmptyObject3;
-}());
-exports.EmptyObject2 = new CEmptyObject2();
-exports.EmptyObject3 = new CEmptyObject3();
-testing: {
-    var mySymbol = Symbol('asdfgh');
-    var tt = {
-    // [mySymbol]: '' as never,
-    // [UniqueSecretSymbolKey]: '',
-    // '': '',
-    };
-    var TT = new CEmptyObject2();
-    TT = tt;
-}