@arach/arc-iso 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -24,6 +24,20 @@ export declare interface ArcConnectorStyle {
 
 export declare function ArcDiagram({ data, className, interactive, mode, theme, label, labelPosition, defaultZoom, zoomLevels, showArcToggle, showAutoLayout, showControls, showMinimap, showLegend, showFocusStory, frame, hoverEffects, onNodeHover, titleBlock, maxFitZoom, }: ArcDiagramProps): JSX.Element;
 
+declare interface ArcDiagram_2 {
+    layout: DiagramLayout_2;
+    grid: GridConfig;
+    layoutHints?: LayoutHints_2;
+    nodes: Record<string, NodePosition_2>;
+    nodeData: Record<string, NodeData>;
+    connectors: Connector[];
+    connectorStyles: Record<string, ConnectorStyle_2>;
+    groups?: GroupShape_2[];
+    focusTargets?: Record<string, FocusTarget_2>;
+    images?: DiagramImage[];
+    exportZone?: ExportZone | null;
+}
+
 export declare interface ArcDiagramData {
     id?: string;
     layout: DiagramLayout;
@@ -108,6 +122,8 @@ export declare interface ArcNodeData {
     subtitle?: string;
     description?: string;
     color: DiagramColor;
+    /** Per-node silhouette. Omit to follow the theme's own node shape. */
+    shape?: NodeShape;
 }
 
 export declare interface ArcNodePosition {
@@ -282,7 +298,7 @@ export declare function deleteDiagramSession(id: string): void;
 /** Derive a URL-safe session ID from a diagram's source path or ID */
 export declare function deriveSessionId(source: string): string;
 
-export declare function DiagramCanvas({ onViewportChange, embedConfig, zoomConfig, themeOverride, isDark }: DiagramCanvasProps): JSX.Element;
+export declare function DiagramCanvas({ onViewportChange, embedConfig, zoomConfig, surface, themeOverride, isDark }: DiagramCanvasProps): JSX.Element;
 
 declare interface DiagramCanvasProps {
     onViewportChange?: (bounds: {
@@ -293,6 +309,10 @@ declare interface DiagramCanvasProps {
     }) => void;
     embedConfig?: EmbedConfig;
     zoomConfig?: ZoomConfig;
+    /** Workspace backdrop: 'theme' paints the diagram theme's container (embeds,
+     *  where the frame is part of the artifact), 'chrome' paints the app canvas
+     *  so the editor's infinite surface matches the shell skin. */
+    surface?: 'theme' | 'chrome';
     /** Override canvas background with an Arc theme. */
     themeOverride?: string;
     isDark?: boolean;
@@ -368,6 +388,17 @@ export declare function DiagramEditor({ initialData, themeId, colorMode, session
     initialDiagramMeta?: Record<string, any>;
 }): JSX.Element;
 
+declare interface DiagramImage {
+    id: string;
+    src: string;
+    name: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    opacity: number;
+}
+
 export declare interface DiagramLayout {
     width: number;
     height: number;
@@ -459,6 +490,13 @@ export declare interface EmbedConfig {
     showGrid?: boolean;
 }
 
+declare interface ExportZone {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+
 export declare interface FocusConnectorRef {
     from: string;
     to: string;
@@ -511,6 +549,14 @@ export declare function getThemeList(): {
     description: string;
 }[];
 
+declare interface GridConfig {
+    enabled: boolean;
+    size: number;
+    color: string;
+    opacity: number;
+    type: 'dots' | 'lines';
+}
+
 export declare type GroupLayoutDirection = 'horizontal' | 'vertical';
 
 declare type GroupLayoutDirection_2 = 'horizontal' | 'vertical';
@@ -628,6 +674,8 @@ declare const initialState: {
     };
 };
 
+export declare function isDiagramShape(value: unknown): boolean;
+
 /** Preset HSL palettes matching Arc's diagram colors. */
 export declare const ISO_COLORS: {
     violet: IsoColorDef;
@@ -748,6 +796,8 @@ declare interface NodeData {
     subtitle?: string;
     description?: string;
     color: DiagramColor_2;
+    /** Per-node silhouette. Omit to follow the theme's own node shape. */
+    shape?: NodeShape;
 }
 
 export declare interface NodeLayoutHint {
@@ -783,11 +833,13 @@ declare interface NodePosition_2 {
     size: NodeSize_2;
 }
 
+declare type NodeShape = 'rounded' | 'square' | 'chamfer' | 'notch' | 'pill';
+
 export declare type NodeSize = 'xs' | 's' | 'm' | 'l';
 
 declare type NodeSize_2 = 'xs' | 's' | 'm' | 'l';
 
-declare type NodeSize_3 = 'large' | 'normal' | 'small';
+declare type NodeSize_3 = 'xs' | 's' | 'm' | 'l';
 
 /**
  * Parse YAML config into DiagramConfig
@@ -936,6 +988,10 @@ declare interface TitleBlockInfo {
     sheet?: string;
 }
 
+export declare function toExportFormat(diagram: ArcDiagram_2): ArcDiagramData_2;
+
+export declare function toTypeScriptSource(diagram: ArcDiagram_2, name?: string): string;
+
 export declare function useColorMode(): string;
 
 export declare function useDiagram(): {
@@ -1005,6 +1061,9 @@ export declare function useThemeId(): string;
 
 export declare function useViewMode(): string;
 
+/** Human-readable reason this is not a diagram, or null if it is. */
+export declare function validateDiagramShape(value: unknown): string | null;
+
 export declare type ViewMode = '2d' | 'isometric';
 
 declare interface ZoomConfig {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arach/arc-iso",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "publishConfig": {
     "access": "public",