@fluixi/core 1.0.0-alpha.53

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

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview Server-Side Rendering Entry Point for Fluixi
+ * @module @fluixi/core/server
+ *
+ * Implements Unified SSR Engine compatible with Lit and JSX.
+ */
+import { serializeHydrationData, setHydrating, isHydrating, setHydrationData, getHydrationData, hasHydrationData, clearHydrationData, clearHydrationDataKey, deserializeHydrationData, hydrationMarker, hydrationMarkerStart, hydrationMarkerEnd, createHydratableResource, useHydrationData, cleanupHydration, isServerEnvironment, isClientEnvironment, type HydrationData } from './hydration.js';
+/**
+ * SSR context for passing data during server rendering
+ */
+export interface SSRContext {
+    url: string;
+    headers: Record<string, string>;
+    [key: string]: any;
+}
+/**
+ * Document options
+ */
+export interface DocumentOptions {
+    title?: string;
+    lang?: string;
+    stylesheets?: string[];
+    scripts?: string[];
+    head?: string;
+    bodyAttributes?: string;
+}
+/**
+ * Get current SSR context
+ */
+export declare function getSSRContext(): SSRContext | null;
+/**
+ * Set SSR context
+ */
+export declare function setSSRContext(context: SSRContext | null): void;
+/**
+ * Run function with SSR context
+ */
+export declare function withSSRContext<T>(context: SSRContext, fn: () => T): T;
+/**
+ * Render complete HTML page
+ *
+ * @param {() => any} code - Component function
+ * @param {DocumentOptions} options - Document options
+ * @returns {Promise<string>} Complete HTML document
+ */
+export declare function renderToPage(code: () => any, options?: DocumentOptions): Promise<string>;
+/**
+ * Create HTML document wrapper
+ */
+export declare function createHtmlDocument(content: string, options?: DocumentOptions): string;
+export declare function isServer(): boolean;
+export declare function isClient(): boolean;
+export declare function onServer<T>(fn: () => T, fallback: T): T;
+export declare function onClient<T>(fn: () => T, fallback: T): T;
+/**
+ * Render component to HTML string
+ */
+export declare function renderToString(code: () => any): Promise<string>;
+/**
+ * Render component to stream (includes hydration data)
+ */
+export declare function renderToStream(code: () => any): Promise<string>;
+/**
+ * Standard server entry point.
+ * Returns an object with render/stream/page helpers
+ * for use in server frameworks (Express, Hono, Nitro, etc.)
+ *
+ * @example
+ * ```ts
+ * // entry-server.ts
+ * import { startServer } from '@fluixi/core/server';
+ * import App from './app';
+ *
+ * export default startServer(App);
+ * ```
+ */
+export declare function startServer(App: (props: {
+    url: string;
+}) => any): {
+    /** Render the app to a full HTML string (includes hydration data) */
+    render: (url: string) => Promise<string>;
+    /** Render the app to a streamable HTML string (includes hydration data) */
+    stream: (url: string) => Promise<string>;
+    /** Render the app to a complete HTML page document */
+    page: (url: string, opts?: DocumentOptions) => Promise<string>;
+};
+export { createSignal, createEffect, createMemo, createRoot, batch, untrack, onCleanup, getOwner, runWithOwner, createContext, useContext, createComputed, createRenderEffect, createDeferred, createSelector, createResource, startTransition, isServer as isServerReactive, isClient as isClientReactive, } from './reactive.js';
+export type { SignalTuple, Accessor, Setter, SignalOptions, RootOwner, Context, } from './reactive.js';
+export { isHydrating, setHydrating, setHydrationData, getHydrationData, hasHydrationData, clearHydrationData, clearHydrationDataKey, serializeHydrationData, deserializeHydrationData, hydrationMarker, hydrationMarkerStart, hydrationMarkerEnd, createHydratableResource, useHydrationData, cleanupHydration, isServerEnvironment, isClientEnvironment, };
+export type { HydrationData };
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,141 @@
+/**
+ * @fileoverview Server-Side Rendering Entry Point for Fluixi
+ * @module @fluixi/core/server
+ *
+ * Implements Unified SSR Engine compatible with Lit and JSX.
+ */
+import { serializeHydrationData, setHydrating, isHydrating, setHydrationData, getHydrationData, hasHydrationData, clearHydrationData, clearHydrationDataKey, deserializeHydrationData, hydrationMarker, hydrationMarkerStart, hydrationMarkerEnd, createHydratableResource, useHydrationData, cleanupHydration, isServerEnvironment, isClientEnvironment, } from './hydration.js';
+// SSR runs through @fluixi/server: the universal renderer + request-scoping,
+// with AsyncLocalStorage injected so concurrent renders are isolated.
+import { renderToString as domRenderToString } from '@fluixi/server';
+// ============================================================================
+// SSR CONTEXT MANAGEMENT
+// ============================================================================
+let currentSSRContext = null;
+/**
+ * Get current SSR context
+ */
+export function getSSRContext() {
+    return currentSSRContext;
+}
+/**
+ * Set SSR context
+ */
+export function setSSRContext(context) {
+    currentSSRContext = context;
+}
+/**
+ * Run function with SSR context
+ */
+export function withSSRContext(context, fn) {
+    const prev = currentSSRContext;
+    currentSSRContext = context;
+    try {
+        return fn();
+    }
+    finally {
+        currentSSRContext = prev;
+    }
+}
+// ============================================================================
+// HTML GENERATION
+// ============================================================================
+/**
+ * Render complete HTML page
+ *
+ * @param {() => any} code - Component function
+ * @param {DocumentOptions} options - Document options
+ * @returns {Promise<string>} Complete HTML document
+ */
+export async function renderToPage(code, options = {}) {
+    const content = await renderToString(code);
+    return createHtmlDocument(content, options);
+}
+/**
+ * Create HTML document wrapper
+ */
+export function createHtmlDocument(content, options = {}) {
+    const { title = 'Fluixi App', lang = 'en', stylesheets = [], scripts = [], head = '', bodyAttributes = '', } = options;
+    const styleTags = stylesheets
+        .map((href) => `<link rel="stylesheet" href="${href}">`)
+        .join('\n    ');
+    const scriptTags = scripts
+        .map((src) => `<script type="module" src="${src}"></script>`)
+        .join('\n    ');
+    return `<!DOCTYPE html>
+<html lang="${lang}">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${title}</title>
+    ${styleTags}
+    ${head}
+  </head>
+  <body${bodyAttributes ? ' ' + bodyAttributes : ''}>
+    ${content}
+    ${scriptTags}
+  </body>
+</html>`;
+}
+// ============================================================================
+// ENVIRONMENT DETECTION
+// ============================================================================
+export function isServer() {
+    return typeof window === 'undefined';
+}
+export function isClient() {
+    return typeof window !== 'undefined';
+}
+export function onServer(fn, fallback) {
+    return isServer() ? fn() : fallback;
+}
+export function onClient(fn, fallback) {
+    return isClient() ? fn() : fallback;
+}
+// ============================================================================
+// EXPORTS
+// ============================================================================
+/**
+ * Render component to HTML string
+ */
+export async function renderToString(code) {
+    const html = await domRenderToString(code);
+    const script = serializeHydrationData();
+    return html + script;
+}
+/**
+ * Render component to stream (includes hydration data)
+ */
+export async function renderToStream(code) {
+    const html = await domRenderToString(code);
+    const script = serializeHydrationData();
+    return html + script;
+}
+/**
+ * Standard server entry point.
+ * Returns an object with render/stream/page helpers
+ * for use in server frameworks (Express, Hono, Nitro, etc.)
+ *
+ * @example
+ * ```ts
+ * // entry-server.ts
+ * import { startServer } from '@fluixi/core/server';
+ * import App from './app';
+ *
+ * export default startServer(App);
+ * ```
+ */
+export function startServer(App) {
+    return {
+        /** Render the app to a full HTML string (includes hydration data) */
+        render: (url) => renderToString(() => App({ url })),
+        /** Render the app to a streamable HTML string (includes hydration data) */
+        stream: (url) => renderToStream(() => App({ url })),
+        /** Render the app to a complete HTML page document */
+        page: (url, opts) => renderToPage(() => App({ url }), opts),
+    };
+}
+// Re-export server-mapped reactive primitives
+export { createSignal, createEffect, createMemo, createRoot, batch, untrack, onCleanup, getOwner, runWithOwner, createContext, useContext, createComputed, createRenderEffect, createDeferred, createSelector, createResource, startTransition, isServer as isServerReactive, isClient as isClientReactive, } from './reactive.js';
+// Re-export all hydration utilities
+export { isHydrating, setHydrating, setHydrationData, getHydrationData, hasHydrationData, clearHydrationData, clearHydrationDataKey, serializeHydrationData, deserializeHydrationData, hydrationMarker, hydrationMarkerStart, hydrationMarkerEnd, createHydratableResource, useHydrationData, cleanupHydration, isServerEnvironment, isClientEnvironment, };

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

@@ -0,0 +1,16 @@
+var x=!1,a=new Map;function g(){return x}function b(t){x=t}function l(t,e){a.set(t,e)}function p(t){return a.get(t)}function O(t){return a.has(t)}function S(){a.clear()}function E(t){a.delete(t)}function f(){if(a.size===0)return"";let t=Object.fromEntries(a);return`<script type="application/json" id="__FLUIXI_HYDRATION__">${JSON.stringify(t)}<\/script>`}function A(){if(typeof window>"u")return!1;let t=document.getElementById("__FLUIXI_HYDRATION__");if(!t||t.getAttribute("type")!=="application/json")return!1;try{let e=t.textContent||"{}",n=JSON.parse(e);for(let[r,o]of Object.entries(n))a.set(r,o);return!0}catch(e){return console.error("Failed to deserialize hydration data:",e),!1}}function k(t){return`<!--#${t}-->`}function _(t){return`<!--#${t}-->`}function j(t){return`<!--/${t}-->`}function M(t,e){return async()=>{if(g()||typeof window<"u"){let r=p(t);if(r!==void 0)return r}let n=await e();return typeof window>"u"&&l(t,n),n}}function $(t,e){let n=p(t);if(n!==void 0)return n;let r=typeof e=="function"?e():e;return typeof window>"u"&&l(t,r),r}function m(){if(typeof window>"u")return;let t=document.getElementById("__FLUIXI_HYDRATION__");t&&t.remove();let e=document.createTreeWalker(document.body,NodeFilter.SHOW_COMMENT,null),n=[],r;for(;r=e.nextNode();){let o=r,i=o.nodeValue||"";(i.startsWith("#")||i.startsWith("/"))&&n.push(o)}n.forEach(o=>o.remove()),S()}typeof window<"u"&&window.addEventListener("load",()=>{setTimeout(m,100)});function K(){return typeof window>"u"}function F(){return typeof window<"u"}import{renderToString as w}from"@fluixi/server";function I(t,e){let n=t;return[(()=>n),i=>(typeof i=="function"?n=i(n):n=i,n)]}function y(t,e,n){try{t(e)}catch(r){console.error("[Fluixi Server] Effect error:",r)}return{dispose:()=>{}}}function h(t,e,n){let r=t(e);return(()=>r)}function N(t){let e=[],n=()=>{e.forEach(r=>{try{r()}catch(o){console.error("[Fluixi Server] Cleanup error:",o)}}),e.length=0};try{return t(n)}catch(r){throw n(),r}}function z(t){return t()}function W(t){return t()}var v=null;function L(t){v&&v.push(t)}var u=null;function U(){return u}function Y(t,e){let n=u;u=t;try{return e()}finally{u=n}}var s=new Map;function P(t){let e=Symbol("context");return{id:e,Provider:r=>{let o=s.get(e);s.set(e,r.value);try{return r.children}finally{o!==void 0?s.set(e,o):s.delete(e)}},defaultValue:t}}function V(t){let e=s.get(t.id);return e!==void 0?e:t.defaultValue}function X(t){return y(t)}function B(t){return y(t)}function J(t){return h(t)}function q(t){let e=t();return n=>n===e}function G(t,e,n){return[()=>{},{mutate:r=>r,refetch:()=>{}}]}function Q(t){t()}var Z=!0,tt=!1;var c=null;function dt(){return c}function lt(t){c=t}function pt(t,e){let n=c;c=t;try{return e()}finally{c=n}}async function et(t,e={}){let n=await C(t);return nt(n,e)}function nt(t,e={}){let{title:n="Fluixi App",lang:r="en",stylesheets:o=[],scripts:i=[],head:D="",bodyAttributes:T=""}=e,R=o.map(d=>`<link rel="stylesheet" href="${d}">`).join(`
+    `),H=i.map(d=>`<script type="module" src="${d}"><\/script>`).join(`
+    `);return`<!DOCTYPE html>
+<html lang="${r}">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${n}</title>
+    ${R}
+    ${D}
+  </head>
+  <body${T?" "+T:""}>
+    ${t}
+    ${H}
+  </body>
+</html>`}function rt(){return typeof window>"u"}function ot(){return typeof window<"u"}function ft(t,e){return rt()?t():e}function yt(t,e){return ot()?t():e}async function C(t){let e=await w(t),n=f();return e+n}async function it(t){let e=await w(t),n=f();return e+n}function Tt(t){return{render:e=>C(()=>t({url:e})),stream:e=>it(()=>t({url:e})),page:(e,n)=>et(()=>t({url:e}),n)}}export{z as batch,m as cleanupHydration,S as clearHydrationData,E as clearHydrationDataKey,X as createComputed,P as createContext,J as createDeferred,y as createEffect,nt as createHtmlDocument,M as createHydratableResource,h as createMemo,B as createRenderEffect,G as createResource,N as createRoot,q as createSelector,I as createSignal,A as deserializeHydrationData,p as getHydrationData,U as getOwner,dt as getSSRContext,O as hasHydrationData,k as hydrationMarker,j as hydrationMarkerEnd,_ as hydrationMarkerStart,ot as isClient,F as isClientEnvironment,tt as isClientReactive,g as isHydrating,rt as isServer,K as isServerEnvironment,Z as isServerReactive,L as onCleanup,yt as onClient,ft as onServer,et as renderToPage,it as renderToStream,C as renderToString,Y as runWithOwner,f as serializeHydrationData,b as setHydrating,l as setHydrationData,lt as setSSRContext,Tt as startServer,Q as startTransition,W as untrack,V as useContext,$ as useHydrationData,pt as withSSRContext};

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

@@ -0,0 +1 @@
+"use strict";var l=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var v=(e,t)=>{for(var o in t)l(e,o,{get:t[o],enumerable:!0})},S=(e,t,o,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of x(t))!y.call(e,r)&&r!==o&&l(e,r,{get:()=>t[r],enumerable:!(n=d(t,r))||n.enumerable});return e};var g=e=>S(l({},"__esModule",{value:!0}),e);var G={};v(G,{batch:()=>h,createComputed:()=>j,createContext:()=>b,createDeferred:()=>E,createEffect:()=>T,createMemo:()=>f,createRenderEffect:()=>F,createResource:()=>M,createRoot:()=>C,createSelector:()=>k,createSignal:()=>w,createStore:()=>D,getOwner:()=>R,getSharedConfig:()=>B,isClient:()=>q,isServer:()=>W,onCleanup:()=>K,runWithOwner:()=>O,setOwner:()=>z,sharedConfig:()=>u,startTransition:()=>V,untrack:()=>A,useContext:()=>m});module.exports=g(G);function w(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 f(e,t,o){let n=e(t);return(()=>n)}function C(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 h(e){return e()}function A(e){return e()}var p=null;function K(e){p&&p.push(e)}var s=null;function R(){return s}function O(e,t){let o=s;s=e;try{return t()}finally{s=o}}var i=new Map;function b(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 m(e){let t=i.get(e.id);return t!==void 0?t:e.defaultValue}function j(e){return T(e)}function F(e){return T(e)}function E(e){return f(e)}function k(e){let t=e();return o=>o===t}function M(e,t,o){return[()=>{},{mutate:n=>n,refetch:()=>{}}]}function D(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 a=n[c];t[c]=typeof a=="function"?a(t[c]):a}else t[n]=typeof r=="function"?r(t[n]):r}return[t,o]}function V(e){e()}var W=!0,q=!1,u={context:null,owner:null};function z(e){s=e,u.owner=e,u.context=e}function B(){return u}

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

@@ -0,0 +1,298 @@
+/**
+ * @fileoverview Server Reactive Primitives for Fluixi
+ * @module @fluixi/core/server/reactive
+ *
+ * Maps reactive primitives for server-side execution
+ * Following SolidJS pattern of server-specific reactive behavior
+ *
+ * Server mode:
+ * - Signals read-only snapshot
+ * - Effects run once
+ * - No scheduling
+ * - No subscriptions
+ */
+import type { SignalTuple, Accessor, Setter, SignalOptions, RootOwner, Context } from '@fluixi/reactive/signal';
+/**
+ * Server createSignal - Returns snapshot value
+ *
+ * Section 4: 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
+ * const [count, setCount] = createSignal(0);
+ * console.log(count()); // 0
+ * setCount(1); // Updates value but triggers no effects
+ * console.log(count()); // 1
+ * ```
+ */
+export declare function createSignal<T>(value: T, options?: SignalOptions<T>): SignalTuple<T>;
+/**
+ * Server createEffect - Runs once, no tracking
+ *
+ * Section 4: 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
+ * createEffect(() => {
+ *   console.log('This runs once');
+ * });
+ * ```
+ */
+export declare function createEffect(fn: (v?: any) => any, value?: any, options?: any): {
+    dispose: () => void;
+};
+/**
+ * Server createMemo - Compute once, return static accessor
+ *
+ * Section 4: 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);
+ * const doubled = createMemo(() => count() * 2);
+ * console.log(doubled()); // 10 (computed once)
+ * ```
+ */
+export declare function createMemo<T>(fn: (v?: T) => T, value?: T, options?: any): Accessor<T>;
+/**
+ * Server createRoot - Creates owner but no reactive tracking
+ *
+ * Section 5: 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) => {
+ *   // Server: Executes once, maintains owner tree
+ *   return <App />;
+ * });
+ * ```
+ */
+export declare function createRoot<T>(fn: (dispose: () => void) => T): T;
+/**
+ * Server batch - Execute immediately, no batching
+ *
+ * Section 4: No scheduling on server
+ * Just runs the function synchronously
+ *
+ * @template T
+ * @param {() => T} fn - Function to batch
+ * @returns {T} Function result
+ *
+ * @example
+ * ```typescript
+ * batch(() => {
+ *   setCount(1);
+ *   setName('Alice');
+ * }); // Executes immediately
+ * ```
+ */
+export declare function batch<T>(fn: () => T): T;
+/**
+ * Server untrack - Execute function (already untracked)
+ *
+ * Section 4: 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(() => {
+ *   return signal(); // Not tracked (but nothing is on server)
+ * });
+ * ```
+ */
+export declare function untrack<T>(fn: () => T): T;
+/**
+ * Server onCleanup - Register cleanup function
+ *
+ * Section 5: Cleanup still needed for SSR resource management
+ * Stores cleanup for execution when root disposes
+ *
+ * @param {() => void} fn - Cleanup function
+ *
+ * @example
+ * ```typescript
+ * createRoot((dispose) => {
+ *   onCleanup(() => {
+ *     console.log('Cleanup on dispose');
+ *   });
+ *   return result;
+ * });
+ * ```
+ */
+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
+ */
+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
+ */
+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
+ *
+ * @example
+ * ```typescript
+ * const ThemeContext = createContext('light');
+ * ```
+ */
+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
+ *
+ * @example
+ * ```typescript
+ * const theme = useContext(ThemeContext);
+ * ```
+ */
+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
+ *
+ * @template T
+ * @param {() => T} source - Source value
+ * @returns {(key: T) => boolean} Selector function
+ */
+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;
+    refetch: () => void;
+}];
+export type Store<T extends object> = {
+    readonly [K in keyof T]: T[K];
+};
+export type SetStoreFunction<T extends object> = {
+    (patch: {
+        [K in keyof T]?: T[K] | ((prev: T[K]) => T[K]);
+    }): void;
+    <K extends keyof T>(key: K, value: T[K] | ((prev: T[K]) => T[K])): void;
+};
+/**
+ * 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;
+/**
+ * Check if running on server
+ */
+export declare const isServer = true;
+/**
+ * Check if running on client
+ */
+export declare const isClient = false;
+export type { SignalTuple, Accessor, Setter, SignalOptions, RootOwner, Context };
+/**
+ * Server sharedConfig - Empty config object for compatibility
+ */
+export declare const sharedConfig: {
+    context: RootOwner | null;
+    owner: RootOwner | null;
+};
+/**
+ * Set current reactive owner (for internal use)
+ * @internal
+ */
+export declare function setOwner(owner: RootOwner | null): void;
+/**
+ * Get shared config (for compatibility)
+ * @internal
+ */
+export declare function getSharedConfig(): {
+    context: RootOwner | null;
+    owner: RootOwner | null;
+};
+//# sourceMappingURL=reactive.d.ts.map

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

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