@flexsurfer/reflex 0.1.5 → 0.1.7

package/README.md

@@ -16,7 +16,7 @@ A reactive, functional state management library that brings the elegance and pow
 
 ## ✨ Why Reflex?
 
-After 10+ years of building applications with re-frame in the ClojureScript world, I wanted to bring the same architectural elegance to the JavaScript/TypeScript ecosystem. Reflex is not just another state management library—it's a battle-tested pattern that promotes:
+After many years of building applications with re-frame in the ClojureScript world, I wanted to bring the same architectural elegance to the JavaScript/TypeScript ecosystem. Reflex is not just another state management library—it's a battle-tested pattern that promotes:
 
 🎯 **Predictable State Management** - Unidirectional data flow with pure functions  
 🧩 **Composable Architecture** - Build complex apps from simple, reusable pieces  
@@ -266,7 +266,9 @@ regSub('count');
 - [re-frame Documentation](https://day8.github.io/re-frame/re-frame/) - The original and comprehensive guide to understanding the philosophy and patterns
 - Step-by-Step Tutorial - TBD
 - API Reference - TBD
-- Examples - TBD
+- Examples
+  - [TodoMVC](https://github.com/flexsurfer/reflex/tree/main/examples/todomvc) - Classic todo app implementation showcasing core reflex patterns
+  - [Einbürgerungstest](https://github.com/flexsurfer/einburgerungstest/) - German citizenship test app built with reflex ([Live Demo](https://www.ebtest.org/))
 - Best Practices - TBD
 
 ## 🤝 Contributing

package/dist/index.cjs

@@ -508,7 +508,15 @@ var doFxInterceptor = {
       consoleLog("warn", `[reflex] effects expects a vector, but was given ${typeof effects}`);
       return context;
     }
-    effects.filter((effect) => Array.isArray(effect) && effect.length === 2).forEach(([key, val]) => {
+    effects.forEach((effect) => {
+      if (!effect) {
+        return;
+      }
+      if (!Array.isArray(effect) || effect.length === 0 || effect.length > 2) {
+        consoleLog("warn", `[reflex] invalid effect in effects:`, effect);
+        return;
+      }
+      const [key, val] = effect;
       const effectFn = getHandler(KIND2, key);
       if (effectFn) {
         try {
@@ -1189,8 +1197,12 @@ function setupSubsHotReload() {
   return { dispose, accept };
 }
 function HotReloadWrapper({ children }) {
-  const key = useHotReloadKey();
-  return import_react2.default.createElement("div", { key, style: { display: "contents" } }, children);
+  if (isDebugEnabled()) {
+    const key = useHotReloadKey();
+    return import_react2.default.createElement(import_react2.default.Fragment, { key }, children);
+  } else {
+    return children;
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.cts

@@ -13,7 +13,7 @@ type ErrorHandler = (originalError: Error, reFrameError: Error & {
 type SubVector = [Id, ...any[]];
 type SubHandler = (...values: any[]) => any;
 type SubDepsHandler = (...params: any[]) => SubVector[];
-type Effects = [string, any][];
+type Effects = [string, any?][];
 interface DispatchLaterEffect {
     ms: number;
     dispatch: EventVector;
@@ -178,12 +178,9 @@ declare function setupSubsHotReload(): {
  */
 declare function HotReloadWrapper({ children }: {
     children: React.ReactNode;
-}): React.DetailedReactHTMLElement<{
-    key: string;
-    style: {
-        display: "contents";
-    };
-}, HTMLElement>;
+}): string | number | boolean | React.ReactElement<any, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.FunctionComponentElement<{
+    children?: React.ReactNode | undefined;
+}> | null | undefined;
 
 type TraceID = number;
 interface TraceOpts {

package/dist/index.d.ts

@@ -13,7 +13,7 @@ type ErrorHandler = (originalError: Error, reFrameError: Error & {
 type SubVector = [Id, ...any[]];
 type SubHandler = (...values: any[]) => any;
 type SubDepsHandler = (...params: any[]) => SubVector[];
-type Effects = [string, any][];
+type Effects = [string, any?][];
 interface DispatchLaterEffect {
     ms: number;
     dispatch: EventVector;
@@ -178,12 +178,9 @@ declare function setupSubsHotReload(): {
  */
 declare function HotReloadWrapper({ children }: {
     children: React.ReactNode;
-}): React.DetailedReactHTMLElement<{
-    key: string;
-    style: {
-        display: "contents";
-    };
-}, HTMLElement>;
+}): string | number | boolean | React.ReactElement<any, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.FunctionComponentElement<{
+    children?: React.ReactNode | undefined;
+}> | null | undefined;
 
 type TraceID = number;
 interface TraceOpts {

package/dist/index.mjs

@@ -441,7 +441,15 @@ var doFxInterceptor = {
       consoleLog("warn", `[reflex] effects expects a vector, but was given ${typeof effects}`);
       return context;
     }
-    effects.filter((effect) => Array.isArray(effect) && effect.length === 2).forEach(([key, val]) => {
+    effects.forEach((effect) => {
+      if (!effect) {
+        return;
+      }
+      if (!Array.isArray(effect) || effect.length === 0 || effect.length > 2) {
+        consoleLog("warn", `[reflex] invalid effect in effects:`, effect);
+        return;
+      }
+      const [key, val] = effect;
       const effectFn = getHandler(KIND2, key);
       if (effectFn) {
         try {
@@ -1122,8 +1130,12 @@ function setupSubsHotReload() {
   return { dispose, accept };
 }
 function HotReloadWrapper({ children }) {
-  const key = useHotReloadKey();
-  return React.createElement("div", { key, style: { display: "contents" } }, children);
+  if (isDebugEnabled()) {
+    const key = useHotReloadKey();
+    return React.createElement(React.Fragment, { key }, children);
+  } else {
+    return children;
+  }
 }
 export {
   HotReloadWrapper,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flexsurfer/reflex",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "license": "MIT",
   "repository": {
     "type": "git",