@flowdrop/flowdrop 1.0.0

package/dist/utils/uischema.d.ts

@@ -0,0 +1,52 @@
+/**
+ * UISchema Utilities
+ *
+ * Functions for resolving JSON Pointer scope strings to property keys,
+ * and for generating default UISchema from a ConfigSchema.
+ */
+import type { ConfigSchema } from '../types/index.js';
+import type { UISchemaElement, UISchemaVerticalLayout } from '../types/uischema.js';
+/**
+ * Resolve a JSON Pointer scope string to a property key.
+ *
+ * Supports the JSON Forms scope format: #/properties/<fieldName>
+ *
+ * @param scope - JSON Pointer string (e.g., "#/properties/temperature")
+ * @returns The property key (e.g., "temperature"), or null if invalid
+ *
+ * @example
+ * ```typescript
+ * resolveScopeToKey("#/properties/temperature") // => "temperature"
+ * resolveScopeToKey("#/properties/nested/deep")  // => null (only single-level supported)
+ * resolveScopeToKey("invalid")                   // => null
+ * ```
+ */
+export declare function resolveScopeToKey(scope: string): string | null;
+/**
+ * Build a scope string from a property key.
+ * Inverse of resolveScopeToKey.
+ *
+ * @param key - Property key (e.g., "temperature")
+ * @returns JSON Pointer scope string (e.g., "#/properties/temperature")
+ */
+export declare function keyToScope(key: string): string;
+/**
+ * Generate a default UISchema from a ConfigSchema.
+ * Creates a flat VerticalLayout with one Control per property,
+ * preserving the property iteration order.
+ *
+ * This is a convenience utility for programmatically building UISchema.
+ *
+ * @param schema - The ConfigSchema to generate a UISchema from
+ * @returns A VerticalLayout UISchema element
+ */
+export declare function generateDefaultUISchema(schema: ConfigSchema): UISchemaVerticalLayout;
+/**
+ * Collect all property keys referenced by Controls in a UISchema tree.
+ * Useful for detecting properties that are NOT in the UISchema
+ * (e.g., to warn about unreferenced fields during development).
+ *
+ * @param element - Root UISchema element
+ * @returns Set of property keys referenced by Controls
+ */
+export declare function collectReferencedKeys(element: UISchemaElement): Set<string>;

package/dist/utils/uischema.js

@@ -0,0 +1,88 @@
+/**
+ * UISchema Utilities
+ *
+ * Functions for resolving JSON Pointer scope strings to property keys,
+ * and for generating default UISchema from a ConfigSchema.
+ */
+/**
+ * Resolve a JSON Pointer scope string to a property key.
+ *
+ * Supports the JSON Forms scope format: #/properties/<fieldName>
+ *
+ * @param scope - JSON Pointer string (e.g., "#/properties/temperature")
+ * @returns The property key (e.g., "temperature"), or null if invalid
+ *
+ * @example
+ * ```typescript
+ * resolveScopeToKey("#/properties/temperature") // => "temperature"
+ * resolveScopeToKey("#/properties/nested/deep")  // => null (only single-level supported)
+ * resolveScopeToKey("invalid")                   // => null
+ * ```
+ */
+export function resolveScopeToKey(scope) {
+    const prefix = '#/properties/';
+    if (!scope.startsWith(prefix)) {
+        return null;
+    }
+    const key = scope.slice(prefix.length);
+    // Only support single-level property references (no nested paths)
+    if (key.includes('/') || key.length === 0) {
+        return null;
+    }
+    return key;
+}
+/**
+ * Build a scope string from a property key.
+ * Inverse of resolveScopeToKey.
+ *
+ * @param key - Property key (e.g., "temperature")
+ * @returns JSON Pointer scope string (e.g., "#/properties/temperature")
+ */
+export function keyToScope(key) {
+    return `#/properties/${key}`;
+}
+/**
+ * Generate a default UISchema from a ConfigSchema.
+ * Creates a flat VerticalLayout with one Control per property,
+ * preserving the property iteration order.
+ *
+ * This is a convenience utility for programmatically building UISchema.
+ *
+ * @param schema - The ConfigSchema to generate a UISchema from
+ * @returns A VerticalLayout UISchema element
+ */
+export function generateDefaultUISchema(schema) {
+    const elements = Object.keys(schema.properties).map((key) => ({
+        type: 'Control',
+        scope: keyToScope(key)
+    }));
+    return {
+        type: 'VerticalLayout',
+        elements
+    };
+}
+/**
+ * Collect all property keys referenced by Controls in a UISchema tree.
+ * Useful for detecting properties that are NOT in the UISchema
+ * (e.g., to warn about unreferenced fields during development).
+ *
+ * @param element - Root UISchema element
+ * @returns Set of property keys referenced by Controls
+ */
+export function collectReferencedKeys(element) {
+    const keys = new Set();
+    function walk(el) {
+        if (el.type === 'Control') {
+            const key = resolveScopeToKey(el.scope);
+            if (key)
+                keys.add(key);
+        }
+        else if (el.type === 'VerticalLayout' || el.type === 'Group') {
+            for (const child of el.elements) {
+                walk(child);
+            }
+        }
+    }
+    walk(element);
+    return keys;
+}

package/dist/utils/validation.d.ts

@@ -0,0 +1,29 @@
+/**
+ * FlowDrop Workflow Validation
+ *
+ * Lightweight validation utilities for workflow JSON data.
+ * Checks minimum required fields without relying on a full JSON Schema validator library.
+ *
+ * @module utils/validation
+ */
+/**
+ * Result of a workflow validation check.
+ */
+export interface WorkflowValidationResult {
+    valid: boolean;
+    /** Human-readable description of the first validation failure, or undefined if valid. */
+    error?: string;
+}
+/**
+ * Validate that the given value has the minimum required fields of a FlowDrop Workflow.
+ *
+ * Required fields (matching the Workflow type and workflow.schema.json):
+ * - `id`    — string
+ * - `name`  — string
+ * - `nodes` — array
+ * - `edges` — array
+ *
+ * @param data - The parsed JSON value to validate.
+ * @returns A `WorkflowValidationResult` indicating whether the data is valid.
+ */
+export declare function validateWorkflowData(data: unknown): WorkflowValidationResult;

package/dist/utils/validation.js

@@ -0,0 +1,39 @@
+/**
+ * FlowDrop Workflow Validation
+ *
+ * Lightweight validation utilities for workflow JSON data.
+ * Checks minimum required fields without relying on a full JSON Schema validator library.
+ *
+ * @module utils/validation
+ */
+/**
+ * Validate that the given value has the minimum required fields of a FlowDrop Workflow.
+ *
+ * Required fields (matching the Workflow type and workflow.schema.json):
+ * - `id`    — string
+ * - `name`  — string
+ * - `nodes` — array
+ * - `edges` — array
+ *
+ * @param data - The parsed JSON value to validate.
+ * @returns A `WorkflowValidationResult` indicating whether the data is valid.
+ */
+export function validateWorkflowData(data) {
+    if (data === null || typeof data !== 'object' || Array.isArray(data)) {
+        return { valid: false, error: 'Workflow must be a JSON object.' };
+    }
+    const obj = data;
+    if (typeof obj.id !== 'string' || obj.id.trim() === '') {
+        return { valid: false, error: 'Workflow JSON must contain a non-empty string "id" field.' };
+    }
+    if (typeof obj.name !== 'string' || obj.name.trim() === '') {
+        return { valid: false, error: 'Workflow JSON must contain a non-empty string "name" field.' };
+    }
+    if (!Array.isArray(obj.nodes)) {
+        return { valid: false, error: 'Workflow JSON must contain a "nodes" array.' };
+    }
+    if (!Array.isArray(obj.edges)) {
+        return { valid: false, error: 'Workflow JSON must contain an "edges" array.' };
+    }
+    return { valid: true };
+}

package/package.json

@@ -0,0 +1,292 @@
+{
+	"name": "@flowdrop/flowdrop",
+	"license": "MIT",
+	"private": false,
+	"version": "1.0.0",
+	"scripts": {
+		"dev": "vite dev",
+		"build": "vite build && pnpm run prepack",
+		"build:drupal": "vite build --config vite.config.drupal.ts",
+		"build:production": "vite build --config vite.config.production.ts",
+		"watch:build:drupal": "npm-watch build:drupal",
+		"watch:build:production": "npm-watch build:production",
+		"watch:build": "npm-watch build",
+		"preview": "vite preview",
+		"prepare": "svelte-kit sync || echo ''",
+		"prepack": "svelte-kit sync && svelte-package && publint",
+		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+		"lint": "eslint . && prettier --check .",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"test:ui": "vitest --ui",
+		"test:coverage": "vitest run --coverage",
+		"test:e2e": "playwright test",
+		"test:e2e:ui": "playwright test --ui",
+		"test:e2e:debug": "playwright test --debug",
+		"test:all": "pnpm run test && pnpm run test:e2e",
+		"format": "prettier --write .",
+		"storybook": "storybook dev -p 6006",
+		"storybook:build": "storybook build",
+		"schema:generate": "node scripts/generate-schema.mjs",
+		"schema:check": "node scripts/generate-schema.mjs --check",
+		"api:lint": "pnpm --dir ../../apps/api-docs run lint",
+		"api:bundle": "pnpm --dir ../../apps/api-docs run bundle"
+	},
+	"watch": {
+		"build": {
+			"ignore": "build",
+			"patterns": [
+				"src"
+			],
+			"extensions": "js,ts,svelte,html,css,svg",
+			"quiet": true,
+			"legacyWatch": true,
+			"delay": 2500,
+			"runOnChangeOnly": false
+		},
+		"build:drupal": {
+			"ignore": "build",
+			"patterns": [
+				"src"
+			],
+			"extensions": "js,ts,svelte,html,css,svg",
+			"quiet": true,
+			"legacyWatch": true,
+			"delay": 2500,
+			"runOnChangeOnly": false
+		},
+		"build:production": {
+			"ignore": "build",
+			"patterns": [
+				"src"
+			],
+			"extensions": "js,ts,svelte,html,css,svg",
+			"quiet": true,
+			"legacyWatch": true,
+			"delay": 2500,
+			"runOnChangeOnly": false
+		}
+	},
+	"files": [
+		"dist",
+		"!dist/**/*.test.*",
+		"!dist/**/*.spec.*"
+	],
+	"sideEffects": [
+		"**/*.css",
+		"./dist/styles/base.css",
+		"./dist/editor/index.js"
+	],
+	"svelte": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"type": "module",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"svelte": "./dist/index.js",
+			"default": "./dist/index.js"
+		},
+		"./core": {
+			"types": "./dist/core/index.d.ts",
+			"svelte": "./dist/core/index.js",
+			"default": "./dist/core/index.js"
+		},
+		"./editor": {
+			"types": "./dist/editor/index.d.ts",
+			"svelte": "./dist/editor/index.js",
+			"default": "./dist/editor/index.js"
+		},
+		"./form": {
+			"types": "./dist/form/index.d.ts",
+			"svelte": "./dist/form/index.js",
+			"default": "./dist/form/index.js"
+		},
+		"./form/code": {
+			"types": "./dist/form/code.d.ts",
+			"svelte": "./dist/form/code.js",
+			"default": "./dist/form/code.js"
+		},
+		"./form/markdown": {
+			"types": "./dist/form/markdown.d.ts",
+			"svelte": "./dist/form/markdown.js",
+			"default": "./dist/form/markdown.js"
+		},
+		"./form/full": {
+			"types": "./dist/form/full.d.ts",
+			"svelte": "./dist/form/full.js",
+			"default": "./dist/form/full.js"
+		},
+		"./display": {
+			"types": "./dist/display/index.d.ts",
+			"svelte": "./dist/display/index.js",
+			"default": "./dist/display/index.js"
+		},
+		"./playground": {
+			"types": "./dist/playground/index.d.ts",
+			"svelte": "./dist/playground/index.js",
+			"default": "./dist/playground/index.js"
+		},
+		"./settings": {
+			"types": "./dist/settings/index.d.ts",
+			"svelte": "./dist/settings/index.js",
+			"default": "./dist/settings/index.js"
+		},
+		"./styles": "./dist/styles/base.css",
+		"./styles/*": "./dist/styles/*",
+		"./schema": {
+			"default": "./dist/schemas/v1/workflow.schema.json"
+		},
+		"./schema/v1": {
+			"default": "./dist/schemas/v1/workflow.schema.json"
+		}
+	},
+	"peerDependencies": {
+		"@codemirror/autocomplete": "^6.20.0",
+		"@codemirror/commands": "^6.10.2",
+		"@codemirror/lang-json": "^6.0.2",
+		"@codemirror/lang-markdown": "^6.5.0",
+		"@codemirror/language": "^6.12.1",
+		"@codemirror/lint": "^6.9.2",
+		"@codemirror/state": "^6.5.4",
+		"@codemirror/theme-one-dark": "^6.1.3",
+		"@codemirror/view": "^6.39.14",
+		"@iconify/svelte": "^5.0.0",
+		"@xyflow/svelte": "^1.2",
+		"codemirror": "^6.0.2",
+		"svelte": "^5.0.0"
+	},
+	"peerDependenciesMeta": {
+		"@codemirror/autocomplete": {
+			"optional": true
+		},
+		"@codemirror/commands": {
+			"optional": true
+		},
+		"@codemirror/lang-json": {
+			"optional": true
+		},
+		"@codemirror/lang-markdown": {
+			"optional": true
+		},
+		"@codemirror/language": {
+			"optional": true
+		},
+		"@codemirror/lint": {
+			"optional": true
+		},
+		"@codemirror/state": {
+			"optional": true
+		},
+		"@codemirror/theme-one-dark": {
+			"optional": true
+		},
+		"@codemirror/view": {
+			"optional": true
+		},
+		"@iconify/svelte": {
+			"optional": true
+		},
+		"codemirror": {
+			"optional": true
+		}
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/flowdrop-io/flowdrop.git"
+	},
+	"devDependencies": {
+		"@chromatic-com/storybook": "^5.0.1",
+		"@xyflow/svelte": "^1.2",
+		"@codemirror/autocomplete": "^6.20.0",
+		"@codemirror/commands": "^6.10.2",
+		"@codemirror/lang-json": "^6.0.2",
+		"@codemirror/lang-markdown": "^6.5.0",
+		"@codemirror/language": "^6.12.1",
+		"@codemirror/lint": "^6.9.2",
+		"@codemirror/state": "^6.5.4",
+		"@codemirror/theme-one-dark": "^6.1.3",
+		"@codemirror/view": "^6.39.14",
+		"codemirror": "^6.0.2",
+		"@eslint/compat": "^1.2.5",
+		"@eslint/js": "^9.18.0",
+		"@iconify/svelte": "^5.0.0",
+		"@playwright/test": "^1.49.1",
+		"@storybook/addon-docs": "^10.2.15",
+		"@storybook/addon-svelte-csf": "^5.0.11",
+		"@storybook/addon-themes": "^10.2.15",
+		"@storybook/addon-vitest": "^10.2.15",
+		"@storybook/sveltekit": "^10.2.15",
+		"@sveltejs/adapter-auto": "^6.0.0",
+		"@sveltejs/adapter-node": "^5.4.0",
+		"@sveltejs/kit": "^2.49.2",
+		"@sveltejs/package": "^2.0.0",
+		"@sveltejs/vite-plugin-svelte": "^5.0.0",
+		"@types/dompurify": "^3.2.0",
+		"@types/marked": "^6.0.0",
+		"@types/node": "^20",
+		"@types/uuid": "^10.0.0",
+		"@vitest/browser": "^3.2.3",
+		"@vitest/coverage-v8": "^3.2.4",
+		"@vitest/ui": "^3.2.4",
+		"eslint": "^9.18.0",
+		"eslint-config-prettier": "^10.0.1",
+		"eslint-plugin-storybook": "^10.2.15",
+		"eslint-plugin-svelte": "^3.0.0",
+		"globals": "^16.0.0",
+		"happy-dom": "^20.0.11",
+		"msw": "^2.12.7",
+		"npm-watch": "^0.13.0",
+		"picomatch": "^4.0.3",
+		"playwright": "^1.53.0",
+		"prettier": "^3.4.2",
+		"prettier-plugin-svelte": "^3.3.3",
+		"publint": "^0.3.2",
+		"storybook": "^10.2.15",
+		"storybook-addon-tag-badges": "^3.0.6",
+		"svelte": "^5.0.0",
+		"svelte-check": "^4.0.0",
+		"terser": "^5.43.1",
+		"typescript": "^5.0.0",
+		"typescript-eslint": "^8.20.0",
+		"vite": "^6.2.6",
+		"vite-plugin-devtools-json": "^0.2.1",
+		"vitest": "^3.2.3",
+		"vitest-browser-svelte": "^0.1.0",
+		"yaml": "^2.8.2"
+	},
+	"overrides": {
+		"@sveltejs/kit": {
+			"cookie": "0.7.2"
+		}
+	},
+	"keywords": [
+		"svelte",
+		"svelte5",
+		"workflow",
+		"editor",
+		"node-editor",
+		"graph-editor",
+		"visual-programming",
+		"xyflow",
+		"flowchart",
+		"dag"
+	],
+	"dependencies": {
+		"diff": "^8.0.3",
+		"dompurify": "^3.3.1",
+		"marked": "^16.1.1",
+		"svelte-5-french-toast": "^2.0.6",
+		"uuid": "^11.1.0"
+	},
+	"pnpm": {
+		"overrides": {
+			"cookie@<0.7.0": "0.7.2"
+		}
+	},
+	"msw": {
+		"workerDirectory": [
+			"static"
+		]
+	}
+}