@01.software/sdk 0.4.3-dev.1774344568213 → 0.4.3-dev.1774352883356

package/dist/ui/flow.d.cts

@@ -1,191 +1,13 @@
-import React from 'react';
-import { QueryClient } from '@tanstack/react-query';
+import { N as NodeTypeDef, E as EdgeTypeDef, C as CanvasData, F as FlowNode, D as DynamicNodeSlotProps, a as FlowEdge, b as FrameNodeSlotProps, c as EdgeSlotProps, d as NodeWrapperSlotProps, e as FlowViewport, f as FlowBounds } from '../server-B80o7igg.cjs';
+export { i as DynamicNodeData, h as FlowNodeData, g as FlowNodePosition, s as FrameData, j as FrameNodeData, k as NodeTypeFieldDef, P as PrefetchFlowOptions, S as SDKClient, U as UseFlowOptions, n as UseFlowResult, r as getFrameData, q as getFrames, o as getNodeBounds, l as isDynamicNode, m as isFrameNode, p as prefetchFlow, u as useFlow } from '../server-B80o7igg.cjs';
 import { Edge } from '@xyflow/react';
-
-interface DynamicNodeData {
-    nodeTypeSlug: string;
-    label: string;
-    fields: Record<string, unknown>;
-}
-type FlowNodeData = (DynamicNodeData | FrameNodeData) & Record<string, unknown>;
-interface FlowNodePosition {
-    x: number;
-    y: number;
-}
-interface FlowNode {
-    id: string;
-    type?: string;
-    position: FlowNodePosition;
-    data: FlowNodeData;
-    parentId?: string;
-    style?: React.CSSProperties;
-    width?: number;
-    height?: number;
-    measured?: {
-        width?: number;
-        height?: number;
-    };
-    draggable?: boolean;
-    selectable?: boolean;
-    [key: string]: unknown;
-}
-interface FlowEdge {
-    id: string;
-    source: string;
-    target: string;
-    sourceHandle?: string | null;
-    targetHandle?: string | null;
-    type?: string;
-    style?: React.CSSProperties;
-    animated?: boolean;
-    markerStart?: unknown;
-    markerEnd?: unknown;
-    edgeTypeSlug?: string;
-    fields?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-interface FlowViewport {
-    x: number;
-    y: number;
-    zoom: number;
-}
-interface CanvasData {
-    nodes: FlowNode[];
-    edges: FlowEdge[];
-    viewport: FlowViewport;
-}
-interface NodeTypeFieldDef {
-    name: string;
-    label: string;
-    fieldType: 'text' | 'textarea' | 'number' | 'url' | 'color' | 'image' | 'select' | 'toggle';
-    options?: {
-        label: string;
-        value: string;
-    }[];
-    defaultValue?: string;
-    required?: boolean;
-}
-interface NodeTypeDef {
-    slug: string;
-    name: string;
-    color: string;
-    defaultSize: {
-        width: number;
-        height: number;
-    };
-    fields: NodeTypeFieldDef[];
-    transparentBackground?: boolean;
-    template?: string | null;
-    customCSS?: string | null;
-}
-interface EdgeTypeDef {
-    slug: string;
-    name: string;
-    color: string;
-    strokeWidth: number;
-    animated: boolean;
-    lineStyle: string;
-    markerStart: string;
-    markerEnd: string;
-    fields: NodeTypeFieldDef[];
-}
-declare function isDynamicNode(node: FlowNode): node is FlowNode & {
-    data: DynamicNodeData;
-};
-declare function isFrameNode(node: FlowNode): node is FlowNode & {
-    data: FrameNodeData;
-};
-interface DynamicNodeSlotProps {
-    id: string;
-    nodeTypeSlug: string;
-    label: string;
-    fields: Record<string, unknown>;
-    nodeTypeDef?: NodeTypeDef;
-    /** Whether this node is currently selected */
-    selected?: boolean;
-    /** Measured node width (undefined before first measurement) */
-    width?: number;
-    /** Measured node height (undefined before first measurement) */
-    height?: number;
-    /** The default rendering (template or field-based). Allows custom renderers to wrap/extend instead of replacing entirely. */
-    defaultRender?: React.ReactElement;
-}
-interface FrameNodeData {
-    label: string;
-    color?: string;
-    padding?: number;
-    borderStyle?: 'dashed' | 'solid' | 'none';
-    opacity?: number;
-}
-interface FrameNodeSlotProps {
-    id: string;
-    label: string;
-    color?: string;
-    padding?: number;
-    borderStyle?: 'dashed' | 'solid' | 'none';
-    opacity?: number;
-    width?: number;
-    height?: number;
-    children?: React.ReactNode;
-}
-interface EdgeSlotProps {
-    id: string;
-    edgeTypeSlug?: string;
-    source: string;
-    target: string;
-    label?: string;
-    fields?: Record<string, unknown>;
-    edgeTypeDef?: EdgeTypeDef;
-    style?: React.CSSProperties;
-}
-interface NodeWrapperSlotProps {
-    id: string;
-    nodeTypeSlug: string;
-    label: string;
-    selected?: boolean;
-    nodeTypeDef?: NodeTypeDef;
-    children: React.ReactNode;
-}
-interface FlowBounds {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
+import React from 'react';
+import '@tanstack/react-query';
 
 declare const BUILT_IN_NODE_TYPES: NodeTypeDef[];
 
 declare const BUILT_IN_EDGE_TYPES: EdgeTypeDef[];
 
-type FlowCollection = 'flows' | 'flow-node-types' | 'flow-edge-types';
-type AnyFn = (...args: any[]) => any;
-interface SDKClient {
-    from(collection: FlowCollection): {
-        find: AnyFn;
-        findById: AnyFn;
-    };
-    queryClient: QueryClient;
-}
-interface UseFlowOptions {
-    /** SDK client instance (BrowserClient or ServerClient) */
-    client: SDKClient;
-    /** Flow slug (URL-friendly identifier) */
-    slug?: string;
-    /** Flow document ID (UUID) */
-    id?: string;
-    /** Enable/disable data fetching (default: true) */
-    enabled?: boolean;
-}
-interface UseFlowResult {
-    data: CanvasData | undefined;
-    nodeTypeDefs: NodeTypeDef[];
-    edgeTypeDefs: EdgeTypeDef[];
-    flow: Record<string, unknown> | undefined;
-    isLoading: boolean;
-    error: Error | null;
-}
-declare function useFlow(options: UseFlowOptions): UseFlowResult;
-
 interface UseFlowDataOptions {
     /** Canvas data from Flow document's `canvas` field */
     data: CanvasData | undefined;
@@ -211,45 +33,6 @@ interface UseFlowDataResult {
  */
 declare function useFlowData(options: UseFlowDataOptions): UseFlowDataResult;
 
-/**
- * Calculate bounding box for given node IDs.
- * Pure function — usable in SSR, server components, or outside React.
- */
-declare function getNodeBounds(nodes: FlowNode[], nodeIds: string[]): FlowBounds | undefined;
-/**
- * Get all frame nodes with their bounds.
- * Sorted by position (top-left to bottom-right).
- */
-declare function getFrames(nodes: FlowNode[]): Array<{
-    id: string;
-    label: string;
-    bounds: FlowBounds;
-}>;
-/** Result of getFrameData — contains filtered canvas + dual bounds. */
-interface FrameData {
-    /** Canvas data containing only the frame's descendants (nodes have draggable: false). */
-    data: CanvasData;
-    /** Bounding box of child content nodes — use for initial viewport fit (centering). */
-    fitBounds: FlowBounds;
-    /** Bounding box of the frame itself — use for panning/zoom restriction (clamp). */
-    clampBounds: FlowBounds;
-    /** @deprecated Use fitBounds instead. Alias for clampBounds for backward compatibility. */
-    bounds: FlowBounds;
-}
-/**
- * Extract a frame's descendants and related edges from canvas data.
- * Recursively collects all nested children (supports nested frames).
- * Returns undefined if frameId is not found or is not a frame node.
- *
- * Child nodes are marked `draggable: false` to prevent interfering with canvas panning.
- * The frame node itself is included (use `frameRenderer={() => null}` to hide it).
- *
- * Returns dual bounds:
- * - `fitBounds`: child content bounding box (for centering the viewport)
- * - `clampBounds`: frame area bounding box (for panning restriction)
- */
-declare function getFrameData(data: CanvasData, frameId: string): FrameData | undefined;
-
 interface CodeComponentProps {
     fields: Record<string, unknown>;
     label: string;
@@ -341,4 +124,4 @@ interface FlowRendererProps {
 }
 declare function FlowRenderer({ data, className, style, nodeRenderers, nodeTypeDefs, edgeTypeDefs, background, interactive, fitView, onNodeClick, onNodeDoubleClick, onNodeContextMenu, onNodeMouseEnter, onNodeMouseLeave, onEdgeClick, frameRenderer, edgeRenderers, nodeWrapper, controls, minimap, minimapNodeColor, children, renderNode, onViewportChange, defaultViewport: defaultViewportProp, bounds, clampBounds, focusPadding, focusAnimation, focusMode, responsiveFit, translateExtent: translateExtentProp, minZoom: minZoomProp, maxZoom: maxZoomProp, }: FlowRendererProps): React.JSX.Element | null;
 
-export { BUILT_IN_EDGE_TYPES, BUILT_IN_NODE_TYPES, type CanvasData, type CodeComponentProps, type DynamicNodeData, type DynamicNodeSlotProps, type EdgeSlotProps, type EdgeTypeDef, type FlowBounds, type FlowEdge, type FlowNode, type FlowNodeData, type FlowNodePosition, FlowRenderer, type FlowRendererProps, type FlowViewport, type FrameData, type FrameNodeData, type FrameNodeSlotProps, type NodeTypeDef, type NodeTypeFieldDef, type NodeWrapperSlotProps, type SDKClient, type UseFlowDataOptions, type UseFlowDataResult, type UseFlowOptions, type UseFlowResult, clearTemplateCache, compileTemplate, getFrameData, getFrames, getNodeBounds, isDynamicNode, isFrameNode, useFlow, useFlowData };
+export { BUILT_IN_EDGE_TYPES, BUILT_IN_NODE_TYPES, CanvasData, type CodeComponentProps, DynamicNodeSlotProps, EdgeSlotProps, EdgeTypeDef, FlowBounds, FlowEdge, FlowNode, FlowRenderer, type FlowRendererProps, FlowViewport, FrameNodeSlotProps, NodeTypeDef, NodeWrapperSlotProps, type UseFlowDataOptions, type UseFlowDataResult, clearTemplateCache, compileTemplate, useFlowData };

package/dist/ui/flow.d.ts

@@ -1,191 +1,13 @@
-import React from 'react';
-import { QueryClient } from '@tanstack/react-query';
+import { N as NodeTypeDef, E as EdgeTypeDef, C as CanvasData, F as FlowNode, D as DynamicNodeSlotProps, a as FlowEdge, b as FrameNodeSlotProps, c as EdgeSlotProps, d as NodeWrapperSlotProps, e as FlowViewport, f as FlowBounds } from '../server-B80o7igg.js';
+export { i as DynamicNodeData, h as FlowNodeData, g as FlowNodePosition, s as FrameData, j as FrameNodeData, k as NodeTypeFieldDef, P as PrefetchFlowOptions, S as SDKClient, U as UseFlowOptions, n as UseFlowResult, r as getFrameData, q as getFrames, o as getNodeBounds, l as isDynamicNode, m as isFrameNode, p as prefetchFlow, u as useFlow } from '../server-B80o7igg.js';
 import { Edge } from '@xyflow/react';
-
-interface DynamicNodeData {
-    nodeTypeSlug: string;
-    label: string;
-    fields: Record<string, unknown>;
-}
-type FlowNodeData = (DynamicNodeData | FrameNodeData) & Record<string, unknown>;
-interface FlowNodePosition {
-    x: number;
-    y: number;
-}
-interface FlowNode {
-    id: string;
-    type?: string;
-    position: FlowNodePosition;
-    data: FlowNodeData;
-    parentId?: string;
-    style?: React.CSSProperties;
-    width?: number;
-    height?: number;
-    measured?: {
-        width?: number;
-        height?: number;
-    };
-    draggable?: boolean;
-    selectable?: boolean;
-    [key: string]: unknown;
-}
-interface FlowEdge {
-    id: string;
-    source: string;
-    target: string;
-    sourceHandle?: string | null;
-    targetHandle?: string | null;
-    type?: string;
-    style?: React.CSSProperties;
-    animated?: boolean;
-    markerStart?: unknown;
-    markerEnd?: unknown;
-    edgeTypeSlug?: string;
-    fields?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-interface FlowViewport {
-    x: number;
-    y: number;
-    zoom: number;
-}
-interface CanvasData {
-    nodes: FlowNode[];
-    edges: FlowEdge[];
-    viewport: FlowViewport;
-}
-interface NodeTypeFieldDef {
-    name: string;
-    label: string;
-    fieldType: 'text' | 'textarea' | 'number' | 'url' | 'color' | 'image' | 'select' | 'toggle';
-    options?: {
-        label: string;
-        value: string;
-    }[];
-    defaultValue?: string;
-    required?: boolean;
-}
-interface NodeTypeDef {
-    slug: string;
-    name: string;
-    color: string;
-    defaultSize: {
-        width: number;
-        height: number;
-    };
-    fields: NodeTypeFieldDef[];
-    transparentBackground?: boolean;
-    template?: string | null;
-    customCSS?: string | null;
-}
-interface EdgeTypeDef {
-    slug: string;
-    name: string;
-    color: string;
-    strokeWidth: number;
-    animated: boolean;
-    lineStyle: string;
-    markerStart: string;
-    markerEnd: string;
-    fields: NodeTypeFieldDef[];
-}
-declare function isDynamicNode(node: FlowNode): node is FlowNode & {
-    data: DynamicNodeData;
-};
-declare function isFrameNode(node: FlowNode): node is FlowNode & {
-    data: FrameNodeData;
-};
-interface DynamicNodeSlotProps {
-    id: string;
-    nodeTypeSlug: string;
-    label: string;
-    fields: Record<string, unknown>;
-    nodeTypeDef?: NodeTypeDef;
-    /** Whether this node is currently selected */
-    selected?: boolean;
-    /** Measured node width (undefined before first measurement) */
-    width?: number;
-    /** Measured node height (undefined before first measurement) */
-    height?: number;
-    /** The default rendering (template or field-based). Allows custom renderers to wrap/extend instead of replacing entirely. */
-    defaultRender?: React.ReactElement;
-}
-interface FrameNodeData {
-    label: string;
-    color?: string;
-    padding?: number;
-    borderStyle?: 'dashed' | 'solid' | 'none';
-    opacity?: number;
-}
-interface FrameNodeSlotProps {
-    id: string;
-    label: string;
-    color?: string;
-    padding?: number;
-    borderStyle?: 'dashed' | 'solid' | 'none';
-    opacity?: number;
-    width?: number;
-    height?: number;
-    children?: React.ReactNode;
-}
-interface EdgeSlotProps {
-    id: string;
-    edgeTypeSlug?: string;
-    source: string;
-    target: string;
-    label?: string;
-    fields?: Record<string, unknown>;
-    edgeTypeDef?: EdgeTypeDef;
-    style?: React.CSSProperties;
-}
-interface NodeWrapperSlotProps {
-    id: string;
-    nodeTypeSlug: string;
-    label: string;
-    selected?: boolean;
-    nodeTypeDef?: NodeTypeDef;
-    children: React.ReactNode;
-}
-interface FlowBounds {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
+import React from 'react';
+import '@tanstack/react-query';
 
 declare const BUILT_IN_NODE_TYPES: NodeTypeDef[];
 
 declare const BUILT_IN_EDGE_TYPES: EdgeTypeDef[];
 
-type FlowCollection = 'flows' | 'flow-node-types' | 'flow-edge-types';
-type AnyFn = (...args: any[]) => any;
-interface SDKClient {
-    from(collection: FlowCollection): {
-        find: AnyFn;
-        findById: AnyFn;
-    };
-    queryClient: QueryClient;
-}
-interface UseFlowOptions {
-    /** SDK client instance (BrowserClient or ServerClient) */
-    client: SDKClient;
-    /** Flow slug (URL-friendly identifier) */
-    slug?: string;
-    /** Flow document ID (UUID) */
-    id?: string;
-    /** Enable/disable data fetching (default: true) */
-    enabled?: boolean;
-}
-interface UseFlowResult {
-    data: CanvasData | undefined;
-    nodeTypeDefs: NodeTypeDef[];
-    edgeTypeDefs: EdgeTypeDef[];
-    flow: Record<string, unknown> | undefined;
-    isLoading: boolean;
-    error: Error | null;
-}
-declare function useFlow(options: UseFlowOptions): UseFlowResult;
-
 interface UseFlowDataOptions {
     /** Canvas data from Flow document's `canvas` field */
     data: CanvasData | undefined;
@@ -211,45 +33,6 @@ interface UseFlowDataResult {
  */
 declare function useFlowData(options: UseFlowDataOptions): UseFlowDataResult;
 
-/**
- * Calculate bounding box for given node IDs.
- * Pure function — usable in SSR, server components, or outside React.
- */
-declare function getNodeBounds(nodes: FlowNode[], nodeIds: string[]): FlowBounds | undefined;
-/**
- * Get all frame nodes with their bounds.
- * Sorted by position (top-left to bottom-right).
- */
-declare function getFrames(nodes: FlowNode[]): Array<{
-    id: string;
-    label: string;
-    bounds: FlowBounds;
-}>;
-/** Result of getFrameData — contains filtered canvas + dual bounds. */
-interface FrameData {
-    /** Canvas data containing only the frame's descendants (nodes have draggable: false). */
-    data: CanvasData;
-    /** Bounding box of child content nodes — use for initial viewport fit (centering). */
-    fitBounds: FlowBounds;
-    /** Bounding box of the frame itself — use for panning/zoom restriction (clamp). */
-    clampBounds: FlowBounds;
-    /** @deprecated Use fitBounds instead. Alias for clampBounds for backward compatibility. */
-    bounds: FlowBounds;
-}
-/**
- * Extract a frame's descendants and related edges from canvas data.
- * Recursively collects all nested children (supports nested frames).
- * Returns undefined if frameId is not found or is not a frame node.
- *
- * Child nodes are marked `draggable: false` to prevent interfering with canvas panning.
- * The frame node itself is included (use `frameRenderer={() => null}` to hide it).
- *
- * Returns dual bounds:
- * - `fitBounds`: child content bounding box (for centering the viewport)
- * - `clampBounds`: frame area bounding box (for panning restriction)
- */
-declare function getFrameData(data: CanvasData, frameId: string): FrameData | undefined;
-
 interface CodeComponentProps {
     fields: Record<string, unknown>;
     label: string;
@@ -341,4 +124,4 @@ interface FlowRendererProps {
 }
 declare function FlowRenderer({ data, className, style, nodeRenderers, nodeTypeDefs, edgeTypeDefs, background, interactive, fitView, onNodeClick, onNodeDoubleClick, onNodeContextMenu, onNodeMouseEnter, onNodeMouseLeave, onEdgeClick, frameRenderer, edgeRenderers, nodeWrapper, controls, minimap, minimapNodeColor, children, renderNode, onViewportChange, defaultViewport: defaultViewportProp, bounds, clampBounds, focusPadding, focusAnimation, focusMode, responsiveFit, translateExtent: translateExtentProp, minZoom: minZoomProp, maxZoom: maxZoomProp, }: FlowRendererProps): React.JSX.Element | null;
 
-export { BUILT_IN_EDGE_TYPES, BUILT_IN_NODE_TYPES, type CanvasData, type CodeComponentProps, type DynamicNodeData, type DynamicNodeSlotProps, type EdgeSlotProps, type EdgeTypeDef, type FlowBounds, type FlowEdge, type FlowNode, type FlowNodeData, type FlowNodePosition, FlowRenderer, type FlowRendererProps, type FlowViewport, type FrameData, type FrameNodeData, type FrameNodeSlotProps, type NodeTypeDef, type NodeTypeFieldDef, type NodeWrapperSlotProps, type SDKClient, type UseFlowDataOptions, type UseFlowDataResult, type UseFlowOptions, type UseFlowResult, clearTemplateCache, compileTemplate, getFrameData, getFrames, getNodeBounds, isDynamicNode, isFrameNode, useFlow, useFlowData };
+export { BUILT_IN_EDGE_TYPES, BUILT_IN_NODE_TYPES, CanvasData, type CodeComponentProps, DynamicNodeSlotProps, EdgeSlotProps, EdgeTypeDef, FlowBounds, FlowEdge, FlowNode, FlowRenderer, type FlowRendererProps, FlowViewport, FrameNodeSlotProps, NodeTypeDef, NodeWrapperSlotProps, type UseFlowDataOptions, type UseFlowDataResult, clearTemplateCache, compileTemplate, useFlowData };

package/dist/ui/flow.js

@@ -205,6 +205,44 @@ function useFlow(options) {
   };
 }
 
+// src/ui/Flow/prefetchFlow.ts
+function prefetchFlow(options) {
+  return __async(this, null, function* () {
+    var _a;
+    const { client, slug, id } = options;
+    const identifier = (_a = id != null ? id : slug) != null ? _a : "";
+    yield Promise.all([
+      client.queryClient.prefetchQuery({
+        queryKey: collectionKeys("flows").detail(identifier),
+        queryFn: () => __async(null, null, function* () {
+          if (id) return client.from("flows").findById(id);
+          const result = yield client.from("flows").find({
+            where: { slug: { equals: slug } },
+            limit: 1
+          });
+          const doc = result.docs[0];
+          if (!doc) throw new Error(`Flow not found: ${slug}`);
+          return doc;
+        })
+      }),
+      client.queryClient.prefetchQuery({
+        queryKey: collectionKeys("flow-node-types").lists(),
+        queryFn: () => __async(null, null, function* () {
+          const result = yield client.from("flow-node-types").find({ limit: 100 });
+          return result.docs;
+        })
+      }),
+      client.queryClient.prefetchQuery({
+        queryKey: collectionKeys("flow-edge-types").lists(),
+        queryFn: () => __async(null, null, function* () {
+          const result = yield client.from("flow-edge-types").find({ limit: 100 });
+          return result.docs;
+        })
+      })
+    ]);
+  });
+}
+
 // src/ui/Flow/useFlowData.ts
 import { useMemo as useMemo2 } from "react";
 function useFlowData(options) {
@@ -1065,6 +1103,7 @@ export {
   getNodeBounds,
   isDynamicNode,
   isFrameNode,
+  prefetchFlow,
   useFlow,
   useFlowData
 };