@fluixi/core 1.0.0-alpha.100

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

@@ -0,0 +1,590 @@
+// src/lib/render/index.ts
+import { isServer as isServer3 } from "@fluixi/dom";
+import { createRoot as createRoot2 } from "@fluixi/reactive/signal";
+
+// src/lib/render/versions.ts
+import { registerCoreVersion } from "@fluixi/dom";
+
+// src/version.generated.ts
+var VERSION = "1.0.0-alpha.100";
+
+// src/lib/render/versions.ts
+import { stampVersions, warnOnVersionSkew, versions } from "@fluixi/dom";
+registerCoreVersion(VERSION);
+
+// src/lib/render/index.ts
+import {
+  isDOMNode,
+  delegateEvents,
+  insert
+} from "@fluixi/dom";
+
+// src/lib/render/component.ts
+import { isServer } from "@fluixi/dom";
+import {
+  createComponent as domCreateComponent,
+  asComponent
+} from "@fluixi/dom";
+import {
+  untrack,
+  onCleanup,
+  getOwner,
+  createEffect,
+  createMemo,
+  createSignal,
+  isSignal,
+  batch,
+  runWithOwner,
+  isOwnerDisposed
+} from "@fluixi/reactive/signal";
+var sharedConfig = {
+  context: null,
+  owner: null
+};
+function getSharedConfig() {
+  return sharedConfig;
+}
+var DEV = typeof process !== "undefined" && false;
+var _LIFECYCLE = /* @__PURE__ */ Symbol.for("fluixi-lifecycle");
+function getOwnerLifecycle() {
+  const owner = 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 (isServer()) {
+    lc.mounts = [];
+    lc.effects = [];
+    return;
+  }
+  lc.scheduled = true;
+  const owner = getOwner();
+  queueMicrotask(() => {
+    if (isOwnerDisposed(owner)) {
+      lc.mounts = [];
+      lc.effects = [];
+      return;
+    }
+    runWithOwner(owner, () => {
+      for (const cb of lc.mounts) {
+        try {
+          const cleanup = cb();
+          if (typeof cleanup === "function") {
+            onCleanup(cleanup);
+          }
+        } catch (e) {
+          console.error("Error in onMount callback:", e);
+        }
+      }
+      for (const cb of lc.effects) {
+        let cleanup;
+        createEffect(() => {
+          if (cleanup) cleanup();
+          cleanup = cb();
+        });
+        onCleanup(() => {
+          if (cleanup) cleanup();
+        });
+      }
+      lc.mounts = [];
+      lc.effects = [];
+    });
+  });
+}
+function createComponent(Comp, props) {
+  return domCreateComponent(Comp, props);
+}
+function $component(value, props) {
+  const component = typeof value === "function" ? untrack(() => value(props)) : value;
+  const nameable = component != null && (typeof component === "function" || typeof component === "object");
+  if (nameable) {
+    try {
+      component["$name"] = value.name;
+    } catch {
+    }
+  }
+  if (nameable && !isSignal(component)) {
+    return asComponent(component);
+  }
+  return component;
+}
+function onMount(fn, reactive = true) {
+  if (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;
+    }
+    createEffect(() => {
+      const cleanup = untrack(fn);
+      if (typeof cleanup === "function") {
+        onCleanup(cleanup);
+      }
+    });
+  }
+}
+function onUnmount(fn) {
+  onCleanup(fn);
+}
+function useEffect(callback) {
+  const lc = getOwnerLifecycle();
+  if (lc) {
+    lc.effects.push(callback);
+    scheduleLifecycleFlush(lc);
+  } else {
+    let cleanup;
+    createEffect(() => {
+      if (cleanup) cleanup();
+      cleanup = callback();
+    });
+    onCleanup(() => {
+      if (cleanup) cleanup();
+    });
+  }
+}
+function useMemo(fn) {
+  return createMemo(fn);
+}
+function useRef(initialValue) {
+  const ref = { current: initialValue };
+  onCleanup(() => {
+    ref.current = null;
+  });
+  return ref;
+}
+function useReducer(reducer, initialState) {
+  const [state, setState] = 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 isDev() {
+  return DEV;
+}
+function devOnly(fn) {
+  if (DEV) {
+    fn();
+  }
+}
+
+// src/lib/render/suspense.ts
+import {
+  createSignal as createSignal2,
+  createMemo as createMemo2,
+  createEffect as createEffect2,
+  createRenderEffect as createRenderEffect2,
+  isSignal as isSignal2,
+  readChildren,
+  useContext as useContext2,
+  createContext as createContext2,
+  createSuspenseBoundary,
+  provideSuspense
+} from "@fluixi/reactive/signal";
+import {
+  asSuspense,
+  isComponent,
+  createComponent as createComponent2,
+  runWithoutHydration
+} from "@fluixi/dom";
+function isNode(value) {
+  if (typeof window === "undefined") return false;
+  if (typeof Node === "function" && value instanceof Node) return true;
+  return !!(value && typeof value === "object" && typeof value.nodeType === "number");
+}
+function isLitResult(value) {
+  if (!value || typeof value !== "object") return false;
+  return !!(typeof value["_$litType$"] !== "undefined" || typeof value["_$litDirective$"] !== "undefined" || Array.isArray(value.strings) && Array.isArray(value.values));
+}
+function isPromise(value) {
+  return !!(value && typeof value === "object" && typeof value.then === "function" || value instanceof Promise);
+}
+function isJSXElement(value) {
+  return !!(value && typeof value === "object" && "type" in value && "props" in value);
+}
+var SuspenseListContext = createContext2(void 0, "suspense-list");
+function Suspense(props) {
+  return createComponent2(SuspenseImpl, props);
+}
+function SuspenseImpl(props) {
+  const boundary = createSuspenseBoundary();
+  const listCtx = useContext2(SuspenseListContext);
+  const listState = listCtx ? listCtx.register(boundary.inFallback) : void 0;
+  function instantiateOnce(val) {
+    if (val == null || typeof val === "boolean") return null;
+    if (typeof val === "function" && isComponent(val) && !isSignal2(val)) return val();
+    return val;
+  }
+  const fallback = runWithoutHydration(() => instantiateOnce(props.fallback ?? null));
+  const children = provideSuspense(boundary, () => readChildren(() => props.children));
+  const track = (value, depth) => {
+    if (depth > 8) return;
+    if (Array.isArray(value)) {
+      for (const x of value) track(x, depth + 1);
+    } else if (typeof value === "function" && isSignal2(value)) {
+      track(value(), depth + 1);
+    }
+  };
+  provideSuspense(boundary, () => {
+    createRenderEffect2(() => track(children, 0));
+  });
+  const [resolved, setResolved] = createSignal2(void 0);
+  const childIsPromise = isPromise(children);
+  if (childIsPromise) {
+    boundary.increment();
+    children.then(
+      (v) => {
+        setResolved(() => v);
+        boundary.decrement();
+      },
+      () => boundary.decrement()
+    );
+  }
+  return createMemo2(() => {
+    const showFallback = listState ? listState.showFallback() : boundary.inFallback();
+    if (showFallback) return fallback;
+    if (childIsPromise) return resolved();
+    return children;
+  });
+}
+function SuspenseList(props) {
+  return createComponent2(SuspenseListImpl, props);
+}
+function SuspenseListImpl(props) {
+  const { revealOrder = "together", tail } = props;
+  const registrations = [];
+  function coordinateReveal() {
+    if (revealOrder === "together") {
+      const allResolved = registrations.every((r) => !r.inFallback());
+      registrations.forEach((r) => {
+        r.setShowContent(allResolved);
+        r.setShowFallback(!allResolved);
+      });
+    } else {
+      const items = revealOrder === "backwards" ? [...registrations].reverse() : registrations;
+      let blocked = false;
+      for (const r of items) {
+        if (blocked || r.inFallback()) {
+          blocked = true;
+          r.setShowContent(false);
+          r.setShowFallback(tail !== "hidden");
+        } else {
+          r.setShowContent(true);
+          r.setShowFallback(false);
+        }
+      }
+    }
+  }
+  const coordinator = {
+    register: (inFallback) => {
+      const [showContent, setShowContent] = createSignal2(true);
+      const [showFallback, setShowFallback] = createSignal2(false);
+      registrations.push({ inFallback, setShowContent, setShowFallback });
+      createEffect2(() => {
+        inFallback();
+        coordinateReveal();
+      });
+      return { showContent, showFallback };
+    }
+  };
+  return SuspenseListContext.Provider({
+    value: coordinator,
+    children: props.children
+  });
+}
+asSuspense(Suspense);
+Object.defineProperty(Suspense, "__suspense", { value: true, enumerable: true });
+
+// src/lib/render/lazy.ts
+import { createComponent as createComponent3 } from "@fluixi/dom";
+import {
+  untrack as untrack2,
+  createMemo as createMemo3,
+  createResource as createResource2
+} from "@fluixi/reactive/signal";
+function fromChunk(value) {
+  if (value != null && (typeof value === "object" || typeof value === "function")) {
+    try {
+      value["$lazy"] = true;
+    } catch {
+    }
+  }
+  return value;
+}
+function lazy(loader, options) {
+  let resolved;
+  let promise;
+  let component;
+  function load() {
+    if (!promise) {
+      promise = loader().then((mod) => resolved = mod.default);
+    }
+    return promise;
+  }
+  if (options?.preload) load();
+  const LazyWrapper = ((props) => {
+    if (resolved) {
+      const C = resolved;
+      return fromChunk(untrack2(() => C(props)));
+    }
+    if (!component) {
+      const [resource] = createResource2(() => load(), { transport: false });
+      component = resource;
+      if (resource.error) throw resource.error;
+    }
+    return createMemo3(() => {
+      const C = component();
+      return C ? fromChunk(createComponent3(C, props)) : void 0;
+    });
+  });
+  LazyWrapper.preload = () => load().then(() => void 0);
+  LazyWrapper.$lazy = true;
+  LazyWrapper.loader = loader;
+  return LazyWrapper;
+}
+
+// src/lib/render/deferred.ts
+import { isServer as isServer2 } from "@fluixi/dom";
+import { createMemo as createMemo4, createSignal as createSignal3 } from "@fluixi/reactive/signal";
+import { observeIntersection } from "@fluixi/dom/utils";
+function deferred(loader, options) {
+  const exportName = options.export ?? "default";
+  const Lazy = lazy(
+    () => loader().then((mod) => {
+      const component = mod[exportName];
+      if (typeof component !== "function") {
+        throw new Error(
+          `deferred(): module has no '${exportName}' export (got ${typeof component}).`
+        );
+      }
+      return { default: component };
+    }),
+    { fallback: options.fallback }
+  );
+  function Deferred(props) {
+    if (options.strategy.kind === "never") return isServer2() ? Lazy(props) : null;
+    if (isServer2() || options.strategy.kind === "eager") return Lazy(props);
+    const [ready, setReady] = createSignal3(false);
+    const start = () => {
+      void Lazy.preload().then(() => setReady(true));
+    };
+    const anchor = options.strategy.kind === "visible" ? createAnchor() : void 0;
+    schedule(options.strategy, start, anchor);
+    return createMemo4(() => ready() ? Lazy(props) : anchor ?? options.fallback ?? null, void 0, {
+      name: "deferred"
+    });
+  }
+  Deferred.preload = Lazy.preload;
+  return Deferred;
+}
+function createAnchor() {
+  const el = document.createElement("span");
+  el.setAttribute("data-fx-load", "visible");
+  el.style.display = "block";
+  return el;
+}
+function schedule(strategy, start, anchor) {
+  let fired = false;
+  const once = () => {
+    if (fired) return;
+    fired = true;
+    start();
+  };
+  switch (strategy.kind) {
+    case "idle": {
+      const ric = globalThis.requestIdleCallback;
+      if (ric) ric(once);
+      else setTimeout(once, 1);
+      return;
+    }
+    case "visible": {
+      if (!anchor || typeof IntersectionObserver === "undefined") {
+        once();
+        return;
+      }
+      const stop = observeIntersection(
+        anchor,
+        (isIntersecting) => {
+          if (!isIntersecting) return;
+          stop();
+          once();
+        },
+        { rootMargin: strategy.rootMargin ?? "0px" }
+      );
+      return;
+    }
+    case "interaction": {
+      const handler = () => {
+        for (const event of strategy.events) {
+          document.removeEventListener(event, handler, true);
+        }
+        once();
+      };
+      for (const event of strategy.events) {
+        document.addEventListener(event, handler, { capture: true, passive: true });
+      }
+      return;
+    }
+    case "media": {
+      if (typeof matchMedia === "undefined") {
+        once();
+        return;
+      }
+      const query = matchMedia(strategy.query);
+      if (query.matches) {
+        once();
+        return;
+      }
+      const onChange = (e) => {
+        if (!e.matches) return;
+        query.removeEventListener("change", onChange);
+        once();
+      };
+      query.addEventListener("change", onChange);
+      return;
+    }
+    /* c8 ignore next 3 */
+    default:
+      once();
+  }
+}
+
+// src/lib/render/await.ts
+import { createResource as createResource3 } from "@fluixi/reactive/signal";
+function Await(props) {
+  const fetcher = () => {
+    const v = props.value;
+    return typeof v === "function" ? v() : v;
+  };
+  const [data] = createResource3(fetcher);
+  return () => {
+    if (data.loading) return props.fallback;
+    const child = props.children;
+    return typeof child === "function" ? child(data()) : child;
+  };
+}
+
+// src/lib/render/index.ts
+function render(code, container, options = {}) {
+  delegateEvents(["click", "input", "change", "submit"]);
+  if (isServer3()) {
+    throw new Error(
+      "render() is for client-side only. Use renderToString() on server."
+    );
+  }
+  if (!container) {
+    throw new Error("Container element is required");
+  }
+  let disposer;
+  createRoot2((dispose) => {
+    disposer = dispose;
+    const result = typeof code === "function" ? code() : code;
+    container.textContent = "";
+    stampVersions(container);
+    warnOnVersionSkew();
+    insert(container, () => result);
+  });
+  return () => {
+    if (disposer) {
+      disposer();
+      disposer = void 0;
+    }
+  };
+}
+function isLitTemplateResult(value) {
+  return value && typeof value === "object" && (value["_$litType$"] !== void 0 || value["_$litDirective$"] !== void 0);
+}
+function portal(code, target, options = {}) {
+  const container = document.createElement("div");
+  container.setAttribute("data-portal", "true");
+  target.appendChild(container);
+  const dispose = render(code, container, options);
+  return () => {
+    dispose();
+    if (target.contains(container)) {
+      target.removeChild(container);
+    }
+  };
+}
+function isRenderable(value) {
+  if (value == null) return true;
+  if (typeof value === "function") return true;
+  if (isDOMNode(value)) return true;
+  if (isLitTemplateResult(value)) return true;
+  if (Array.isArray(value)) return true;
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return true;
+  }
+  return false;
+}
+function initDelegation() {
+  if (isServer3()) return;
+  delegateEvents(["click", "input", "change", "submit"]);
+}
+function cleanupDelegation() {
+  if (isServer3()) return;
+}
+export {
+  $component,
+  Await,
+  DEV,
+  Suspense,
+  SuspenseList,
+  batch,
+  cleanupDelegation,
+  createComponent,
+  createEffect,
+  createMemo,
+  deferred,
+  devOnly,
+  getOwner,
+  getSharedConfig,
+  initDelegation,
+  isDev,
+  isJSXElement,
+  isLitResult,
+  isNode,
+  isPromise,
+  isRenderable,
+  lazy,
+  onCleanup,
+  onMount,
+  onUnmount,
+  portal,
+  render,
+  runWithOwner,
+  useCallback,
+  useEffect,
+  useEventListener,
+  useMemo,
+  useReducer,
+  useRef
+};

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

@@ -0,0 +1,67 @@
+"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/lazy.ts
+var lazy_exports = {};
+__export(lazy_exports, {
+  lazy: () => lazy
+});
+module.exports = __toCommonJS(lazy_exports);
+var import_dom = require("@fluixi/dom");
+var import_signal = require("@fluixi/reactive/signal");
+function fromChunk(value) {
+  if (value != null && (typeof value === "object" || typeof value === "function")) {
+    try {
+      value["$lazy"] = true;
+    } catch {
+    }
+  }
+  return value;
+}
+function lazy(loader, options) {
+  let resolved;
+  let promise;
+  let component;
+  function load() {
+    if (!promise) {
+      promise = loader().then((mod) => resolved = mod.default);
+    }
+    return promise;
+  }
+  if (options?.preload) load();
+  const LazyWrapper = ((props) => {
+    if (resolved) {
+      const C = resolved;
+      return fromChunk((0, import_signal.untrack)(() => C(props)));
+    }
+    if (!component) {
+      const [resource] = (0, import_signal.createResource)(() => load(), { transport: false });
+      component = resource;
+      if (resource.error) throw resource.error;
+    }
+    return (0, import_signal.createMemo)(() => {
+      const C = component();
+      return C ? fromChunk((0, import_dom.createComponent)(C, props)) : void 0;
+    });
+  });
+  LazyWrapper.preload = () => load().then(() => void 0);
+  LazyWrapper.$lazy = true;
+  LazyWrapper.loader = loader;
+  return LazyWrapper;
+}

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

@@ -0,0 +1,49 @@
+/**
+ * Lazy-load a component module.
+ *
+ * SolidJS-aligned pattern:
+ *  1. `comp` signal is shared across all instances of this lazy component (module-level).
+ *  2. `createResource` at the component level registers the load promise with the
+ *     nearest Suspense boundary (trackPromise / resource.loading).
+ *  3. A pure `createMemo` reads `comp()`: undefined while loading (Suspense shows
+ *     fallback), the rendered component once loaded.
+ *  4. `preload()` is exposed so routes / link hover handlers can start the download
+ *     before the component is rendered.
+ */
+import { Component, ComponentProps } from '@fluixi/dom';
+export type LazyComponent<P = ComponentProps> = () => Promise<{
+    default: Component<P>;
+}>;
+export interface LazyOptions {
+    /** Show this while the module is loading */
+    fallback?: any;
+    /** If true, start loading immediately when lazy() is called */
+    preload?: boolean;
+}
+/**
+ * Defer a component to its own chunk, loaded the first time it renders.
+ *
+ * `loader` is a dynamic import, and its `default` export is the component. The returned
+ * function stands in for it and carries `preload()`, which starts the import without
+ * rendering anything. File routing uses that: `startClient` preloads the matched route
+ * before hydrating.
+ *
+ * Preloading is what keeps hydration intact. If the module has already resolved by the
+ * time this renders, the component renders synchronously on the first pass, so it adopts
+ * the server's DOM in place. On a cold client navigation it goes through a resource
+ * instead, suspends, and a `Suspense` boundary above it shows the fallback.
+ *
+ * @example
+ * ```ts
+ * const Settings = lazy(() => import('./Settings.js'));
+ *
+ * // somewhere that knows the route is next
+ * void Settings.preload();
+ * ```
+ */
+export declare function lazy<T extends (...args: any[]) => any>(loader: () => Promise<{
+    default: T;
+}>, options?: LazyOptions): T & {
+    preload: () => Promise<void>;
+};
+//# sourceMappingURL=lazy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../../../src/lib/render/lazy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAUzE,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,cAAc,IAAI,MAAM,OAAO,CAAC;IAC5D,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;CACvB,CAAC,CAAC;AAEH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACpD,MAAM,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC,EACrC,OAAO,CAAC,EAAE,WAAW,GACpB,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CA2DtC"}