@jentic/arazzo-ui 1.0.0-alpha.13

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@jentic/arazzo-ui",
+  "version": "1.0.0-alpha.13",
+  "description": "UI for Arazzo Workflows.",
+  "keywords": [
+    "arazzo",
+    "arazzo-specification",
+    "ui",
+    "renderer",
+    "workflow",
+    "workflows"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org",
+    "tag": "latest"
+  },
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "unpkg": "./dist/arazzo-ui.js",
+  "main": "./dist/arazzo-ui.js",
+  "module": "./dist/arazzo-ui.mjs",
+  "exports": {
+    ".": {
+      "types": "./types/arazzo-ui.d.ts",
+      "import": "./dist/arazzo-ui.mjs",
+      "require": "./dist/arazzo-ui.js"
+    },
+    "./standalone": {
+      "types": "./types/arazzo-ui-standalone.d.ts",
+      "import": "./dist/arazzo-ui-standalone.mjs",
+      "require": "./dist/arazzo-ui-standalone.js"
+    },
+    "./styles.css": "./dist/arazzo-ui.css"
+  },
+  "types": "./types/arazzo-ui.d.ts",
+  "scripts": {
+    "dev": "vite serve --config config/vite/vite.dev.config.ts",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:umd:ui build:umd:standalone build:esm:ui build:esm:standalone && npm run build:app",
+    "build:umd:ui": "cross-env BUILD_ENTRY=ArazzoUI vite build --config config/vite/vite.config.ts",
+    "build:umd:standalone": "cross-env BUILD_ENTRY=ArazzoUIStandalone vite build --config config/vite/vite.config.ts",
+    "build:esm:ui": "cross-env BUILD_FORMAT=esm BUILD_ENTRY=ArazzoUI vite build --config config/vite/vite.config.ts",
+    "build:esm:standalone": "cross-env BUILD_FORMAT=esm BUILD_ENTRY=ArazzoUIStandalone vite build --config config/vite/vite.config.ts",
+    "build:app": "npm run build:umd:standalone && rimraf ./build && mkdir -p ./build && cp ./dist/arazzo-ui-standalone.js ./dist/arazzo-ui.css ./build/ && cp ./public/app.html ./build/index.html && cp ./public/petstore-order-workflow.arazzo.yaml ./build/",
+    "lint": "eslint ./",
+    "lint:fix": "eslint ./ --fix",
+    "clean": "rimraf ./dist ./types ./build",
+    "typescript:check-types": "tsc --noEmit",
+    "typescript:declaration": "tsc -p tsconfig.declaration.json && api-extractor run -l -c ./config/api-extractor/api-extractor.ArazzoUI.json && api-extractor run -l -c ./config/api-extractor/api-extractor.ArazzoUIStandalone.json",
+    "test": "echo 'no tests yet'",
+    "prepack": "copyfiles -u 2 ../../LICENSE . && copyfiles -u 2 ../../NOTICE .",
+    "postpack": "rimraf NOTICE LICENSE"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jentic/jentic-arazzo-tools.git"
+  },
+  "author": "Jentic <hello@jentic.com>",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@jentic/arazzo-parser": "^1.0.0-alpha.13",
+    "@jentic/arazzo-resolver": "^1.0.0-alpha.13",
+    "@speclynx/apidom-core": "2.11.0",
+    "mermaid": "^11.12.2",
+    "react-markdown": "^10.1.0",
+    "reactflow": "^11.10.4",
+    "rehype-highlight": "^7.0.2",
+    "rehype-raw": "^7.0.0",
+    "remark-gfm": "^4.0.1"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.43",
+    "@types/react-dom": "^18.2.17",
+    "@vitejs/plugin-react": "^4.2.1",
+    "vite": "^6.3.5"
+  },
+  "files": [
+    "dist/",
+    "types/arazzo-ui.d.ts",
+    "types/arazzo-ui-standalone.d.ts",
+    "LICENSE",
+    "NOTICE",
+    "README.md",
+    "CHANGELOG.md"
+  ]
+}

package/types/arazzo-ui-standalone.d.ts

@@ -0,0 +1,337 @@
+import { Edge } from 'reactflow';
+import { Node as Node_2 } from 'reactflow';
+import { default as React_2 } from 'react';
+
+/**
+ * Arazzo Specification v1.0.1 Type Definitions
+ * Based on: https://spec.openapis.org/arazzo/latest.html
+ */
+/** @public */
+export declare interface ArazzoDocument {
+    arazzo: string;
+    info: InfoObject;
+    sourceDescriptions: SourceDescription[];
+    workflows: Workflow[];
+    components?: ComponentsObject;
+}
+
+/** @public */
+export declare type ArazzoEdge = Edge<ArazzoEdgeData>;
+
+/** @public */
+export declare type ArazzoEdgeData = SequentialEdgeData | SuccessEdgeData | FailureEdgeData | RetryEdgeData | BundledSuccessEdgeData | BundledFailureEdgeData | BundledRetryEdgeData;
+
+/** @public */
+export declare type ArazzoNode = Node_2<ArazzoNodeData>;
+
+/** @public */
+export declare type ArazzoNodeData = StepNodeData | WorkflowRefNodeData | StartNodeData | EndNodeData | WorkflowNodeData | ExternalWorkflowNodeData;
+
+/** @public */
+export declare interface ArazzoUIProps {
+    document: ArazzoDocument | string;
+    view?: ViewerMode;
+    activeWorkflowId?: string | null;
+    selectedNodeId?: string | null;
+    diagramType?: DiagramType | 'none';
+    className?: string;
+    style?: React.CSSProperties;
+    onNodeSelect?: (nodeId: string, node: ArazzoNode) => void;
+    onEdgeSelect?: (edgeId: string, edge: ArazzoEdge) => void;
+    onWorkflowSelect?: (workflowId: string) => void;
+    onViewChange?: (view: ViewerMode) => void;
+}
+
+/** @public */
+export declare interface ArazzoUIRef {
+    fitView(): void;
+    setZoom(level: number): void;
+    getDocument(): ArazzoDocument;
+    setActiveWorkflow(workflowId: string | null): void;
+    selectStep(stepId: string): void;
+    clearSelection(): void;
+    getActiveWorkflowId(): string | null;
+    getSelectedStepId(): string | null;
+}
+
+/**
+ * ArazzoUIStandalone - Self-contained Arazzo viewer with built-in header
+ *
+ * Includes Jentic logo, URL input for loading documents, and view mode toggle.
+ * Use this when you want a complete, ready-to-use viewer widget.
+ * For custom layouts without the header, use ArazzoUI directly.
+ *
+ * @public
+ */
+export declare const ArazzoUIStandalone: React_2.ForwardRefExoticComponent<Omit<ArazzoUIProps, "view"> & {
+    initialView?: ViewerMode;
+} & React_2.RefAttributes<ArazzoUIRef>>;
+
+/** @public */
+export declare type ArazzoUIStandaloneProps = Omit<ArazzoUIProps, 'view'> & {
+    initialView?: ViewerMode;
+};
+
+/** @public */
+export declare interface BundledFailureEdgeData {
+    type: 'bundled-failure';
+    action: FailureAction;
+    criteria?: Criterion[];
+    sources: Array<{
+        nodeId: string;
+        handleId: string;
+    }>;
+    actionIdx: number;
+}
+
+/** @public */
+export declare interface BundledRetryEdgeData {
+    type: 'bundled-retry';
+    action: FailureAction;
+    retryAfter?: number;
+    retryLimit?: number;
+    criteria?: Criterion[];
+    sources: Array<{
+        nodeId: string;
+        handleId: string;
+    }>;
+    actionIdx: number;
+}
+
+/** @public */
+export declare interface BundledSuccessEdgeData {
+    type: 'bundled-success';
+    action: SuccessAction;
+    criteria?: Criterion[];
+    sources: Array<{
+        nodeId: string;
+        handleId: string;
+    }>;
+    actionIdx: number;
+}
+
+/** @public */
+export declare interface ComponentsObject {
+    inputs?: Record<string, JSONSchema>;
+    parameters?: Record<string, Parameter>;
+    successActions?: Record<string, SuccessAction>;
+    failureActions?: Record<string, FailureAction>;
+}
+
+/** @public */
+export declare interface Criterion {
+    context?: string;
+    condition: string;
+    type?: 'simple' | 'regex' | 'jsonpath' | 'xpath' | CriterionExpressionType;
+}
+
+/** @public */
+export declare interface CriterionExpressionType {
+    type: 'jsonpath' | 'xpath';
+    version: string;
+}
+
+/** @public */
+export declare type DiagramType = 'sequence' | 'flowchart';
+
+/** @public */
+export declare interface EndNodeData {
+    type: 'end';
+    workflowId: string;
+    outputs?: Record<string, string>;
+}
+
+/** @public */
+export declare interface ExternalWorkflowNodeData {
+    type: 'externalWorkflow';
+    workflowId: string;
+    workflow?: Workflow;
+    onClick?: (workflowId: string) => void;
+}
+
+/** @public */
+export declare interface FailureAction {
+    name: string;
+    type: 'end' | 'retry' | 'goto';
+    workflowId?: string;
+    stepId?: string;
+    retryAfter?: number;
+    retryLimit?: number;
+    criteria?: Criterion[];
+}
+
+/** @public */
+export declare interface FailureEdgeData {
+    type: 'failure';
+    action: FailureAction;
+    criteria?: Criterion[];
+    isInherited?: boolean;
+}
+
+/** @public */
+export declare interface InfoObject {
+    title: string;
+    version: string;
+    summary?: string;
+    description?: string;
+}
+
+/** @public */
+export declare type JSONSchema = Record<string, any>;
+
+/** @public */
+export declare interface Parameter {
+    name: string;
+    in?: 'path' | 'query' | 'header' | 'cookie';
+    value: any;
+}
+
+/** @public */
+export declare interface PayloadReplacement {
+    target: string;
+    value: any;
+}
+
+/** @public */
+export declare interface RequestBody {
+    contentType?: string;
+    payload?: any;
+    replacements?: PayloadReplacement[];
+}
+
+/** @public */
+export declare interface RetryEdgeData {
+    type: 'retry';
+    action: FailureAction;
+    retryAfter?: number;
+    retryLimit?: number;
+    criteria?: Criterion[];
+    isInherited?: boolean;
+}
+
+/** @public */
+export declare interface ReusableObject {
+    reference: string;
+    value?: string;
+}
+
+/** @public */
+export declare interface SequentialEdgeData {
+    type: 'sequential';
+}
+
+/** @public */
+export declare interface SourceDescription {
+    name: string;
+    url: string;
+    type?: 'openapi' | 'arazzo';
+    /** Internal tracking ID - not part of Arazzo spec, stripped on export */
+    _internalId?: string;
+}
+
+/** @public */
+export declare interface StartNodeData {
+    type: 'start';
+    workflowId: string;
+    inputs?: JSONSchema;
+    description?: string;
+}
+
+/** @public */
+export declare interface Step {
+    stepId: string;
+    description?: string;
+    operationId?: string;
+    operationPath?: string;
+    workflowId?: string;
+    parameters?: (Parameter | ReusableObject)[];
+    requestBody?: RequestBody;
+    successCriteria?: Criterion[];
+    onSuccess?: (SuccessAction | ReusableObject)[];
+    onFailure?: (FailureAction | ReusableObject)[];
+    outputs?: Record<string, string>;
+    /** Internal tracking ID - not part of Arazzo spec, stripped on export */
+    _internalId?: string;
+}
+
+/** @public */
+export declare interface StepNodeData {
+    type: 'step';
+    step: Step;
+    workflowId: string;
+    workflowSuccessActions?: (SuccessAction | {
+        $ref: string;
+    })[];
+    workflowFailureActions?: (FailureAction | {
+        $ref: string;
+    })[];
+    isValid: boolean;
+    errors?: ValidationError[];
+    isSelected?: boolean;
+    isHighlighted?: boolean;
+}
+
+/** @public */
+export declare interface SuccessAction {
+    name: string;
+    type: 'end' | 'goto';
+    workflowId?: string;
+    stepId?: string;
+    criteria?: Criterion[];
+}
+
+/** @public */
+export declare interface SuccessEdgeData {
+    type: 'success';
+    action: SuccessAction;
+    criteria?: Criterion[];
+    isInherited?: boolean;
+}
+
+/** @public */
+export declare interface ValidationError {
+    path: string;
+    message: string;
+    severity: 'error' | 'warning';
+    nodeId?: string;
+    edgeId?: string;
+    specRef?: string;
+}
+
+/** @public */
+export declare type ViewerMode = 'diagram' | 'docs' | 'split';
+
+/** @public */
+export declare interface Workflow {
+    workflowId: string;
+    summary?: string;
+    description?: string;
+    inputs?: JSONSchema;
+    dependsOn?: string[];
+    steps: Step[];
+    successActions?: (SuccessAction | ReusableObject)[];
+    failureActions?: (FailureAction | ReusableObject)[];
+    outputs?: Record<string, string>;
+    parameters?: (Parameter | ReusableObject)[];
+    /** Internal tracking ID - not part of Arazzo spec, stripped on export */
+    _internalId?: string;
+}
+
+/** @public */
+export declare interface WorkflowNodeData {
+    type: 'workflow';
+    workflow: Workflow;
+    onClick?: (workflowId: string) => void;
+}
+
+/** @public */
+export declare interface WorkflowRefNodeData {
+    type: 'workflowRef';
+    step: Step;
+    targetWorkflowId: string;
+    workflowSuccessActions?: (SuccessAction | ReusableObject)[];
+    workflowFailureActions?: (FailureAction | ReusableObject)[];
+    isValid: boolean;
+}
+
+export { }