setti 0.0.0-stage → 0.1.0-alpha.0

package/dist/client/index.d.ts

@@ -0,0 +1,180 @@
+export { J as JsonRpcErrorPayload, N as NixoError, a as NixoErrorBoundary, b as NixoErrorBoundaryProps, c as NixoLoading, d as NixoNotFound, e as NixoRpcError, S as NixoService, R as Remote, f as computePath, g as defineGlobalLoader, h as defineNixoConfig, i as defineRoute } from '../not-found-fz-2RDV6.js';
+import { S as SliceRegistry, N as NixoClientRouter, A as AbstractSlice } from '../prefetch-Bp9dMSTK.js';
+export { a as AuthRequirement, C as CrudOp, F as FactoryDef, b as FactoryImplementation, c as FactoryMap, H as HttpMethod, I as IBinding, M as Manifest, d as ManifestEntry, e as MiddlewareDef, f as ModuleKind, g as NixoConfig, h as NixoRoute, i as NixoRouter, P as PrefetchContext, j as PrefetchRegistry, k as PrefetchResult, l as PrefetchSliceInfo, R as ResolvedNixoConfig, m as ResolvedRpcOptions, n as RouteTree, o as RpcContext, p as RpcExecutor, q as RpcMethodDefinition, r as RpcObjectDefinition, s as RpcOptions, t as RpcParamsSchema, u as ScanResult, v as ServerPluginDef, w as ServerPluginsOptions, x as ServerRoute, y as ServiceOptions, z as Slice, B as SliceListener, D as SliceUpdater, E as StandardSchemaV1, G as runGlobalPrefetch, J as runPagePrefetch, K as runPrefetch } from '../prefetch-Bp9dMSTK.js';
+import { PropsWithChildren, ReactNode, ComponentType } from 'react';
+export { parse as devalueParse, stringify as devalueStringify } from 'devalue';
+import 'fastify';
+
+/** Значение контекста nixo (клиент). */
+interface NixoContextValue {
+    /** Реестр слайсов. */
+    sliceRegistry: SliceRegistry;
+    /** Текущий роутер (controlled из client-entry). */
+    router: NixoClientRouter;
+}
+/** Пропсы провайдера. */
+type NixoProviderProps = PropsWithChildren<{
+    /** Реестр слайсов. */
+    sliceRegistry: SliceRegistry;
+    /** Текущий роутер (controlled — обновляется через повторный render). */
+    router: NixoClientRouter;
+}>;
+/**
+ * Провайдер фреймворка: прокидывает реестр слайсов и router в дерево React.
+ *
+ * `router` — **controlled prop**. Не хранит собственный state. При навигации
+ * client-entry делает `rootRef.render(<NixoProvider router={newRouter} ...>)`,
+ * и `usePathname`/`useParams`/`useQuery` сразу видят новое значение.
+ *
+ * @param props пропсы.
+ * @returns элемент провайдера.
+ */
+declare function NixoProvider(props: NixoProviderProps): ReactNode;
+/**
+ * Достаёт контекст nixo.
+ *
+ * @returns значение контекста.
+ * @throws {NixoError} если провайдера нет.
+ */
+declare function useResourceContext(): NixoContextValue;
+
+/**
+ * Подписка на state слайса.
+ *
+ * Возвращает `undefined`, если слайса нет. Не бросает.
+ *
+ * @param key имя слайса.
+ * @returns слайс или undefined.
+ */
+declare function useSlice<S extends AbstractSlice<unknown>>(key: string): S | undefined;
+
+/**
+ * Строгий вариант `useSlice`: бросает, если слайса нет.
+ *
+ * @param key имя слайса.
+ * @returns слайс.
+ * @throws NixoError если слайса нет в реестре.
+ */
+declare function useStrictSlice<S extends AbstractSlice<unknown>>(key: string): S;
+
+/**
+ * Подписка только на присутствие слайса (без подписки на state).
+ *
+ * @param key имя слайса.
+ * @returns слайс или undefined.
+ */
+declare function useSliceRef<S extends AbstractSlice<unknown>>(key: string): S | undefined;
+
+/** Опции внутреннего хука. */
+interface UseSliceInternalOptions {
+    /** Подписка на state (true) или только на присутствие слайса (false). */
+    observeState?: boolean;
+    /** Кидать, если slice не найден. */
+    strict?: boolean;
+}
+/**
+ * Внутренняя реализация `useSlice`.
+ *
+ * `S` — конкретный тип слайса; реестр хранит `AbstractSlice<unknown>`,
+ * каст в точке возврата — ответственность вызывающего.
+ *
+ * @param key имя слайса.
+ * @param options опции (observeState, strict).
+ * @returns слайс или undefined (в strict-режиме — только слайс).
+ */
+declare function useSliceInternal<S extends AbstractSlice<unknown>>(key: string, options?: UseSliceInternalOptions): S | undefined;
+
+/** Результат `useRouter`. */
+interface NixoRouterApi {
+    /** Перейти на путь, добавить в history. */
+    push: (path: string) => Promise<void>;
+    /** Заменить текущий путь без записи в history. */
+    replace: (path: string) => Promise<void>;
+    /** Назад. */
+    back: () => void;
+    /** Прогреть данные для маршрута (без навигации). */
+    prefetch: (path: string) => Promise<void>;
+}
+/**
+ * Императивные операции роутера.
+ *
+ * Реализация — в виртуальном client-entry (`window.__nixoNavigate`).
+ *
+ * @returns API роутера.
+ */
+declare function useRouter(): NixoRouterApi;
+
+/**
+ * Динамические сегменты текущего маршрута (Phase 2.5, пока `{}`).
+ *
+ * @returns объект `params`.
+ */
+declare function useParams(): Record<string, string>;
+
+/**
+ * Query-параметры текущего URL.
+ *
+ * @returns объект `query`.
+ */
+declare function useQuery(): Record<string, string>;
+
+/**
+ * Текущий путь.
+ *
+ * @returns pathname.
+ */
+declare function usePathname(): string;
+
+/** Пропсы `<Link>`. */
+interface LinkProps {
+    /** Целевой путь. */
+    href: string;
+    /** Дочерние элементы. */
+    children?: ReactNode;
+    /** Прогревать данные на hover. */
+    prefetch?: boolean;
+    /** CSS-класс. */
+    className?: string;
+}
+/**
+ * Клиентская ссылка. Перехватывает клик, использует SPA-навигацию.
+ *
+ * @param props пропсы.
+ * @returns `<a>` с перехватом клика.
+ */
+declare function Link(props: LinkProps): ReactNode;
+
+/**
+ * Slot для дочернего контента во вложенных layouts.
+ *
+ * Альтернатива `props.children`: layout может рендерить `<Outlet/>`
+ * вместо `{children}`. Оба варианта работают одновременно.
+ *
+ * @returns дочерний элемент или `null`.
+ */
+declare function Outlet(): ReactNode;
+/**
+ * Провайдер для `<Outlet/>`. Используется внутренне `renderLayoutChain`.
+ *
+ * @param props пропсы.
+ * @param props.content дочерний ReactNode (то, что увидит `<Outlet/>`).
+ * @param props.children сам layout (передаётся как React children).
+ * @returns элемент-обёртка.
+ */
+declare function OutletProvider(props: {
+    content: ReactNode;
+    children?: ReactNode;
+}): ReactNode;
+/**
+ * Оборачивает страницу цепочкой layouts.
+ *
+ * `layouts` — от root к leaf. Каждый получает и `children` (следующий
+ * уровень), и контекст для `<Outlet/>`.
+ *
+ * @param page страница (или компонент `<Template/>`).
+ * @param layouts цепочка layouts (root → leaf).
+ * @returns вложенный ReactNode.
+ */
+declare function renderLayoutChain(page: ReactNode, layouts: ComponentType[]): ReactNode;
+
+export { AbstractSlice, Link, type LinkProps, NixoClientRouter, type NixoContextValue, NixoProvider, type NixoProviderProps, type NixoRouterApi, Outlet, OutletProvider, SliceRegistry, type UseSliceInternalOptions, renderLayoutChain, useParams, usePathname, useQuery, useResourceContext, useRouter, useSlice, useSliceInternal, useSliceRef, useStrictSlice };