@olonjs/react 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,194 @@
+import { AssetsConfig } from '@olonjs/core';
+import { buildThemeVariableMap } from '@olonjs/core';
+import { Component } from 'react';
+import { Context } from 'react';
+import { default as default_2 } from 'react';
+import { ErrorInfo } from 'react';
+import { JsonPagesConfig } from '@olonjs/core';
+import { JSX } from 'react/jsx-runtime';
+import { LucideIcon } from 'lucide-react';
+import { MenuConfig } from '@olonjs/core';
+import { MenuItem } from '@olonjs/core';
+import { PageConfig } from '@olonjs/core';
+import { PageMeta } from '@olonjs/core';
+import { PageRendererProps } from '@olonjs/core';
+import { ReactNode } from 'react';
+import { Section } from '@olonjs/core';
+import { SiteConfig } from '@olonjs/core';
+import { StudioRouteBodyProps } from '@olonjs/studio';
+import { ThemeConfig } from '@olonjs/core';
+
+export { buildThemeVariableMap }
+
+export declare interface ConfigContextValue {
+    registry: Registry;
+    schemas: Schemas;
+    tenantId?: string;
+    basePath?: string;
+    assets?: AssetsConfig;
+    overlayDisabledSectionTypes?: string[];
+}
+
+export declare const ConfigProvider: default_2.FC<{
+    config: Pick<JsonPagesConfig, 'registry' | 'schemas' | 'tenantId' | 'basePath' | 'assets' | 'overlayDisabledSectionTypes'>;
+    children: default_2.ReactNode;
+}>;
+
+export declare const DefaultNotFound: default_2.FC;
+
+/**
+ * Engine-level error boundary: prevents black screen on any render error
+ * and surfaces a visible error UI.
+ */
+export declare class EngineErrorBoundary extends Component<{
+    children: ReactNode;
+}, {
+    hasError: boolean;
+    error: Error | null;
+}> {
+    constructor(props: {
+        children: ReactNode;
+    });
+    static getDerivedStateFromError(error: Error): {
+        hasError: boolean;
+        error: Error;
+    };
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    render(): string | number | bigint | boolean | Iterable<default_2.ReactNode> | Promise<string | number | bigint | boolean | default_2.ReactPortal | default_2.ReactElement<unknown, string | default_2.JSXElementConstructor<any>> | Iterable<default_2.ReactNode> | null | undefined> | JSX.Element | null | undefined;
+}
+
+export declare interface FormState {
+    status: FormStatus;
+    message: string;
+}
+
+export declare type FormStatus = 'idle' | 'submitting' | 'success' | 'error';
+
+export declare type IconRegistry = Record<string, LucideIcon>;
+
+export declare const IconRegistryContext: Context<IconRegistry>;
+
+export declare function JsonPagesEngine({ config }: JsonPagesEngineProps): JSX.Element;
+
+export declare interface JsonPagesEngineProps {
+    config: JsonPagesConfig;
+}
+
+/**
+ * Context holding the submission state of every olon-managed form,
+ * keyed by the form's id attribute (or anchorId).
+ * Provided by App.tsx via useOlonForms().
+ */
+export declare const OlonFormsContext: Context<Record<string, FormState>>;
+
+export declare function OlonJSEngine({ config }: OlonJSEngineProps): JSX.Element;
+
+export declare interface OlonJSEngineProps {
+    config: JsonPagesConfig;
+}
+
+export declare const PageRenderer: default_2.FC<Props>;
+
+export declare const PreviewEntry: default_2.FC;
+
+export declare const PreviewRoute: default_2.FC<PreviewRouteProps>;
+
+export declare interface PreviewRouteProps {
+    tenantCss: string;
+    adminCss: string;
+}
+
+declare type Props = PageRendererProps & {
+    onReorder?: (sectionId: string, newIndex: number) => void;
+    scrollToSectionId?: string | null;
+    onActiveSectionChange?: (sectionId: string | null) => void;
+};
+
+declare type Registry = JsonPagesConfig['registry'];
+
+declare type Schemas = JsonPagesConfig['schemas'];
+
+export declare const SectionRenderer: default_2.FC<SectionRendererProps>;
+
+declare interface SectionRendererProps {
+    section: Section;
+    menu?: MenuItem[];
+    selectedId?: string | null;
+    reorderable?: boolean;
+    sectionIndex?: number;
+    totalSections?: number;
+    onReorder?: (sectionId: string, newIndex: number) => void;
+}
+
+declare interface StudioContextType {
+    mode: StudioMode;
+}
+
+declare type StudioMode = 'visitor' | 'studio';
+
+export declare const StudioProvider: default_2.FC<{
+    mode: StudioMode;
+    children: ReactNode;
+}>;
+
+export declare const StudioRoute: default_2.FC<StudioRouteProps>;
+
+/**
+ * Thin composition bridge: wires up the react-bound `ThemeLoader` /
+ * `StudioProvider` context around `@olonjs/studio`'s `StudioRouteBody`.
+ *
+ * Per ADR-0016 D2/D6, `@olonjs/studio` is never a static import anywhere in
+ * this package — only the `import type` above (erased at compile time) and
+ * the dynamic `import('@olonjs/studio')` below. This is the single bridge
+ * point where the optional Studio dependency actually loads, and it only
+ * loads when a consumer's router mounts this component (i.e. navigates to
+ * `/admin`).
+ */
+export declare interface StudioRouteProps extends StudioRouteBodyProps {
+    tenantCss: string;
+    adminCss: string;
+}
+
+export declare const ThemeLoader: default_2.FC<ThemeLoaderProps>;
+
+export declare interface ThemeLoaderProps {
+    mode: 'tenant' | 'admin';
+    tenantCss: string;
+    adminCss: string;
+    children: default_2.ReactNode;
+}
+
+export declare const themeManager: {
+    setTheme: (theme: ThemeConfig) => void;
+};
+
+export declare function useConfig(): ConfigContextValue;
+
+export declare const useDocumentMeta: (meta: PageMeta) => void;
+
+/**
+ * Read the submission state for a specific form.
+ * @param formId - must match the id attribute on the <form> element.
+ */
+export declare function useFormState(formId: string): FormState;
+
+export declare const useIconRegistry: () => IconRegistry;
+
+export declare const useStudio: () => StudioContextType;
+
+export declare const VisitorRoute: default_2.FC<VisitorRouteProps>;
+
+export declare interface VisitorRouteProps {
+    pageRegistry: Record<string, PageConfig>;
+    siteConfig: SiteConfig;
+    menuConfig: MenuConfig;
+    themeConfig: JsonPagesConfig['themeConfig'];
+    collections?: JsonPagesConfig['collections'];
+    collectionSchemas?: JsonPagesConfig['collectionSchemas'];
+    refDocuments?: JsonPagesConfig['refDocuments'];
+    tenantCss: string;
+    adminCss: string;
+    NotFoundComponent: default_2.ComponentType;
+}
+
+export { }