@fluixi/core 1.0.0-alpha.83 → 1.0.0-alpha.84

package/dist/src/lib/render/component.cjs

@@ -1 +1,221 @@
-"use strict";var f=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var T=(e,t)=>{for(var o in t)f(e,o,{get:t[o],enumerable:!0})},E=(e,t,o,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let c of x(t))!C.call(e,c)&&c!==o&&f(e,c,{get:()=>t[c],enumerable:!(r=y(t,c))||r.enumerable});return e};var O=e=>E(f({},"__esModule",{value:!0}),e);var V={};T(V,{$component:()=>R,DEV:()=>p,batch:()=>n.batch,createComponent:()=>L,createEffect:()=>n.createEffect,createMemo:()=>n.createMemo,devOnly:()=>K,ensureIntegration:()=>g,getContextOwner:()=>b,getOwner:()=>n.getOwner,getSharedConfig:()=>w,hasLifecycleContext:()=>_,isDev:()=>W,onCleanup:()=>n.onCleanup,onMount:()=>S,onUnmount:()=>U,runWithOwner:()=>n.runWithOwner,setOwner:()=>h,useCallback:()=>D,useEffect:()=>v,useEventListener:()=>k,useMemo:()=>A,useReducer:()=>j,useRef:()=>M});module.exports=O(V);var a=require("@fluixi/dom"),u=require("@fluixi/dom"),n=require("@fluixi/reactive/signal"),i={context:null,owner:null};function w(){return i}function h(e){i.owner=e,i.context=e}function b(){return i.context||i.owner}var p=typeof process<"u"&&!1,s=Symbol.for("fluixi-lifecycle");function d(){let e=(0,n.getOwner)();if(!e)return null;if(!e[s]){let t={mounts:[],effects:[],scheduled:!1};e[s]=t}return e[s]}function l(e){if(e.scheduled)return;if((0,a.isServer)()){e.mounts=[],e.effects=[];return}e.scheduled=!0;let t=(0,n.getOwner)();queueMicrotask(()=>{if((0,n.isOwnerDisposed)(t)){e.mounts=[],e.effects=[];return}(0,n.runWithOwner)(t,()=>{for(let o of e.mounts)try{let r=o();typeof r=="function"&&(0,n.onCleanup)(r)}catch(r){console.error("Error in onMount callback:",r)}for(let o of e.effects){let r;(0,n.createEffect)(()=>{r&&r(),r=o()}),(0,n.onCleanup)(()=>{r&&r()})}e.mounts=[],e.effects=[]})})}function g(e){}function L(e,t){return(0,u.createComponent)(e,t)}function R(e,t){let o=typeof e=="function"?(0,n.untrack)(()=>e(t)):e,r=o!=null&&(typeof o=="function"||typeof o=="object");if(r)try{o.$name=e.name}catch{}return r&&!(0,n.isSignal)(o)?(0,u.asComponent)(o):o}function S(e,t=!0){if((0,a.isServer)())return;let o=d();if(o){if(!t){o.scheduled||e();return}o.mounts.push(e),l(o)}else{if(!t){e();return}(0,n.createEffect)(()=>{let r=(0,n.untrack)(e);typeof r=="function"&&(0,n.onCleanup)(r)})}}function U(e){(0,n.onCleanup)(e)}function v(e){let t=d();if(t)t.effects.push(e),l(t);else{let o;(0,n.createEffect)(()=>{o&&o(),o=e()}),(0,n.onCleanup)(()=>{o&&o()})}}function A(e){return(0,n.createMemo)(e)}function M(e){let t={current:e};return(0,n.onCleanup)(()=>{t.current=null}),t}function j(e,t){let[o,r]=(0,n.createSignal)(t);return[o,m=>{r(e(o(),m))}]}function k(e,t,o,r){v(()=>{let c=e&&"current"in e?e.current:e;if(c)return c.addEventListener(t,o,r),()=>{c.removeEventListener(t,o,r)}})}function D(e){return e}function _(){return(0,n.getOwner)()!==null}function W(){return p}function K(e){p&&e()}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/render/component.ts
+var component_exports = {};
+__export(component_exports, {
+  $component: () => $component,
+  DEV: () => DEV,
+  batch: () => import_signal.batch,
+  createComponent: () => createComponent,
+  createEffect: () => import_signal.createEffect,
+  createMemo: () => import_signal.createMemo,
+  devOnly: () => devOnly,
+  ensureIntegration: () => ensureIntegration,
+  getContextOwner: () => getContextOwner,
+  getOwner: () => import_signal.getOwner,
+  getSharedConfig: () => getSharedConfig,
+  hasLifecycleContext: () => hasLifecycleContext,
+  isDev: () => isDev,
+  onCleanup: () => import_signal.onCleanup,
+  onMount: () => onMount,
+  onUnmount: () => onUnmount,
+  runWithOwner: () => import_signal.runWithOwner,
+  setOwner: () => setOwner,
+  useCallback: () => useCallback,
+  useEffect: () => useEffect,
+  useEventListener: () => useEventListener,
+  useMemo: () => useMemo,
+  useReducer: () => useReducer,
+  useRef: () => useRef
+});
+module.exports = __toCommonJS(component_exports);
+var import_dom = require("@fluixi/dom");
+var import_dom2 = require("@fluixi/dom");
+var import_signal = require("@fluixi/reactive/signal");
+var sharedConfig = {
+  context: null,
+  owner: null
+};
+function getSharedConfig() {
+  return sharedConfig;
+}
+function setOwner(owner) {
+  sharedConfig.owner = owner;
+  sharedConfig.context = owner;
+}
+function getContextOwner() {
+  return sharedConfig.context || sharedConfig.owner;
+}
+var DEV = typeof process !== "undefined" && false;
+var _LIFECYCLE = /* @__PURE__ */ Symbol.for("fluixi-lifecycle");
+function getOwnerLifecycle() {
+  const owner = (0, import_signal.getOwner)();
+  if (!owner) return null;
+  if (!owner[_LIFECYCLE]) {
+    const lc = { mounts: [], effects: [], scheduled: false };
+    owner[_LIFECYCLE] = lc;
+  }
+  return owner[_LIFECYCLE];
+}
+function scheduleLifecycleFlush(lc) {
+  if (lc.scheduled) return;
+  if ((0, import_dom.isServer)()) {
+    lc.mounts = [];
+    lc.effects = [];
+    return;
+  }
+  lc.scheduled = true;
+  const owner = (0, import_signal.getOwner)();
+  queueMicrotask(() => {
+    if ((0, import_signal.isOwnerDisposed)(owner)) {
+      lc.mounts = [];
+      lc.effects = [];
+      return;
+    }
+    (0, import_signal.runWithOwner)(owner, () => {
+      for (const cb of lc.mounts) {
+        try {
+          const cleanup = cb();
+          if (typeof cleanup === "function") {
+            (0, import_signal.onCleanup)(cleanup);
+          }
+        } catch (e) {
+          console.error("Error in onMount callback:", e);
+        }
+      }
+      for (const cb of lc.effects) {
+        let cleanup;
+        (0, import_signal.createEffect)(() => {
+          if (cleanup) cleanup();
+          cleanup = cb();
+        });
+        (0, import_signal.onCleanup)(() => {
+          if (cleanup) cleanup();
+        });
+      }
+      lc.mounts = [];
+      lc.effects = [];
+    });
+  });
+}
+function ensureIntegration(_from) {
+}
+function createComponent(Comp, props) {
+  return (0, import_dom2.createComponent)(Comp, props);
+}
+function $component(value, props) {
+  const component = typeof value === "function" ? (0, import_signal.untrack)(() => value(props)) : value;
+  const nameable = component != null && (typeof component === "function" || typeof component === "object");
+  if (nameable) {
+    try {
+      component["$name"] = value.name;
+    } catch {
+    }
+  }
+  if (nameable && !(0, import_signal.isSignal)(component)) {
+    return (0, import_dom2.asComponent)(component);
+  }
+  return component;
+}
+function onMount(fn, reactive = true) {
+  if ((0, import_dom.isServer)()) return;
+  const lc = getOwnerLifecycle();
+  if (lc) {
+    if (!reactive) {
+      if (!lc.scheduled) {
+        fn();
+      }
+      return;
+    }
+    lc.mounts.push(fn);
+    scheduleLifecycleFlush(lc);
+  } else {
+    if (!reactive) {
+      fn();
+      return;
+    }
+    (0, import_signal.createEffect)(() => {
+      const cleanup = (0, import_signal.untrack)(fn);
+      if (typeof cleanup === "function") {
+        (0, import_signal.onCleanup)(cleanup);
+      }
+    });
+  }
+}
+function onUnmount(fn) {
+  (0, import_signal.onCleanup)(fn);
+}
+function useEffect(callback) {
+  const lc = getOwnerLifecycle();
+  if (lc) {
+    lc.effects.push(callback);
+    scheduleLifecycleFlush(lc);
+  } else {
+    let cleanup;
+    (0, import_signal.createEffect)(() => {
+      if (cleanup) cleanup();
+      cleanup = callback();
+    });
+    (0, import_signal.onCleanup)(() => {
+      if (cleanup) cleanup();
+    });
+  }
+}
+function useMemo(fn) {
+  return (0, import_signal.createMemo)(fn);
+}
+function useRef(initialValue) {
+  const ref = { current: initialValue };
+  (0, import_signal.onCleanup)(() => {
+    ref.current = null;
+  });
+  return ref;
+}
+function useReducer(reducer, initialState) {
+  const [state, setState] = (0, import_signal.createSignal)(initialState);
+  const dispatch = (action) => {
+    setState(reducer(state(), action));
+  };
+  return [state, dispatch];
+}
+function useEventListener(target, event, handler, options) {
+  useEffect(() => {
+    const element = target && "current" in target ? target.current : target;
+    if (!element) return;
+    element.addEventListener(event, handler, options);
+    return () => {
+      element.removeEventListener(event, handler, options);
+    };
+  });
+}
+function useCallback(callback) {
+  return callback;
+}
+function hasLifecycleContext() {
+  return (0, import_signal.getOwner)() !== null;
+}
+function isDev() {
+  return DEV;
+}
+function devOnly(fn) {
+  if (DEV) {
+    fn();
+  }
+}

package/dist/src/lib/render/component.d.ts

@@ -1,5 +1,5 @@
 /**
- * Component creation for Fluixi. Component-creation logic only — context lives in
+ * Component creation for Fluixi. Component-creation logic only: context lives in
  * the reactive system, rendering in render/index.ts, and SSR in server/.
  */
 import { CreateComponentReturnType } from '@fluixi/dom';
@@ -43,7 +43,7 @@ export interface RefObject<T> {
  * The runtime creates components itself now, so nothing has to be registered for
  * it to work and this does nothing. It stays because callers exist, and because
  * `registerCreateComponent` is still the way to install a different component
- * model — pass your own implementation there and the runtime uses it instead.
+ * model: pass your own implementation there and the runtime uses it instead.
  *
  * Do not register a function that calls the runtime's own `createComponent`: it
  * consults the slot first, so that recurses.
@@ -54,11 +54,6 @@ export declare function ensureIntegration(_from?: string): void;
  * captures its output, keeps children lazy, propagates context (via sharedConfig), and
  * attaches cleanup. Components execute once and never re-execute.
  *
- * @template P - Props type
- * @param {Component<P>} Comp - Component function
- * @param {P} props - Component props
- * @returns {any} Component output
- *
  * @example
  * ```typescript
  * const MyComponent = (props: { name: string }) => {
@@ -77,8 +72,6 @@ export declare function $component<T extends (props?: any) => any, U = any>(valu
  * The effect runs once after the reactive graph is established,
  * tied to the current Owner for automatic cleanup.
  *
- * @param {LifecycleCallback} fn - Mount callback
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -98,8 +91,6 @@ export declare function onMount(fn: LifecycleCallback, reactive?: boolean): void
  * SolidJS-aligned: directly delegates to onCleanup which registers
  * with the current reactive Owner for automatic disposal.
  *
- * @param {() => void} fn - Unmount callback
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -115,9 +106,7 @@ export declare function onUnmount(fn: () => void): void;
 /**
  * Register a cleanup function
  *
- * Section 1: Component constructs reactive graph including cleanup
- *
- * @param {() => void} fn - Cleanup function
+ * Component constructs reactive graph including cleanup
  *
  * @example
  * ```typescript
@@ -137,8 +126,6 @@ export { onCleanup };
  * Effects run when their dependencies change
  * On server, effects run once
  *
- * @param {(v?: any) => any} fn - Effect function
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -156,10 +143,6 @@ export declare function useEffect(callback: () => void | (() => void)): void;
 /**
  * Create a memoized computed value
  *
- * @template T
- * @param {() => T} fn - Computation function
- * @returns {() => T} Memoized accessor
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -177,10 +160,6 @@ export declare function useMemo<T>(fn: () => T): () => T;
  * Refs persist across component re-renders (though components only run once)
  * Useful for storing DOM references and mutable values
  *
- * @template T
- * @param {T} initialValue - Initial value
- * @returns {RefObject<T>} Ref object
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -198,12 +177,6 @@ export declare function useRef<T>(initialValue: T): RefObject<T>;
 /**
  * Create a reducer for state management
  *
- * @template S - State type
- * @template A - Action type
- * @param {(state: S, action: A) => S} reducer - Reducer function
- * @param {S} initialState - Initial state
- * @returns {[() => S, (action: A) => void]} State accessor and dispatch function
- *
  * @example
  * ```typescript
  * type Action = { type: 'increment' } | { type: 'decrement' };
@@ -231,12 +204,6 @@ export declare function useReducer<S, A>(reducer: (state: S, action: A) => S, in
 /**
  * Attach an event listener with automatic cleanup
  *
- * @template K - Event type key
- * @param {EventTarget | RefObject<EventTarget | null>} target - Event target or ref
- * @param {K} event - Event name
- * @param {(event: Event) => void} handler - Event handler
- * @param {AddEventListenerOptions} options - Event listener options
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -261,10 +228,6 @@ export declare function useEventListener<K extends keyof WindowEventMap>(target:
  * In Fluixi, components only run once, so this is mostly for
  * API compatibility and explicit intent
  *
- * @template T
- * @param {T} callback - Callback function
- * @returns {T} Callback function
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -310,8 +273,6 @@ export declare function hasLifecycleContext(): boolean;
 /**
  * Check if in development mode
  *
- * @returns {boolean} True if in development mode
- *
  * @example
  * ```typescript
  * if (isDev()) {
@@ -323,8 +284,6 @@ export declare function isDev(): boolean;
 /**
  * Development-only code execution
  *
- * @param {() => void} fn - Function to run in dev mode
- *
  * @example
  * ```typescript
  * devOnly(() => {

package/dist/src/lib/render/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../../src/lib/render/component.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../../src/lib/render/component.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/render/component.js

@@ -1,5 +1,5 @@
 /**
- * Component creation for Fluixi. Component-creation logic only — context lives in
+ * Component creation for Fluixi. Component-creation logic only: context lives in
  * the reactive system, rendering in render/index.ts, and SSR in server/.
  */
 import { isServer } from '@fluixi/dom';
@@ -48,7 +48,7 @@ export const DEV = typeof process !== 'undefined' && process.env?.NODE_ENV === '
 //   1. All onMount callbacks run first
 //   2. Then all useEffect callbacks are created as reactive effects
 // This works regardless of whether the component goes through $component,
-// the JSX runtime, or is called directly — as long as there's an Owner.
+// the JSX runtime, or is called directly, as long as there's an Owner.
 const _LIFECYCLE = Symbol.for('fluixi-lifecycle');
 /**
  * Get or create a lifecycle bucket on the current Owner.
@@ -66,7 +66,7 @@ function getOwnerLifecycle() {
 }
 /**
  * Schedule a microtask to flush the lifecycle for the current Owner.
- * Only schedules once per Owner — subsequent calls are no-ops.
+ * Only schedules once per Owner: subsequent calls are no-ops.
  */
 function scheduleLifecycleFlush(lc) {
     if (lc.scheduled)
@@ -84,7 +84,7 @@ function scheduleLifecycleFlush(lc) {
     queueMicrotask(() => {
         // The scope may have been torn down before this microtask ran (e.g. a <Portal>
         // inside a <Show> that closed synchronously). Running mount/effect callbacks on a
-        // dead owner would re-attach listeners/effects whose cleanup never fires — a leak.
+        // dead owner would re-attach listeners/effects whose cleanup never fires, a leak.
         // Match Solid: an unmounted component's onMount simply does not run.
         if (isOwnerDisposed(owner)) {
             lc.mounts = [];
@@ -127,7 +127,7 @@ function scheduleLifecycleFlush(lc) {
  * The runtime creates components itself now, so nothing has to be registered for
  * it to work and this does nothing. It stays because callers exist, and because
  * `registerCreateComponent` is still the way to install a different component
- * model — pass your own implementation there and the runtime uses it instead.
+ * model: pass your own implementation there and the runtime uses it instead.
  *
  * Do not register a function that calls the runtime's own `createComponent`: it
  * consults the slot first, so that recurses.
@@ -138,11 +138,6 @@ export function ensureIntegration(_from) { }
  * captures its output, keeps children lazy, propagates context (via sharedConfig), and
  * attaches cleanup. Components execute once and never re-execute.
  *
- * @template P - Props type
- * @param {Component<P>} Comp - Component function
- * @param {P} props - Component props
- * @returns {any} Component output
- *
  * @example
  * ```typescript
  * const MyComponent = (props: { name: string }) => {
@@ -152,17 +147,6 @@ export function ensureIntegration(_from) { }
  * const result = createComponent(MyComponent, { name: 'World' });
  * ```
  */
-// export function $component<T, U = any>(value: T, props?: U) {
-//   const component = () => (typeof value === 'function' && props) ?(value as any)(props) : value;
-//   Object.defineProperty(component, '__fluixi', {
-//     enumerable: true,
-//     configurable: true,
-//     value: true,
-//   });
-//    // (component as any).$COMPONENT = true;
-//   return asComponent(component) as C<T, U>;
-// }
-//
 export function createComponent(Comp, props) {
     return domCreateComponent(Comp, props);
 }
@@ -180,7 +164,7 @@ export function $component(value, props) {
     const component = (typeof value === 'function')
         ? untrack(() => value(props))
         : value;
-    // Only stamp $name and $COMPONENT on functions/objects — primitives (strings, numbers)
+    // Only stamp $name and $COMPONENT on functions/objects: primitives (strings, numbers)
     // cannot have properties added in strict mode and would throw TypeError.
     // Also skip stamping reactive values (signals/memos) with $COMPONENT so the DOM
     // runtime doesn't misidentify them as static component thunks and cache them.
@@ -210,8 +194,6 @@ export function $component(value, props) {
  * The effect runs once after the reactive graph is established,
  * tied to the current Owner for automatic cleanup.
  *
- * @param {LifecycleCallback} fn - Mount callback
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -235,7 +217,7 @@ export function onMount(fn, reactive = true) {
             }
             return;
         }
-        // Attach to Owner — will run BEFORE useEffect callbacks in the flush.
+        // Attach to Owner: will run before useEffect callbacks in the flush.
         lc.mounts.push(fn);
         scheduleLifecycleFlush(lc);
     }
@@ -259,8 +241,6 @@ export function onMount(fn, reactive = true) {
  * SolidJS-aligned: directly delegates to onCleanup which registers
  * with the current reactive Owner for automatic disposal.
  *
- * @param {() => void} fn - Unmount callback
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -278,9 +258,7 @@ export function onUnmount(fn) {
 /**
  * Register a cleanup function
  *
- * Section 1: Component constructs reactive graph including cleanup
- *
- * @param {() => void} fn - Cleanup function
+ * Component constructs reactive graph including cleanup
  *
  * @example
  * ```typescript
@@ -303,8 +281,6 @@ export { onCleanup };
  * Effects run when their dependencies change
  * On server, effects run once
  *
- * @param {(v?: any) => any} fn - Effect function
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -321,7 +297,7 @@ export { onCleanup };
 export function useEffect(callback) {
     const lc = getOwnerLifecycle();
     if (lc) {
-        // Attach to the Owner — created as an effect after all onMount callbacks.
+        // Attach to the Owner: created as an effect after all onMount callbacks.
         lc.effects.push(callback);
         scheduleLifecycleFlush(lc);
     }
@@ -342,10 +318,6 @@ export function useEffect(callback) {
 /**
  * Create a memoized computed value
  *
- * @template T
- * @param {() => T} fn - Computation function
- * @returns {() => T} Memoized accessor
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -367,10 +339,6 @@ export function useMemo(fn) {
  * Refs persist across component re-renders (though components only run once)
  * Useful for storing DOM references and mutable values
  *
- * @template T
- * @param {T} initialValue - Initial value
- * @returns {RefObject<T>} Ref object
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -395,12 +363,6 @@ export function useRef(initialValue) {
 /**
  * Create a reducer for state management
  *
- * @template S - State type
- * @template A - Action type
- * @param {(state: S, action: A) => S} reducer - Reducer function
- * @param {S} initialState - Initial state
- * @returns {[() => S, (action: A) => void]} State accessor and dispatch function
- *
  * @example
  * ```typescript
  * type Action = { type: 'increment' } | { type: 'decrement' };
@@ -431,6 +393,20 @@ export function useReducer(reducer, initialState) {
     };
     return [state, dispatch];
 }
+/**
+ * Attach a listener for as long as the current owner lives.
+ *
+ * Runs through `useEffect`, so the removal it returns is called on disposal and before
+ * any re-run. Nothing has to be undone by hand. `target` may be a ref, read when the
+ * listener is attached rather than when this is called, so it works for an element the
+ * template has not created yet.
+ *
+ * @example
+ * ```ts
+ * useEventListener(window, 'resize', () => setWidth(window.innerWidth));
+ * useEventListener(dialogRef, 'keydown', onKey, { capture: true });
+ * ```
+ */
 export function useEventListener(target, event, handler, options) {
     useEffect(() => {
         // Resolve target from ref or direct value
@@ -453,10 +429,6 @@ export function useEventListener(target, event, handler, options) {
  * In Fluixi, components only run once, so this is mostly for
  * API compatibility and explicit intent
  *
- * @template T
- * @param {T} callback - Callback function
- * @returns {T} Callback function
- *
  * @example
  * ```typescript
  * const MyComponent = () => {
@@ -514,8 +486,6 @@ export function hasLifecycleContext() {
 /**
  * Check if in development mode
  *
- * @returns {boolean} True if in development mode
- *
  * @example
  * ```typescript
  * if (isDev()) {
@@ -530,8 +500,6 @@ export function isDev() {
 /**
  * Development-only code execution
  *
- * @param {() => void} fn - Function to run in dev mode
- *
  * @example
  * ```typescript
  * devOnly(() => {