@d34dman/flowdrop 0.0.56 → 0.0.58

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/package.json

@@ -1,226 +1,232 @@
 {
-	"name": "@d34dman/flowdrop",
-	"license": "MIT",
-	"private": false,
-	"version": "0.0.56",
-	"scripts": {
-		"dev": "vite dev",
-		"build": "vite build && npm 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 '' && husky",
-		"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": "npm run test && npm run test:e2e",
-		"format": "prettier --write .",
-		"storybook": "storybook dev -p 6006",
-		"build-storybook": "storybook build",
-		"api:lint": "redocly lint api/openapi.yaml --config api/redocly.yaml",
-		"api:bundle": "redocly bundle api/openapi.yaml -o api/bundled.yaml --config api/redocly.yaml",
-		"api:watch": "nodemon --watch api --ext yaml --ignore api/bundled.yaml --exec 'npm run api:bundle'",
-		"api:preview": "redocly preview-docs api/openapi.yaml --config api/redocly.yaml",
-		"api:docs": "redocly build-docs api/bundled.yaml -o api-docs/index.html"
-	},
-	"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/*"
-	},
-	"peerDependencies": {
-		"@iconify/svelte": "^5.0.0",
-		"@sveltejs/kit": "^2.0.0",
-		"svelte": "^5.0.0"
-	},
-	"peerDependenciesMeta": {
-		"@iconify/svelte": {
-			"optional": false
-		}
-	},
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/flowdrop-io/flowdrop.git"
-	},
-	"devDependencies": {
-		"@chromatic-com/storybook": "^4.0.1",
-		"@eslint/compat": "^1.2.5",
-		"@eslint/js": "^9.18.0",
-		"@iconify/svelte": "^5.0.0",
-		"@playwright/test": "^1.49.1",
-		"@redocly/cli": "^1.31.0",
-		"@storybook/addon-docs": "^9.0.15",
-		"@storybook/addon-svelte-csf": "^5.0.4",
-		"@storybook/addon-vitest": "^9.0.15",
-		"@storybook/sveltekit": "^9.0.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/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": "^9.0.15",
-		"eslint-plugin-svelte": "^3.0.0",
-		"globals": "^16.0.0",
-		"happy-dom": "^20.0.11",
-		"husky": "^9.1.7",
-		"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": "^9.0.15",
-		"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"
-	],
-	"dependencies": {
-		"@codemirror/autocomplete": "^6.20.0",
-		"@codemirror/lang-json": "^6.0.2",
-		"@codemirror/lint": "^6.9.2",
-		"@codemirror/theme-one-dark": "^6.1.3",
-		"@xyflow/svelte": "~1.2",
-		"codemirror": "^6.0.2",
-		"easymde": "^2.20.0",
-		"marked": "^16.1.1",
-		"svelte-5-french-toast": "^2.0.6",
-		"uuid": "^11.1.0"
-	},
-	"msw": {
-		"workerDirectory": [
-			"static"
-		]
-	}
-}
+  "name": "@d34dman/flowdrop",
+  "license": "MIT",
+  "private": false,
+  "version": "0.0.58",
+  "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",
+    "schemas",
+    "!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": "./schemas/v1/workflow.schema.json"
+    },
+    "./schema/v1": {
+      "default": "./schemas/v1/workflow.schema.json"
+    }
+  },
+  "peerDependencies": {
+    "@iconify/svelte": "^5.0.0",
+    "@sveltejs/kit": "^2.0.0",
+    "svelte": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@iconify/svelte": {
+      "optional": false
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/flowdrop-io/flowdrop.git"
+  },
+  "devDependencies": {
+    "@chromatic-com/storybook": "^4.0.1",
+    "@eslint/compat": "^1.2.5",
+    "@eslint/js": "^9.18.0",
+    "@iconify/svelte": "^5.0.0",
+    "@playwright/test": "^1.49.1",
+    "@storybook/addon-docs": "^9.0.15",
+    "@storybook/addon-svelte-csf": "^5.0.4",
+    "@storybook/addon-vitest": "^9.0.15",
+    "@storybook/sveltekit": "^9.0.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/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": "^9.0.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": "^9.0.15",
+    "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"
+  ],
+  "dependencies": {
+    "@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",
+    "@xyflow/svelte": "~1.2",
+    "codemirror": "^6.0.2",
+    "marked": "^16.1.1",
+    "svelte-5-french-toast": "^2.0.6",
+    "uuid": "^11.1.0"
+  },
+  "msw": {
+    "workerDirectory": [
+      "static"
+    ]
+  },
+  "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",
+    "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",
+    "build-storybook": "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"
+  }
+}