ripple 0.2.46 → 0.2.48

package/src/runtime/index.js

@@ -1,9 +1,9 @@
-/** @import { Block } from '#client' */
+/** @import { Block, Derived, Tracked } from '#client' */
 
 import { destroy_block, root } from './internal/client/blocks.js';
 import { handle_root_events } from './internal/client/events.js';
 import { init_operations } from './internal/client/operations.js';
-import { active_block } from './internal/client/runtime.js';
+import { active_block, tracked, derived } from './internal/client/runtime.js';
 import { create_anchor } from './internal/client/utils.js';
 
 // Re-export JSX runtime functions for jsxImportSource: "ripple"
@@ -15,28 +15,40 @@ export { jsx, jsxs, Fragment } from '../jsx-runtime.js';
  * @returns {() => void}
  */
 export function mount(component, options) {
-	init_operations();
+  init_operations();
 
-	const props = options.props || {};
-	const target = options.target;
-	const anchor = create_anchor();
-	target.append(anchor);
+  const props = options.props || {};
+  const target = options.target;
+  const anchor = create_anchor();
+  target.append(anchor);
 
-	const cleanup_events = handle_root_events(target);
+  const cleanup_events = handle_root_events(target);
 
-	const _root = root(() => {
-		component(anchor, props, active_block);
-	});
+  const _root = root(() => {
+    component(anchor, props, active_block);
+  });
 
-	return () => {
-		cleanup_events();
-		destroy_block(_root);
-	};
+  return () => {
+    cleanup_events();
+    destroy_block(_root);
+  };
 }
 
 export { create_context as createContext } from './internal/client/context.js';
 
-export { flush_sync as flushSync, untrack, deferred, tracked } from './internal/client/runtime.js';
+export { flush_sync as flushSync, untrack, deferred } from './internal/client/runtime.js';
+
+/**
+ * @param {any} v
+ * @param {Block} b
+ * @returns {Tracked | Derived}
+ */
+export function track(v, b) {
+  if (typeof v === 'function') {
+    return derived(v, b);
+  }
+  return tracked(v, b);
+}
 
 export { RippleArray } from './array.js';
 
@@ -50,4 +62,4 @@ export { user_effect as effect } from './internal/client/blocks.js';
 
 export { Portal } from './internal/client/portal.js';
 
-export { ref_prop as createRefKey } from './internal/client/runtime.js';
+export { ref_prop as createRefKey } from './internal/client/runtime.js';

package/src/runtime/internal/client/array.js

@@ -11,20 +11,20 @@ const array_proto = Array.prototype;
  * @returns {T}
  */
 export function array_reduce(array, callback, initial_value) {
-	// @ts-expect-error
-	var tracked_properties = array[TRACKED_OBJECT];
+  // @ts-expect-error
+  var tracked_properties = array[TRACKED_OBJECT];
 
-	if (tracked_properties === undefined || array.reduce !== array_proto.reduce) {
-		return array.reduce(callback, initial_value);
-	}
+  if (tracked_properties === undefined || array.reduce !== array_proto.reduce) {
+    return array.reduce(callback, initial_value);
+  }
 
-	let accumulator = initial_value;
+  let accumulator = initial_value;
 
-	for (let i = 0; i < array.length; i++) {
-		accumulator = callback(accumulator, old_get_property(array, i), i, array);
-	}
+  for (let i = 0; i < array.length; i++) {
+    accumulator = callback(accumulator, old_get_property(array, i), i, array);
+  }
 
-	return accumulator;
+  return accumulator;
 }
 
 /**
@@ -34,21 +34,21 @@ export function array_reduce(array, callback, initial_value) {
  * @returns {string}
  */
 export function array_join(array, separator) {
-	// @ts-expect-error
-	var tracked_properties = array[TRACKED_OBJECT];
-	if (tracked_properties === undefined || array.join !== array_proto.join) {
-		return array.join(separator);
-	}
-
-	let result = '';
-	for (let i = 0; i < array.length; i++) {
-		if (i > 0 && separator !== undefined) {
-			result += separator;
-		}
-		result += String(old_get_property(array, i));
-	}
-
-	return result;
+  // @ts-expect-error
+  var tracked_properties = array[TRACKED_OBJECT];
+  if (tracked_properties === undefined || array.join !== array_proto.join) {
+    return array.join(separator);
+  }
+
+  let result = '';
+  for (let i = 0; i < array.length; i++) {
+    if (i > 0 && separator !== undefined) {
+      result += separator;
+    }
+    result += String(old_get_property(array, i));
+  }
+
+  return result;
 }
 
 /**
@@ -59,20 +59,20 @@ export function array_join(array, separator) {
  * @returns {Array<U>}
  */
 export function array_map(array, callback) {
-	// @ts-expect-error
-	var tracked_properties = array[TRACKED_OBJECT];
-	if (tracked_properties === undefined || array.map !== array_proto.map) {
-		return array.map(callback);
-	}
-
-	const result = [];
-	for (let i = 0; i < array.length; i++) {
-		if (i in array) {
-			result[i] = callback(old_get_property(array, i), i, array);
-		}
-	}
-
-	return result;
+  // @ts-expect-error
+  var tracked_properties = array[TRACKED_OBJECT];
+  if (tracked_properties === undefined || array.map !== array_proto.map) {
+    return array.map(callback);
+  }
+
+  const result = [];
+  for (let i = 0; i < array.length; i++) {
+    if (i in array) {
+      result[i] = callback(old_get_property(array, i), i, array);
+    }
+  }
+
+  return result;
 }
 
 /**
@@ -82,23 +82,23 @@ export function array_map(array, callback) {
  * @returns {Array<T>}
  */
 export function array_filter(array, callback) {
-	// @ts-expect-error
-	var tracked_properties = array[TRACKED_OBJECT];
-	if (tracked_properties === undefined || array.filter !== array_proto.filter) {
-		return array.filter(callback);
-	}
-
-	const result = [];
-	for (let i = 0; i < array.length; i++) {
-		if (i in array) {
-			const value = old_get_property(array, i);
-			if (callback(value, i, array)) {
-				result.push(value);
-			}
-		}
-	}
-
-	return result;
+  // @ts-expect-error
+  var tracked_properties = array[TRACKED_OBJECT];
+  if (tracked_properties === undefined || array.filter !== array_proto.filter) {
+    return array.filter(callback);
+  }
+
+  const result = [];
+  for (let i = 0; i < array.length; i++) {
+    if (i in array) {
+      const value = old_get_property(array, i);
+      if (callback(value, i, array)) {
+        result.push(value);
+      }
+    }
+  }
+
+  return result;
 }
 
 /**
@@ -108,17 +108,17 @@ export function array_filter(array, callback) {
  * @returns {void}
  */
 export function array_forEach(array, callback) {
-	// @ts-expect-error
-	var tracked_properties = array[TRACKED_OBJECT];
-	if (tracked_properties === undefined || array.forEach !== array_proto.forEach) {
-		return array.forEach(callback);
-	}
-
-	for (let i = 0; i < array.length; i++) {
-		if (i in array) {
-			callback(old_get_property(array, i), i, array);
-		}
-	}
+  // @ts-expect-error
+  var tracked_properties = array[TRACKED_OBJECT];
+  if (tracked_properties === undefined || array.forEach !== array_proto.forEach) {
+    return array.forEach(callback);
+  }
+
+  for (let i = 0; i < array.length; i++) {
+    if (i in array) {
+      callback(old_get_property(array, i), i, array);
+    }
+  }
 }
 
 /**
@@ -128,19 +128,19 @@ export function array_forEach(array, callback) {
  * @returns {boolean}
  */
 export function array_includes(array, value) {
-	// @ts-expect-error
-	var tracked_properties = array[TRACKED_OBJECT];
-	if (tracked_properties === undefined || array.includes !== array_proto.includes) {
-		return array.includes(value);
-	}
-
-	for (let i = 0; i < array.length; i++) {
-		if (i in array && old_get_property(array, i) === value) {
-			return true;
-		}
-	}
-
-	return false;
+  // @ts-expect-error
+  var tracked_properties = array[TRACKED_OBJECT];
+  if (tracked_properties === undefined || array.includes !== array_proto.includes) {
+    return array.includes(value);
+  }
+
+  for (let i = 0; i < array.length; i++) {
+    if (i in array && old_get_property(array, i) === value) {
+      return true;
+    }
+  }
+
+  return false;
 }
 
 /**
@@ -150,19 +150,19 @@ export function array_includes(array, value) {
  * @returns {number}
  */
 export function array_indexOf(array, value) {
-	// @ts-expect-error
-	var tracked_properties = array[TRACKED_OBJECT];
-	if (tracked_properties === undefined || array.indexOf !== array_proto.indexOf) {
-		return array.indexOf(value);
-	}
-
-	for (let i = 0; i < array.length; i++) {
-		if (i in array && old_get_property(array, i) === value) {
-			return i;
-		}
-	}
-
-	return -1;
+  // @ts-expect-error
+  var tracked_properties = array[TRACKED_OBJECT];
+  if (tracked_properties === undefined || array.indexOf !== array_proto.indexOf) {
+    return array.indexOf(value);
+  }
+
+  for (let i = 0; i < array.length; i++) {
+    if (i in array && old_get_property(array, i) === value) {
+      return i;
+    }
+  }
+
+  return -1;
 }
 
 /**
@@ -172,19 +172,19 @@ export function array_indexOf(array, value) {
  * @returns {number}
  */
 export function array_lastIndexOf(array, value) {
-	// @ts-expect-error
-	var tracked_properties = array[TRACKED_OBJECT];
-	if (tracked_properties === undefined || array.lastIndexOf !== array_proto.lastIndexOf) {
-		return array.lastIndexOf(value);
-	}
-
-	for (let i = array.length - 1; i >= 0; i--) {
-		if (i in array && old_get_property(array, i) === value) {
-			return i;
-		}
-	}
-
-	return -1;
+  // @ts-expect-error
+  var tracked_properties = array[TRACKED_OBJECT];
+  if (tracked_properties === undefined || array.lastIndexOf !== array_proto.lastIndexOf) {
+    return array.lastIndexOf(value);
+  }
+
+  for (let i = array.length - 1; i >= 0; i--) {
+    if (i in array && old_get_property(array, i) === value) {
+      return i;
+    }
+  }
+
+  return -1;
 }
 
 /**
@@ -334,19 +334,19 @@ export function array_values(array) {
  * @returns {IterableIterator<[number, T]>}
  */
 export function array_entries(array) {
-	// @ts-expect-error
-	var tracked_properties = array[TRACKED_OBJECT];
-	if (tracked_properties === undefined || array.entries !== array_proto.entries) {
-		return array.entries();
-	}
-
-	/** @type {Array<[number, T]>} */
-	const result = [];
-	for (let i = 0; i < array.length; i++) {
-		if (i in array) {
-			result.push([i, old_get_property(array, i)]);
-		}
-	}
-
-	return result[Symbol.iterator]();
+  // @ts-expect-error
+  var tracked_properties = array[TRACKED_OBJECT];
+  if (tracked_properties === undefined || array.entries !== array_proto.entries) {
+    return array.entries();
+  }
+
+  /** @type {Array<[number, T]>} */
+  const result = [];
+  for (let i = 0; i < array.length; i++) {
+    if (i in array) {
+      result.push([i, old_get_property(array, i)]);
+    }
+  }
+
+  return result[Symbol.iterator]();
 }