solid-ctrl-flow 1.0.41 → 1.0.43

package/dist/index.d.ts

@@ -75,7 +75,7 @@ export declare const Case: (props: {
 
 /**
  * Returns a {@link Signal} that applies the `??=` operator to the input one.
- * If the getter of {@link param0} is like "x", then the result one is like "(x ??= {@link f}())"
+ * If the getter of {@link param0} is like `x`, then the result one is like "(x ??= {@link f}())"
  * @param param0 The {@link Signal} to which to coalesce the getter
  * @param f An {@link Accessor} to the value to use when there's a nullish value
  */
@@ -97,8 +97,8 @@ export declare type Convert<S, D> = (x: S, prev: D) => D;
  *      </div>
  *      <div id="something-else">
  *          <e.Source>
- *              This text will be shown instead of "e.Dest".
- *              If there weren't to be any "e.Joint" ancestor, then this text would have stayed here
+ *              This text will be shown instead of `e.Dest`.
+ *              If there weren't to be any `e.Joint` ancestor, then this text would have stayed here
  *          </e.Source>
  *      </div>
  *  </e.Joint>
@@ -149,7 +149,7 @@ export declare function Enfold<T>(props: Unkeyed<T>): JSX.Element;
 declare type Equals = MemoOptions<unknown>["equals"];
 
 /** Informations about a {@link Source} component */
-declare type Info = {
+declare type Info = Slot & {
     /** Order of the current source if there are many */
     order?: number;
     children: JSX.Element;
@@ -245,6 +245,36 @@ export declare function runWithContext<T, V extends T, R>(ctx: Context<T>, value
 
 export declare function runWithContext<T, R>(ctx: Context<T>, value: T | undefined, f: (x: T) => R): R;
 
+/** Element which tracks its index in its containing array */
+export declare interface Slot {
+    slot?: number;
+}
+
+/** Utility of {@link Slot}s */
+export declare namespace Slot {
+    /**
+     * Pushes an element into a slotted list
+     * @param list The list in which to add the element
+     * @param v The element to add to {@link list}
+     * @returns The index of the new element
+     */
+    const push: <T extends Slot>(list: T[], v: T) => number;
+    /**
+     * Exactly like {@link removeSlotAt}, but it gets the index from {@link v}
+     * @param list The list from which to remove the element
+     * @param v The element to remove from {@link list}
+     * @returns The removed element
+     */
+    const remove: <T extends Slot>(list: T[], v: T) => T | undefined;
+    /**
+     * Removes an element from a slotted list
+     * @param list The list from which to remove the element
+     * @param i The index at which to remove the element
+     * @returns The removed element
+     */
+    export function removeAt<T extends Slot>(list: T[], i: number): T | undefined;
+}
+
 /**
  * Executes {@link splitProps} and memoizes the first of the two returned objects using {@link memoProps}
  * @param obj Object to split and partially memoize
@@ -305,11 +335,11 @@ export declare const unwrap: <T extends object>(f: Accessor<T>) => T;
  * Calls {@link f} maintaining its reactivity at 2 levels.
  * Unlike the normal {@link unwrap}, this maintains reactivity on the elements of the array too, which means that it can be destructured
  * ```ts
- * const first = unwrap(f);         // The value of "first" is reactive but CANNOT be destructured
- * const [ getFirst ] = first;      // The value of "getFirst" is NOT reactive, it's the first element of the CURRENT signal returned by "f"
+ * const first = unwrap(f);         // The value of `first` is reactive but CANNOT be destructured
+ * const [ getFirst ] = first;      // The value of `getFirst()` is NOT reactive, it's the first element of the CURRENT signal returned by `f()`
  *
- * const second = unwrapSignal(f);  // The value of "second" is reactive and CAN be destructured
- * const [ getSecond ] = second;    // The value of "getSecond" IS reactive, it's a function that calls "f", gets the first element and calls that too
+ * const second = unwrapSignal(f);  // The value of `second` is reactive and CAN be destructured
+ * const [ getSecond ] = second;    // The value of `getSecond()` IS reactive, it's a function that calls `f()`, gets the first element and calls that too
  * ```
  * @param f An {@link Accessor} to a {@link Signal}
  */

package/dist/index.mjs

@@ -123,6 +123,23 @@ function Enfold(props) {
     children: (x) => createMemo(() => untrackCall(props.template, children, x))
   });
 }
+var Slot;
+((Slot2) => {
+  Slot2.push = (list, v) => v.slot = list.push(v) - 1;
+  Slot2.remove = (list, v) => v.slot != null ? removeAt(list, v.slot) : v;
+  function removeAt(list, i) {
+    if (i >= list.length)
+      return;
+    const last = list.pop();
+    if (i === list.length)
+      return last;
+    const out = list[i];
+    out.slot = void 0;
+    list[last.slot = i] = last;
+    return out;
+  }
+  Slot2.removeAt = removeAt;
+})(Slot || (Slot = {}));
 function createExtractor(name = "extractor") {
   const ctx2 = createContext(void 0, {
     name
@@ -152,7 +169,7 @@ function Dest() {
   onCleanup(() => obj.attached--);
   return createComponent(For, {
     get each() {
-      return obj.source.sort((a, b) => a.order - b.order);
+      return obj.source.toSorted((a, b) => a.order - b.order);
     },
     children: (x) => createMemo(() => x.children)
   });
@@ -170,8 +187,8 @@ function Source(props) {
       return props.children;
     }
   };
-  obj.source.push(info);
-  onCleanup(() => obj.source.splice(obj.source.indexOf(createMutable(info)), 1));
+  Slot.push(obj.source, info);
+  onCleanup(() => Slot.remove(obj.source, info));
   return createComponent(Show, {
     get when() {
       return !obj.attached;
@@ -241,6 +258,7 @@ export {
   Enfold,
   Nest,
   ReactiveContext,
+  Slot,
   When,
   bind,
   bindTwoWay,

package/dist/index.umd.js

@@ -125,6 +125,23 @@
       children: (x) => solidJs.createMemo(() => untrackCall(props.template, children, x))
     });
   }
+  exports2.Slot = void 0;
+  ((Slot2) => {
+    Slot2.push = (list, v) => v.slot = list.push(v) - 1;
+    Slot2.remove = (list, v) => v.slot != null ? removeAt(list, v.slot) : v;
+    function removeAt(list, i) {
+      if (i >= list.length)
+        return;
+      const last = list.pop();
+      if (i === list.length)
+        return last;
+      const out = list[i];
+      out.slot = void 0;
+      list[last.slot = i] = last;
+      return out;
+    }
+    Slot2.removeAt = removeAt;
+  })(exports2.Slot || (exports2.Slot = {}));
   function createExtractor(name = "extractor") {
     const ctx2 = solidJs.createContext(void 0, {
       name
@@ -154,7 +171,7 @@
     solidJs.onCleanup(() => obj.attached--);
     return solidJs.createComponent(solidJs.For, {
       get each() {
-        return obj.source.sort((a, b) => a.order - b.order);
+        return obj.source.toSorted((a, b) => a.order - b.order);
       },
       children: (x) => solidJs.createMemo(() => x.children)
     });
@@ -172,8 +189,8 @@
         return props.children;
       }
     };
-    obj.source.push(info);
-    solidJs.onCleanup(() => obj.source.splice(obj.source.indexOf(store.createMutable(info)), 1));
+    exports2.Slot.push(obj.source, info);
+    solidJs.onCleanup(() => exports2.Slot.remove(obj.source, info));
     return solidJs.createComponent(solidJs.Show, {
       get when() {
         return !obj.attached;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solid-ctrl-flow",
-  "version": "1.0.41",
+  "version": "1.0.43",
   "description": "Control flow components for solid-js",
   "author": "AFatNiBBa",
   "license": "ISC",
@@ -34,6 +34,6 @@
     "switch",
     "case",
     "when",
-    "debug"
+    "slot"
   ]
 }