@naderikladious/react-flow 0.1.0 → 0.1.6

package/README.md

@@ -2,6 +2,10 @@
 
 Utilities for declarative control-flow primitives in React, written in TypeScript and packaged for ESM/CJS consumers.
 
+<p>
+  <img src="docs/assets/flow-logo.png" alt="Flow logo" width="120" />
+</p>
+
 ## Motivation
 - Keep conditional and iterative UI logic readable without custom hooks per component.
 - Provide type-safe, render-prop based building blocks (`Flow.Condition`, `Flow.If`, `Flow.ForEach`, etc.).
@@ -23,20 +27,31 @@ To explore the Vite example app:
 cd example
 npm install
 npm run dev
+# For GitHub Pages build: GITHUB_PAGES=true npm run build
 ```
 
 ## API
+Preferred namespace is `Flow` (with `ReactFlow` available as an alias).
+
 - `Flow.Condition` — provides a boolean value to descendants.
+- `Flow.AsyncCondition` — resolves a boolean asynchronously and provides it to descendants.
 - `Flow.If` — renders children when the condition is true (prop overrides context).
 - `Flow.Else` — renders children when the condition is false (prop overrides context).
+- `Flow.Unless` — renders children when the condition is false (prop overrides context).
 - `Flow.ForEach<T>` — iterates an array with an optional `keyExtractor` and render-function children `(item, index) => ReactNode`.
 - `Flow.For` — iterates `count` times with optional `start` and `step`, render-function children `(index) => ReactNode`.
 - `Flow.Batch<T>` — groups items into chunks of `batchSize` and renders `(batch, batchIndex) => ReactNode` using `Flow.ForEach` under the hood.
+- `Flow.Switch` / `Flow.Case` / `Flow.Default` — declarative branching on a single value.
 - `useFlowCondition` — hook to read the nearest `Flow.Condition` value (throws if missing).
 
-All components are also available as named exports (tree-shakeable) in addition to the `Flow` namespace object.
+All components are also available as named exports (tree-shakeable) in addition to the namespace object.
 
 ## Examples
+Demo video:
+<p>
+  <video src="docs/assets/flow-demo.webm" controls muted playsinline width="720"></video>
+</p>
+
 Basic conditionals:
 ```tsx
 <Flow.Condition value={isEnabled}>
@@ -45,7 +60,7 @@ Basic conditionals:
   </Flow.If>
   <Flow.Else>
     <div>Disabled</div>
-  </Flow.Else>
+</Flow.Else>
 </Flow.Condition>
 ```
 

package/dist/index.cjs

@@ -12,6 +12,38 @@ const FlowConditionContext = React.createContext({
 const Condition = ({ value, children }) => {
     return (jsxRuntime.jsx(FlowConditionContext.Provider, { value: { value, hasProvider: true }, children: children }));
 };
+const AsyncCondition = ({ value, pending = null, error, children, }) => {
+    var _a;
+    const [state, setState] = React.useState({ status: "pending" });
+    React.useEffect(() => {
+        let active = true;
+        const promise = typeof value === "function" ? value() : value;
+        Promise.resolve(promise)
+            .then((resolved) => {
+            if (!active)
+                return;
+            setState({ status: "resolved", value: resolved });
+        })
+            .catch((err) => {
+            if (!active)
+                return;
+            setState({ status: "rejected", error: err });
+        });
+        return () => {
+            active = false;
+        };
+    }, [value]);
+    if (state.status === "pending") {
+        return jsxRuntime.jsx(jsxRuntime.Fragment, { children: pending });
+    }
+    if (state.status === "rejected") {
+        if (error) {
+            return jsxRuntime.jsx(jsxRuntime.Fragment, { children: error(state.error) });
+        }
+        throw state.error instanceof Error ? state.error : new Error("Flow.AsyncCondition failed.");
+    }
+    return (jsxRuntime.jsx(FlowConditionContext.Provider, { value: { value: (_a = state.value) !== null && _a !== void 0 ? _a : false, hasProvider: true }, children: children }));
+};
 const resolveCondition = (condition, context, componentName) => {
     if (typeof condition === "boolean") {
         return condition;
@@ -31,6 +63,11 @@ const Else = ({ condition, children }) => {
     const active = resolveCondition(condition, context, "Flow.Else");
     return !active ? jsxRuntime.jsx(jsxRuntime.Fragment, { children: children }) : null;
 };
+const Unless = ({ condition, children }) => {
+    const context = React.useContext(FlowConditionContext);
+    const active = resolveCondition(condition, context, "Flow.Unless");
+    return !active ? jsxRuntime.jsx(jsxRuntime.Fragment, { children: children }) : null;
+};
 const ForEach = ({ items, keyExtractor, children }) => {
     return (jsxRuntime.jsx(jsxRuntime.Fragment, { children: items.map((item, index) => (jsxRuntime.jsx(React.Fragment, { children: children(item, index) }, keyExtractor ? keyExtractor(item, index) : index))) }));
 };
@@ -64,6 +101,46 @@ const Batch = ({ items, batchSize, children }) => {
     const batches = chunkItems(items, batchSize);
     return (jsxRuntime.jsx(ForEach, { items: batches, keyExtractor: (_, index) => index, children: (batch, batchIndex) => children(batch, batchIndex) }));
 };
+const Case = (_props) => {
+    throw new Error("Flow.Case must be used within Flow.Switch.");
+};
+const Default = () => {
+    throw new Error("Flow.Default must be used within Flow.Switch.");
+};
+const Switch = ({ value, children }) => {
+    let match = null;
+    let defaultChildren = null;
+    const isPredicate = (when) => typeof when === "function";
+    const isCaseElement = (node) => React.isValidElement(node) && node.type === Case;
+    const isDefaultElement = (node) => React.isValidElement(node) && node.type === Default;
+    React.Children.forEach(children, (child) => {
+        if (match) {
+            return;
+        }
+        if (isDefaultElement(child)) {
+            if (defaultChildren === null) {
+                defaultChildren = child.props.children;
+            }
+            return;
+        }
+        if (isCaseElement(child)) {
+            const { when, children: caseChildren } = child.props;
+            const isMatch = isPredicate(when)
+                ? when(value)
+                : Object.is(when, value);
+            if (isMatch) {
+                match = caseChildren;
+            }
+        }
+    });
+    if (match !== null) {
+        return jsxRuntime.jsx(jsxRuntime.Fragment, { children: match });
+    }
+    if (defaultChildren !== null) {
+        return jsxRuntime.jsx(jsxRuntime.Fragment, { children: defaultChildren });
+    }
+    return null;
+};
 const useFlowCondition = () => {
     const context = React.useContext(FlowConditionContext);
     if (!context.hasProvider) {
@@ -71,26 +148,39 @@ const useFlowCondition = () => {
     }
     return context.value;
 };
-const Flow = {
+const ReactFlow = {
     Condition,
+    AsyncCondition,
     If,
     Else,
+    Unless,
     ForEach,
     For,
     Batch,
+    Switch,
+    Case,
+    Default,
 };
-const ReactFlow = ({ message = "Hello from react-flow" }) => {
+// Legacy alias
+const Flow = ReactFlow;
+const ReactFlowComponent = ({ message = "Hello from react-flow" }) => {
     return jsxRuntime.jsx("div", { children: message });
 };
 
+exports.AsyncCondition = AsyncCondition;
 exports.Batch = Batch;
+exports.Case = Case;
 exports.Condition = Condition;
+exports.Default = Default;
 exports.Else = Else;
 exports.Flow = Flow;
 exports.For = For;
 exports.ForEach = ForEach;
 exports.If = If;
 exports.ReactFlow = ReactFlow;
-exports.default = ReactFlow;
+exports.ReactFlowComponent = ReactFlowComponent;
+exports.Switch = Switch;
+exports.Unless = Unless;
+exports.default = ReactFlowComponent;
 exports.useFlowCondition = useFlowCondition;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/index.tsx"],"sourcesContent":["import React from \"react\";\n\ntype FlowConditionContextValue = {\n  value: boolean;\n  hasProvider: boolean;\n};\n\nconst FlowConditionContext = React.createContext<FlowConditionContextValue>({\n  value: false,\n  hasProvider: false,\n});\n\nexport type FlowConditionProps = {\n  value: boolean;\n  children?: React.ReactNode;\n};\n\nexport const Condition: React.FC<FlowConditionProps> = ({ value, children }) => {\n  return (\n    <FlowConditionContext.Provider value={{ value, hasProvider: true }}>\n      {children}\n    </FlowConditionContext.Provider>\n  );\n};\n\nexport type FlowConditionalBranchProps = {\n  condition?: boolean;\n  children?: React.ReactNode;\n};\n\nconst resolveCondition = (\n  condition: boolean | undefined,\n  context: FlowConditionContextValue,\n  componentName: string\n) => {\n  if (typeof condition === \"boolean\") {\n    return condition;\n  }\n  if (context.hasProvider) {\n    return context.value;\n  }\n  throw new Error(`${componentName} requires a condition prop or Flow.Condition parent.`);\n};\n\nexport const If: React.FC<FlowConditionalBranchProps> = ({ condition, children }) => {\n  const context = React.useContext(FlowConditionContext);\n  const active = resolveCondition(condition, context, \"Flow.If\");\n  return active ? <>{children}</> : null;\n};\n\nexport const Else: React.FC<FlowConditionalBranchProps> = ({ condition, children }) => {\n  const context = React.useContext(FlowConditionContext);\n  const active = resolveCondition(condition, context, \"Flow.Else\");\n  return !active ? <>{children}</> : null;\n};\n\nexport type FlowForEachProps<T> = {\n  items: T[];\n  keyExtractor?: (item: T, index: number) => React.Key;\n  children: (item: T, index: number) => React.ReactNode;\n};\n\nexport const ForEach = <T,>({ items, keyExtractor, children }: FlowForEachProps<T>): React.ReactElement => {\n  return (\n    <>\n      {items.map((item, index) => (\n        <React.Fragment key={keyExtractor ? keyExtractor(item, index) : index}>{children(item, index)}</React.Fragment>\n      ))}\n    </>\n  );\n};\n\nexport type FlowForProps = {\n  count: number;\n  start?: number;\n  step?: number;\n  children: (index: number) => React.ReactNode;\n};\n\nexport const For: React.FC<FlowForProps> = ({ count, start = 0, step = 1, children }) => {\n  if (!Number.isFinite(count) || count < 0) {\n    console.warn(\"Flow.For received an invalid count; rendering nothing.\");\n    return null;\n  }\n  if (!Number.isFinite(step) || step === 0) {\n    throw new Error(\"Flow.For requires a finite non-zero step.\");\n  }\n\n  const iterations = Math.min(count, 10_000);\n  const items = Array.from({ length: iterations }, (_, i) => start + i * step);\n\n  if (iterations !== count) {\n    // Guardrail against accidental infinite or huge loops.\n    console.warn(\"Flow.For capped iterations at 10,000 to avoid infinite loops.\");\n  }\n\n  return (\n    <>\n      {items.map((value, idx) => (\n        <React.Fragment key={value}>{children(value)}</React.Fragment>\n      ))}\n    </>\n  );\n};\n\nexport type FlowBatchProps<T> = {\n  items: T[];\n  batchSize: number;\n  children: (batch: T[], batchIndex: number) => React.ReactNode;\n};\n\nconst chunkItems = <T,>(items: T[], batchSize: number): T[][] => {\n  const batches: T[][] = [];\n  for (let i = 0; i < items.length; i += batchSize) {\n    batches.push(items.slice(i, i + batchSize));\n  }\n  return batches;\n};\n\nexport const Batch = <T,>({ items, batchSize, children }: FlowBatchProps<T>): React.ReactElement => {\n  if (!Number.isInteger(batchSize) || batchSize <= 0) {\n    throw new Error(\"Flow.Batch requires a positive integer batchSize.\");\n  }\n\n  const batches = chunkItems(items, batchSize);\n\n  return (\n    <ForEach\n      items={batches}\n      keyExtractor={(_, index) => index}\n    >\n      {(batch, batchIndex) => children(batch, batchIndex)}\n    </ForEach>\n  );\n};\n\nexport const useFlowCondition = () => {\n  const context = React.useContext(FlowConditionContext);\n  if (!context.hasProvider) {\n    throw new Error(\"useFlowCondition must be used within a Flow.Condition.\");\n  }\n  return context.value;\n};\n\nexport const Flow = {\n  Condition,\n  If,\n  Else,\n  ForEach,\n  For,\n  Batch,\n};\n\nexport type ReactFlowProps = {\n  message?: string;\n};\n\nexport const ReactFlow: React.FC<ReactFlowProps> = ({ message = \"Hello from react-flow\" }) => {\n  return <div>{message}</div>;\n};\n\nexport default ReactFlow;\n"],"names":["_jsx","_Fragment"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/index.tsx"],"sourcesContent":["import React from \"react\";\n\ntype FlowConditionContextValue = {\n  value: boolean;\n  hasProvider: boolean;\n};\n\nconst FlowConditionContext = React.createContext<FlowConditionContextValue>({\n  value: false,\n  hasProvider: false,\n});\n\nexport type FlowConditionProps = {\n  value: boolean;\n  children?: React.ReactNode;\n};\n\nexport const Condition: React.FC<FlowConditionProps> = ({ value, children }) => {\n  return (\n    <FlowConditionContext.Provider value={{ value, hasProvider: true }}>\n      {children}\n    </FlowConditionContext.Provider>\n  );\n};\n\nexport type FlowAsyncConditionProps = {\n  value: Promise<boolean> | (() => Promise<boolean>);\n  pending?: React.ReactNode;\n  error?: (error: unknown) => React.ReactNode;\n  children?: React.ReactNode;\n};\n\nexport const AsyncCondition: React.FC<FlowAsyncConditionProps> = ({\n  value,\n  pending = null,\n  error,\n  children,\n}) => {\n  const [state, setState] = React.useState<{\n    status: \"pending\" | \"resolved\" | \"rejected\";\n    value?: boolean;\n    error?: unknown;\n  }>({ status: \"pending\" });\n\n  React.useEffect(() => {\n    let active = true;\n    const promise = typeof value === \"function\" ? value() : value;\n    Promise.resolve(promise)\n      .then((resolved) => {\n        if (!active) return;\n        setState({ status: \"resolved\", value: resolved });\n      })\n      .catch((err) => {\n        if (!active) return;\n        setState({ status: \"rejected\", error: err });\n      });\n    return () => {\n      active = false;\n    };\n  }, [value]);\n\n  if (state.status === \"pending\") {\n    return <>{pending}</>;\n  }\n\n  if (state.status === \"rejected\") {\n    if (error) {\n      return <>{error(state.error)}</>;\n    }\n    throw state.error instanceof Error ? state.error : new Error(\"Flow.AsyncCondition failed.\");\n  }\n\n  return (\n    <FlowConditionContext.Provider value={{ value: state.value ?? false, hasProvider: true }}>\n      {children}\n    </FlowConditionContext.Provider>\n  );\n};\n\nexport type FlowConditionalBranchProps = {\n  condition?: boolean;\n  children?: React.ReactNode;\n};\n\nconst resolveCondition = (\n  condition: boolean | undefined,\n  context: FlowConditionContextValue,\n  componentName: string\n) => {\n  if (typeof condition === \"boolean\") {\n    return condition;\n  }\n  if (context.hasProvider) {\n    return context.value;\n  }\n  throw new Error(`${componentName} requires a condition prop or Flow.Condition parent.`);\n};\n\nexport const If: React.FC<FlowConditionalBranchProps> = ({ condition, children }) => {\n  const context = React.useContext(FlowConditionContext);\n  const active = resolveCondition(condition, context, \"Flow.If\");\n  return active ? <>{children}</> : null;\n};\n\nexport const Else: React.FC<FlowConditionalBranchProps> = ({ condition, children }) => {\n  const context = React.useContext(FlowConditionContext);\n  const active = resolveCondition(condition, context, \"Flow.Else\");\n  return !active ? <>{children}</> : null;\n};\n\nexport const Unless: React.FC<FlowConditionalBranchProps> = ({ condition, children }) => {\n  const context = React.useContext(FlowConditionContext);\n  const active = resolveCondition(condition, context, \"Flow.Unless\");\n  return !active ? <>{children}</> : null;\n};\n\nexport type FlowForEachProps<T> = {\n  items: T[];\n  keyExtractor?: (item: T, index: number) => React.Key;\n  children: (item: T, index: number) => React.ReactNode;\n};\n\nexport const ForEach = <T,>({ items, keyExtractor, children }: FlowForEachProps<T>): React.ReactElement => {\n  return (\n    <>\n      {items.map((item, index) => (\n        <React.Fragment key={keyExtractor ? keyExtractor(item, index) : index}>{children(item, index)}</React.Fragment>\n      ))}\n    </>\n  );\n};\n\nexport type FlowForProps = {\n  count: number;\n  start?: number;\n  step?: number;\n  children: (index: number) => React.ReactNode;\n};\n\nexport const For: React.FC<FlowForProps> = ({ count, start = 0, step = 1, children }) => {\n  if (!Number.isFinite(count) || count < 0) {\n    console.warn(\"Flow.For received an invalid count; rendering nothing.\");\n    return null;\n  }\n  if (!Number.isFinite(step) || step === 0) {\n    throw new Error(\"Flow.For requires a finite non-zero step.\");\n  }\n\n  const iterations = Math.min(count, 10_000);\n  const items = Array.from({ length: iterations }, (_, i) => start + i * step);\n\n  if (iterations !== count) {\n    // Guardrail against accidental infinite or huge loops.\n    console.warn(\"Flow.For capped iterations at 10,000 to avoid infinite loops.\");\n  }\n\n  return (\n    <>\n      {items.map((value, idx) => (\n        <React.Fragment key={value}>{children(value)}</React.Fragment>\n      ))}\n    </>\n  );\n};\n\nexport type FlowBatchProps<T> = {\n  items: T[];\n  batchSize: number;\n  children: (batch: T[], batchIndex: number) => React.ReactNode;\n};\n\nconst chunkItems = <T,>(items: T[], batchSize: number): T[][] => {\n  const batches: T[][] = [];\n  for (let i = 0; i < items.length; i += batchSize) {\n    batches.push(items.slice(i, i + batchSize));\n  }\n  return batches;\n};\n\nexport const Batch = <T,>({ items, batchSize, children }: FlowBatchProps<T>): React.ReactElement => {\n  if (!Number.isInteger(batchSize) || batchSize <= 0) {\n    throw new Error(\"Flow.Batch requires a positive integer batchSize.\");\n  }\n\n  const batches = chunkItems(items, batchSize);\n\n  return (\n    <ForEach\n      items={batches}\n      keyExtractor={(_, index) => index}\n    >\n      {(batch, batchIndex) => children(batch, batchIndex)}\n    </ForEach>\n  );\n};\n\nexport type FlowSwitchProps<T> = {\n  value: T;\n  children?: React.ReactNode;\n};\n\nexport type FlowCaseProps<T> = {\n  when: T | ((value: T) => boolean);\n  children?: React.ReactNode;\n};\n\nexport type FlowDefaultProps = {\n  children?: React.ReactNode;\n};\n\nexport const Case = <T,>(_props: FlowCaseProps<T>): React.ReactElement | null => {\n  throw new Error(\"Flow.Case must be used within Flow.Switch.\");\n};\n\nexport const Default: React.FC<FlowDefaultProps> = () => {\n  throw new Error(\"Flow.Default must be used within Flow.Switch.\");\n};\n\nexport const Switch = <T,>({ value, children }: FlowSwitchProps<T>): React.ReactElement | null => {\n  let match: React.ReactNode | null = null;\n  let defaultChildren: React.ReactNode | null = null;\n\n  const isPredicate = (when: FlowCaseProps<T>[\"when\"]): when is (value: T) => boolean =>\n    typeof when === \"function\";\n  const isCaseElement = (node: React.ReactNode): node is React.ReactElement<FlowCaseProps<T>> =>\n    React.isValidElement(node) && node.type === Case;\n  const isDefaultElement = (node: React.ReactNode): node is React.ReactElement<FlowDefaultProps> =>\n    React.isValidElement(node) && node.type === Default;\n\n  React.Children.forEach(children, (child) => {\n    if (match) {\n      return;\n    }\n    if (isDefaultElement(child)) {\n      if (defaultChildren === null) {\n        defaultChildren = child.props.children;\n      }\n      return;\n    }\n\n    if (isCaseElement(child)) {\n      const { when, children: caseChildren } = child.props;\n      const isMatch = isPredicate(when)\n        ? (when as (value: T) => boolean)(value)\n        : Object.is(when, value);\n      if (isMatch) {\n        match = caseChildren;\n      }\n    }\n  });\n\n  if (match !== null) {\n    return <>{match}</>;\n  }\n\n  if (defaultChildren !== null) {\n    return <>{defaultChildren}</>;\n  }\n\n  return null;\n};\n\nexport const useFlowCondition = () => {\n  const context = React.useContext(FlowConditionContext);\n  if (!context.hasProvider) {\n    throw new Error(\"useFlowCondition must be used within a Flow.Condition.\");\n  }\n  return context.value;\n};\n\nexport const ReactFlow = {\n  Condition,\n  AsyncCondition,\n  If,\n  Else,\n  Unless,\n  ForEach,\n  For,\n  Batch,\n  Switch,\n  Case,\n  Default,\n};\n\n// Legacy alias\nexport const Flow = ReactFlow;\n\nexport type ReactFlowProps = {\n  message?: string;\n};\n\nexport const ReactFlowComponent: React.FC<ReactFlowProps> = ({ message = \"Hello from react-flow\" }) => {\n  return <div>{message}</div>;\n};\n\nexport default ReactFlowComponent;\n"],"names":["_jsx","_Fragment"],"mappings":"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"}

package/dist/index.d.ts

@@ -5,12 +5,20 @@ type FlowConditionProps = {
     children?: React.ReactNode;
 };
 declare const Condition: React.FC<FlowConditionProps>;
+type FlowAsyncConditionProps = {
+    value: Promise<boolean> | (() => Promise<boolean>);
+    pending?: React.ReactNode;
+    error?: (error: unknown) => React.ReactNode;
+    children?: React.ReactNode;
+};
+declare const AsyncCondition: React.FC<FlowAsyncConditionProps>;
 type FlowConditionalBranchProps = {
     condition?: boolean;
     children?: React.ReactNode;
 };
 declare const If: React.FC<FlowConditionalBranchProps>;
 declare const Else: React.FC<FlowConditionalBranchProps>;
+declare const Unless: React.FC<FlowConditionalBranchProps>;
 type FlowForEachProps<T> = {
     items: T[];
     keyExtractor?: (item: T, index: number) => React.Key;
@@ -30,19 +38,51 @@ type FlowBatchProps<T> = {
     children: (batch: T[], batchIndex: number) => React.ReactNode;
 };
 declare const Batch: <T>({ items, batchSize, children }: FlowBatchProps<T>) => React.ReactElement;
+type FlowSwitchProps<T> = {
+    value: T;
+    children?: React.ReactNode;
+};
+type FlowCaseProps<T> = {
+    when: T | ((value: T) => boolean);
+    children?: React.ReactNode;
+};
+type FlowDefaultProps = {
+    children?: React.ReactNode;
+};
+declare const Case: <T>(_props: FlowCaseProps<T>) => React.ReactElement | null;
+declare const Default: React.FC<FlowDefaultProps>;
+declare const Switch: <T>({ value, children }: FlowSwitchProps<T>) => React.ReactElement | null;
 declare const useFlowCondition: () => boolean;
+declare const ReactFlow: {
+    Condition: React.FC<FlowConditionProps>;
+    AsyncCondition: React.FC<FlowAsyncConditionProps>;
+    If: React.FC<FlowConditionalBranchProps>;
+    Else: React.FC<FlowConditionalBranchProps>;
+    Unless: React.FC<FlowConditionalBranchProps>;
+    ForEach: <T>({ items, keyExtractor, children }: FlowForEachProps<T>) => React.ReactElement;
+    For: React.FC<FlowForProps>;
+    Batch: <T>({ items, batchSize, children }: FlowBatchProps<T>) => React.ReactElement;
+    Switch: <T>({ value, children }: FlowSwitchProps<T>) => React.ReactElement | null;
+    Case: <T>(_props: FlowCaseProps<T>) => React.ReactElement | null;
+    Default: React.FC<FlowDefaultProps>;
+};
 declare const Flow: {
     Condition: React.FC<FlowConditionProps>;
+    AsyncCondition: React.FC<FlowAsyncConditionProps>;
     If: React.FC<FlowConditionalBranchProps>;
     Else: React.FC<FlowConditionalBranchProps>;
+    Unless: React.FC<FlowConditionalBranchProps>;
     ForEach: <T>({ items, keyExtractor, children }: FlowForEachProps<T>) => React.ReactElement;
     For: React.FC<FlowForProps>;
     Batch: <T>({ items, batchSize, children }: FlowBatchProps<T>) => React.ReactElement;
+    Switch: <T>({ value, children }: FlowSwitchProps<T>) => React.ReactElement | null;
+    Case: <T>(_props: FlowCaseProps<T>) => React.ReactElement | null;
+    Default: React.FC<FlowDefaultProps>;
 };
 type ReactFlowProps = {
     message?: string;
 };
-declare const ReactFlow: React.FC<ReactFlowProps>;
+declare const ReactFlowComponent: React.FC<ReactFlowProps>;
 
-export { Batch, Condition, Else, Flow, For, ForEach, If, ReactFlow, ReactFlow as default, useFlowCondition };
-export type { FlowBatchProps, FlowConditionProps, FlowConditionalBranchProps, FlowForEachProps, FlowForProps, ReactFlowProps };
+export { AsyncCondition, Batch, Case, Condition, Default, Else, Flow, For, ForEach, If, ReactFlow, ReactFlowComponent, Switch, Unless, ReactFlowComponent as default, useFlowCondition };
+export type { FlowAsyncConditionProps, FlowBatchProps, FlowCaseProps, FlowConditionProps, FlowConditionalBranchProps, FlowDefaultProps, FlowForEachProps, FlowForProps, FlowSwitchProps, ReactFlowProps };

package/dist/index.mjs

@@ -8,6 +8,38 @@ const FlowConditionContext = React.createContext({
 const Condition = ({ value, children }) => {
     return (jsx(FlowConditionContext.Provider, { value: { value, hasProvider: true }, children: children }));
 };
+const AsyncCondition = ({ value, pending = null, error, children, }) => {
+    var _a;
+    const [state, setState] = React.useState({ status: "pending" });
+    React.useEffect(() => {
+        let active = true;
+        const promise = typeof value === "function" ? value() : value;
+        Promise.resolve(promise)
+            .then((resolved) => {
+            if (!active)
+                return;
+            setState({ status: "resolved", value: resolved });
+        })
+            .catch((err) => {
+            if (!active)
+                return;
+            setState({ status: "rejected", error: err });
+        });
+        return () => {
+            active = false;
+        };
+    }, [value]);
+    if (state.status === "pending") {
+        return jsx(Fragment, { children: pending });
+    }
+    if (state.status === "rejected") {
+        if (error) {
+            return jsx(Fragment, { children: error(state.error) });
+        }
+        throw state.error instanceof Error ? state.error : new Error("Flow.AsyncCondition failed.");
+    }
+    return (jsx(FlowConditionContext.Provider, { value: { value: (_a = state.value) !== null && _a !== void 0 ? _a : false, hasProvider: true }, children: children }));
+};
 const resolveCondition = (condition, context, componentName) => {
     if (typeof condition === "boolean") {
         return condition;
@@ -27,6 +59,11 @@ const Else = ({ condition, children }) => {
     const active = resolveCondition(condition, context, "Flow.Else");
     return !active ? jsx(Fragment, { children: children }) : null;
 };
+const Unless = ({ condition, children }) => {
+    const context = React.useContext(FlowConditionContext);
+    const active = resolveCondition(condition, context, "Flow.Unless");
+    return !active ? jsx(Fragment, { children: children }) : null;
+};
 const ForEach = ({ items, keyExtractor, children }) => {
     return (jsx(Fragment, { children: items.map((item, index) => (jsx(React.Fragment, { children: children(item, index) }, keyExtractor ? keyExtractor(item, index) : index))) }));
 };
@@ -60,6 +97,46 @@ const Batch = ({ items, batchSize, children }) => {
     const batches = chunkItems(items, batchSize);
     return (jsx(ForEach, { items: batches, keyExtractor: (_, index) => index, children: (batch, batchIndex) => children(batch, batchIndex) }));
 };
+const Case = (_props) => {
+    throw new Error("Flow.Case must be used within Flow.Switch.");
+};
+const Default = () => {
+    throw new Error("Flow.Default must be used within Flow.Switch.");
+};
+const Switch = ({ value, children }) => {
+    let match = null;
+    let defaultChildren = null;
+    const isPredicate = (when) => typeof when === "function";
+    const isCaseElement = (node) => React.isValidElement(node) && node.type === Case;
+    const isDefaultElement = (node) => React.isValidElement(node) && node.type === Default;
+    React.Children.forEach(children, (child) => {
+        if (match) {
+            return;
+        }
+        if (isDefaultElement(child)) {
+            if (defaultChildren === null) {
+                defaultChildren = child.props.children;
+            }
+            return;
+        }
+        if (isCaseElement(child)) {
+            const { when, children: caseChildren } = child.props;
+            const isMatch = isPredicate(when)
+                ? when(value)
+                : Object.is(when, value);
+            if (isMatch) {
+                match = caseChildren;
+            }
+        }
+    });
+    if (match !== null) {
+        return jsx(Fragment, { children: match });
+    }
+    if (defaultChildren !== null) {
+        return jsx(Fragment, { children: defaultChildren });
+    }
+    return null;
+};
 const useFlowCondition = () => {
     const context = React.useContext(FlowConditionContext);
     if (!context.hasProvider) {
@@ -67,17 +144,24 @@ const useFlowCondition = () => {
     }
     return context.value;
 };
-const Flow = {
+const ReactFlow = {
     Condition,
+    AsyncCondition,
     If,
     Else,
+    Unless,
     ForEach,
     For,
     Batch,
+    Switch,
+    Case,
+    Default,
 };
-const ReactFlow = ({ message = "Hello from react-flow" }) => {
+// Legacy alias
+const Flow = ReactFlow;
+const ReactFlowComponent = ({ message = "Hello from react-flow" }) => {
     return jsx("div", { children: message });
 };
 
-export { Batch, Condition, Else, Flow, For, ForEach, If, ReactFlow, ReactFlow as default, useFlowCondition };
+export { AsyncCondition, Batch, Case, Condition, Default, Else, Flow, For, ForEach, If, ReactFlow, ReactFlowComponent, Switch, Unless, ReactFlowComponent as default, useFlowCondition };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/index.tsx"],"sourcesContent":["import React from \"react\";\n\ntype FlowConditionContextValue = {\n  value: boolean;\n  hasProvider: boolean;\n};\n\nconst FlowConditionContext = React.createContext<FlowConditionContextValue>({\n  value: false,\n  hasProvider: false,\n});\n\nexport type FlowConditionProps = {\n  value: boolean;\n  children?: React.ReactNode;\n};\n\nexport const Condition: React.FC<FlowConditionProps> = ({ value, children }) => {\n  return (\n    <FlowConditionContext.Provider value={{ value, hasProvider: true }}>\n      {children}\n    </FlowConditionContext.Provider>\n  );\n};\n\nexport type FlowConditionalBranchProps = {\n  condition?: boolean;\n  children?: React.ReactNode;\n};\n\nconst resolveCondition = (\n  condition: boolean | undefined,\n  context: FlowConditionContextValue,\n  componentName: string\n) => {\n  if (typeof condition === \"boolean\") {\n    return condition;\n  }\n  if (context.hasProvider) {\n    return context.value;\n  }\n  throw new Error(`${componentName} requires a condition prop or Flow.Condition parent.`);\n};\n\nexport const If: React.FC<FlowConditionalBranchProps> = ({ condition, children }) => {\n  const context = React.useContext(FlowConditionContext);\n  const active = resolveCondition(condition, context, \"Flow.If\");\n  return active ? <>{children}</> : null;\n};\n\nexport const Else: React.FC<FlowConditionalBranchProps> = ({ condition, children }) => {\n  const context = React.useContext(FlowConditionContext);\n  const active = resolveCondition(condition, context, \"Flow.Else\");\n  return !active ? <>{children}</> : null;\n};\n\nexport type FlowForEachProps<T> = {\n  items: T[];\n  keyExtractor?: (item: T, index: number) => React.Key;\n  children: (item: T, index: number) => React.ReactNode;\n};\n\nexport const ForEach = <T,>({ items, keyExtractor, children }: FlowForEachProps<T>): React.ReactElement => {\n  return (\n    <>\n      {items.map((item, index) => (\n        <React.Fragment key={keyExtractor ? keyExtractor(item, index) : index}>{children(item, index)}</React.Fragment>\n      ))}\n    </>\n  );\n};\n\nexport type FlowForProps = {\n  count: number;\n  start?: number;\n  step?: number;\n  children: (index: number) => React.ReactNode;\n};\n\nexport const For: React.FC<FlowForProps> = ({ count, start = 0, step = 1, children }) => {\n  if (!Number.isFinite(count) || count < 0) {\n    console.warn(\"Flow.For received an invalid count; rendering nothing.\");\n    return null;\n  }\n  if (!Number.isFinite(step) || step === 0) {\n    throw new Error(\"Flow.For requires a finite non-zero step.\");\n  }\n\n  const iterations = Math.min(count, 10_000);\n  const items = Array.from({ length: iterations }, (_, i) => start + i * step);\n\n  if (iterations !== count) {\n    // Guardrail against accidental infinite or huge loops.\n    console.warn(\"Flow.For capped iterations at 10,000 to avoid infinite loops.\");\n  }\n\n  return (\n    <>\n      {items.map((value, idx) => (\n        <React.Fragment key={value}>{children(value)}</React.Fragment>\n      ))}\n    </>\n  );\n};\n\nexport type FlowBatchProps<T> = {\n  items: T[];\n  batchSize: number;\n  children: (batch: T[], batchIndex: number) => React.ReactNode;\n};\n\nconst chunkItems = <T,>(items: T[], batchSize: number): T[][] => {\n  const batches: T[][] = [];\n  for (let i = 0; i < items.length; i += batchSize) {\n    batches.push(items.slice(i, i + batchSize));\n  }\n  return batches;\n};\n\nexport const Batch = <T,>({ items, batchSize, children }: FlowBatchProps<T>): React.ReactElement => {\n  if (!Number.isInteger(batchSize) || batchSize <= 0) {\n    throw new Error(\"Flow.Batch requires a positive integer batchSize.\");\n  }\n\n  const batches = chunkItems(items, batchSize);\n\n  return (\n    <ForEach\n      items={batches}\n      keyExtractor={(_, index) => index}\n    >\n      {(batch, batchIndex) => children(batch, batchIndex)}\n    </ForEach>\n  );\n};\n\nexport const useFlowCondition = () => {\n  const context = React.useContext(FlowConditionContext);\n  if (!context.hasProvider) {\n    throw new Error(\"useFlowCondition must be used within a Flow.Condition.\");\n  }\n  return context.value;\n};\n\nexport const Flow = {\n  Condition,\n  If,\n  Else,\n  ForEach,\n  For,\n  Batch,\n};\n\nexport type ReactFlowProps = {\n  message?: string;\n};\n\nexport const ReactFlow: React.FC<ReactFlowProps> = ({ message = \"Hello from react-flow\" }) => {\n  return <div>{message}</div>;\n};\n\nexport default ReactFlow;\n"],"names":["_jsx","_Fragment"],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../src/index.tsx"],"sourcesContent":["import React from \"react\";\n\ntype FlowConditionContextValue = {\n  value: boolean;\n  hasProvider: boolean;\n};\n\nconst FlowConditionContext = React.createContext<FlowConditionContextValue>({\n  value: false,\n  hasProvider: false,\n});\n\nexport type FlowConditionProps = {\n  value: boolean;\n  children?: React.ReactNode;\n};\n\nexport const Condition: React.FC<FlowConditionProps> = ({ value, children }) => {\n  return (\n    <FlowConditionContext.Provider value={{ value, hasProvider: true }}>\n      {children}\n    </FlowConditionContext.Provider>\n  );\n};\n\nexport type FlowAsyncConditionProps = {\n  value: Promise<boolean> | (() => Promise<boolean>);\n  pending?: React.ReactNode;\n  error?: (error: unknown) => React.ReactNode;\n  children?: React.ReactNode;\n};\n\nexport const AsyncCondition: React.FC<FlowAsyncConditionProps> = ({\n  value,\n  pending = null,\n  error,\n  children,\n}) => {\n  const [state, setState] = React.useState<{\n    status: \"pending\" | \"resolved\" | \"rejected\";\n    value?: boolean;\n    error?: unknown;\n  }>({ status: \"pending\" });\n\n  React.useEffect(() => {\n    let active = true;\n    const promise = typeof value === \"function\" ? value() : value;\n    Promise.resolve(promise)\n      .then((resolved) => {\n        if (!active) return;\n        setState({ status: \"resolved\", value: resolved });\n      })\n      .catch((err) => {\n        if (!active) return;\n        setState({ status: \"rejected\", error: err });\n      });\n    return () => {\n      active = false;\n    };\n  }, [value]);\n\n  if (state.status === \"pending\") {\n    return <>{pending}</>;\n  }\n\n  if (state.status === \"rejected\") {\n    if (error) {\n      return <>{error(state.error)}</>;\n    }\n    throw state.error instanceof Error ? state.error : new Error(\"Flow.AsyncCondition failed.\");\n  }\n\n  return (\n    <FlowConditionContext.Provider value={{ value: state.value ?? false, hasProvider: true }}>\n      {children}\n    </FlowConditionContext.Provider>\n  );\n};\n\nexport type FlowConditionalBranchProps = {\n  condition?: boolean;\n  children?: React.ReactNode;\n};\n\nconst resolveCondition = (\n  condition: boolean | undefined,\n  context: FlowConditionContextValue,\n  componentName: string\n) => {\n  if (typeof condition === \"boolean\") {\n    return condition;\n  }\n  if (context.hasProvider) {\n    return context.value;\n  }\n  throw new Error(`${componentName} requires a condition prop or Flow.Condition parent.`);\n};\n\nexport const If: React.FC<FlowConditionalBranchProps> = ({ condition, children }) => {\n  const context = React.useContext(FlowConditionContext);\n  const active = resolveCondition(condition, context, \"Flow.If\");\n  return active ? <>{children}</> : null;\n};\n\nexport const Else: React.FC<FlowConditionalBranchProps> = ({ condition, children }) => {\n  const context = React.useContext(FlowConditionContext);\n  const active = resolveCondition(condition, context, \"Flow.Else\");\n  return !active ? <>{children}</> : null;\n};\n\nexport const Unless: React.FC<FlowConditionalBranchProps> = ({ condition, children }) => {\n  const context = React.useContext(FlowConditionContext);\n  const active = resolveCondition(condition, context, \"Flow.Unless\");\n  return !active ? <>{children}</> : null;\n};\n\nexport type FlowForEachProps<T> = {\n  items: T[];\n  keyExtractor?: (item: T, index: number) => React.Key;\n  children: (item: T, index: number) => React.ReactNode;\n};\n\nexport const ForEach = <T,>({ items, keyExtractor, children }: FlowForEachProps<T>): React.ReactElement => {\n  return (\n    <>\n      {items.map((item, index) => (\n        <React.Fragment key={keyExtractor ? keyExtractor(item, index) : index}>{children(item, index)}</React.Fragment>\n      ))}\n    </>\n  );\n};\n\nexport type FlowForProps = {\n  count: number;\n  start?: number;\n  step?: number;\n  children: (index: number) => React.ReactNode;\n};\n\nexport const For: React.FC<FlowForProps> = ({ count, start = 0, step = 1, children }) => {\n  if (!Number.isFinite(count) || count < 0) {\n    console.warn(\"Flow.For received an invalid count; rendering nothing.\");\n    return null;\n  }\n  if (!Number.isFinite(step) || step === 0) {\n    throw new Error(\"Flow.For requires a finite non-zero step.\");\n  }\n\n  const iterations = Math.min(count, 10_000);\n  const items = Array.from({ length: iterations }, (_, i) => start + i * step);\n\n  if (iterations !== count) {\n    // Guardrail against accidental infinite or huge loops.\n    console.warn(\"Flow.For capped iterations at 10,000 to avoid infinite loops.\");\n  }\n\n  return (\n    <>\n      {items.map((value, idx) => (\n        <React.Fragment key={value}>{children(value)}</React.Fragment>\n      ))}\n    </>\n  );\n};\n\nexport type FlowBatchProps<T> = {\n  items: T[];\n  batchSize: number;\n  children: (batch: T[], batchIndex: number) => React.ReactNode;\n};\n\nconst chunkItems = <T,>(items: T[], batchSize: number): T[][] => {\n  const batches: T[][] = [];\n  for (let i = 0; i < items.length; i += batchSize) {\n    batches.push(items.slice(i, i + batchSize));\n  }\n  return batches;\n};\n\nexport const Batch = <T,>({ items, batchSize, children }: FlowBatchProps<T>): React.ReactElement => {\n  if (!Number.isInteger(batchSize) || batchSize <= 0) {\n    throw new Error(\"Flow.Batch requires a positive integer batchSize.\");\n  }\n\n  const batches = chunkItems(items, batchSize);\n\n  return (\n    <ForEach\n      items={batches}\n      keyExtractor={(_, index) => index}\n    >\n      {(batch, batchIndex) => children(batch, batchIndex)}\n    </ForEach>\n  );\n};\n\nexport type FlowSwitchProps<T> = {\n  value: T;\n  children?: React.ReactNode;\n};\n\nexport type FlowCaseProps<T> = {\n  when: T | ((value: T) => boolean);\n  children?: React.ReactNode;\n};\n\nexport type FlowDefaultProps = {\n  children?: React.ReactNode;\n};\n\nexport const Case = <T,>(_props: FlowCaseProps<T>): React.ReactElement | null => {\n  throw new Error(\"Flow.Case must be used within Flow.Switch.\");\n};\n\nexport const Default: React.FC<FlowDefaultProps> = () => {\n  throw new Error(\"Flow.Default must be used within Flow.Switch.\");\n};\n\nexport const Switch = <T,>({ value, children }: FlowSwitchProps<T>): React.ReactElement | null => {\n  let match: React.ReactNode | null = null;\n  let defaultChildren: React.ReactNode | null = null;\n\n  const isPredicate = (when: FlowCaseProps<T>[\"when\"]): when is (value: T) => boolean =>\n    typeof when === \"function\";\n  const isCaseElement = (node: React.ReactNode): node is React.ReactElement<FlowCaseProps<T>> =>\n    React.isValidElement(node) && node.type === Case;\n  const isDefaultElement = (node: React.ReactNode): node is React.ReactElement<FlowDefaultProps> =>\n    React.isValidElement(node) && node.type === Default;\n\n  React.Children.forEach(children, (child) => {\n    if (match) {\n      return;\n    }\n    if (isDefaultElement(child)) {\n      if (defaultChildren === null) {\n        defaultChildren = child.props.children;\n      }\n      return;\n    }\n\n    if (isCaseElement(child)) {\n      const { when, children: caseChildren } = child.props;\n      const isMatch = isPredicate(when)\n        ? (when as (value: T) => boolean)(value)\n        : Object.is(when, value);\n      if (isMatch) {\n        match = caseChildren;\n      }\n    }\n  });\n\n  if (match !== null) {\n    return <>{match}</>;\n  }\n\n  if (defaultChildren !== null) {\n    return <>{defaultChildren}</>;\n  }\n\n  return null;\n};\n\nexport const useFlowCondition = () => {\n  const context = React.useContext(FlowConditionContext);\n  if (!context.hasProvider) {\n    throw new Error(\"useFlowCondition must be used within a Flow.Condition.\");\n  }\n  return context.value;\n};\n\nexport const ReactFlow = {\n  Condition,\n  AsyncCondition,\n  If,\n  Else,\n  Unless,\n  ForEach,\n  For,\n  Batch,\n  Switch,\n  Case,\n  Default,\n};\n\n// Legacy alias\nexport const Flow = ReactFlow;\n\nexport type ReactFlowProps = {\n  message?: string;\n};\n\nexport const ReactFlowComponent: React.FC<ReactFlowProps> = ({ message = \"Hello from react-flow\" }) => {\n  return <div>{message}</div>;\n};\n\nexport default ReactFlowComponent;\n"],"names":["_jsx","_Fragment"],"mappings":";;;AAOA,MAAM,oBAAoB,GAAG,KAAK,CAAC,aAAa,CAA4B;AAC1E,IAAA,KAAK,EAAE,KAAK;AACZ,IAAA,WAAW,EAAE,KAAK;AACnB,CAAA,CAAC;AAOK,MAAM,SAAS,GAAiC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAI;AAC7E,IAAA,QACEA,GAAA,CAAC,oBAAoB,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,YAC/D,QAAQ,EAAA,CACqB;AAEpC;AASO,MAAM,cAAc,GAAsC,CAAC,EAChE,KAAK,EACL,OAAO,GAAG,IAAI,EACd,KAAK,EACL,QAAQ,GACT,KAAI;;AACH,IAAA,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAIrC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAEzB,IAAA,KAAK,CAAC,SAAS,CAAC,MAAK;QACnB,IAAI,MAAM,GAAG,IAAI;AACjB,QAAA,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,UAAU,GAAG,KAAK,EAAE,GAAG,KAAK;AAC7D,QAAA,OAAO,CAAC,OAAO,CAAC,OAAO;AACpB,aAAA,IAAI,CAAC,CAAC,QAAQ,KAAI;AACjB,YAAA,IAAI,CAAC,MAAM;gBAAE;YACb,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACnD,QAAA,CAAC;AACA,aAAA,KAAK,CAAC,CAAC,GAAG,KAAI;AACb,YAAA,IAAI,CAAC,MAAM;gBAAE;YACb,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAC9C,QAAA,CAAC,CAAC;AACJ,QAAA,OAAO,MAAK;YACV,MAAM,GAAG,KAAK;AAChB,QAAA,CAAC;AACH,IAAA,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AAEX,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE;QAC9B,OAAOA,GAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EAAG,OAAO,EAAA,CAAI;IACvB;AAEA,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE;QAC/B,IAAI,KAAK,EAAE;YACT,OAAOD,GAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAI;QAClC;AACA,QAAA,MAAM,KAAK,CAAC,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,6BAA6B,CAAC;IAC7F;IAEA,QACED,GAAA,CAAC,oBAAoB,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAA,EAAA,GAAA,KAAK,CAAC,KAAK,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAA,QAAA,EACrF,QAAQ,EAAA,CACqB;AAEpC;AAOA,MAAM,gBAAgB,GAAG,CACvB,SAA8B,EAC9B,OAAkC,EAClC,aAAqB,KACnB;AACF,IAAA,IAAI,OAAO,SAAS,KAAK,SAAS,EAAE;AAClC,QAAA,OAAO,SAAS;IAClB;AACA,IAAA,IAAI,OAAO,CAAC,WAAW,EAAE;QACvB,OAAO,OAAO,CAAC,KAAK;IACtB;AACA,IAAA,MAAM,IAAI,KAAK,CAAC,GAAG,aAAa,CAAA,oDAAA,CAAsD,CAAC;AACzF,CAAC;AAEM,MAAM,EAAE,GAAyC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAI;IAClF,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC;IACtD,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC;IAC9D,OAAO,MAAM,GAAGA,GAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAI,GAAG,IAAI;AACxC;AAEO,MAAM,IAAI,GAAyC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAI;IACpF,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC;IACtD,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC;AAChE,IAAA,OAAO,CAAC,MAAM,GAAGD,GAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAI,GAAG,IAAI;AACzC;AAEO,MAAM,MAAM,GAAyC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAI;IACtF,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC;IACtD,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC;AAClE,IAAA,OAAO,CAAC,MAAM,GAAGD,GAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAI,GAAG,IAAI;AACzC;AAQO,MAAM,OAAO,GAAG,CAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAuB,KAAwB;IACxG,QACED,0BACG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,MACrBA,GAAA,CAAC,KAAK,CAAC,QAAQ,EAAA,EAAA,QAAA,EAAyD,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,IAAxE,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,KAAK,CAA0C,CAChH,CAAC,EAAA,CACD;AAEP;AASO,MAAM,GAAG,GAA2B,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,QAAQ,EAAE,KAAI;AACtF,IAAA,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE;AACxC,QAAA,OAAO,CAAC,IAAI,CAAC,wDAAwD,CAAC;AACtE,QAAA,OAAO,IAAI;IACb;AACA,IAAA,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE;AACxC,QAAA,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC;IAC9D;IAEA,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAM,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC;AAE5E,IAAA,IAAI,UAAU,KAAK,KAAK,EAAE;;AAExB,QAAA,OAAO,CAAC,IAAI,CAAC,+DAA+D,CAAC;IAC/E;AAEA,IAAA,QACEA,GAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EACG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,MACpBD,GAAA,CAAC,KAAK,CAAC,QAAQ,EAAA,EAAA,QAAA,EAAc,QAAQ,CAAC,KAAK,CAAC,EAAA,EAAvB,KAAK,CAAoC,CAC/D,CAAC,EAAA,CACD;AAEP;AAQA,MAAM,UAAU,GAAG,CAAK,KAAU,EAAE,SAAiB,KAAW;IAC9D,MAAM,OAAO,GAAU,EAAE;AACzB,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE;AAChD,QAAA,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7C;AACA,IAAA,OAAO,OAAO;AAChB,CAAC;AAEM,MAAM,KAAK,GAAG,CAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAqB,KAAwB;AACjG,IAAA,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE;AAClD,QAAA,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC;IACtE;IAEA,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC;AAE5C,IAAA,QACEA,GAAA,CAAC,OAAO,EAAA,EACN,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,KAAK,EAAA,QAAA,EAEhC,CAAC,KAAK,EAAE,UAAU,KAAK,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,EAAA,CAC3C;AAEd;AAgBO,MAAM,IAAI,GAAG,CAAK,MAAwB,KAA+B;AAC9E,IAAA,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC;AAC/D;AAEO,MAAM,OAAO,GAA+B,MAAK;AACtD,IAAA,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC;AAClE;AAEO,MAAM,MAAM,GAAG,CAAK,EAAE,KAAK,EAAE,QAAQ,EAAsB,KAA+B;IAC/F,IAAI,KAAK,GAA2B,IAAI;IACxC,IAAI,eAAe,GAA2B,IAAI;IAElD,MAAM,WAAW,GAAG,CAAC,IAA8B,KACjD,OAAO,IAAI,KAAK,UAAU;AAC5B,IAAA,MAAM,aAAa,GAAG,CAAC,IAAqB,KAC1C,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;AAClD,IAAA,MAAM,gBAAgB,GAAG,CAAC,IAAqB,KAC7C,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;IAErD,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,KAAI;QACzC,IAAI,KAAK,EAAE;YACT;QACF;AACA,QAAA,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE;AAC3B,YAAA,IAAI,eAAe,KAAK,IAAI,EAAE;AAC5B,gBAAA,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ;YACxC;YACA;QACF;AAEA,QAAA,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE;YACxB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,KAAK;AACpD,YAAA,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI;AAC9B,kBAAG,IAA8B,CAAC,KAAK;kBACrC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC;YAC1B,IAAI,OAAO,EAAE;gBACX,KAAK,GAAG,YAAY;YACtB;QACF;AACF,IAAA,CAAC,CAAC;AAEF,IAAA,IAAI,KAAK,KAAK,IAAI,EAAE;QAClB,OAAOA,GAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EAAG,KAAK,EAAA,CAAI;IACrB;AAEA,IAAA,IAAI,eAAe,KAAK,IAAI,EAAE;QAC5B,OAAOD,GAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EAAG,eAAe,EAAA,CAAI;IAC/B;AAEA,IAAA,OAAO,IAAI;AACb;AAEO,MAAM,gBAAgB,GAAG,MAAK;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC;AACtD,IAAA,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE;AACxB,QAAA,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC;IAC3E;IACA,OAAO,OAAO,CAAC,KAAK;AACtB;AAEO,MAAM,SAAS,GAAG;IACvB,SAAS;IACT,cAAc;IACd,EAAE;IACF,IAAI;IACJ,MAAM;IACN,OAAO;IACP,GAAG;IACH,KAAK;IACL,MAAM;IACN,IAAI;IACJ,OAAO;;AAGT;AACO,MAAM,IAAI,GAAG;AAMb,MAAM,kBAAkB,GAA6B,CAAC,EAAE,OAAO,GAAG,uBAAuB,EAAE,KAAI;IACpG,OAAOD,GAAA,CAAA,KAAA,EAAA,EAAA,QAAA,EAAM,OAAO,EAAA,CAAO;AAC7B;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naderikladious/react-flow",
-  "version": "0.1.0",
+  "version": "0.1.6",
   "description": "Declarative control-flow primitives for React (Condition/If/Else, For/ForEach, Batch) with TypeScript types.",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -21,7 +21,9 @@
     "clean": "rm -rf dist && mkdir -p dist",
     "dev": "npm run build -- --watch",
     "lint": "echo 'No linter configured yet'",
-    "release": "npm run build"
+    "release": "npm run build",
+    "changelog": "conventional-changelog -p conventionalcommits -i CHANGELOG.md -s",
+    "changelog:first": "conventional-changelog -p conventionalcommits -i CHANGELOG.md -s -r 0"
   },
   "keywords": [
     "react",
@@ -43,6 +45,7 @@
     "@rollup/plugin-commonjs": "^25.0.7",
     "@rollup/plugin-node-resolve": "^15.2.3",
     "@rollup/plugin-typescript": "^11.1.6",
+    "conventional-changelog-cli": "^4.1.0",
     "rollup": "^4.9.1",
     "rollup-plugin-dts": "^6.1.0",
     "typescript": "^5.3.0"