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

package/dist/src/lib/server/reactive.d.ts

@@ -1,5 +1,4 @@
 /**
- * @fileoverview Server Reactive Primitives for Fluixi
  * @module @fluixi/core/server/reactive
  *
  * Maps reactive primitives for server-side execution
@@ -15,14 +14,9 @@ import type { SignalTuple, Accessor, Setter, SignalOptions, RootOwner, Context }
 /**
  * Server createSignal - Returns snapshot value
  *
- * Section 4: Signals read-only snapshot on server
+ * Signals read-only snapshot on server
  * No reactivity, no tracking, just initial value
  *
- * @template T
- * @param {T} value - Initial value
- * @param {SignalOptions<T>} options - SignalTuple options (ignored on server)
- * @returns {SignalTuple<T>} Tuple of [getter, setter]
- *
  * @example
  * ```typescript
  * // On server, this returns a static snapshot
@@ -36,14 +30,9 @@ export declare function createSignal<T>(value: T, options?: SignalOptions<T>): S
 /**
  * Server createEffect - Runs once, no tracking
  *
- * Section 4: Effects run once on server, no scheduling
+ * Effects run once on server, no scheduling
  * Execute immediately and return no-op disposer
  *
- * @param {(v?: any) => any} fn - Effect function
- * @param {any} value - Initial value (optional)
- * @param {any} options - Effect options (ignored on server)
- * @returns {{ dispose: () => void }} Disposer object
- *
  * @example
  * ```typescript
  * // On server, runs once immediately
@@ -58,15 +47,9 @@ export declare function createEffect(fn: (v?: any) => any, value?: any, options?
 /**
  * Server createMemo - Compute once, return static accessor
  *
- * Section 4: No tracking on server, single evaluation
+ * No tracking on server, single evaluation
  * Memoizes value at creation time
  *
- * @template T
- * @param {(v?: T) => T} fn - Computation function
- * @param {T} value - Initial value (optional)
- * @param {any} options - Memo options (ignored on server)
- * @returns {Accessor<T>} Static accessor
- *
  * @example
  * ```typescript
  * const [count] = createSignal(5);
@@ -78,13 +61,9 @@ export declare function createMemo<T>(fn: (v?: T) => T, value?: T, options?: any
 /**
  * Server createRoot - Creates owner but no reactive tracking
  *
- * Section 5: Owners exist on server for tree structure
+ * Owners exist on server for tree structure
  * Needed for context and cleanup, but no reactive tracking
  *
- * @template T
- * @param {(dispose: () => void) => T} fn - Root function
- * @returns {T} Function result
- *
  * @example
  * ```typescript
  * const result = createRoot((dispose) => {
@@ -97,13 +76,9 @@ export declare function createRoot<T>(fn: (dispose: () => void) => T): T;
 /**
  * Server batch - Execute immediately, no batching
  *
- * Section 4: No scheduling on server
+ * No scheduling on server
  * Just runs the function synchronously
  *
- * @template T
- * @param {() => T} fn - Function to batch
- * @returns {T} Function result
- *
  * @example
  * ```typescript
  * batch(() => {
@@ -116,13 +91,9 @@ export declare function batch<T>(fn: () => T): T;
 /**
  * Server untrack - Execute function (already untracked)
  *
- * Section 4: No tracking on server anyway
+ * No tracking on server anyway
  * This is a no-op but exists for API compatibility
  *
- * @template T
- * @param {() => T} fn - Function to run untracked
- * @returns {T} Function result
- *
  * @example
  * ```typescript
  * untrack(() => {
@@ -134,11 +105,9 @@ export declare function untrack<T>(fn: () => T): T;
 /**
  * Server onCleanup - Register cleanup function
  *
- * Section 5: Cleanup still needed for SSR resource management
+ * Cleanup still needed for SSR resource management
  * Stores cleanup for execution when root disposes
  *
- * @param {() => void} fn - Cleanup function
- *
  * @example
  * ```typescript
  * createRoot((dispose) => {
@@ -153,30 +122,19 @@ export declare function onCleanup(fn: () => void): void;
 /**
  * Server getOwner - Get current reactive owner
  *
- * Section 5: Owner tree maintained on server for context
- *
- * @returns {RootOwner | null} Current owner or null
+ * Owner tree maintained on server for context
  */
 export declare function getOwner(): RootOwner | null;
 /**
  * Server runWithOwner - Run function with specific owner
  *
- * Section 5: Owner switching for proper context nesting
- *
- * @template T
- * @param {RootOwner | null} owner - Owner to run with
- * @param {() => T} fn - Function to run
- * @returns {T} Function result
+ * Owner switching for proper context nesting
  */
 export declare function runWithOwner<T>(owner: RootOwner | null, fn: () => T): T;
 /**
  * Server createContext - Create context with default value
  *
- * Section 9: Context lookup-based, no subscriptions on server
- *
- * @template T
- * @param {T} defaultValue - Default context value
- * @returns {Context<T>} Context object
+ * Context lookup-based, no subscriptions on server
  *
  * @example
  * ```typescript
@@ -187,11 +145,7 @@ export declare function createContext<T>(defaultValue?: T): Context<T>;
 /**
  * Server useContext - Retrieve context value
  *
- * Section 9: No subscriptions on server, just lookup
- *
- * @template T
- * @param {Context<T>} context - Context to use
- * @returns {T} Context value
+ * No subscriptions on server, just lookup
  *
  * @example
  * ```typescript
@@ -203,44 +157,33 @@ export declare function useContext<T>(context: Context<T>): T;
  * Server createComputed - Alias for createEffect
  *
  * On server, computed values run once like effects
- *
- * @param {() => any} fn - Computation function
- * @returns {{ dispose: () => void }} Disposer
  */
 export declare function createComputed(fn: () => any): {
     dispose: () => void;
 };
 /**
  * Server createRenderEffect - Runs once for SSR rendering
- *
- * @param {() => any} fn - Render effect function
- * @returns {{ dispose: () => void }} Disposer
  */
 export declare function createRenderEffect(fn: () => any): {
     dispose: () => void;
 };
 /**
  * Server createDeferred - No deferring on server
- *
- * @template T
- * @param {() => T} fn - Deferred computation
- * @returns {Accessor<T>} Accessor
  */
 export declare function createDeferred<T>(fn: () => T): Accessor<T>;
 /**
  * Server createSelector - Returns static equality check
+ */
+/**
+ * The server stand-in for `createSelector`.
  *
- * @template T
- * @param {() => T} source - Source value
- * @returns {(key: T) => boolean} Selector function
+ * On the client a selector is a fine-grained membership test that only notifies the two
+ * keys whose match changed. A server render produces one pass and has no subscriptions to
+ * be fine-grained about, so this reads the source once and compares.
  */
 export declare function createSelector<T>(source: () => T): (key: T) => boolean;
 /**
  * Server createResource - Stub for resource creation
- *
- * @param source Source signal or value
- * @param fetcher Fetcher function
- * @param options Resource options
  */
 export declare function createResource<T, S = true>(source: any, fetcher?: any, options?: any): [() => T | undefined, {
     mutate: (v: T) => T;
@@ -256,14 +199,12 @@ export type SetStoreFunction<T extends object> = {
     <K extends keyof T>(key: K, value: T[K] | ((prev: T[K]) => T[K])): void;
 };
 /**
- * Server createStore — plain object wrapper, no reactivity.
+ * Server createStore: plain object wrapper, no reactivity.
  * Mirrors the client API so shared code compiles on both sides.
  */
 export declare function createStore<T extends object>(init: T): [Store<T>, SetStoreFunction<T>];
 /**
  * Server startTransition - Execute immediately
- *
- * @param fn Transition function
  */
 export declare function startTransition(fn: () => void): void;
 /**

package/dist/src/lib/server/reactive.d.ts.map

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

package/dist/src/lib/server/reactive.js

@@ -1,5 +1,4 @@
 /**
- * @fileoverview Server Reactive Primitives for Fluixi
  * @module @fluixi/core/server/reactive
  *
  * Maps reactive primitives for server-side execution
@@ -17,14 +16,9 @@
 /**
  * Server createSignal - Returns snapshot value
  *
- * Section 4: Signals read-only snapshot on server
+ * Signals read-only snapshot on server
  * No reactivity, no tracking, just initial value
  *
- * @template T
- * @param {T} value - Initial value
- * @param {SignalOptions<T>} options - SignalTuple options (ignored on server)
- * @returns {SignalTuple<T>} Tuple of [getter, setter]
- *
  * @example
  * ```typescript
  * // On server, this returns a static snapshot
@@ -55,14 +49,9 @@ export function createSignal(value, options) {
 /**
  * Server createEffect - Runs once, no tracking
  *
- * Section 4: Effects run once on server, no scheduling
+ * Effects run once on server, no scheduling
  * Execute immediately and return no-op disposer
  *
- * @param {(v?: any) => any} fn - Effect function
- * @param {any} value - Initial value (optional)
- * @param {any} options - Effect options (ignored on server)
- * @returns {{ dispose: () => void }} Disposer object
- *
  * @example
  * ```typescript
  * // On server, runs once immediately
@@ -88,15 +77,9 @@ export function createEffect(fn, value, options) {
 /**
  * Server createMemo - Compute once, return static accessor
  *
- * Section 4: No tracking on server, single evaluation
+ * No tracking on server, single evaluation
  * Memoizes value at creation time
  *
- * @template T
- * @param {(v?: T) => T} fn - Computation function
- * @param {T} value - Initial value (optional)
- * @param {any} options - Memo options (ignored on server)
- * @returns {Accessor<T>} Static accessor
- *
  * @example
  * ```typescript
  * const [count] = createSignal(5);
@@ -115,13 +98,9 @@ export function createMemo(fn, value, options) {
 /**
  * Server createRoot - Creates owner but no reactive tracking
  *
- * Section 5: Owners exist on server for tree structure
+ * Owners exist on server for tree structure
  * Needed for context and cleanup, but no reactive tracking
  *
- * @template T
- * @param {(dispose: () => void) => T} fn - Root function
- * @returns {T} Function result
- *
  * @example
  * ```typescript
  * const result = createRoot((dispose) => {
@@ -159,13 +138,9 @@ export function createRoot(fn) {
 /**
  * Server batch - Execute immediately, no batching
  *
- * Section 4: No scheduling on server
+ * No scheduling on server
  * Just runs the function synchronously
  *
- * @template T
- * @param {() => T} fn - Function to batch
- * @returns {T} Function result
- *
  * @example
  * ```typescript
  * batch(() => {
@@ -184,13 +159,9 @@ export function batch(fn) {
 /**
  * Server untrack - Execute function (already untracked)
  *
- * Section 4: No tracking on server anyway
+ * No tracking on server anyway
  * This is a no-op but exists for API compatibility
  *
- * @template T
- * @param {() => T} fn - Function to run untracked
- * @returns {T} Function result
- *
  * @example
  * ```typescript
  * untrack(() => {
@@ -209,11 +180,9 @@ let currentCleanups = null;
 /**
  * Server onCleanup - Register cleanup function
  *
- * Section 5: Cleanup still needed for SSR resource management
+ * Cleanup still needed for SSR resource management
  * Stores cleanup for execution when root disposes
  *
- * @param {() => void} fn - Cleanup function
- *
  * @example
  * ```typescript
  * createRoot((dispose) => {
@@ -236,9 +205,7 @@ let currentOwner = null;
 /**
  * Server getOwner - Get current reactive owner
  *
- * Section 5: Owner tree maintained on server for context
- *
- * @returns {RootOwner | null} Current owner or null
+ * Owner tree maintained on server for context
  */
 export function getOwner() {
     return currentOwner;
@@ -246,12 +213,7 @@ export function getOwner() {
 /**
  * Server runWithOwner - Run function with specific owner
  *
- * Section 5: Owner switching for proper context nesting
- *
- * @template T
- * @param {RootOwner | null} owner - Owner to run with
- * @param {() => T} fn - Function to run
- * @returns {T} Function result
+ * Owner switching for proper context nesting
  */
 export function runWithOwner(owner, fn) {
     const prev = currentOwner;
@@ -270,11 +232,7 @@ const contextMap = new Map();
 /**
  * Server createContext - Create context with default value
  *
- * Section 9: Context lookup-based, no subscriptions on server
- *
- * @template T
- * @param {T} defaultValue - Default context value
- * @returns {Context<T>} Context object
+ * Context lookup-based, no subscriptions on server
  *
  * @example
  * ```typescript
@@ -309,11 +267,7 @@ export function createContext(defaultValue) {
 /**
  * Server useContext - Retrieve context value
  *
- * Section 9: No subscriptions on server, just lookup
- *
- * @template T
- * @param {Context<T>} context - Context to use
- * @returns {T} Context value
+ * No subscriptions on server, just lookup
  *
  * @example
  * ```typescript
@@ -332,9 +286,6 @@ export function useContext(context) {
  * Server createComputed - Alias for createEffect
  *
  * On server, computed values run once like effects
- *
- * @param {() => any} fn - Computation function
- * @returns {{ dispose: () => void }} Disposer
  */
 export function createComputed(fn) {
     return createEffect(fn);
@@ -344,9 +295,6 @@ export function createComputed(fn) {
 // ============================================================================
 /**
  * Server createRenderEffect - Runs once for SSR rendering
- *
- * @param {() => any} fn - Render effect function
- * @returns {{ dispose: () => void }} Disposer
  */
 export function createRenderEffect(fn) {
     return createEffect(fn);
@@ -356,10 +304,6 @@ export function createRenderEffect(fn) {
 // ============================================================================
 /**
  * Server createDeferred - No deferring on server
- *
- * @template T
- * @param {() => T} fn - Deferred computation
- * @returns {Accessor<T>} Accessor
  */
 export function createDeferred(fn) {
     return createMemo(fn);
@@ -369,12 +313,15 @@ export function createDeferred(fn) {
 // ============================================================================
 /**
  * Server createSelector - Returns static equality check
- *
- * @template T
- * @param {() => T} source - Source value
- * @returns {(key: T) => boolean} Selector function
  */
 // ENVIRONMENT
+/**
+ * The server stand-in for `createSelector`.
+ *
+ * On the client a selector is a fine-grained membership test that only notifies the two
+ * keys whose match changed. A server render produces one pass and has no subscriptions to
+ * be fine-grained about, so this reads the source once and compares.
+ */
 export function createSelector(source) {
     const value = source();
     return (key) => key === value;
@@ -384,10 +331,6 @@ export function createSelector(source) {
 // ============================================================================
 /**
  * Server createResource - Stub for resource creation
- *
- * @param source Source signal or value
- * @param fetcher Fetcher function
- * @param options Resource options
  */
 export function createResource(source, fetcher, options) {
     return [
@@ -399,7 +342,7 @@ export function createResource(source, fetcher, options) {
     ];
 }
 /**
- * Server createStore — plain object wrapper, no reactivity.
+ * Server createStore: plain object wrapper, no reactivity.
  * Mirrors the client API so shared code compiles on both sides.
  */
 export function createStore(init) {
@@ -425,8 +368,6 @@ export function createStore(init) {
 // ============================================================================
 /**
  * Server startTransition - Execute immediately
- *
- * @param fn Transition function
  */
 export function startTransition(fn) {
     fn();

package/dist/src/lib/server/reactive.mjs

@@ -1 +1,176 @@
-function f(e,t){let o=e;return[(()=>o),c=>(typeof c=="function"?o=c(o):o=c,o)]}function T(e,t,o){try{e(t)}catch(n){console.error("[Fluixi Server] Effect error:",n)}return{dispose:()=>{}}}function p(e,t,o){let n=e(t);return(()=>n)}function d(e){let t=[],o=()=>{t.forEach(n=>{try{n()}catch(r){console.error("[Fluixi Server] Cleanup error:",r)}}),t.length=0};try{return e(o)}catch(n){throw o(),n}}function x(e){return e()}function y(e){return e()}var l=null;function v(e){l&&l.push(e)}var s=null;function S(){return s}function g(e,t){let o=s;s=e;try{return t()}finally{s=o}}var i=new Map;function w(e){let t=Symbol("context");return{id:t,Provider:n=>{let r=i.get(t);i.set(t,n.value);try{return n.children}finally{r!==void 0?i.set(t,r):i.delete(t)}},defaultValue:e}}function C(e){let t=i.get(e.id);return t!==void 0?t:e.defaultValue}function h(e){return T(e)}function A(e){return T(e)}function K(e){return p(e)}function R(e){let t=e();return o=>o===t}function O(e,t,o){return[()=>{},{mutate:n=>n,refetch:()=>{}}]}function b(e){let t={...e};function o(n,r){if(typeof n=="object"&&n!==null&&!Array.isArray(n))for(let c of Object.keys(n)){let u=n[c];t[c]=typeof u=="function"?u(t[c]):u}else t[n]=typeof r=="function"?r(t[n]):r}return[t,o]}function m(e){e()}var j=!0,F=!1,a={context:null,owner:null};function E(e){s=e,a.owner=e,a.context=e}function k(){return a}export{x as batch,h as createComputed,w as createContext,K as createDeferred,T as createEffect,p as createMemo,A as createRenderEffect,O as createResource,d as createRoot,R as createSelector,f as createSignal,b as createStore,S as getOwner,k as getSharedConfig,F as isClient,j as isServer,v as onCleanup,g as runWithOwner,E as setOwner,a as sharedConfig,m as startTransition,y as untrack,C as useContext};
+// src/lib/server/reactive.ts
+function createSignal(value, options) {
+  let current = value;
+  const read = (() => current);
+  const write = (newValue) => {
+    if (typeof newValue === "function") {
+      current = newValue(current);
+    } else {
+      current = newValue;
+    }
+    return current;
+  };
+  return [read, write];
+}
+function createEffect(fn, value, options) {
+  try {
+    fn(value);
+  } catch (error) {
+    console.error("[Fluixi Server] Effect error:", error);
+  }
+  return { dispose: () => {
+  } };
+}
+function createMemo(fn, value, options) {
+  const computed = fn(value);
+  return (() => computed);
+}
+function createRoot(fn) {
+  const cleanups = [];
+  const dispose = () => {
+    cleanups.forEach((cleanup) => {
+      try {
+        cleanup();
+      } catch (error) {
+        console.error("[Fluixi Server] Cleanup error:", error);
+      }
+    });
+    cleanups.length = 0;
+  };
+  try {
+    return fn(dispose);
+  } catch (error) {
+    dispose();
+    throw error;
+  }
+}
+function batch(fn) {
+  return fn();
+}
+function untrack(fn) {
+  return fn();
+}
+var currentCleanups = null;
+function onCleanup(fn) {
+  if (currentCleanups) {
+    currentCleanups.push(fn);
+  }
+}
+var currentOwner = null;
+function getOwner() {
+  return currentOwner;
+}
+function runWithOwner(owner, fn) {
+  const prev = currentOwner;
+  currentOwner = owner;
+  try {
+    return fn();
+  } finally {
+    currentOwner = prev;
+  }
+}
+var contextMap = /* @__PURE__ */ new Map();
+function createContext(defaultValue) {
+  const id = /* @__PURE__ */ Symbol("context");
+  const Provider = (props) => {
+    const prevValue = contextMap.get(id);
+    contextMap.set(id, props.value);
+    try {
+      return props.children;
+    } finally {
+      if (prevValue !== void 0) {
+        contextMap.set(id, prevValue);
+      } else {
+        contextMap.delete(id);
+      }
+    }
+  };
+  return {
+    id,
+    Provider,
+    defaultValue
+  };
+}
+function useContext(context) {
+  const value = contextMap.get(context.id);
+  return value !== void 0 ? value : context.defaultValue;
+}
+function createComputed(fn) {
+  return createEffect(fn);
+}
+function createRenderEffect(fn) {
+  return createEffect(fn);
+}
+function createDeferred(fn) {
+  return createMemo(fn);
+}
+function createSelector(source) {
+  const value = source();
+  return (key) => key === value;
+}
+function createResource(source, fetcher, options) {
+  return [
+    () => void 0,
+    {
+      mutate: (v) => v,
+      refetch: () => {
+      }
+    }
+  ];
+}
+function createStore(init) {
+  const state = { ...init };
+  function setStore(keyOrPatch, value) {
+    if (typeof keyOrPatch === "object" && keyOrPatch !== null && !Array.isArray(keyOrPatch)) {
+      for (const k of Object.keys(keyOrPatch)) {
+        const v = keyOrPatch[k];
+        state[k] = typeof v === "function" ? v(state[k]) : v;
+      }
+    } else {
+      state[keyOrPatch] = typeof value === "function" ? value(state[keyOrPatch]) : value;
+    }
+  }
+  return [state, setStore];
+}
+function startTransition(fn) {
+  fn();
+}
+var isServer = true;
+var isClient = false;
+var sharedConfig = {
+  context: null,
+  owner: null
+};
+function setOwner(owner) {
+  currentOwner = owner;
+  sharedConfig.owner = owner;
+  sharedConfig.context = owner;
+}
+function getSharedConfig() {
+  return sharedConfig;
+}
+export {
+  batch,
+  createComputed,
+  createContext,
+  createDeferred,
+  createEffect,
+  createMemo,
+  createRenderEffect,
+  createResource,
+  createRoot,
+  createSelector,
+  createSignal,
+  createStore,
+  getOwner,
+  getSharedConfig,
+  isClient,
+  isServer,
+  onCleanup,
+  runWithOwner,
+  setOwner,
+  sharedConfig,
+  startTransition,
+  untrack,
+  useContext
+};