@cleanweb/react 1.1.1-beta.10 → 1.1.1-beta.12

package/build/base/merged-state.d.ts

@@ -1,3 +1,4 @@
+import '../globals';
 declare class MergedState<TState extends object> {
     static useRefresh<TState extends object>(this: MergedState<TState>): void;
     reservedKeys: string[];

package/build/base/merged-state.js

@@ -12,6 +12,7 @@ var __assign = (this && this.__assign) || function () {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useMergedState = void 0;
+require("../globals");
 var react_1 = require("react");
 var MergedState = /** @class */ (function () {
     function MergedState(initialState) {

package/build/base/state.d.ts

@@ -1,3 +1,4 @@
+import '../globals';
 /**
  * Returns a value that is false before the component has been mounted,
  * then true during all subsequent rerenders.

package/build/base/state.js

@@ -12,6 +12,7 @@ var __assign = (this && this.__assign) || function () {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useCleanState = exports.useMountState = void 0;
+require("../globals");
 var react_1 = require("react");
 /**
  * Returns a value that is false before the component has been mounted,

package/build/classy/class.d.ts

@@ -2,6 +2,7 @@ import type { VoidFunctionComponent } from 'react';
 import type { IComponentInstanceClass } from './instance';
 import type { TStateData } from '../base';
 import { ComponentInstance } from './instance';
+export declare const useRerender: () => () => void;
 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> {

package/build/classy/class.js

@@ -15,7 +15,7 @@ var __extends = (this && this.__extends) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Use = exports.ClassComponent = void 0;
+exports.Use = exports.ClassComponent = exports.useRerender = void 0;
 var jsx_runtime_1 = require("react/jsx-runtime");
 var react_1 = require("react");
 var instance_1 = require("./instance");
@@ -41,6 +41,7 @@ var useRerender = function () {
     var rerender = function () { return _forceRerender(Date.now()); };
     return rerender;
 };
+exports.useRerender = useRerender;
 ;
 var ClassComponent = /** @class */ (function (_super) {
     __extends(ClassComponent, _super);
@@ -57,7 +58,7 @@ var ClassComponent = /** @class */ (function (_super) {
             var Render = instance.Render, template = instance.template;
             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.
+            instance.forceUpdate = (_forceUpdate = (0, exports.useRerender)() // Moved this to separate line to allow TS errors. Use proxy local variable to regain some type checking for the assignment to `instance.forceUpdate`.
             );
             // Add calling component name to Render function name in stack traces.
             (0, react_1.useMemo)(function () {
@@ -76,13 +77,17 @@ var ClassComponent = /** @class */ (function (_super) {
              * 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
+             * Users should favor using the `template()` method instead. 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.
+             * of doing it directly in `Render`. Even if `template` is being used, the `beforeRender` method
+             * is the preferred location for such logic to maintain a high level of separation of concerns,
+             * which is what this library exists to provide.
+             *
+             * So there's probably no real value lost with the component boundary. Users should just use
+             * `beforeRender` + `template`.
             **/
             switch (typeof template) {
                 case 'undefined':

package/build/classy/instance.d.ts

@@ -54,8 +54,8 @@ type InstanceClassParams = ConstructorParameters<typeof ComponentInstance<o, o,
 export interface IComponentInstanceClass<Instance extends ComponentInstance<o, o, o> = ComponentInstance, Params extends InstanceClassParams = InstanceClassParams> extends IComponentLogicClass<Instance, Params> {
 }
 type UseInstance = {
-    <Class extends typeof ComponentInstance<HardEmptyObject, o, o>>(Methods: Class & IComponentInstanceClass<InstanceType<Class>>, ...props: ([] | [HardEmptyObject])): InstanceType<Class>;
-    <Class extends typeof ComponentInstance<o, o, o>>(Methods: Class & IComponentInstanceClass<InstanceType<Class>>, ...props: [InstanceType<Class>['props']]): InstanceType<Class>;
+    <Class extends typeof ComponentInstance<HardEmptyObject, o, o>>(Methods: Class & IComponentInstanceClass<InstanceType<Class>>, props?: HardEmptyObject): InstanceType<Class>;
+    <Class extends typeof ComponentInstance<o, o, o>>(Methods: Class & IComponentInstanceClass<InstanceType<Class>>, props: InstanceType<Class>['props']): InstanceType<Class>;
 };
 export declare const useInstance: UseInstance;
 export {};

package/build/classy/logic.js

@@ -56,7 +56,7 @@ testing: {
     }(ComponentLogic));
     ;
     MyComponentLogic.getInitialState;
-    var self_1 = useLogic(MyComponentLogic, {});
+    // const self = useLogic(MyComponentLogic);
 }
 testing: {
     var A = /** @class */ (function (_super) {

package/build/index.d.ts

@@ -1 +1 @@
-export * from "./classy";
+export * from './classy';

package/build/index.js

@@ -16,7 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./classy"), exports);
 // PS: Document component inheritance pattern with lifecycle callback arrays and namespaces.
-// Due to react's remounting behaviour, components must externally track when some logic has run, if it really really must only ever run once per mounted instance. Tricky to get right for components that may have multiple instance rendered simultaneously at different parts of a page.
+// Due to react's remounting behaviour, components must externally track when some logic has run,
+// if it really really must only ever run once per mounted instance. Tricky to get right for components that may have multiple instance rendered simultaneously at different parts of a page.
 // useCleanState => useState, separate call for each key
 // useMergedState => useState, same call for all keys
 // useMethods => useCallback

package/build/tsconfig.json

@@ -35,10 +35,12 @@
 		"exactOptionalPropertyTypes": true,
 	},
 	"include": [
+		// "**/[!globals].ts",
 		"**/*.ts",
 		"**/*.tsx"
 	],
 	"exclude": [
+		"**/globals.ts",
 		"node_modules/**/**.*",
 		"build/**/**.*",
 		"mirror-pkg/**/**.*"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleanweb/react",
-  "version": "1.1.1-beta.10",
+  "version": "1.1.1-beta.12",
   "description": "A suite of helpers for writing cleaner React function components.",
   "engines": {
     "node": ">=18"
@@ -30,7 +30,7 @@
   "scripts": {
     "prebuild": "rimraf ./build",
     "build": "tsc && tsc-alias",
-    "postbuild": "copyfiles globals.d.ts tsconfig.json build",
+    "postbuild": "copyfiles tsconfig.json build",
     "_": "",
     "prepublishOnly": "npm run build",
     "publish:patch": "npm version patch && npm publish",