@kopai/ui 0.0.5 → 0.1.0

package/dist/index.d.cts

@@ -1,5 +1,303 @@
-//#region src/index.d.ts
-declare const name = "@kopai/ui";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import z$1, { z } from "zod";
+import { ComponentType, ReactNode } from "react";
+import { KopaiClient as KopaiClient$1 } from "@kopai/sdk";
+
+//#region src/pages/observability.d.ts
+declare function ObservabilityPage(): react_jsx_runtime0.JSX.Element;
 //#endregion
-export { name };
+//#region src/lib/component-catalog.d.ts
+declare const dataSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  method: z.ZodLiteral<"searchTracesPage">;
+  params: z.ZodObject<{
+    traceId: z.ZodOptional<z.ZodString>;
+    spanId: z.ZodOptional<z.ZodString>;
+    parentSpanId: z.ZodOptional<z.ZodString>;
+    serviceName: z.ZodOptional<z.ZodString>;
+    spanName: z.ZodOptional<z.ZodString>;
+    spanKind: z.ZodOptional<z.ZodString>;
+    statusCode: z.ZodOptional<z.ZodString>;
+    scopeName: z.ZodOptional<z.ZodString>;
+    timestampMin: z.ZodOptional<z.ZodString>;
+    timestampMax: z.ZodOptional<z.ZodString>;
+    durationMin: z.ZodOptional<z.ZodString>;
+    durationMax: z.ZodOptional<z.ZodString>;
+    spanAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    eventsAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    linksAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodOptional<z.ZodEnum<{
+      ASC: "ASC";
+      DESC: "DESC";
+    }>>;
+  }, z.core.$strip>;
+  refetchIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  method: z.ZodLiteral<"searchLogsPage">;
+  params: z.ZodObject<{
+    traceId: z.ZodOptional<z.ZodString>;
+    spanId: z.ZodOptional<z.ZodString>;
+    serviceName: z.ZodOptional<z.ZodString>;
+    scopeName: z.ZodOptional<z.ZodString>;
+    severityText: z.ZodOptional<z.ZodString>;
+    severityNumberMin: z.ZodOptional<z.ZodNumber>;
+    severityNumberMax: z.ZodOptional<z.ZodNumber>;
+    bodyContains: z.ZodOptional<z.ZodString>;
+    timestampMin: z.ZodOptional<z.ZodString>;
+    timestampMax: z.ZodOptional<z.ZodString>;
+    logAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    scopeAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodOptional<z.ZodEnum<{
+      ASC: "ASC";
+      DESC: "DESC";
+    }>>;
+  }, z.core.$strip>;
+  refetchIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  method: z.ZodLiteral<"searchMetricsPage">;
+  params: z.ZodObject<{
+    metricType: z.ZodEnum<{
+      Gauge: "Gauge";
+      Sum: "Sum";
+      Histogram: "Histogram";
+      ExponentialHistogram: "ExponentialHistogram";
+      Summary: "Summary";
+    }>;
+    metricName: z.ZodOptional<z.ZodString>;
+    serviceName: z.ZodOptional<z.ZodString>;
+    scopeName: z.ZodOptional<z.ZodString>;
+    timeUnixMin: z.ZodOptional<z.ZodString>;
+    timeUnixMax: z.ZodOptional<z.ZodString>;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    scopeAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodOptional<z.ZodEnum<{
+      ASC: "ASC";
+      DESC: "DESC";
+    }>>;
+  }, z.core.$strip>;
+  refetchIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  method: z.ZodLiteral<"getTrace">;
+  params: z.ZodObject<{
+    traceId: z.ZodString;
+  }, z.core.$strip>;
+  refetchIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  method: z.ZodLiteral<"discoverMetrics">;
+  params: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+  refetchIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "method">;
+declare const componentDefinitionSchema: z.ZodObject<{
+  hasChildren: z.ZodBoolean;
+  description: z.ZodString;
+  props: z.ZodUnknown;
+}, z.core.$strip>;
+type ElementVariantSchema<K extends string, Props extends z.ZodTypeAny> = z.ZodObject<{
+  key: z.ZodString;
+  type: z.ZodLiteral<K>;
+  children: z.ZodArray<z.ZodString>;
+  parentKey: z.ZodString;
+  dataSource: z.ZodOptional<typeof dataSourceSchema>;
+  props: Props;
+}>;
+type ElementVariantSchemas<C extends Record<string, {
+  props: unknown;
+}>> = { [K in keyof C & string]: ElementVariantSchema<K, C[K]["props"] extends z.ZodTypeAny ? C[K]["props"] : z.ZodUnknown> }[keyof C & string];
+/**
+ * Creates a component catalog with typed UI tree schema for validation.
+ *
+ * @param catalogConfig - Catalog configuration with name and component definitions
+ * @returns Catalog object with name, components, and generated uiTreeSchema
+ *
+ * @example
+ * ```ts
+ * const catalog = createCatalog({
+ *   name: "my-catalog",
+ *   components: {
+ *     Card: {
+ *       hasChildren: true,
+ *       description: "Container card",
+ *       props: z.object({ title: z.string() }),
+ *     },
+ *   },
+ * });
+ * ```
+ */
+declare function createCatalog<C extends Record<string, z.infer<typeof componentDefinitionSchema>>>(catalogConfig: {
+  name: string;
+  components: C;
+}): {
+  name: string;
+  components: C;
+  uiTreeSchema: z.ZodObject<{
+    root: z.ZodString;
+    elements: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[ElementVariantSchemas<C>, ...ElementVariantSchemas<C>[]], "type">>;
+  }, z.core.$strip>;
+};
+type ComponentDefinition = z.infer<typeof componentDefinitionSchema>;
+type InferProps<P> = P extends z.ZodTypeAny ? z.infer<P> : P;
+//#endregion
+//#region src/lib/generate-prompt-instructions.d.ts
+type Catalog$1 = {
+  name: string;
+  components: Record<string, {
+    hasChildren: boolean;
+    description: string;
+    props: unknown;
+  }>;
+  uiTreeSchema: z.ZodTypeAny;
+};
+/**
+ * Generates LLM prompt instructions from a catalog.
+ * Includes component docs, JSON schema, and usage examples.
+ *
+ * @param catalog - The catalog created via createCatalog
+ * @returns Markdown string with component docs, schema, and examples
+ *
+ * @example
+ * ```ts
+ * const instructions = generatePromptInstructions(catalog);
+ * const prompt = `Build a dashboard UI.\n\n${instructions}`;
+ * ```
+ */
+declare function generatePromptInstructions(catalog: Catalog$1): string;
+//#endregion
+//#region src/lib/renderer.d.ts
+type RegistryFromCatalog<C extends {
+  components: Record<string, ComponentDefinition>;
+}> = { [K in keyof C["components"]]: ComponentType<RendererComponentProps<C["components"][K]>> };
+type Catalog = ReturnType<typeof createCatalog>;
+type UITree = z$1.infer<Catalog["uiTreeSchema"]>;
+type UIElement = UITree["elements"][string];
+type RendererDataSource = {
+  method: string;
+  params?: Record<string, unknown>;
+};
+type BaseElement<Props> = {
+  key: string;
+  type: string;
+  children: string[];
+  parentKey: string;
+  dataSource?: RendererDataSource;
+  props: Props;
+};
+type WithData = {
+  hasData: true;
+  data: unknown;
+  loading: boolean;
+  error: Error | null;
+  refetch: () => void;
+  updateParams: (params: Record<string, unknown>) => void;
+};
+type WithoutData = {
+  hasData: false;
+};
+type RendererComponentProps<CD extends ComponentDefinition> = CD extends {
+  hasChildren: true;
+  props: infer P;
+} ? ({
+  element: BaseElement<InferProps<P>>;
+  children: ReactNode;
+} & WithoutData) | ({
+  element: BaseElement<InferProps<P>>;
+  children: ReactNode;
+} & WithData) : CD extends {
+  props: infer P;
+} ? ({
+  element: BaseElement<InferProps<P>>;
+} & WithoutData) | ({
+  element: BaseElement<InferProps<P>>;
+} & WithData) : never;
+/**
+ * Base props (no dataSource)
+ */
+interface ComponentRenderPropsBase {
+  element: UIElement;
+  children?: ReactNode;
+  hasData: false;
+}
+/**
+ * Props with dataSource
+ */
+interface ComponentRenderPropsWithData {
+  element: UIElement;
+  children?: ReactNode;
+  hasData: true;
+  data: unknown;
+  loading: boolean;
+  error: Error | null;
+  refetch: () => void;
+  updateParams: (params: Record<string, unknown>) => void;
+}
+/**
+ * Discriminated union for component render props
+ */
+type ComponentRenderProps = ComponentRenderPropsBase | ComponentRenderPropsWithData;
+/**
+ * Component renderer type
+ */
+type ComponentRenderer = ComponentType<ComponentRenderProps>;
+/**
+ * Creates a typed Renderer component bound to a catalog and component implementations.
+ *
+ * @param _catalog - The catalog created via createCatalog (used for type inference)
+ * @param components - React component implementations matching catalog definitions
+ * @returns A Renderer component that only needs `tree` and optional `fallback`
+ *
+ * @example
+ * ```tsx
+ * const DashboardRenderer = createRendererFromCatalog(catalog, {
+ *   Card: ({ element, children }) => <div className="card">{children}</div>,
+ *   Table: ({ element, data }) => <table>...</table>,
+ * });
+ *
+ * <DashboardRenderer tree={uiTree} />
+ * ```
+ */
+declare function createRendererFromCatalog<C extends {
+  components: Record<string, ComponentDefinition>;
+}>(_catalog: C, components: RegistryFromCatalog<C>): ({
+  tree,
+  fallback
+}: {
+  tree: UITree | null;
+  fallback?: ComponentRenderer;
+}) => react_jsx_runtime0.JSX.Element;
+/**
+ * Renders a UITree using a component registry.
+ * Prefer using {@link createRendererFromCatalog} for type-safe rendering.
+ */
+declare function Renderer<C extends {
+  components: Record<string, ComponentDefinition>;
+}>({
+  tree,
+  registry,
+  fallback
+}: {
+  tree: z$1.infer<ReturnType<typeof createCatalog>["uiTreeSchema"]> | null;
+  registry: RegistryFromCatalog<C>;
+  fallback?: ComponentRenderer;
+}): react_jsx_runtime0.JSX.Element | null;
+//#endregion
+//#region src/providers/kopai-provider.d.ts
+type KopaiClient = Pick<KopaiClient$1, "searchTracesPage" | "searchLogsPage" | "searchMetricsPage" | "getTrace" | "discoverMetrics">;
+interface KopaiSDKProviderProps {
+  client: KopaiClient;
+  children: ReactNode;
+}
+declare function KopaiSDKProvider({
+  client,
+  children
+}: KopaiSDKProviderProps): react_jsx_runtime0.JSX.Element;
+declare function useKopaiSDK(): KopaiClient;
+//#endregion
+export { type ComponentRenderProps, type ComponentRenderer, type KopaiClient, KopaiSDKProvider, ObservabilityPage, Renderer, type RendererComponentProps, createCatalog, createRendererFromCatalog, generatePromptInstructions, useKopaiSDK };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";cAAa,IAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/pages/observability.tsx","../src/lib/component-catalog.ts","../src/lib/generate-prompt-instructions.ts","../src/lib/renderer.tsx","../src/providers/kopai-provider.tsx"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,5 +1,304 @@
-//#region src/index.d.ts
-declare const name = "@kopai/ui";
+import { ComponentType, ReactNode } from "react";
+import { QueryClient } from "@tanstack/react-query";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { KopaiClient as KopaiClient$1 } from "@kopai/sdk";
+import z$1, { z } from "zod";
+
+//#region src/pages/observability.d.ts
+declare function ObservabilityPage(): react_jsx_runtime0.JSX.Element;
 //#endregion
-export { name };
+//#region src/lib/component-catalog.d.ts
+declare const dataSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  method: z.ZodLiteral<"searchTracesPage">;
+  params: z.ZodObject<{
+    traceId: z.ZodOptional<z.ZodString>;
+    spanId: z.ZodOptional<z.ZodString>;
+    parentSpanId: z.ZodOptional<z.ZodString>;
+    serviceName: z.ZodOptional<z.ZodString>;
+    spanName: z.ZodOptional<z.ZodString>;
+    spanKind: z.ZodOptional<z.ZodString>;
+    statusCode: z.ZodOptional<z.ZodString>;
+    scopeName: z.ZodOptional<z.ZodString>;
+    timestampMin: z.ZodOptional<z.ZodString>;
+    timestampMax: z.ZodOptional<z.ZodString>;
+    durationMin: z.ZodOptional<z.ZodString>;
+    durationMax: z.ZodOptional<z.ZodString>;
+    spanAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    eventsAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    linksAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodOptional<z.ZodEnum<{
+      ASC: "ASC";
+      DESC: "DESC";
+    }>>;
+  }, z.core.$strip>;
+  refetchIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  method: z.ZodLiteral<"searchLogsPage">;
+  params: z.ZodObject<{
+    traceId: z.ZodOptional<z.ZodString>;
+    spanId: z.ZodOptional<z.ZodString>;
+    serviceName: z.ZodOptional<z.ZodString>;
+    scopeName: z.ZodOptional<z.ZodString>;
+    severityText: z.ZodOptional<z.ZodString>;
+    severityNumberMin: z.ZodOptional<z.ZodNumber>;
+    severityNumberMax: z.ZodOptional<z.ZodNumber>;
+    bodyContains: z.ZodOptional<z.ZodString>;
+    timestampMin: z.ZodOptional<z.ZodString>;
+    timestampMax: z.ZodOptional<z.ZodString>;
+    logAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    scopeAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodOptional<z.ZodEnum<{
+      ASC: "ASC";
+      DESC: "DESC";
+    }>>;
+  }, z.core.$strip>;
+  refetchIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  method: z.ZodLiteral<"searchMetricsPage">;
+  params: z.ZodObject<{
+    metricType: z.ZodEnum<{
+      Gauge: "Gauge";
+      Sum: "Sum";
+      Histogram: "Histogram";
+      ExponentialHistogram: "ExponentialHistogram";
+      Summary: "Summary";
+    }>;
+    metricName: z.ZodOptional<z.ZodString>;
+    serviceName: z.ZodOptional<z.ZodString>;
+    scopeName: z.ZodOptional<z.ZodString>;
+    timeUnixMin: z.ZodOptional<z.ZodString>;
+    timeUnixMax: z.ZodOptional<z.ZodString>;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    scopeAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodOptional<z.ZodEnum<{
+      ASC: "ASC";
+      DESC: "DESC";
+    }>>;
+  }, z.core.$strip>;
+  refetchIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  method: z.ZodLiteral<"getTrace">;
+  params: z.ZodObject<{
+    traceId: z.ZodString;
+  }, z.core.$strip>;
+  refetchIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  method: z.ZodLiteral<"discoverMetrics">;
+  params: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+  refetchIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "method">;
+declare const componentDefinitionSchema: z.ZodObject<{
+  hasChildren: z.ZodBoolean;
+  description: z.ZodString;
+  props: z.ZodUnknown;
+}, z.core.$strip>;
+type ElementVariantSchema<K extends string, Props extends z.ZodTypeAny> = z.ZodObject<{
+  key: z.ZodString;
+  type: z.ZodLiteral<K>;
+  children: z.ZodArray<z.ZodString>;
+  parentKey: z.ZodString;
+  dataSource: z.ZodOptional<typeof dataSourceSchema>;
+  props: Props;
+}>;
+type ElementVariantSchemas<C extends Record<string, {
+  props: unknown;
+}>> = { [K in keyof C & string]: ElementVariantSchema<K, C[K]["props"] extends z.ZodTypeAny ? C[K]["props"] : z.ZodUnknown> }[keyof C & string];
+/**
+ * Creates a component catalog with typed UI tree schema for validation.
+ *
+ * @param catalogConfig - Catalog configuration with name and component definitions
+ * @returns Catalog object with name, components, and generated uiTreeSchema
+ *
+ * @example
+ * ```ts
+ * const catalog = createCatalog({
+ *   name: "my-catalog",
+ *   components: {
+ *     Card: {
+ *       hasChildren: true,
+ *       description: "Container card",
+ *       props: z.object({ title: z.string() }),
+ *     },
+ *   },
+ * });
+ * ```
+ */
+declare function createCatalog<C extends Record<string, z.infer<typeof componentDefinitionSchema>>>(catalogConfig: {
+  name: string;
+  components: C;
+}): {
+  name: string;
+  components: C;
+  uiTreeSchema: z.ZodObject<{
+    root: z.ZodString;
+    elements: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[ElementVariantSchemas<C>, ...ElementVariantSchemas<C>[]], "type">>;
+  }, z.core.$strip>;
+};
+type ComponentDefinition = z.infer<typeof componentDefinitionSchema>;
+type InferProps<P> = P extends z.ZodTypeAny ? z.infer<P> : P;
+//#endregion
+//#region src/lib/generate-prompt-instructions.d.ts
+type Catalog$1 = {
+  name: string;
+  components: Record<string, {
+    hasChildren: boolean;
+    description: string;
+    props: unknown;
+  }>;
+  uiTreeSchema: z.ZodTypeAny;
+};
+/**
+ * Generates LLM prompt instructions from a catalog.
+ * Includes component docs, JSON schema, and usage examples.
+ *
+ * @param catalog - The catalog created via createCatalog
+ * @returns Markdown string with component docs, schema, and examples
+ *
+ * @example
+ * ```ts
+ * const instructions = generatePromptInstructions(catalog);
+ * const prompt = `Build a dashboard UI.\n\n${instructions}`;
+ * ```
+ */
+declare function generatePromptInstructions(catalog: Catalog$1): string;
+//#endregion
+//#region src/lib/renderer.d.ts
+type RegistryFromCatalog<C extends {
+  components: Record<string, ComponentDefinition>;
+}> = { [K in keyof C["components"]]: ComponentType<RendererComponentProps<C["components"][K]>> };
+type Catalog = ReturnType<typeof createCatalog>;
+type UITree = z$1.infer<Catalog["uiTreeSchema"]>;
+type UIElement = UITree["elements"][string];
+type RendererDataSource = {
+  method: string;
+  params?: Record<string, unknown>;
+};
+type BaseElement<Props> = {
+  key: string;
+  type: string;
+  children: string[];
+  parentKey: string;
+  dataSource?: RendererDataSource;
+  props: Props;
+};
+type WithData = {
+  hasData: true;
+  data: unknown;
+  loading: boolean;
+  error: Error | null;
+  refetch: () => void;
+  updateParams: (params: Record<string, unknown>) => void;
+};
+type WithoutData = {
+  hasData: false;
+};
+type RendererComponentProps<CD extends ComponentDefinition> = CD extends {
+  hasChildren: true;
+  props: infer P;
+} ? ({
+  element: BaseElement<InferProps<P>>;
+  children: ReactNode;
+} & WithoutData) | ({
+  element: BaseElement<InferProps<P>>;
+  children: ReactNode;
+} & WithData) : CD extends {
+  props: infer P;
+} ? ({
+  element: BaseElement<InferProps<P>>;
+} & WithoutData) | ({
+  element: BaseElement<InferProps<P>>;
+} & WithData) : never;
+/**
+ * Base props (no dataSource)
+ */
+interface ComponentRenderPropsBase {
+  element: UIElement;
+  children?: ReactNode;
+  hasData: false;
+}
+/**
+ * Props with dataSource
+ */
+interface ComponentRenderPropsWithData {
+  element: UIElement;
+  children?: ReactNode;
+  hasData: true;
+  data: unknown;
+  loading: boolean;
+  error: Error | null;
+  refetch: () => void;
+  updateParams: (params: Record<string, unknown>) => void;
+}
+/**
+ * Discriminated union for component render props
+ */
+type ComponentRenderProps = ComponentRenderPropsBase | ComponentRenderPropsWithData;
+/**
+ * Component renderer type
+ */
+type ComponentRenderer = ComponentType<ComponentRenderProps>;
+/**
+ * Creates a typed Renderer component bound to a catalog and component implementations.
+ *
+ * @param _catalog - The catalog created via createCatalog (used for type inference)
+ * @param components - React component implementations matching catalog definitions
+ * @returns A Renderer component that only needs `tree` and optional `fallback`
+ *
+ * @example
+ * ```tsx
+ * const DashboardRenderer = createRendererFromCatalog(catalog, {
+ *   Card: ({ element, children }) => <div className="card">{children}</div>,
+ *   Table: ({ element, data }) => <table>...</table>,
+ * });
+ *
+ * <DashboardRenderer tree={uiTree} />
+ * ```
+ */
+declare function createRendererFromCatalog<C extends {
+  components: Record<string, ComponentDefinition>;
+}>(_catalog: C, components: RegistryFromCatalog<C>): ({
+  tree,
+  fallback
+}: {
+  tree: UITree | null;
+  fallback?: ComponentRenderer;
+}) => react_jsx_runtime0.JSX.Element;
+/**
+ * Renders a UITree using a component registry.
+ * Prefer using {@link createRendererFromCatalog} for type-safe rendering.
+ */
+declare function Renderer<C extends {
+  components: Record<string, ComponentDefinition>;
+}>({
+  tree,
+  registry,
+  fallback
+}: {
+  tree: z$1.infer<ReturnType<typeof createCatalog>["uiTreeSchema"]> | null;
+  registry: RegistryFromCatalog<C>;
+  fallback?: ComponentRenderer;
+}): react_jsx_runtime0.JSX.Element | null;
+//#endregion
+//#region src/providers/kopai-provider.d.ts
+type KopaiClient = Pick<KopaiClient$1, "searchTracesPage" | "searchLogsPage" | "searchMetricsPage" | "getTrace" | "discoverMetrics">;
+interface KopaiSDKProviderProps {
+  client: KopaiClient;
+  children: ReactNode;
+}
+declare function KopaiSDKProvider({
+  client,
+  children
+}: KopaiSDKProviderProps): react_jsx_runtime0.JSX.Element;
+declare function useKopaiSDK(): KopaiClient;
+//#endregion
+export { type ComponentRenderProps, type ComponentRenderer, type KopaiClient, KopaiSDKProvider, ObservabilityPage, Renderer, type RendererComponentProps, createCatalog, createRendererFromCatalog, generatePromptInstructions, useKopaiSDK };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";cAAa,IAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/pages/observability.tsx","../src/lib/component-catalog.ts","../src/lib/generate-prompt-instructions.ts","../src/lib/renderer.tsx","../src/providers/kopai-provider.tsx"],"mappings":"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"}