@01.software/sdk 0.44.0 → 0.45.0

package/dist/ui/canvas.d.cts

@@ -1,10 +1,12 @@
-import { S as SDKClient, C as CanvasData, N as NodeTypeDef, E as EdgeTypeDef, a as CanvasNode, b as NodeTypeFieldDef, D as DynamicNodeSlotProps, c as CanvasEdge, F as FrameNodeSlotProps, d as EdgeSlotProps, e as NodeWrapperSlotProps, f as CanvasViewport, g as CanvasBounds, h as FrameData } from '../server-nXOezi4b.cjs';
-export { i as CanvasNodeData, j as CanvasNodePosition, k as DynamicNodeData, l as FrameNodeData, P as PrefetchCanvasOptions, m as getFrameData, n as getFrames, o as getNodeBounds, p as isDynamicNode, q as isFrameNode, r as prefetchCanvas, s as sanitizeCSS, t as toEdgeTypeDef, u as toNodeTypeDef, v as validateTenantCSS } from '../server-nXOezi4b.cjs';
+import { w as SDKClient, b as CanvasData, N as NodeTypeDef, E as EdgeTypeDef, d as CanvasNode, j as NodeTypeFieldDef, x as DynamicNodeSlotProps, c as CanvasEdge, y as FrameNodeSlotProps, z as EdgeSlotProps, A as NodeWrapperSlotProps, h as CanvasViewport, a as CanvasBounds, F as FrameData } from '../catalog-mappers-sIshKNb3.cjs';
+export { C as CANVAS_SHAPE_TYPES, e as CanvasNodeData, f as CanvasNodePosition, g as CanvasNodeType, D as DynamicNodeData, i as FrameNodeData, P as PrefetchCanvasOptions, S as ShapeNodeData, k as ShapeType, l as getFrameData, m as getFrames, n as getNodeBounds, o as isDynamicNode, p as isFrameNode, q as isShapeNode, r as prefetchCanvas, s as sanitizeCSS, t as toEdgeTypeDef, u as toNodeTypeDef, v as validateTenantCSS } from '../catalog-mappers-sIshKNb3.cjs';
 import { QueryClient } from '@tanstack/react-query';
-import { Edge } from '@xyflow/react';
+import { Edge, NodeProps } from '@xyflow/react';
 import React from 'react';
 import { I as ImageData } from '../image-BDjHp03R.cjs';
 
+type CanvasRendererLocale = 'ko' | 'en';
+
 interface UseCanvasOptions {
     /** SDK client instance (Client or ServerClient) */
     client: SDKClient;
@@ -89,7 +91,11 @@ interface CodeComponentProps {
 declare function compileTemplate(code: string, slug: string): React.FC<CodeComponentProps> | null;
 declare function clearTemplateCache(): void;
 
-declare function renderFieldValue(key: string, val: unknown, fieldDef?: NodeTypeFieldDef): React.ReactNode;
+declare function renderFieldValue(key: string, val: unknown, fieldDef?: NodeTypeFieldDef, imageAlt?: {
+    authored?: string;
+    fallback?: string;
+}): React.ReactNode;
+declare function DefaultShapeNode({ data }: NodeProps): React.JSX.Element;
 
 /** Extract an image field value with proper typing. */
 declare function getImageField(fields: Record<string, unknown>, name: string): ImageData | undefined;
@@ -119,7 +125,11 @@ interface CanvasRendererProps {
     className?: string;
     /** Container style */
     style?: React.CSSProperties;
-    /** Custom renderers by node type slug (e.g., `{ 'product-card': MyProductCard }`) */
+    /** Accessible name for the canvas region (localized default: "Canvas diagram") */
+    ariaLabel?: string;
+    /** Language for built-in accessibility labels (default: "en") */
+    locale?: CanvasRendererLocale;
+    /** Custom renderers by dynamic catalog slug (e.g., `{ 'product-card': MyProductCard }`). Reserved `frame` and `shape` nodes keep their first-party paths. */
     nodeRenderers?: Record<string, React.ComponentType<DynamicNodeSlotProps>>;
     /** Node type definitions for enhanced rendering (field-type-aware display) */
     nodeTypeDefs?: NodeTypeDef[];
@@ -131,6 +141,8 @@ interface CanvasRendererProps {
     interactive?: boolean;
     /** Fit view on mount (default: true) */
     fitView?: boolean;
+    /** Render only nodes inside the viewport (default: true) */
+    onlyRenderVisibleElements?: boolean;
     /** Called when a node is clicked */
     onNodeClick?: (event: React.MouseEvent, node: CanvasNode) => void;
     /** Called when a node is double-clicked */
@@ -184,7 +196,7 @@ interface CanvasRendererProps {
     /** Maximum zoom level */
     maxZoom?: number;
 }
-declare function CanvasRenderer({ data, className, style, nodeRenderers, nodeTypeDefs, edgeTypeDefs, background, interactive, fitView, onNodeClick, onNodeDoubleClick, onNodeContextMenu, onNodeMouseEnter, onNodeMouseLeave, onEdgeClick, frameRenderer, hideFrames, edgeRenderers, nodeWrapper, controls, minimap, minimapNodeColor, children, renderNode, onViewportChange, defaultViewport: defaultViewportProp, bounds, clampBounds, focusPadding, focusAnimation, focusMode, responsiveFit, translateExtent: translateExtentProp, minZoom: minZoomProp, maxZoom: maxZoomProp, }: CanvasRendererProps): React.JSX.Element | null;
+declare function CanvasRenderer({ data, className, style, ariaLabel, locale, nodeRenderers, nodeTypeDefs, edgeTypeDefs, background, interactive, fitView, onlyRenderVisibleElements, onNodeClick, onNodeDoubleClick, onNodeContextMenu, onNodeMouseEnter, onNodeMouseLeave, onEdgeClick, frameRenderer, hideFrames, edgeRenderers, nodeWrapper, controls, minimap, minimapNodeColor, children, renderNode, onViewportChange, defaultViewport: defaultViewportProp, bounds, clampBounds, focusPadding, focusAnimation, focusMode, responsiveFit, translateExtent: translateExtentProp, minZoom: minZoomProp, maxZoom: maxZoomProp, }: CanvasRendererProps): React.JSX.Element | null;
 
 interface CanvasFrameProps extends Omit<CanvasRendererProps, 'data' | 'nodeTypeDefs' | 'edgeTypeDefs' | 'bounds' | 'clampBounds' | 'fitView' | 'hideFrames' | 'translateExtent' | 'defaultViewport'> {
     /** SDK client instance (Client or ServerClient) */
@@ -228,4 +240,4 @@ interface CanvasFrameProps extends Omit<CanvasRendererProps, 'data' | 'nodeTypeD
  */
 declare function CanvasFrame({ client, slug, id, frameId, loading, error: renderError, onDataReady, ...rendererProps }: CanvasFrameProps): React.JSX.Element | null;
 
-export { CanvasBounds, CanvasData, CanvasEdge, CanvasFrame, type CanvasFrameProps, CanvasNode, CanvasRenderer, type CanvasRendererProps, CanvasViewport, type CodeComponentProps, DynamicNodeSlotProps, EdgeSlotProps, EdgeTypeDef, FrameData, FrameNodeSlotProps, NodeTypeDef, NodeTypeFieldDef, NodeWrapperSlotProps, SDKClient, type UseCanvasDataOptions, type UseCanvasDataResult, type UseCanvasOptions, type UseCanvasResult, clearTemplateCache, compileTemplate, getBooleanField, getImageField, getNumberField, getTextField, renderFieldValue, useCanvas, useCanvasData, useQuickJS };
+export { CanvasBounds, CanvasData, CanvasEdge, CanvasFrame, type CanvasFrameProps, CanvasNode, CanvasRenderer, type CanvasRendererLocale, type CanvasRendererProps, CanvasViewport, type CodeComponentProps, DefaultShapeNode, DynamicNodeSlotProps, EdgeSlotProps, EdgeTypeDef, FrameData, FrameNodeSlotProps, NodeTypeDef, NodeTypeFieldDef, NodeWrapperSlotProps, SDKClient, type UseCanvasDataOptions, type UseCanvasDataResult, type UseCanvasOptions, type UseCanvasResult, clearTemplateCache, compileTemplate, getBooleanField, getImageField, getNumberField, getTextField, renderFieldValue, useCanvas, useCanvasData, useQuickJS };

package/dist/ui/canvas.d.ts

@@ -1,10 +1,12 @@
-import { S as SDKClient, C as CanvasData, N as NodeTypeDef, E as EdgeTypeDef, a as CanvasNode, b as NodeTypeFieldDef, D as DynamicNodeSlotProps, c as CanvasEdge, F as FrameNodeSlotProps, d as EdgeSlotProps, e as NodeWrapperSlotProps, f as CanvasViewport, g as CanvasBounds, h as FrameData } from '../server-nXOezi4b.js';
-export { i as CanvasNodeData, j as CanvasNodePosition, k as DynamicNodeData, l as FrameNodeData, P as PrefetchCanvasOptions, m as getFrameData, n as getFrames, o as getNodeBounds, p as isDynamicNode, q as isFrameNode, r as prefetchCanvas, s as sanitizeCSS, t as toEdgeTypeDef, u as toNodeTypeDef, v as validateTenantCSS } from '../server-nXOezi4b.js';
+import { w as SDKClient, b as CanvasData, N as NodeTypeDef, E as EdgeTypeDef, d as CanvasNode, j as NodeTypeFieldDef, x as DynamicNodeSlotProps, c as CanvasEdge, y as FrameNodeSlotProps, z as EdgeSlotProps, A as NodeWrapperSlotProps, h as CanvasViewport, a as CanvasBounds, F as FrameData } from '../catalog-mappers-sIshKNb3.js';
+export { C as CANVAS_SHAPE_TYPES, e as CanvasNodeData, f as CanvasNodePosition, g as CanvasNodeType, D as DynamicNodeData, i as FrameNodeData, P as PrefetchCanvasOptions, S as ShapeNodeData, k as ShapeType, l as getFrameData, m as getFrames, n as getNodeBounds, o as isDynamicNode, p as isFrameNode, q as isShapeNode, r as prefetchCanvas, s as sanitizeCSS, t as toEdgeTypeDef, u as toNodeTypeDef, v as validateTenantCSS } from '../catalog-mappers-sIshKNb3.js';
 import { QueryClient } from '@tanstack/react-query';
-import { Edge } from '@xyflow/react';
+import { Edge, NodeProps } from '@xyflow/react';
 import React from 'react';
 import { I as ImageData } from '../image-BDjHp03R.js';
 
+type CanvasRendererLocale = 'ko' | 'en';
+
 interface UseCanvasOptions {
     /** SDK client instance (Client or ServerClient) */
     client: SDKClient;
@@ -89,7 +91,11 @@ interface CodeComponentProps {
 declare function compileTemplate(code: string, slug: string): React.FC<CodeComponentProps> | null;
 declare function clearTemplateCache(): void;
 
-declare function renderFieldValue(key: string, val: unknown, fieldDef?: NodeTypeFieldDef): React.ReactNode;
+declare function renderFieldValue(key: string, val: unknown, fieldDef?: NodeTypeFieldDef, imageAlt?: {
+    authored?: string;
+    fallback?: string;
+}): React.ReactNode;
+declare function DefaultShapeNode({ data }: NodeProps): React.JSX.Element;
 
 /** Extract an image field value with proper typing. */
 declare function getImageField(fields: Record<string, unknown>, name: string): ImageData | undefined;
@@ -119,7 +125,11 @@ interface CanvasRendererProps {
     className?: string;
     /** Container style */
     style?: React.CSSProperties;
-    /** Custom renderers by node type slug (e.g., `{ 'product-card': MyProductCard }`) */
+    /** Accessible name for the canvas region (localized default: "Canvas diagram") */
+    ariaLabel?: string;
+    /** Language for built-in accessibility labels (default: "en") */
+    locale?: CanvasRendererLocale;
+    /** Custom renderers by dynamic catalog slug (e.g., `{ 'product-card': MyProductCard }`). Reserved `frame` and `shape` nodes keep their first-party paths. */
     nodeRenderers?: Record<string, React.ComponentType<DynamicNodeSlotProps>>;
     /** Node type definitions for enhanced rendering (field-type-aware display) */
     nodeTypeDefs?: NodeTypeDef[];
@@ -131,6 +141,8 @@ interface CanvasRendererProps {
     interactive?: boolean;
     /** Fit view on mount (default: true) */
     fitView?: boolean;
+    /** Render only nodes inside the viewport (default: true) */
+    onlyRenderVisibleElements?: boolean;
     /** Called when a node is clicked */
     onNodeClick?: (event: React.MouseEvent, node: CanvasNode) => void;
     /** Called when a node is double-clicked */
@@ -184,7 +196,7 @@ interface CanvasRendererProps {
     /** Maximum zoom level */
     maxZoom?: number;
 }
-declare function CanvasRenderer({ data, className, style, nodeRenderers, nodeTypeDefs, edgeTypeDefs, background, interactive, fitView, onNodeClick, onNodeDoubleClick, onNodeContextMenu, onNodeMouseEnter, onNodeMouseLeave, onEdgeClick, frameRenderer, hideFrames, edgeRenderers, nodeWrapper, controls, minimap, minimapNodeColor, children, renderNode, onViewportChange, defaultViewport: defaultViewportProp, bounds, clampBounds, focusPadding, focusAnimation, focusMode, responsiveFit, translateExtent: translateExtentProp, minZoom: minZoomProp, maxZoom: maxZoomProp, }: CanvasRendererProps): React.JSX.Element | null;
+declare function CanvasRenderer({ data, className, style, ariaLabel, locale, nodeRenderers, nodeTypeDefs, edgeTypeDefs, background, interactive, fitView, onlyRenderVisibleElements, onNodeClick, onNodeDoubleClick, onNodeContextMenu, onNodeMouseEnter, onNodeMouseLeave, onEdgeClick, frameRenderer, hideFrames, edgeRenderers, nodeWrapper, controls, minimap, minimapNodeColor, children, renderNode, onViewportChange, defaultViewport: defaultViewportProp, bounds, clampBounds, focusPadding, focusAnimation, focusMode, responsiveFit, translateExtent: translateExtentProp, minZoom: minZoomProp, maxZoom: maxZoomProp, }: CanvasRendererProps): React.JSX.Element | null;
 
 interface CanvasFrameProps extends Omit<CanvasRendererProps, 'data' | 'nodeTypeDefs' | 'edgeTypeDefs' | 'bounds' | 'clampBounds' | 'fitView' | 'hideFrames' | 'translateExtent' | 'defaultViewport'> {
     /** SDK client instance (Client or ServerClient) */
@@ -228,4 +240,4 @@ interface CanvasFrameProps extends Omit<CanvasRendererProps, 'data' | 'nodeTypeD
  */
 declare function CanvasFrame({ client, slug, id, frameId, loading, error: renderError, onDataReady, ...rendererProps }: CanvasFrameProps): React.JSX.Element | null;
 
-export { CanvasBounds, CanvasData, CanvasEdge, CanvasFrame, type CanvasFrameProps, CanvasNode, CanvasRenderer, type CanvasRendererProps, CanvasViewport, type CodeComponentProps, DynamicNodeSlotProps, EdgeSlotProps, EdgeTypeDef, FrameData, FrameNodeSlotProps, NodeTypeDef, NodeTypeFieldDef, NodeWrapperSlotProps, SDKClient, type UseCanvasDataOptions, type UseCanvasDataResult, type UseCanvasOptions, type UseCanvasResult, clearTemplateCache, compileTemplate, getBooleanField, getImageField, getNumberField, getTextField, renderFieldValue, useCanvas, useCanvasData, useQuickJS };
+export { CanvasBounds, CanvasData, CanvasEdge, CanvasFrame, type CanvasFrameProps, CanvasNode, CanvasRenderer, type CanvasRendererLocale, type CanvasRendererProps, CanvasViewport, type CodeComponentProps, DefaultShapeNode, DynamicNodeSlotProps, EdgeSlotProps, EdgeTypeDef, FrameData, FrameNodeSlotProps, NodeTypeDef, NodeTypeFieldDef, NodeWrapperSlotProps, SDKClient, type UseCanvasDataOptions, type UseCanvasDataResult, type UseCanvasOptions, type UseCanvasResult, clearTemplateCache, compileTemplate, getBooleanField, getImageField, getNumberField, getTextField, renderFieldValue, useCanvas, useCanvasData, useQuickJS };