solid-js 2.0.0-beta.6 → 2.0.0-beta.8

package/types-cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/types-cjs/server/component.d.cts

@@ -0,0 +1,67 @@
+import type { JSX } from "../jsx.cjs";
+export declare function enableHydration(): void;
+/**
+ * A general `Component` has no implicit `children` prop.  If desired, you can
+ * specify one as in `Component<{name: String, children: JSX.Element}>`.
+ */
+export type Component<P extends Record<string, any> = {}> = (props: P) => JSX.Element;
+/**
+ * Extend props to forbid the `children` prop.
+ */
+export type VoidProps<P extends Record<string, any> = {}> = P & {
+    children?: never;
+};
+/**
+ * `VoidComponent` forbids the `children` prop.
+ */
+export type VoidComponent<P extends Record<string, any> = {}> = Component<VoidProps<P>>;
+/**
+ * Extend props to allow an optional `children` prop with the usual type in JSX.
+ */
+export type ParentProps<P extends Record<string, any> = {}> = P & {
+    children?: JSX.Element;
+};
+/**
+ * `ParentComponent` allows an optional `children` prop with the usual type in JSX.
+ */
+export type ParentComponent<P extends Record<string, any> = {}> = Component<ParentProps<P>>;
+/**
+ * Extend props to require a `children` prop with the specified type.
+ */
+export type FlowProps<P extends Record<string, any> = {}, C = JSX.Element> = P & {
+    children: C;
+};
+/**
+ * `FlowComponent` requires a `children` prop with the specified type.
+ */
+export type FlowComponent<P extends Record<string, any> = {}, C = JSX.Element> = Component<FlowProps<P, C>>;
+export type ValidComponent = keyof JSX.IntrinsicElements | Component<any> | (string & {});
+/**
+ * Takes the props of the passed component and returns its type
+ */
+export type ComponentProps<T extends ValidComponent> = T extends Component<infer P> ? P : T extends keyof JSX.IntrinsicElements ? JSX.IntrinsicElements[T] : Record<string, unknown>;
+/**
+ * Type of `props.ref`, for use in `Component` or `props` typing.
+ */
+export type Ref<T> = T | ((val: T) => void);
+/**
+ * Creates a component. On server, just calls the function directly (no untrack needed).
+ */
+export declare function createComponent<T extends Record<string, any>>(Comp: Component<T>, props: T): JSX.Element;
+/**
+ * Lazy load a function component asynchronously.
+ * On server, returns a createMemo that throws NotReadyError until the module resolves,
+ * allowing resolveSSRNode to capture it as a fine-grained hole. The memo naturally
+ * scopes the owner so hydration IDs align with the client's createMemo in lazy().
+ * Requires `moduleUrl` for SSR — the bundler plugin injects the module specifier
+ * so the server can look up client chunk URLs from the asset manifest.
+ */
+export declare function lazy<T extends Component<any>>(fn: () => Promise<{
+    default: T;
+}>, moduleUrl?: string): T & {
+    preload: () => Promise<{
+        default: T;
+    }>;
+    moduleUrl?: string;
+};
+export declare function createUniqueId(): string;

package/types-cjs/server/core.d.cts

@@ -0,0 +1,44 @@
+import type { Accessor, EffectOptions } from "./signals.cjs";
+import type { JSX } from "../jsx.cjs";
+import type { FlowComponent } from "./component.cjs";
+export declare const $DEVCOMP: unique symbol;
+export type NoInfer<T extends any> = [T][T extends any ? 0 : never];
+export type ContextProviderComponent<T> = FlowComponent<{
+    value: T;
+}>;
+export interface Context<T> extends ContextProviderComponent<T> {
+    id: symbol;
+    defaultValue: T;
+}
+/**
+ * Creates a Context to handle a state scoped for the children of a component
+ * @param defaultValue optional default to inject into context
+ * @param options allows to set a name in dev mode for debugging purposes
+ * @returns The context that contains the Provider Component and that can be used with `useContext`
+ */
+export declare function createContext<T>(defaultValue?: undefined, options?: EffectOptions): Context<T | undefined>;
+export declare function createContext<T>(defaultValue: T, options?: EffectOptions): Context<T>;
+/**
+ * Uses a context to receive a scoped state from a parent's Context.Provider
+ * @param context Context object made by `createContext`
+ * @returns the current or `defaultValue`, if present
+ */
+export declare function useContext<T>(context: Context<T>): T;
+export type ResolvedJSXElement = Exclude<JSX.Element, JSX.ArrayElement>;
+export type ResolvedChildren = ResolvedJSXElement | ResolvedJSXElement[];
+export type ChildrenReturn = Accessor<ResolvedChildren> & {
+    toArray: () => ResolvedJSXElement[];
+};
+/**
+ * Resolves child elements to help interact with children
+ * @param fn an accessor for the children
+ * @returns a accessor of the same children, but resolved
+ */
+export declare function children(fn: Accessor<JSX.Element>): ChildrenReturn;
+/**
+ * Pass-through for SSR dynamic expressions.
+ * On the client, insert() render effects are transparent (0 owner slots),
+ * so the server doesn't need to create owners for these either.
+ */
+export declare function ssrRunInScope(fn: () => any): () => any;
+export declare function ssrRunInScope(array: (() => any)[]): (() => any)[];

package/types-cjs/server/flow.d.cts

@@ -0,0 +1,115 @@
+import type { Accessor, RevealOrder } from "./signals.cjs";
+import type { JSX } from "../jsx.cjs";
+export type { RevealOrder };
+type NonZeroParams<T extends (...args: any[]) => any> = Parameters<T>["length"] extends 0 ? never : T;
+type ConditionalRenderCallback<T> = (item: Accessor<NonNullable<T>>) => JSX.Element;
+type ConditionalRenderChildren<T, F extends ConditionalRenderCallback<T> = ConditionalRenderCallback<T>> = JSX.Element | NonZeroParams<F>;
+/**
+ * Creates a list of elements from a list
+ *
+ * @description https://docs.solidjs.com/reference/components/for
+ */
+export declare function For<T extends readonly any[], U extends JSX.Element>(props: {
+    each: T | undefined | null | false;
+    fallback?: JSX.Element;
+    keyed?: boolean | ((item: T[number]) => any);
+    children: (item: Accessor<T[number]>, index: Accessor<number>) => U;
+}): JSX.Element;
+/**
+ * Creates a list elements from a count
+ *
+ * @description https://docs.solidjs.com/reference/components/repeat
+ */
+export declare function Repeat<T extends JSX.Element>(props: {
+    count: number;
+    from?: number | undefined;
+    fallback?: JSX.Element;
+    children: ((index: number) => T) | T;
+}): JSX.Element;
+/**
+ * Conditionally render its children or an optional fallback component
+ * @description https://docs.solidjs.com/reference/components/show
+ */
+export declare function Show<T, F extends ConditionalRenderCallback<T>>(props: {
+    when: T | undefined | null | false;
+    keyed?: boolean;
+    fallback?: JSX.Element;
+    children: ConditionalRenderChildren<T, F>;
+}): JSX.Element;
+/**
+ * Switches between content based on mutually exclusive conditions
+ * @description https://docs.solidjs.com/reference/components/switch-and-match
+ */
+export declare function Switch(props: {
+    fallback?: JSX.Element;
+    children: JSX.Element;
+}): JSX.Element;
+export type MatchProps<T, F extends ConditionalRenderCallback<T> = ConditionalRenderCallback<T>> = {
+    when: T | undefined | null | false;
+    keyed?: boolean;
+    children: ConditionalRenderChildren<T, F>;
+};
+/**
+ * Selects a content based on condition when inside a `<Switch>` control flow
+ * @description https://docs.solidjs.com/reference/components/switch-and-match
+ */
+export declare function Match<T, F extends ConditionalRenderCallback<T>>(props: MatchProps<T, F>): JSX.Element;
+/**
+ * Catches uncaught errors inside components and renders a fallback content
+ * @description https://docs.solidjs.com/reference/components/error-boundary
+ */
+export declare function Errored(props: {
+    fallback: JSX.Element | ((err: any, reset: () => void) => JSX.Element);
+    children: JSX.Element;
+}): JSX.Element;
+/**
+ * Tracks all resources inside a component and renders a fallback until they are all resolved
+ * @description https://docs.solidjs.com/reference/components/suspense
+ */
+export declare function Loading(props: {
+    fallback?: JSX.Element;
+    on?: any;
+    children: JSX.Element;
+}): JSX.Element;
+export type RevealProps = {
+    order?: RevealOrder;
+    collapsed?: boolean;
+    children: JSX.Element;
+};
+/**
+ * Coordinates the reveal timing of sibling `<Loading>` boundaries during SSR.
+ *
+ * The `order` prop picks the reveal policy:
+ * - `"sequential"` (default) — boundaries reveal in streamed order; out-of-order
+ *   resolutions have their fragment HTML streamed into templates as data arrives,
+ *   but the swap from fallback to content waits until the frontier reaches them.
+ * - `"together"` — every direct slot holds its fallback until the whole group is
+ *   "minimally ready" (every direct slot has its own first visible content
+ *   available), then the whole group releases in a single activation.
+ * - `"natural"` — each boundary's swap is triggered as its own data resolves. At
+ *   the top level this is equivalent to omitting `<Reveal>`; the mode exists for
+ *   nesting, where the group registers as a single composite slot in an enclosing
+ *   `<Reveal>`.
+ *
+ * The `collapsed` prop is only consulted when `order="sequential"` (the default);
+ * it is ignored under `"together"` and `"natural"`.
+ *
+ * Nesting: a nested `<Reveal>` is held on its fallbacks until its parent releases
+ * the slot it occupies. HTML for resolved fragments still streams through normally;
+ * only the `revealFragments` swap calls are deferred. Once released, the inner
+ * group runs its own `order` locally over whatever is still pending. There is no
+ * escape hatch.
+ *
+ * Engine support:
+ * - `renderToString` fully supports `order="sequential"` (without `collapsed`) and
+ *   `order="natural"` because neither requires streamed activation.
+ * - `order="together"` and `collapsed` rely on streamed activation and require
+ *   `renderToStream` / `renderToStringAsync`. Using them inside a nested `<Reveal>`
+ *   under `renderToString` logs a warning.
+ *
+ * See `documentation/solid-2.0/03-control-flow.md` for the full outer/inner
+ * nesting matrix and the "minimally ready" definition per order.
+ *
+ * @description https://docs.solidjs.com/reference/components/reveal
+ */
+export declare function Reveal(props: RevealProps): JSX.Element;

package/types-cjs/server/hydration.d.cts

@@ -0,0 +1,63 @@
+import type { Context } from "./signals.cjs";
+import type { JSX } from "../jsx.cjs";
+export { sharedConfig, NoHydrateContext } from "./shared.cjs";
+export type { HydrationContext, SSRTemplateObject } from "./shared.cjs";
+export type ServerRevealGroup = {
+    id: string;
+    /**
+     * Register a child fragment (Loading) or composite child (inner Reveal).
+     * Returns `collapseFallback` (hide fallback visually, used for collapsed-sequential
+     * tail) and `held` (stash `revealFragments` swaps until the parent releases us).
+     * `held` only applies when the caller is a nested Reveal — Loadings ignore it.
+     */
+    register(key: string, options?: {
+        onActivate?: () => void;
+    }): {
+        collapseFallback: boolean;
+        held: boolean;
+    };
+    /** Called by a child when its subtree is fully resolved. */
+    onResolved(key: string): void;
+    /**
+     * Called by a nested Reveal when it becomes "minimally resolved" under its own
+     * order (together: fully resolved; sequential: first registered fragment resolved;
+     * natural: any fragment resolved). Loadings don't fire this — their `onResolved`
+     * implies minimal readiness at the same time.
+     */
+    onMinimallyResolved?(key: string): void;
+};
+export declare const RevealGroupContext: Context<ServerRevealGroup | null>;
+/**
+ * Handles errors during SSR rendering.
+ * Returns the promise source for NotReadyError (for async handling),
+ * or delegates to the ErrorContext handler.
+ */
+export declare function ssrHandleError(err: any): Promise<any> | undefined;
+/**
+ * Tracks all resources inside a component and renders a fallback until they are all resolved
+ *
+ * On the server, this is SSR-aware: it handles async mode (streaming) by registering
+ * fragments and resolving asynchronously, and sync mode by serializing fallback markers.
+ *
+ * @description https://docs.solidjs.com/reference/components/suspense
+ */
+export declare function createLoadingBoundary(fn: () => any, fallback: () => any, options?: {
+    on?: () => any;
+}): () => unknown;
+/**
+ * Disables hydration for its children during SSR.
+ * Elements inside will not receive hydration keys (`_hk`) and signals will not be serialized.
+ * Use `Hydration` to re-enable hydration within a `NoHydration` zone.
+ */
+export declare function NoHydration(props: {
+    children: JSX.Element;
+}): JSX.Element;
+/**
+ * Re-enables hydration within a `NoHydration` zone, establishing a new ID namespace.
+ * Pass an `id` prop matching the client's `hydrate({ renderId })` to align hydration keys.
+ * Has no effect when not inside a `NoHydration` zone (passthrough).
+ */
+export declare function Hydration(props: {
+    id?: string;
+    children: JSX.Element;
+}): JSX.Element;

package/types-cjs/server/index.d.cts

@@ -0,0 +1,12 @@
+export { $PROXY, $REFRESH, $TRACK, action, createEffect, createMemo, createOptimistic, createOptimisticStore, createErrorBoundary, createOwner, createProjection, createReaction, createRenderEffect, createRevealOrder, createRoot, createSignal, createStore, createTrackedEffect, deep, flatten, flush, getNextChildId, getObserver, getOwner, isDisposed, isEqual, isRefreshing, isPending, isWrappable, mapArray, merge, omit, onCleanup, onSettled, latest, reconcile, refresh, repeat, resolve, NotReadyError, runWithOwner, snapshot, storePath, createDeepProxy, enableExternalSource, enforceLoadingBoundary, untrack } from "./signals.cjs";
+export type { Accessor, ComputeFunction, EffectFunction, EffectOptions, ExternalSource, ExternalSourceConfig, ExternalSourceFactory, Merge, NoInfer, NotWrappable, Omit, Owner, Signal, SignalOptions, Setter, Store, SolidStore, StoreNode, StoreSetter, StorePathRange, ArrayFilterFn, CustomPartial, Part, PathSetter, PatchOp } from "./signals.cjs";
+export { $DEVCOMP, children, createContext, useContext, ssrRunInScope } from "./core.cjs";
+export type { ChildrenReturn, Context, ContextProviderComponent, ResolvedChildren, ResolvedJSXElement } from "./core.cjs";
+export * from "./component.cjs";
+export * from "./flow.cjs";
+export { sharedConfig, createLoadingBoundary, ssrHandleError, NoHydration, Hydration, NoHydrateContext } from "./hydration.cjs";
+export type { HydrationContext } from "./hydration.cjs";
+import type { JSX } from "../jsx.cjs";
+type JSXElement = JSX.Element;
+export type { JSXElement, JSX };
+export declare const DEV: undefined;

package/types-cjs/server/shared.d.cts

@@ -0,0 +1,50 @@
+import type { Context } from "@solidjs/signals";
+export type SSRTemplateObject = {
+    t: string[];
+    h: Function[];
+    p: Promise<any>[];
+};
+export type HydrationContext = {
+    id: string;
+    count: number;
+    /**
+     * Serialize a value for client hydration.
+     * In renderToStream (async: true), accepts promises and async iterables.
+     * In renderToString (async: false), only synchronous values are allowed —
+     * passing async values will throw.
+     */
+    serialize: (id: string, v: any, deferStream?: boolean) => void;
+    resolve(value: any): SSRTemplateObject;
+    ssr(template: string[], ...values: any[]): SSRTemplateObject;
+    escape(value: any): string;
+    replace: (id: string, replacement: () => any) => void;
+    block: (p: Promise<any>) => void;
+    registerFragment: (v: string, options?: {
+        revealGroup?: string;
+    }) => (v?: string, err?: any) => boolean;
+    revealFragments?: (groupOrKeys: string | string[]) => void;
+    revealFallbacks?: (groupOrKeys: string | string[]) => void;
+    /** Register a client-side asset URL discovered during SSR (e.g. from lazy()). */
+    registerAsset?: (type: "module" | "style", url: string) => void;
+    /** Register a moduleUrl-to-entryUrl mapping for the current boundary. */
+    registerModule?: (moduleUrl: string, entryUrl: string) => void;
+    /** Resolve a module's JS and CSS assets from the asset manifest. Set by dom-expressions. */
+    resolveAssets?: (moduleUrl: string) => {
+        js: string[];
+        css: string[];
+    } | null;
+    /** Retrieve the moduleUrl-to-entryUrl map for a boundary. */
+    getBoundaryModules?: (id: string) => Record<string, string> | null;
+    /** @internal Tracks which Loading boundary is currently rendering. Set by dom-expressions via applyAssetTracking(). */
+    _currentBoundaryId?: string | null;
+    assets: any[];
+    /** True only in renderToStream — enables async data serialization and streaming. */
+    async?: boolean;
+};
+export declare const NoHydrateContext: Context<boolean>;
+type SharedConfig = {
+    context?: HydrationContext;
+    getNextContextId(): string | undefined;
+};
+export declare const sharedConfig: SharedConfig;
+export {};

package/types-cjs/server/signals.d.cts

@@ -0,0 +1,87 @@
+export { createRoot, createOwner, runWithOwner, getOwner, isDisposed, onCleanup, getNextChildId, createContext, setContext, getContext, NotReadyError, NoOwnerError, ContextNotFoundError, isEqual, isWrappable, SUPPORTS_PROXY, enableExternalSource, enforceLoadingBoundary } from "@solidjs/signals";
+export { flatten } from "@solidjs/signals";
+export { snapshot, merge, omit, storePath, $PROXY, $REFRESH, $TRACK } from "@solidjs/signals";
+export type { Accessor, ComputeFunction, EffectFunction, EffectBundle, EffectOptions, ExternalSource, ExternalSourceConfig, ExternalSourceFactory, MemoOptions, NoInfer, SignalOptions, Setter, Signal, Owner, Maybe, Store, StoreSetter, StoreNode, NotWrappable, SolidStore, Merge, Omit, Context, ContextRecord, IQueue, StorePathRange, ArrayFilterFn, CustomPartial, Part, PathSetter } from "@solidjs/signals";
+import type { Accessor, ComputeFunction, EffectFunction, EffectBundle, EffectOptions, MemoOptions, SignalOptions, Signal, Owner, Store, StoreSetter, Context } from "@solidjs/signals";
+import { sharedConfig, NoHydrateContext } from "./shared.cjs";
+interface ServerComputation<T = any> {
+    owner: Owner;
+    value: T;
+    compute: ComputeFunction<any, T>;
+    error: unknown;
+    computed: boolean;
+    disposed: boolean;
+}
+type SsrSourceMode = "server" | "hybrid" | "client";
+type ServerSsrOptions = {
+    deferStream?: boolean;
+    ssrSource?: SsrSourceMode;
+};
+type ServerClientMemoOptions<T> = Omit<MemoOptions<T>, "ssrSource"> & {
+    ssrSource: "client";
+};
+type ServerMemoOptions<T> = Omit<MemoOptions<T>, "ssrSource"> & {
+    ssrSource?: "server" | "hybrid";
+};
+type ServerClientSignalOptions<T> = Omit<SignalOptions<T>, "ssrSource"> & {
+    ssrSource: "client";
+};
+type ServerSignalOptions<T> = Omit<SignalOptions<T>, "ssrSource"> & {
+    ssrSource?: "server" | "hybrid";
+};
+export declare function getObserver(): ServerComputation<any> | null;
+export declare function createSignal<T>(): Signal<T | undefined>;
+export declare function createSignal<T>(value: Exclude<T, Function>, options?: SignalOptions<T>): Signal<T>;
+export declare function createSignal<T>(fn: ComputeFunction<undefined | NoInfer<T>, T>, options: ServerClientSignalOptions<T>): Signal<T | undefined>;
+export declare function createSignal<T>(fn: ComputeFunction<undefined | NoInfer<T>, T>, options?: ServerSignalOptions<T>): Signal<T>;
+export declare function createMemo<T>(compute: ComputeFunction<undefined | NoInfer<T>, T>, options: ServerClientMemoOptions<T>): Accessor<T | undefined>;
+export declare function createMemo<T>(compute: ComputeFunction<undefined | NoInfer<T>, T>, options?: ServerMemoOptions<T>): Accessor<T>;
+export type PatchOp = [path: PropertyKey[]] | [path: PropertyKey[], value: any] | [path: PropertyKey[], value: any, insert: 1];
+export declare function createDeepProxy<T extends object>(target: T, patches: PatchOp[], basePath?: PropertyKey[]): T;
+export declare function createEffect<T>(compute: ComputeFunction<undefined | NoInfer<T>, T>, effect: EffectFunction<NoInfer<T>, T> | EffectBundle<NoInfer<T>, T>, options?: EffectOptions): void;
+export declare function createRenderEffect<T>(compute: ComputeFunction<undefined | NoInfer<T>, T>, effectFn: EffectFunction<NoInfer<T>, T>, options?: EffectOptions): void;
+export declare function createTrackedEffect(compute: () => void | (() => void), options?: {
+    name?: string;
+}): void;
+export declare function createReaction(effectFn: EffectFunction<undefined> | EffectBundle<undefined>, options?: EffectOptions): (tracking: () => void) => void;
+export declare function createOptimistic<T>(): Signal<T | undefined>;
+export declare function createOptimistic<T>(value: Exclude<T, Function>, options?: SignalOptions<T>): Signal<T>;
+export declare function createOptimistic<T>(fn: ComputeFunction<undefined | NoInfer<T>, T>, options: ServerClientSignalOptions<T>): Signal<T | undefined>;
+export declare function createOptimistic<T>(fn: ComputeFunction<undefined | NoInfer<T>, T>, options?: ServerSignalOptions<T>): Signal<T>;
+export declare function createStore<T extends object>(store: T | Store<T>): [get: Store<T>, set: StoreSetter<T>];
+export declare function createStore<T extends object>(fn: (store: T) => void | T | Promise<void | T>, store: Partial<T> | Store<T>): [get: Store<T>, set: StoreSetter<T>];
+export declare const createOptimisticStore: typeof createStore;
+export declare function createProjection<T extends object>(fn: (draft: T) => void | T | Promise<void | T> | AsyncIterable<void | T>, initialValue: Partial<T>, options?: ServerSsrOptions): Store<T>;
+export declare function reconcile<T extends U, U extends object>(value: T): (state: U) => T;
+export declare function deep<T extends object>(store: Store<T>): Store<T>;
+export declare function mapArray<T, U>(list: Accessor<readonly T[] | undefined | null | false>, mapFn: (v: Accessor<T>, i: Accessor<number>) => U, options?: {
+    keyed?: boolean | ((item: T) => any);
+    fallback?: Accessor<any>;
+}): () => U[];
+export declare function repeat<T>(count: Accessor<number>, mapFn: (i: number) => T, options?: {
+    fallback?: Accessor<any>;
+    from?: Accessor<number | undefined>;
+}): () => T[];
+declare const ErrorContext: Context<((err: any) => void) | null>;
+export { ErrorContext };
+export declare function runWithBoundaryErrorContext<T>(owner: Owner, render: () => T, onError: (err: any, parentHandler: ((err: any) => void) | null) => void, context?: NonNullable<typeof sharedConfig.context>, boundaryId?: string): T;
+export { NoHydrateContext };
+export declare function createErrorBoundary<U>(fn: () => any, fallback: (error: unknown, reset: () => void) => U): () => unknown;
+export declare function createLoadingBoundary(fn: () => any, fallback: () => any, options?: {
+    on?: () => any;
+}): () => unknown;
+export type RevealOrder = "sequential" | "together" | "natural";
+export declare function createRevealOrder<T>(fn: () => T, _options?: {
+    order?: () => RevealOrder;
+    collapsed?: () => boolean;
+}): T;
+export declare function untrack<T>(fn: () => T): T;
+export declare function flush(): void;
+export declare function resolve<T>(fn: () => T): Promise<T>;
+export declare function isPending(fn: () => any, fallback?: boolean): boolean;
+export declare function latest<T>(fn: () => T): T;
+export declare function isRefreshing(): boolean;
+export declare function refresh<T>(fn: () => T): T;
+export declare function action<T extends (...args: any[]) => any>(fn: T): T;
+export declare function onSettled(callback: () => void | (() => void)): void;
+type NoInfer<T extends any> = [T][T extends any ? 0 : never];