@superblocksteam/library 2.0.175-next.0 → 2.0.176-next.0

package/dist/lib/index.d.ts

@@ -3,16 +3,22 @@ import { DataRouter, Location, Params } from "react-router";
 import { EditorConfig, EvaluateOrValueComputedArgs, Property, TailwindPropertyKey } from "@superblocksteam/library-shared";
 import * as React$2 from "react";
 import React$1, { ReactNode, createElement } from "react";
-import { PlaceholderInfo, Profile } from "@superblocksteam/shared";
+import { OrchestratorViewMode, PlaceholderInfo, Profile } from "@superblocksteam/shared";
 import { AiContextMode, AppToEditorMessage, Catalog, ComponentRegistryShareState, ConsoleLogEntry, CreateChild, CreateChild as CreateChild$1, DeleteMeLibraryApi, EditorConfig as EditorConfig$1, Entity, EntityOutputProp, ExecutionTimingBreakdown, InitData, InteractionMode, LoadErrorMessageTypesMap, PayloadAction, PropertyInfo, RuntimeErrorData, SbApiRunOptions, SbElement, SbSelector, SourceLocation, UrlState, ViteMessage, ViteMessageKind, WithBindingIdentifier } from "@superblocksteam/library-shared/types";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import { CompiledApi, IntegrationDeclaration } from "@superblocksteam/sdk-api";
 import { Graph } from "@dagrejs/graphlib";
+import { XYCoord } from "react-dnd";
+
+//#region src/lib/internal-details/scope/types.d.ts
 declare const AppMode: {
   readonly EDIT: "EDIT";
   readonly PUBLISHED: "PUBLISHED";
   readonly PREVIEW: "PREVIEW";
 };
 type AppMode = (typeof AppMode)[keyof typeof AppMode];
+//#endregion
+//#region src/lib/internal-details/superblocks-context.d.ts
 type User = {
   name: string;
   email: string;
@@ -64,28 +70,39 @@ declare class SuperblocksAppContext {
     };
   } | undefined;
 }
-export declare function useSuperblocksUser(): User | undefined;
-export declare function useSuperblocksGroups(): Group[] | undefined;
-export declare function useSuperblocksDataTags(): {
+declare function useSuperblocksUser(): User | undefined;
+declare function useSuperblocksGroups(): Group[] | undefined;
+declare function useSuperblocksDataTags(): {
   dataTags: DataTags | undefined;
   setDataTag: (dataTagKey: string) => void;
 };
 /** @deprecated Use useSuperblocksDataTags instead */
-export declare function useSuperblocksProfiles(): {
+declare function useSuperblocksProfiles(): {
   profiles: DataTags | undefined;
   setProfile: (dataTagKey: string) => void;
 };
-export declare function getAppMode(): AppMode | undefined;
-declare const SbProvider: ({ name, children, className, context }: {
+declare function getAppMode(): AppMode | undefined;
+//#endregion
+//#region src/lib/user-facing/sb-provider.d.ts
+declare const SbProvider: ({
+  name,
+  children,
+  className,
+  context
+}: {
   name?: string;
   children?: React$1.ReactNode;
   className?: string;
   context?: SuperblocksAppContext;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/lib/internal-details/lib/evaluator/entity-types.d.ts
 type SingleInputProp<T = EntityOutputProp, ARGS extends any[] = any[]> = T extends Callback ? Callback<ARGS> : T;
-type NestedInputProp<T, ARGS extends any[] = any[]> = T extends object ? { [K in keyof T]: SingleInputProp<T[K], ARGS> | NestedInputProp<T[K], ARGS>; } : never;
+type NestedInputProp<T, ARGS extends any[] = any[]> = T extends object ? { [K in keyof T]: SingleInputProp<T[K], ARGS> | NestedInputProp<T[K], ARGS> } : never;
 type InputProp<T = EntityOutputProp, ARGS extends any[] = any[]> = SingleInputProp<T, ARGS> | NestedInputProp<T, ARGS>;
 type EntityFunction<ARGS extends any[] = any[], R = EntityOutputProp> = (this: Entity, ...ARGS: ARGS) => R;
+//#endregion
+//#region src/edit-mode/runtime-graph/types.d.ts
 type ComponentNode = {
   selectorId: SbSelector;
   sourceId: SbElement;
@@ -97,6 +114,8 @@ type ComponentNode = {
   nearestSelectableAncestor: SbSelector | undefined;
   displayName: string;
 };
+//#endregion
+//#region src/edit-mode/features/runtime-tracking-store.d.ts
 declare class RuntimeTrackingStore {
   readonly editStore: EditStore | undefined;
   constructor(editStore: EditStore | undefined);
@@ -142,6 +161,8 @@ declare class RuntimeTrackingStore {
    */
   getOutermostComponentForFirstRenderedTag(anchorSelectorId: SbSelector): SbSelector | undefined;
 }
+//#endregion
+//#region src/edit-mode/features/ai-store.d.ts
 declare class AiManager {
   private readonly runtimeTrackingStore;
   private _isTaggingEnabled;
@@ -185,6 +206,8 @@ declare class AiManager {
   private removeAllSharedSelectors;
   private removeAllSelectorsForSource;
 }
+//#endregion
+//#region src/edit-mode/features/connection-manager.d.ts
 type ConnectionStatus = "pre-init" | "disconnected" | "connecting" | "connected";
 declare class ConnectionManager {
   connectionStatus: ConnectionStatus;
@@ -193,9 +216,13 @@ declare class ConnectionManager {
   connect(): void;
   disconnect(): void;
 }
+//#endregion
+//#region src/edit-mode/features/operation-store.d.ts
 declare class OperationManager {
   ensureFilesSynced(): Promise<void>;
 }
+//#endregion
+//#region src/edit-mode/features/ui-store.d.ts
 declare class UIStore {
   readonly root: RootStore;
   readonly editStore: EditStore;
@@ -226,8 +253,11 @@ declare class UIStore {
    */
   selectNewComponentBySourceId(sourceId: SbElement, selectorIdsToIgnore?: Set<`S-${string}`>): Promise<void>;
 }
+//#endregion
+//#region src/edit-mode/edit-store.d.ts
 declare global {
   interface Window {
+    _SB_ENABLE_SESSION_RECORDING?: boolean;
     __SUPERBLOCKS_EDITOR_HOOK__: InstanceType<typeof EditStore>;
   }
 }
@@ -238,6 +268,7 @@ declare class EditStore {
   connectionManager: ConnectionManager;
   ai: AiManager;
   isInitialized: boolean;
+  recordingInitialized: boolean;
   interactionMode: InteractionMode;
   lastInteractionMode: InteractionMode;
   private viteMessageListeners;
@@ -250,7 +281,14 @@ declare class EditStore {
   triggerViteMessage<T extends ViteMessageKind, Message extends Extract<ViteMessage, {
     kind: T;
   }>>(kind: T, message: Message): void;
+  startRecording(recording: {
+    userId: string;
+    appId: string;
+    sessionRecordingKey: string;
+  }): void;
 }
+//#endregion
+//#region src/lib/internal-details/lib/types.d.ts
 type ExecutionError = {
   name?: string;
   message: string;
@@ -265,10 +303,10 @@ type ExecutionEventRequest = {
   };
 };
 type Resolutions = Record<string, // name of the field: eg: "range", for the range field let's say the code is {{[1,2,3]}}
-  {
-    value: any;
-    bindings: any[];
-  }>;
+{
+  value: any;
+  bindings: any[];
+}>;
 type ExecutionEvent = {
   name: string;
   type: string;
@@ -330,13 +368,9 @@ interface SdkApiMetadata {
   isStreaming: boolean;
   /** Declared integrations for this API */
   integrations: Array<{
-    /** Key used in the API code to reference this integration */
-    key: string;
-    /** Plugin ID (e.g., "postgres", "slack") */
-    pluginId: string;
-    /** Integration name (e.g., "Production Postgres") */
-    name: string;
-    /** Integration ID (UUID) */
+    /** Key used in the API code to reference this integration */key: string; /** Plugin ID (e.g., "postgres", "slack") */
+    pluginId: string; /** Integration name (e.g., "Production Postgres") */
+    name: string; /** Integration ID (UUID) */
     id: string;
   }>;
   /** Entry point file path relative to app root (e.g. "server/apis/GetUsers/api.ts") */
@@ -474,11 +508,9 @@ type FromParentToChildMessageTypesMap = {
     agents: AgentInfo[];
     logContext: Record<string, unknown>;
     featureFlags?: Record<string, unknown>;
-    /** Selected integration profile for API execution */
-    profile?: SdkProfileInfo;
-    /** Current git branch name (editor mode only) */
-    branchName?: string;
-    /** Deployed/preview commit ID (non-editor modes) */
+    sessionRecordingKey?: string; /** Selected integration profile for API execution */
+    profile?: SdkProfileInfo; /** Current git branch name (editor mode only) */
+    branchName?: string; /** Deployed/preview commit ID (non-editor modes) */
     commitId?: string;
     /**
      * Profile keys mapped to data-plane URLs when the gateway is enabled.
@@ -489,9 +521,7 @@ type FromParentToChildMessageTypesMap = {
     forceRefreshScopedToken?: boolean;
   };
   "sb-update-active-agents": {
-    /** Pre-filtered URLs for current profile (cloud org fallback) */
-    agentUrls: string[];
-    /** All active on-premise agents for local profile filtering */
+    /** Pre-filtered URLs for current profile (cloud org fallback) */agentUrls: string[]; /** All active on-premise agents for local profile filtering */
     agents: AgentInfo[];
     /**
      * DP routing config mapping profile keys to DP URLs.
@@ -719,10 +749,7 @@ type FromChildToParentMessageTypesMap = LoadErrorMessageTypesMap & {
     interactionMode: InteractionMode;
   };
   getDropTargetResult: {
-    offset: {
-      x: number;
-      y: number;
-    };
+    offset: XYCoord;
     size: {
       height: number;
       width: number;
@@ -863,8 +890,7 @@ type FromChildToParentMessageTypesMap = LoadErrorMessageTypesMap & {
     /** Full page content dimensions (APPS-5714), so the caller can choose
      * sensible `region` coordinates on a follow-up capture. Absent on error. */
     pageWidth?: number;
-    pageHeight?: number;
-    /** Which rectangle this capture actually used. Absent on error. */
+    pageHeight?: number; /** Which rectangle this capture actually used. Absent on error. */
     mode?: ScreenshotCaptureMode;
     /** The part of the page the image shows, in full-page pixel coordinates.
      * Absent for selector captures. */
@@ -969,6 +995,8 @@ type FromChildToParentMessageTypesMap = LoadErrorMessageTypesMap & {
   };
 } & AppToEditorMessage;
 type FromChildToParentMessageTypes = keyof FromChildToParentMessageTypesMap;
+//#endregion
+//#region src/lib/internal-details/location-store.d.ts
 declare class LocationStore {
   route?: RouteInfo;
   rootStore: RootStore;
@@ -978,6 +1006,8 @@ declare class LocationStore {
   private matchesToRoutePattern;
   locationToRouteInfo(location: Location, routes: DataRouter["routes"], params: Readonly<Params<string>>): RouteInfo | undefined;
 }
+//#endregion
+//#region src/lib/internal-details/lib/features/api-store.d.ts
 type ApiResult<T = any> = {
   data?: T;
   error?: string;
@@ -1036,14 +1066,23 @@ declare class ApiManager {
   private awaitBootstrapIfNeeded;
   notifyBootstrapComplete(): void;
   private prewarmExecutionPath;
-  loadApiManifest({ apis }: {
+  loadApiManifest({
+    apis
+  }: {
     apis?: Record<string, {
       api: DeleteMeLibraryApi;
       scopeId: string;
     }>;
   }): void;
   rerunApiByCallId(callId: string): Promise<ApiResult>;
-  runApiByPath({ path, inputs, callId, callback, isTestRun, injectedCallerId }: {
+  runApiByPath({
+    path,
+    inputs,
+    callId,
+    callback,
+    isTestRun,
+    injectedCallerId
+  }: {
     path: string;
     inputs: SbApiRunOptions;
     callId?: string;
@@ -1084,6 +1123,8 @@ declare class ApiManager {
   }>;
   cancelApi(apiName: string, _scopeId?: string): Promise<void>;
 }
+//#endregion
+//#region src/lib/internal-details/lib/root-store.d.ts
 /**
  * User information extracted from JWT for SDK API execution.
  * Matches the ApiUser interface from @superblocksteam/sdk-api.
@@ -1214,6 +1255,8 @@ declare class RootStore {
   notifyEditorRegistered(): void;
   onEditorRegistered(fn: () => void): void;
 }
+//#endregion
+//#region src/lib/internal-details/lib/features/component-registry.d.ts
 type DefaultTagNames = {
   container: string;
   button: string;
@@ -1251,6 +1294,8 @@ declare class ComponentRegistry implements ComponentRegistryShareState {
    */
   hasComponent(component: React$2.ElementType | string): boolean;
 }
+//#endregion
+//#region src/lib/internal-details/sb-wrapper.d.ts
 type InjectedProps = {
   dropTargetRef?: React$1.Ref<HTMLElement> | React$1.LegacyRef<HTMLElement>;
 };
@@ -1263,7 +1308,7 @@ interface CreationContext {
   selfTagName: string;
   generateUniqueName: (prefix: string) => string;
 }
-type PropertyValues<P extends React$1.ComponentProps<any>> = { [K in keyof P]?: PropertyInfo | PropertyValues<P[K]>; };
+type PropertyValues<P extends React$1.ComponentProps<any>> = { [K in keyof P]?: PropertyInfo | PropertyValues<P[K]> };
 interface EditorTemplate<P extends React$1.ComponentProps<any> = React$1.ComponentProps<any>> {
   catalog?: Catalog;
   /***
@@ -1299,6 +1344,8 @@ interface Chainable<PROPS extends React$1.ComponentProps<any> = React$1.Componen
  * @returns A chainable object that provides methods for editor integration (addEditorTemplate and editorConfig).
  */
 declare const registerComponentInternal: <T extends React$1.ElementType>(Component: T, propertiesDefinition: PropertiesDefinition) => Chainable<React$1.ComponentProps<T>>;
+//#endregion
+//#region src/lib/user-facing/component-base/sb-component.d.ts
 type SbComponentProps<El = HTMLElement> = {
   name?: string;
   bind?: WithBindingIdentifier;
@@ -1308,6 +1355,8 @@ type SbComponentProps<El = HTMLElement> = {
    */
   loading?: boolean;
 } & Omit<React.HTMLAttributes<El>, "height" | "width">;
+//#endregion
+//#region src/lib/user-facing/properties-panel/props-builder.d.ts
 type Exact<T, Shape> = T extends Shape ? Exclude<keyof T, keyof Shape> extends never ? T : never : never;
 type ManagedProp<T extends DataType = DataType> = PropertyForData<T> & {
   default?: SingleInputProp<T>;
@@ -1353,12 +1402,15 @@ type DefaultValueBehavior = "RequiredIfDefault" | "AlwaysOptional";
  * Extracts the concrete type from a property definition
  * Enhanced to handle contextual properties
  */
-type ExtractPropType<T, DefaultsBehavior extends DefaultValueBehavior, IsEvaluated extends boolean> = T extends Record<string, Prop<any, any, any>> ? ExtractProps<T, DefaultsBehavior, IsEvaluated> : T extends RecordProp<infer U> ? Record<string, ExtractProps<U, DefaultsBehavior, IsEvaluated>> : T extends CompositeProp<infer U> ? IsEvaluated extends true ? ExtractProps<U, DefaultsBehavior, IsEvaluated> : InputProp<ExtractProps<U, DefaultsBehavior, true>> : T extends UnionProp<infer SHARED, infer VARIANTS> ? VARIANTS extends readonly any[] ? { [I in keyof VARIANTS]: ExtractProps<MergeUnionVariant<SHARED, VARIANTS[I]>, DefaultsBehavior, IsEvaluated>; }[number] : never : T extends Prop<infer V, infer _HasDefault, infer ContextualProps> ? IsEvaluated extends true ? ContextualProps extends undefined ? V extends Callback ? (...args: any[]) => Promise<void> : V : ContextualProps extends any[] ? (...args: ContextualProps) => V : InputProp<V> : InputProp<V> : never;
+type ExtractPropType<T, DefaultsBehavior extends DefaultValueBehavior, IsEvaluated extends boolean> = T extends Record<string, Prop<any, any, any>> ? ExtractProps<T, DefaultsBehavior, IsEvaluated> : T extends RecordProp<infer U> ? Record<string, ExtractProps<U, DefaultsBehavior, IsEvaluated>> : T extends CompositeProp<infer U> ? IsEvaluated extends true ? ExtractProps<U, DefaultsBehavior, IsEvaluated> : InputProp<ExtractProps<U, DefaultsBehavior, true>> : T extends UnionProp<infer SHARED, infer VARIANTS> ? VARIANTS extends readonly any[] ? { [I in keyof VARIANTS]: ExtractProps<MergeUnionVariant<SHARED, VARIANTS[I]>, DefaultsBehavior, IsEvaluated> }[number] : never : T extends Prop<infer V, infer _HasDefault, infer ContextualProps> ? IsEvaluated extends true ? ContextualProps extends undefined ? V extends Callback ? (...args: any[]) => Promise<void> : V : ContextualProps extends any[] ? (...args: ContextualProps) => V : InputProp<V> : InputProp<V> : never;
 /**
  * Extracts a flat props object from a properties definition
  * Handles optionality based on DefaultValueBehavior
  */
-type ExtractProps<T, DefaultsBehavior extends DefaultValueBehavior, IsEvaluated extends boolean> = T extends Record<string, Section> ? ExtractProps<MergeSections<T>, DefaultsBehavior, IsEvaluated> : T extends SectionPropRecord ? DefaultsBehavior extends "AlwaysOptional" ? { [K in keyof T as T[K] extends Prop<any, any, any> ? K : never]?: ExtractPropType<T[K], DefaultsBehavior, IsEvaluated>; } : { [K in keyof T as T[K] extends Prop<any, infer HasDefault, any> ? HasDefault extends true ? K : never : never]: ExtractPropType<T[K], DefaultsBehavior, IsEvaluated>; } & { [K in keyof T as T[K] extends Prop<any, infer HasDefault, any> ? HasDefault extends false ? K : never : never]?: ExtractPropType<T[K], DefaultsBehavior, IsEvaluated>; } : never;
+type ExtractProps<T, DefaultsBehavior extends DefaultValueBehavior, IsEvaluated extends boolean> = T extends Record<string, Section> ? ExtractProps<MergeSections<T>, DefaultsBehavior, IsEvaluated> : T extends SectionPropRecord ? DefaultsBehavior extends "AlwaysOptional" ? { [K in keyof T as T[K] extends Prop<any, any, any> ? K : never]?: ExtractPropType<T[K], DefaultsBehavior, IsEvaluated> } : { [K in keyof T as T[K] extends Prop<any, infer HasDefault, any> ? HasDefault extends true ? K : never : never]: ExtractPropType<T[K], DefaultsBehavior, IsEvaluated> } & { [K in keyof T as T[K] extends Prop<any, infer HasDefault, any> ? HasDefault extends false ? K : never : never]?: ExtractPropType<T[K], DefaultsBehavior, IsEvaluated> } : never;
+/**
+ * Handles non Prop types, aka our default types and CSS props
+ */
 type SectionPropertiesPanelConfig = {
   showHeader?: boolean;
   isDefaultOpen?: boolean;
@@ -1379,17 +1431,22 @@ type EntityProps<Definition extends PropertiesDefinition, MergedSections = Merge
  * - Properties are fully evaluated to their final types
  */
 type InternalProps<Definition extends PropertiesDefinition, FlattenedProps = EntityProps<Definition>, BaseProps = Omit<SbComponentProps, keyof FlattenedProps>> = FlattenedProps & BaseProps & InjectedProps;
+/**
+ * External props exposed to component consumers
+ * - All properties are optional regardless of defaults
+ * - Properties accept InputProp values (bindings/functions)
+ */
 type PropertiesDefinition = Record<string, Section>;
-type SectionPropRecord<Props = Record<string, any>> = Partial<{ [K in keyof Props]: Prop<Props[K], any>; }>;
+type SectionPropRecord<Props = Record<string, any>> = Partial<{ [K in keyof Props]: Prop<Props[K], any> }>;
 declare class Section<TProps = any, // Component props type for validation
-  T extends SectionPropRecord<TProps> = SectionPropRecord<TProps>> {
+T extends SectionPropRecord<TProps> = SectionPropRecord<TProps>> {
   readonly category: PropsCategory;
   props: T;
   propertiesPanelConfig: SectionPropertiesPanelConfig;
   constructor(category: PropsCategory);
-  static category<Props = any>(category: PropsCategory): Section<Props, Partial<{ [K in keyof Props]: Prop<Props[K], any, undefined>; }>>;
-  children<INP extends SectionPropRecord<TProps> | CompositeProp<any> | UnionProp<any, any>, OUT extends (INP extends CompositeProp<infer CU> ? CU : INP extends UnionProp<infer SHARED, infer VARIANTS> ? VARIANTS extends readonly any[] ? { [I in keyof VARIANTS]: MergeUnionVariant<SHARED, VARIANTS[I]>; }[number] : never : INP)>(props: INP extends CompositeProp<any> | UnionProp<any, any> ? INP : Exact<INP, SectionPropRecord<TProps>>): Section<TProps, T & OUT>;
-  add: <INP extends SectionPropRecord<TProps> | CompositeProp<any> | UnionProp<any, any>, OUT extends (INP extends CompositeProp<infer CU> ? CU : INP extends UnionProp<infer SHARED, infer VARIANTS> ? VARIANTS extends readonly any[] ? { [I in keyof VARIANTS]: MergeUnionVariant<SHARED, VARIANTS[I]>; }[number] : never : INP)>(props: INP extends CompositeProp<any> | UnionProp<any, any> ? INP : Exact<INP, SectionPropRecord<TProps>>) => Section<TProps, T & OUT>;
+  static category<Props = any>(category: PropsCategory): Section<Props, Partial<{ [K in keyof Props]: Prop<Props[K], any, undefined> }>>;
+  children<INP extends SectionPropRecord<TProps> | CompositeProp<any> | UnionProp<any, any>, OUT extends (INP extends CompositeProp<infer CU> ? CU : INP extends UnionProp<infer SHARED, infer VARIANTS> ? VARIANTS extends readonly any[] ? { [I in keyof VARIANTS]: MergeUnionVariant<SHARED, VARIANTS[I]> }[number] : never : INP)>(props: INP extends CompositeProp<any> | UnionProp<any, any> ? INP : Exact<INP, SectionPropRecord<TProps>>): Section<TProps, T & OUT>;
+  add: <INP extends SectionPropRecord<TProps> | CompositeProp<any> | UnionProp<any, any>, OUT extends (INP extends CompositeProp<infer CU> ? CU : INP extends UnionProp<infer SHARED, infer VARIANTS> ? VARIANTS extends readonly any[] ? { [I in keyof VARIANTS]: MergeUnionVariant<SHARED, VARIANTS[I]> }[number] : never : INP)>(props: INP extends CompositeProp<any> | UnionProp<any, any> ? INP : Exact<INP, SectionPropRecord<TProps>>) => Section<TProps, T & OUT>;
   /** @deprecated Panel configuration is accepted for source compatibility and ignored. */
   propertiesPanel(_config: SectionPropertiesPanelConfig): this;
   get name(): "Content" | "Routing" | "Interaction" | "Styles" | "Layout" | "Appearance" | "Permissions" | "Uncategorized" | "Actions";
@@ -1452,7 +1509,7 @@ declare class Prop<Type extends DataType, _HasDefault extends boolean = false, _
   static union<SHARED extends Record<string, Prop<unknown, boolean>>, VARIANTS extends UnionVariant<SHARED>[] = UnionVariant<SHARED>[]>(props: {
     shared: SHARED;
     variants: VARIANTS;
-  }): UnionProp<SHARED, VARIANTS, VARIANTS extends readonly any[] ? { [I in keyof VARIANTS]: SHARED & VARIANTS[I]; }[number] : never>;
+  }): UnionProp<SHARED, VARIANTS, VARIANTS extends readonly any[] ? { [I in keyof VARIANTS]: SHARED & VARIANTS[I] }[number] : never>;
   default(de: SingleInputProp<DataType>): Prop<Type, true>;
   contextual<TContext extends any[] | undefined = any[]>(computedArgs?: EvaluateOrValueComputedArgs): Prop<Type, _HasDefault, TContext>;
   setName(name: string): this;
@@ -1500,14 +1557,16 @@ declare class FunctionProp<ARGS extends any[] = any[], RETURN = any> extends Pro
   actionPanel(_panel?: ActionPanel): this;
   getActionPanel(): ActionPanel | undefined;
 }
-type UnionVariant<SHARED extends Record<string, Prop<any>>> = { [K in keyof SHARED]: Prop<any>; };
-declare class UnionProp<SHARED extends Record<string, Prop<unknown, boolean>>, VARIANTS extends UnionVariant<SHARED>[] = UnionVariant<SHARED>[], _OUTPUT = VARIANTS extends readonly any[] ? { [I in keyof VARIANTS]: SHARED & VARIANTS[I]; }[number] : never> extends Prop<any> {
+type UnionVariant<SHARED extends Record<string, Prop<any>>> = { [K in keyof SHARED]: Prop<any> };
+declare class UnionProp<SHARED extends Record<string, Prop<unknown, boolean>>, VARIANTS extends UnionVariant<SHARED>[] = UnionVariant<SHARED>[], _OUTPUT = (VARIANTS extends readonly any[] ? { [I in keyof VARIANTS]: SHARED & VARIANTS[I] }[number] : never)> extends Prop<any> {
   typeString: "union";
   shared: SHARED;
   variants: VARIANTS;
   constructor(shared: SHARED, variants: VARIANTS);
   getProps(): Record<string, Prop<any, false, undefined>>;
 }
+//#endregion
+//#region src/lib/user-facing/components/app/props.d.ts
 declare const propertiesDefinition: {
   contents: Section<any, Partial<{
     [x: string]: Prop<any, any, undefined>;
@@ -1520,12 +1579,20 @@ declare const propertiesDefinition: {
     className: Prop<string, any, undefined>;
   }>>;
 };
-declare const App: (({ children, className, context }: InternalProps<typeof propertiesDefinition> & {
+//#endregion
+//#region src/lib/user-facing/components/app/index.d.ts
+declare const App: (({
+  children,
+  className,
+  context
+}: InternalProps<typeof propertiesDefinition> & {
   context?: SuperblocksAppContext;
-}) => import("react/jsx-runtime").JSX.Element) & {
+}) => _$react_jsx_runtime0.JSX.Element) & {
   displayName: string;
 };
-type PropertiesPanelDefinition<Props extends React$1.ComponentProps<any>> = SectionPropRecord<Props> | { [K in string]: Section<Props, SectionPropRecord<Props>>; };
+//#endregion
+//#region src/lib/user-facing/components/custom/register-custom-component.d.ts
+type PropertiesPanelDefinition<Props extends React$1.ComponentProps<any>> = SectionPropRecord<Props> | { [K in string]: Section<Props, SectionPropRecord<Props>> };
 /**
  * Registers a custom React component or HTML element with Superblocks.
  *
@@ -1561,16 +1628,29 @@ type PropertiesPanelDefinition<Props extends React$1.ComponentProps<any>> = Sect
  * });
  * ```
  */
-export declare function registerComponent<T extends React$1.ElementType>(component: T, propertiesDefinition?: PropertiesPanelDefinition<React$1.ComponentProps<T>>): ReturnType<typeof registerComponentInternal>;
-export declare const PageNotFound: ({ title, errorMessage, buttonPath, buttonText, onButtonClick, hideActions }: {
+declare function registerComponent<T extends React$1.ElementType>(component: T, propertiesDefinition?: PropertiesPanelDefinition<React$1.ComponentProps<T>>): ReturnType<typeof registerComponentInternal>;
+//#endregion
+//#region src/lib/user-facing/error-pages/page-not-found.d.ts
+declare const PageNotFound: ({
+  title,
+  errorMessage,
+  buttonPath,
+  buttonText,
+  onButtonClick,
+  hideActions
+}: {
   title?: string;
   errorMessage?: string | React$1.ReactElement;
   buttonPath?: string;
   buttonText?: string;
   onButtonClick?: () => void;
   hideActions?: boolean;
-}) => import("react/jsx-runtime").JSX.Element;
-export declare function RouteLoadError(): import("react/jsx-runtime").JSX.Element;
+}) => _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/lib/internal-details/internal-components/route-load-error.d.ts
+declare function RouteLoadError(): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/lib/internal-details/use-api.d.ts
 declare global {
   interface SuperblocksAPIRegistry {}
 }
@@ -1588,6 +1668,12 @@ type ApiInterfaces<Name extends string> = Name extends keyof SuperblocksAPIRegis
   input: never;
   output: never;
 };
+/**
+ * Get the API path for an API by name.
+ *
+ * When SDK APIs are enabled, paths point to `/server/apis/<name>/api.ts`.
+ * When using legacy YAML mode, paths point to `/apis/<name>/api.yaml`.
+ */
 /** Helper type to extract input type from a CompiledApi */
 type ApiInput<T> = T extends CompiledApi<infer TInput, any> ? TInput : never;
 /** Helper type to extract output type from a CompiledApi */
@@ -1670,14 +1756,14 @@ type UseApiReturnType<TName extends string> = TName extends keyof ApiRegistry ?
  * @param name - The name of the registered API to execute
  * @returns An object with `run` and `cancel` functions
  */
-export declare function useApiStateful<Name extends RegisteredAPINames, Inputs = ApiInterfaces<Name>["input"], Response = ApiInterfaces<Name>["output"]>(name: Name): UseApiCoreMethods<Inputs, Response>;
-export declare function useApi<TName extends string>(apiName: TName, inputs?: undefined): UseApiReturnType<TName>;
+declare function useApiStateful<Name extends RegisteredAPINames, Inputs = ApiInterfaces<Name>["input"], Response = ApiInterfaces<Name>["output"]>(name: Name): UseApiCoreMethods<Inputs, Response>;
+declare function useApi<TName extends string>(apiName: TName, inputs?: undefined): UseApiReturnType<TName>;
 /**
  * @deprecated Use `useApiData` for declarative data fetching.
  * This overload will be removed in a future major version.
  */
-export declare function useApi<TName extends string>(apiName: TName, inputs: TName extends keyof ApiRegistry ? ApiInput<ApiRegistry[TName]> : Record<string, unknown>): UseApiReturnType<TName>;
-export declare function useApi<TApi extends CompiledApi<unknown, unknown>>(apiName: string, inputs?: ApiInput<TApi>): UseApiResult<ApiInput<TApi>, ApiOutput<TApi>>;
+declare function useApi<TName extends string>(apiName: TName, inputs: TName extends keyof ApiRegistry ? ApiInput<ApiRegistry[TName]> : Record<string, unknown>): UseApiReturnType<TName>;
+declare function useApi<TApi extends CompiledApi<unknown, unknown>>(apiName: string, inputs?: ApiInput<TApi>): UseApiResult<ApiInput<TApi>, ApiOutput<TApi>>;
 /**
  * Type for a registry of compiled APIs.
  * Used with useTypedApi to enable automatic type inference.
@@ -1702,7 +1788,9 @@ interface TypedUseApi<TRegistry extends AnyApiRegistry> {
  *
  * @returns A typed useApi function
  */
-export declare function useTypedApi<TRegistry extends AnyApiRegistry>(): TypedUseApi<TRegistry>;
+declare function useTypedApi<TRegistry extends AnyApiRegistry>(): TypedUseApi<TRegistry>;
+//#endregion
+//#region src/lib/internal-details/use-api-data.d.ts
 interface UseApiDataResult<TOutput> {
   /** The most recent successful response. Persists across background refetches. */
   data: TOutput | undefined;
@@ -1791,7 +1879,7 @@ interface UseApiDataOptions {
   /** Shown while the real fetch is in progress, before any data arrives. */
   placeholderData?: unknown;
 }
-export declare function useApiData(apiName: string, inputs: Record<string, unknown>, options?: UseApiDataOptions): UseApiDataResult<unknown>;
+declare function useApiData(apiName: string, inputs: Record<string, unknown>, options?: UseApiDataOptions): UseApiDataResult<unknown>;
 interface TypedUseApiData<TRegistry extends AnyApiRegistry> {
   <TName extends keyof TRegistry & string>(apiName: TName, inputs: ApiInput<TRegistry[TName]>, options?: UseApiDataOptions): UseApiDataResult<ApiOutput<TRegistry[TName]>>;
 }
@@ -1805,7 +1893,9 @@ interface TypedUseApiData<TRegistry extends AnyApiRegistry> {
  * export const useApiData = useTypedApiData<ApiRegistry>();
  * ```
  */
-export declare function useTypedApiData<TRegistry extends AnyApiRegistry>(): TypedUseApiData<TRegistry>;
+declare function useTypedApiData<TRegistry extends AnyApiRegistry>(): TypedUseApiData<TRegistry>;
+//#endregion
+//#region src/lib/internal-details/execute-api.d.ts
 interface ExecuteApiOptions {
   /** AbortSignal to cancel the request mid-flight. */
   signal?: AbortSignal;
@@ -1825,7 +1915,7 @@ interface ExecuteApiOptions {
  * @throws {DOMException} with name "AbortError" if cancelled via signal.
  * @throws The orchestrator error object on API failure.
  */
-export declare function executeApi(apiName: string, inputs?: Record<string, unknown>, options?: ExecuteApiOptions): Promise<unknown>;
+declare function executeApi(apiName: string, inputs?: Record<string, unknown>, options?: ExecuteApiOptions): Promise<unknown>;
 type TypedExecuteApi<TRegistry extends AnyApiRegistry> = <TName extends keyof TRegistry & string>(apiName: TName, inputs?: ApiInput<TRegistry[TName]>, options?: ExecuteApiOptions) => Promise<ApiOutput<TRegistry[TName]>>;
 /**
  * Creates a typed version of executeApi bound to a specific API registry.
@@ -1837,7 +1927,9 @@ type TypedExecuteApi<TRegistry extends AnyApiRegistry> = <TName extends keyof TR
  * export const executeApi = createTypedExecuteApi<ApiRegistry>();
  * ```
  */
-export declare function createTypedExecuteApi<TRegistry extends AnyApiRegistry>(): TypedExecuteApi<TRegistry>;
+declare function createTypedExecuteApi<TRegistry extends AnyApiRegistry>(): TypedExecuteApi<TRegistry>;
+//#endregion
+//#region src/lib/internal-details/query-cache.d.ts
 /**
  * Build a deterministic, string cache key from API name + inputs.
  * Sorts object entries so { b: 2, a: 1 } and { a: 1, b: 2 } produce
@@ -1853,7 +1945,9 @@ declare class QueryClient {
     clear: () => void;
   };
 }
-export declare const queryClient: QueryClient;
+declare const queryClient: QueryClient;
+//#endregion
+//#region src/lib/user-facing/global-functions.d.ts
 /**
  * Logs out the user from all authenticated integrations used in APIs.
  *
@@ -1879,18 +1973,22 @@ export declare const queryClient: QueryClient;
  * }
  * ```
  */
-export declare function logoutIntegrations(): Promise<{
+declare function logoutIntegrations(): Promise<{
   success: boolean;
   errors?: Array<{
     message: string;
   }>;
 }>;
+//#endregion
+//#region src/lib/user-facing/properties-panel/mixins/styles-category.d.ts
 /** @deprecated Accepted for source compatibility. Returns an empty section. */
-export declare const tailwindStylesCategory: (_props?: {
+declare const tailwindStylesCategory: (_props?: {
   prioritizedTailwindProperties?: TailwindPropertyKey[];
 }) => Section<{
   className: string;
 }>;
+//#endregion
+//#region src/lib/internal-details/embed-store.d.ts
 /**
  * Store for managing embed properties and events.
  * Used when the library is embedded in an external application (third-party embedding).
@@ -1930,7 +2028,9 @@ declare class EmbedStore {
     message: string;
   }): void;
 }
-export declare const embedStore: EmbedStore;
+declare const embedStore: EmbedStore;
+//#endregion
+//#region src/lib/user-facing/embed.d.ts
 /**
  * Emit a custom event to the external embedder.
  * This is used when the library is embedded in an iframe
@@ -1969,10 +2069,12 @@ declare function getEmbedProperties(): Record<string, unknown>;
  * The Superblocks object provides utilities for interacting with
  * the embedding context when the library is embedded in an iframe.
  */
-export declare const Superblocks: {
+declare const Superblocks: {
   emitEvent: typeof emitEvent;
   getEmbedProperties: typeof getEmbedProperties;
 };
+//#endregion
+//#region src/lib/hooks/use-embed-properties.d.ts
 /**
  * React hook for accessing embed properties passed from the external embedder.
  * Automatically re-renders when properties change.
@@ -1994,7 +2096,9 @@ export declare const Superblocks: {
  * }
  * ```
  */
-export declare function useEmbedProperties(): Record<string, unknown>;
+declare function useEmbedProperties(): Record<string, unknown>;
+//#endregion
+//#region src/lib/hooks/use-embed-event.d.ts
 /**
  * React hook for listening to events triggered by the external embedder.
  * The handler will be called whenever the embedder triggers the specified event.
@@ -2021,7 +2125,9 @@ export declare function useEmbedProperties(): Record<string, unknown>;
  * }
  * ```
  */
-export declare function useEmbedEvent(eventName: string, handler: (payload: Record<string, unknown>) => void): void;
+declare function useEmbedEvent(eventName: string, handler: (payload: Record<string, unknown>) => void): void;
+//#endregion
+//#region src/lib/hooks/use-emit-embed-event.d.ts
 /**
  * React hook that returns a function to emit events to the external embedder.
  * Use this to communicate actions or state changes back to the parent application.
@@ -2055,6 +2161,7 @@ export declare function useEmbedEvent(eventName: string, handler: (payload: Reco
  * }
  * ```
  */
-export declare function useEmitEmbedEvent(): (eventName: string, payload?: Record<string, unknown>) => void;
-export { type AgentInfo, type AnyApiRegistry, type ApiInput, type ApiOutput, type ApiRegistry, App, type CreateChild, type CreationContext, type DataTag, type DataTags, type EditorConfig, type EditorTemplate, type ExecuteApiOptions, type FromChildToParentMessageTypes, type FromChildToParentMessageTypesMap, type FromParentToChildMessageTypes, type FromParentToChildMessageTypesMap, type IframeLoadTimings, Prop, type PropertiesPanelDefinition, Property, PropsCategory, Section, SbProvider as SuperblocksProvider, type TypedExecuteApi, type TypedUseApi, type TypedUseApiData, type UseApiDataOptions, type UseApiDataResult, type UseApiResult, type UseApiReturnType, createElement };
+declare function useEmitEmbedEvent(): (eventName: string, payload?: Record<string, unknown>) => void;
+//#endregion
+export { type AgentInfo, type AnyApiRegistry, type ApiInput, type ApiOutput, type ApiRegistry, App, type CreateChild, type CreationContext, type DataTag, type DataTags, type EditorConfig, type EditorTemplate, type ExecuteApiOptions, type FromChildToParentMessageTypes, type FromChildToParentMessageTypesMap, type FromParentToChildMessageTypes, type FromParentToChildMessageTypesMap, type IframeLoadTimings, PageNotFound, Prop, type PropertiesPanelDefinition, Property, PropsCategory, RouteLoadError, Section, Superblocks, SbProvider as SuperblocksProvider, type TypedExecuteApi, type TypedUseApi, type TypedUseApiData, type UseApiDataOptions, type UseApiDataResult, type UseApiResult, type UseApiReturnType, createElement, createTypedExecuteApi, embedStore, executeApi, getAppMode, logoutIntegrations, queryClient, registerComponent, tailwindStylesCategory, useApi, useApiData, useApiStateful, useEmbedEvent, useEmbedProperties, useEmitEmbedEvent, useSuperblocksDataTags, useSuperblocksGroups, useSuperblocksProfiles, useSuperblocksUser, useTypedApi, useTypedApiData };
 //# sourceMappingURL=index.d.ts.map