solid-ctrl-flow 1.0.27 → 1.0.29

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { Accessor } from 'solid-js';
 import { Context } from 'solid-js';
 import { EffectFunction } from 'solid-js';
 import { JSX } from 'solid-js';
+import { Ref } from 'solid-js';
 import { Resource } from 'solid-js';
 import { Setter } from 'solid-js';
 import { Signal } from 'solid-js';
@@ -156,6 +157,11 @@ export declare const Debug: {
     read: Accessor<boolean>;
 };
 
+/** Component that gives you the owner {@link Document} */
+export declare function Doc(props: {
+    ref: Ref<Document>;
+}): Text;
+
 /** Informations about a {@link Source} component */
 declare type Info = {
     /** Order of the current source if there are many */
@@ -172,13 +178,23 @@ declare type Info = {
 export declare function memoProps<T, K extends readonly (keyof T)[] = (keyof T)[]>(obj: T, keys?: K): Pick<T, K[number]>;
 
 /**
- * Executes {@link f} with the provided {@link Context}
+ * Executes a {@link Ref}.
+ * Throws a {@link ReferenceError} if {@link ref} its not a function at runtime (Which should never be the case thanks to the solid compiler)
+ * @param ref The function to execute
+ * @param value The value to pass to the function
+ * @returns The same value of {@link value}
+ */
+export declare function refCall<T, U extends T = T>(ref: Ref<T> | undefined, value: U): U;
+
+/**
+ * Executes {@link f} with the provided value for the specified {@link Context}.
+ * You can pass `undefined` to {@link value} in order to get back the default value for {@link ctx}
  * @param ctx The context to which to set the value
  * @param value The value for the context
  * @param f The function to run
  * @returns The same thing {@link f} returned
  */
-export declare function runWithContext<T, R>(ctx: Context<T>, value: T, f: (x: T) => R): R;
+export declare function runWithContext<T, R>(ctx: Context<T>, value: T | undefined, f: (x: T | undefined) => R): R;
 
 /**
  * Executes {@link splitProps} and memoizes the first of the two returned objects

package/dist/index.mjs

@@ -1,8 +1,16 @@
-import { untrack, createMemo, splitProps, createEffect, on, createResource, createContext, createRoot, getOwner, createComponent, useContext, createRenderEffect, onCleanup, Match, mergeProps, For, Show } from "solid-js";
+import { untrack, createMemo, splitProps, createContext, getOwner, runWithOwner, createEffect, on, createResource, createComponent, useContext, createRoot, createRenderEffect, onCleanup, Match, mergeProps, For, Show, onMount } from "solid-js";
 import { createMutable } from "solid-js/store";
 function untrackCall(f, ...args) {
   return untrack(() => f.apply(this, args));
 }
+function refCall(ref, value) {
+  if (!ref)
+    return value;
+  if (typeof ref !== "function")
+    throw new ReferenceError('Il parametro "ref" deve essere stato compilato in una funzione a runtime');
+  ref(value);
+  return value;
+}
 function memoProps(obj, keys = Object.keys(obj)) {
   const out = {};
   for (const elm of keys)
@@ -17,15 +25,6 @@ function splitAndMemoProps(obj, keys) {
   out[0] = memoProps(out[0], keys);
   return out;
 }
-function createReactiveResource(f) {
-  var refetch;
-  const memo = createMemo(f);
-  createEffect(on(memo, () => refetch?.()));
-  const [get] = [, {
-    refetch
-  }] = createResource(memo);
-  return get;
-}
 function createOption(init, def = init, name) {
   const prop = "read";
   const ctx2 = createContext(() => init, {
@@ -44,19 +43,27 @@ function createOption(init, def = init, name) {
   return provider;
 }
 function runWithContext(ctx2, value, f) {
-  return createRoot((d) => {
-    try {
-      getOwner().context = {
-        [ctx2.id]: value
-      };
-      const out = f(value);
-      if (out instanceof Promise)
-        return out.finally(d);
-      return d(), out;
-    } catch (ex) {
-      throw d(), ex;
-    }
-  });
+  const owner = getOwner();
+  const context = {
+    ...owner?.context,
+    [ctx2.id]: value
+  };
+  const temp = {
+    context,
+    owner,
+    owned: null,
+    cleanups: null
+  };
+  return runWithOwner(temp, () => f(value));
+}
+function createReactiveResource(f) {
+  var refetch;
+  const memo = createMemo(f);
+  createEffect(on(memo, () => refetch?.()));
+  const [get] = [, {
+    refetch
+  }] = createResource(memo);
+  return get;
 }
 const IDENTITY = (x) => x;
 function bind([get], [, set], to = IDENTITY) {
@@ -180,9 +187,15 @@ function Joint(props) {
   });
 }
 const Debug = createOption(false, true, "debug-scope");
+function Doc(props) {
+  const node = document.createTextNode("");
+  onMount(() => (refCall(props.ref, node.ownerDocument), node.remove()));
+  return node;
+}
 export {
   Case,
   Debug,
+  Doc,
   When,
   bind,
   bindTwoWay,
@@ -191,6 +204,7 @@ export {
   createOption,
   createReactiveResource,
   memoProps,
+  refCall,
   runWithContext,
   splitAndMemoProps,
   toSetter,

package/dist/index.umd.js

@@ -5,6 +5,14 @@
   function untrackCall(f, ...args) {
     return solidJs.untrack(() => f.apply(this, args));
   }
+  function refCall(ref, value) {
+    if (!ref)
+      return value;
+    if (typeof ref !== "function")
+      throw new ReferenceError('Il parametro "ref" deve essere stato compilato in una funzione a runtime');
+    ref(value);
+    return value;
+  }
   function memoProps(obj, keys = Object.keys(obj)) {
     const out = {};
     for (const elm of keys)
@@ -19,15 +27,6 @@
     out[0] = memoProps(out[0], keys);
     return out;
   }
-  function createReactiveResource(f) {
-    var refetch;
-    const memo = solidJs.createMemo(f);
-    solidJs.createEffect(solidJs.on(memo, () => refetch?.()));
-    const [get] = [, {
-      refetch
-    }] = solidJs.createResource(memo);
-    return get;
-  }
   function createOption(init, def = init, name) {
     const prop = "read";
     const ctx2 = solidJs.createContext(() => init, {
@@ -46,19 +45,27 @@
     return provider;
   }
   function runWithContext(ctx2, value, f) {
-    return solidJs.createRoot((d) => {
-      try {
-        solidJs.getOwner().context = {
-          [ctx2.id]: value
-        };
-        const out = f(value);
-        if (out instanceof Promise)
-          return out.finally(d);
-        return d(), out;
-      } catch (ex) {
-        throw d(), ex;
-      }
-    });
+    const owner = solidJs.getOwner();
+    const context = {
+      ...owner?.context,
+      [ctx2.id]: value
+    };
+    const temp = {
+      context,
+      owner,
+      owned: null,
+      cleanups: null
+    };
+    return solidJs.runWithOwner(temp, () => f(value));
+  }
+  function createReactiveResource(f) {
+    var refetch;
+    const memo = solidJs.createMemo(f);
+    solidJs.createEffect(solidJs.on(memo, () => refetch?.()));
+    const [get] = [, {
+      refetch
+    }] = solidJs.createResource(memo);
+    return get;
   }
   const IDENTITY = (x) => x;
   function bind([get], [, set], to = IDENTITY) {
@@ -182,8 +189,14 @@
     });
   }
   const Debug = createOption(false, true, "debug-scope");
+  function Doc(props) {
+    const node = document.createTextNode("");
+    solidJs.onMount(() => (refCall(props.ref, node.ownerDocument), node.remove()));
+    return node;
+  }
   exports2.Case = Case;
   exports2.Debug = Debug;
+  exports2.Doc = Doc;
   exports2.When = When;
   exports2.bind = bind;
   exports2.bindTwoWay = bindTwoWay;
@@ -192,6 +205,7 @@
   exports2.createOption = createOption;
   exports2.createReactiveResource = createReactiveResource;
   exports2.memoProps = memoProps;
+  exports2.refCall = refCall;
   exports2.runWithContext = runWithContext;
   exports2.splitAndMemoProps = splitAndMemoProps;
   exports2.toSetter = toSetter;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solid-ctrl-flow",
-  "version": "1.0.27",
+  "version": "1.0.29",
   "description": "Control flow components for solid-js",
   "author": "AFatNiBBa",
   "license": "ISC",

package/readMe.md

@@ -47,6 +47,15 @@ return <>
 </>
 ```
 
+### `Doc`
+Gives back the current document
+```tsx
+var doc: Document;
+return <>
+  <Doc ref={doc} />
+</>
+```
+
 ### `createExtractor()`
 Creates a context for components that may need to be out of their parent in certain conditions.
 If you have this component
@@ -148,17 +157,20 @@ Utility functions needed for the components above
 ### `untrackCall()`
 Calls a function untracking what happens inside of it but not what gets passed as its argument
 
+### `refCall()`
+Executes a `Ref`
+
 ### `memoProps()`
 Creates a partial version of an object with memoized remaining properties
 
 ### `splitAndMemoProps()`
 Like `splitProps()` but memoizes the whole local part
 
-### `createReactiveResource()`
-Like `createResource()` but the provided function will be reactive
-
 ### `createOption()`
 Allows you to create simple reactive contexts; For example `Debug` is made with it
 
 ### `runWithContext()`
-Creates a context scope that persists for the duration of a function
+Creates a context scope that persists for the duration of a function
+
+### `createReactiveResource()`
+Like `createResource()` but the provided function will be reactive