@d34dman/flowdrop 0.0.27 → 0.0.28

package/dist/components/SchemaForm.svelte

@@ -0,0 +1,492 @@
+<!--
+  SchemaForm Component
+  
+  A standalone form generator that creates dynamic forms from JSON Schema definitions.
+  Designed for external use without coupling to FlowDrop workflow nodes.
+  
+  Features:
+  - Dynamic form generation from JSON Schema
+  - Two-way binding with value updates via onChange callback
+  - Optional save/cancel action buttons
+  - Support for all standard JSON Schema field types
+  - Accessible form controls with ARIA attributes
+  
+  @example
+  ```svelte
+  <script lang="ts">
+    import { SchemaForm } from "flowdrop";
+    import type { ConfigSchema } from "flowdrop";
+
+    const schema: ConfigSchema = {
+      type: "object",
+      properties: {
+        name: { type: "string", title: "Name", description: "Enter your name" },
+        age: { type: "number", title: "Age", minimum: 0, maximum: 120 },
+        active: { type: "boolean", title: "Active", default: true }
+      },
+      required: ["name"]
+    };
+
+    let values = $state({ name: "", age: 25, active: true });
+
+    function handleChange(newValues: Record<string, unknown>) {
+      values = newValues;
+    }
+
+    function handleSave(finalValues: Record<string, unknown>) {
+      console.log("Saved:", finalValues);
+    }
+  </script>
+
+  <SchemaForm
+    {schema}
+    {values}
+    onChange={handleChange}
+    showActions={true}
+    onSave={handleSave}
+    onCancel={() => console.log("Cancelled")}
+  />
+  ```
+-->
+
+<script lang="ts">
+	import Icon from "@iconify/svelte";
+	import type { ConfigSchema } from "../types/index.js";
+	import { FormField } from "./form/index.js";
+	import type { FieldSchema } from "./form/index.js";
+
+	/**
+	 * Props interface for SchemaForm component
+	 */
+	interface Props {
+		/**
+		 * JSON Schema definition for the form.
+		 * Should follow JSON Schema draft-07 format with type: "object".
+		 */
+		schema: ConfigSchema;
+
+		/**
+		 * Current form values as key-value pairs.
+		 * Keys should correspond to properties defined in the schema.
+		 */
+		values?: Record<string, unknown>;
+
+		/**
+		 * Callback fired whenever any field value changes.
+		 * Receives the complete updated values object.
+		 * @param values - Updated form values
+		 */
+		onChange?: (values: Record<string, unknown>) => void;
+
+		/**
+		 * Whether to display Save and Cancel action buttons.
+		 * @default false
+		 */
+		showActions?: boolean;
+
+		/**
+		 * Label for the save button.
+		 * @default "Save"
+		 */
+		saveLabel?: string;
+
+		/**
+		 * Label for the cancel button.
+		 * @default "Cancel"
+		 */
+		cancelLabel?: string;
+
+		/**
+		 * Callback fired when the Save button is clicked.
+		 * Receives the final form values.
+		 * @param values - Final form values
+		 */
+		onSave?: (values: Record<string, unknown>) => void;
+
+		/**
+		 * Callback fired when the Cancel button is clicked.
+		 */
+		onCancel?: () => void;
+
+		/**
+		 * Whether the form is in a loading state.
+		 * Disables all inputs when true.
+		 * @default false
+		 */
+		loading?: boolean;
+
+		/**
+		 * Whether the form is disabled.
+		 * @default false
+		 */
+		disabled?: boolean;
+
+		/**
+		 * Custom CSS class for the form container.
+		 */
+		class?: string;
+	}
+
+	let {
+		schema,
+		values = {},
+		onChange,
+		showActions = false,
+		saveLabel = "Save",
+		cancelLabel = "Cancel",
+		onSave,
+		onCancel,
+		loading = false,
+		disabled = false,
+		class: className = ""
+	}: Props = $props();
+
+	/**
+	 * Internal reactive state for form values
+	 */
+	let formValues = $state<Record<string, unknown>>({});
+
+	/**
+	 * Initialize form values when schema or values change
+	 * Merges default values from schema with provided values
+	 */
+	$effect(() => {
+		if (schema?.properties) {
+			const mergedValues: Record<string, unknown> = {};
+			Object.entries(schema.properties).forEach(([key, field]) => {
+				const fieldConfig = field as Record<string, unknown>;
+				// Use provided value if available, otherwise use schema default
+				mergedValues[key] = values[key] !== undefined ? values[key] : fieldConfig.default;
+			});
+			formValues = mergedValues;
+		}
+	});
+
+	/**
+	 * Check if a field is required based on schema
+	 * @param key - Field key to check
+	 * @returns Whether the field is required
+	 */
+	function isFieldRequired(key: string): boolean {
+		if (!schema?.required) {
+			return false;
+		}
+		return schema.required.includes(key);
+	}
+
+	/**
+	 * Handle field value changes from FormField components
+	 * Updates internal state and fires onChange callback
+	 * @param key - Field key that changed
+	 * @param value - New field value
+	 */
+	function handleFieldChange(key: string, value: unknown): void {
+		formValues[key] = value;
+		
+		// Notify parent of the change
+		if (onChange) {
+			onChange({ ...formValues });
+		}
+	}
+
+	/**
+	 * Handle form submission
+	 * Collects all form values and fires onSave callback
+	 */
+	function handleSave(): void {
+		if (loading || disabled) {
+			return;
+		}
+
+		// Collect all form values including hidden fields
+		const form = document.querySelector(".schema-form");
+		const updatedValues: Record<string, unknown> = { ...formValues };
+
+		if (form) {
+			const inputs = form.querySelectorAll("input, select, textarea");
+			inputs.forEach((input: Element) => {
+				const inputEl = input as HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
+				if (inputEl.id) {
+					if (inputEl instanceof HTMLInputElement && inputEl.type === "checkbox") {
+						updatedValues[inputEl.id] = inputEl.checked;
+					} else if (
+						inputEl instanceof HTMLInputElement &&
+						(inputEl.type === "number" || inputEl.type === "range")
+					) {
+						updatedValues[inputEl.id] = inputEl.value ? Number(inputEl.value) : inputEl.value;
+					} else if (inputEl instanceof HTMLInputElement && inputEl.type === "hidden") {
+						// Parse hidden field values that might be JSON
+						try {
+							const parsed = JSON.parse(inputEl.value);
+							updatedValues[inputEl.id] = parsed;
+						} catch {
+							// If not JSON, use raw value
+							updatedValues[inputEl.id] = inputEl.value;
+						}
+					} else {
+						updatedValues[inputEl.id] = inputEl.value;
+					}
+				}
+			});
+		}
+
+		// Preserve hidden field values from original values if not collected from form
+		if (values && schema?.properties) {
+			Object.entries(schema.properties).forEach(
+				([key, property]: [string, Record<string, unknown>]) => {
+					if (property.format === "hidden" && !(key in updatedValues) && key in values) {
+						updatedValues[key] = values[key];
+					}
+				}
+			);
+		}
+
+		if (onSave) {
+			onSave(updatedValues);
+		}
+	}
+
+	/**
+	 * Handle cancel action
+	 */
+	function handleCancel(): void {
+		if (onCancel) {
+			onCancel();
+		}
+	}
+
+	/**
+	 * Convert ConfigProperty to FieldSchema for FormField component
+	 * @param property - Schema property definition
+	 * @returns FieldSchema compatible with FormField
+	 */
+	function toFieldSchema(property: Record<string, unknown>): FieldSchema {
+		return property as FieldSchema;
+	}
+</script>
+
+{#if schema?.properties}
+	<form
+		class="schema-form {className}"
+		class:schema-form--loading={loading}
+		class:schema-form--disabled={disabled}
+		onsubmit={(e) => {
+			e.preventDefault();
+			handleSave();
+		}}
+	>
+		<div class="schema-form__fields">
+			{#each Object.entries(schema.properties) as [key, field], index (key)}
+				{@const fieldSchema = toFieldSchema(field as Record<string, unknown>)}
+				{@const required = isFieldRequired(key)}
+
+				<FormField
+					fieldKey={key}
+					schema={fieldSchema}
+					value={formValues[key]}
+					{required}
+					animationIndex={index}
+					onChange={(val) => handleFieldChange(key, val)}
+				/>
+			{/each}
+		</div>
+
+		{#if showActions}
+			<div class="schema-form__footer">
+				<button
+					type="button"
+					class="schema-form__button schema-form__button--secondary"
+					onclick={handleCancel}
+					disabled={loading}
+				>
+					<Icon icon="heroicons:x-mark" class="schema-form__button-icon" />
+					<span>{cancelLabel}</span>
+				</button>
+				<button
+					type="submit"
+					class="schema-form__button schema-form__button--primary"
+					disabled={loading || disabled}
+				>
+					{#if loading}
+						<span class="schema-form__button-spinner"></span>
+					{:else}
+						<Icon icon="heroicons:check" class="schema-form__button-icon" />
+					{/if}
+					<span>{saveLabel}</span>
+				</button>
+			</div>
+		{/if}
+	</form>
+{:else}
+	<div class="schema-form__empty">
+		<div class="schema-form__empty-icon">
+			<Icon icon="heroicons:document-text" />
+		</div>
+		<p class="schema-form__empty-text">No schema properties defined.</p>
+	</div>
+{/if}
+
+<style>
+	/* ============================================
+	   SCHEMA FORM - Container Styles
+	   ============================================ */
+
+	.schema-form {
+		display: flex;
+		flex-direction: column;
+		gap: 1.5rem;
+	}
+
+	.schema-form--loading,
+	.schema-form--disabled {
+		opacity: 0.7;
+		pointer-events: none;
+	}
+
+	.schema-form__fields {
+		display: flex;
+		flex-direction: column;
+		gap: 1.25rem;
+	}
+
+	/* ============================================
+	   FOOTER ACTIONS
+	   ============================================ */
+
+	.schema-form__footer {
+		display: flex;
+		gap: 0.75rem;
+		justify-content: flex-end;
+		padding-top: 1rem;
+		border-top: 1px solid var(--color-ref-gray-100, #f3f4f6);
+		margin-top: 0.5rem;
+	}
+
+	.schema-form__button {
+		display: inline-flex;
+		align-items: center;
+		justify-content: center;
+		gap: 0.5rem;
+		padding: 0.625rem 1rem;
+		border-radius: 0.5rem;
+		font-size: 0.875rem;
+		font-weight: 600;
+		font-family: inherit;
+		cursor: pointer;
+		transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+		border: 1px solid transparent;
+		min-height: 2.5rem;
+	}
+
+	.schema-form__button:disabled {
+		opacity: 0.5;
+		cursor: not-allowed;
+	}
+
+	.schema-form__button :global(svg) {
+		width: 1rem;
+		height: 1rem;
+		flex-shrink: 0;
+	}
+
+	.schema-form__button--secondary {
+		background-color: #ffffff;
+		border-color: var(--color-ref-gray-200, #e5e7eb);
+		color: var(--color-ref-gray-700, #374151);
+		box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04);
+	}
+
+	.schema-form__button--secondary:hover:not(:disabled) {
+		background-color: var(--color-ref-gray-50, #f9fafb);
+		border-color: var(--color-ref-gray-300, #d1d5db);
+		color: var(--color-ref-gray-900, #111827);
+	}
+
+	.schema-form__button--secondary:focus-visible {
+		outline: none;
+		box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.2);
+	}
+
+	.schema-form__button--primary {
+		background: linear-gradient(
+			135deg,
+			var(--color-ref-blue-500, #3b82f6) 0%,
+			var(--color-ref-blue-600, #2563eb) 100%
+		);
+		color: #ffffff;
+		box-shadow:
+			0 1px 3px rgba(59, 130, 246, 0.3),
+			inset 0 1px 0 rgba(255, 255, 255, 0.1);
+	}
+
+	.schema-form__button--primary:hover:not(:disabled) {
+		background: linear-gradient(
+			135deg,
+			var(--color-ref-blue-600, #2563eb) 0%,
+			var(--color-ref-blue-700, #1d4ed8) 100%
+		);
+		box-shadow:
+			0 4px 12px rgba(59, 130, 246, 0.35),
+			inset 0 1px 0 rgba(255, 255, 255, 0.1);
+		transform: translateY(-1px);
+	}
+
+	.schema-form__button--primary:active:not(:disabled) {
+		transform: translateY(0);
+	}
+
+	.schema-form__button--primary:focus-visible {
+		outline: none;
+		box-shadow:
+			0 0 0 3px rgba(59, 130, 246, 0.4),
+			0 4px 12px rgba(59, 130, 246, 0.35);
+	}
+
+	.schema-form__button-spinner {
+		width: 1rem;
+		height: 1rem;
+		border: 2px solid rgba(255, 255, 255, 0.3);
+		border-top-color: white;
+		border-radius: 50%;
+		animation: schema-form-spin 0.6s linear infinite;
+	}
+
+	@keyframes schema-form-spin {
+		to {
+			transform: rotate(360deg);
+		}
+	}
+
+	/* ============================================
+	   EMPTY STATE
+	   ============================================ */
+
+	.schema-form__empty {
+		display: flex;
+		flex-direction: column;
+		align-items: center;
+		justify-content: center;
+		padding: 3rem 1.5rem;
+		text-align: center;
+	}
+
+	.schema-form__empty-icon {
+		width: 3rem;
+		height: 3rem;
+		margin-bottom: 1rem;
+		color: var(--color-ref-gray-300, #d1d5db);
+	}
+
+	.schema-form__empty-icon :global(svg) {
+		width: 100%;
+		height: 100%;
+	}
+
+	.schema-form__empty-text {
+		margin: 0;
+		font-size: 0.875rem;
+		color: var(--color-ref-gray-500, #6b7280);
+		font-style: italic;
+		line-height: 1.5;
+	}
+</style>

package/dist/components/SchemaForm.svelte.d.ts

@@ -0,0 +1,65 @@
+import type { ConfigSchema } from "../types/index.js";
+/**
+ * Props interface for SchemaForm component
+ */
+interface Props {
+    /**
+     * JSON Schema definition for the form.
+     * Should follow JSON Schema draft-07 format with type: "object".
+     */
+    schema: ConfigSchema;
+    /**
+     * Current form values as key-value pairs.
+     * Keys should correspond to properties defined in the schema.
+     */
+    values?: Record<string, unknown>;
+    /**
+     * Callback fired whenever any field value changes.
+     * Receives the complete updated values object.
+     * @param values - Updated form values
+     */
+    onChange?: (values: Record<string, unknown>) => void;
+    /**
+     * Whether to display Save and Cancel action buttons.
+     * @default false
+     */
+    showActions?: boolean;
+    /**
+     * Label for the save button.
+     * @default "Save"
+     */
+    saveLabel?: string;
+    /**
+     * Label for the cancel button.
+     * @default "Cancel"
+     */
+    cancelLabel?: string;
+    /**
+     * Callback fired when the Save button is clicked.
+     * Receives the final form values.
+     * @param values - Final form values
+     */
+    onSave?: (values: Record<string, unknown>) => void;
+    /**
+     * Callback fired when the Cancel button is clicked.
+     */
+    onCancel?: () => void;
+    /**
+     * Whether the form is in a loading state.
+     * Disables all inputs when true.
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * Whether the form is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Custom CSS class for the form container.
+     */
+    class?: string;
+}
+declare const SchemaForm: import("svelte").Component<Props, {}, "">;
+type SchemaForm = ReturnType<typeof SchemaForm>;
+export default SchemaForm;

package/dist/components/form/types.d.ts

@@ -275,3 +275,99 @@ export declare function isFieldOptionArray(options: FieldOption[] | string[]): o
  * Converts string arrays to FieldOption arrays for consistent handling
  */
 export declare function normalizeOptions(options: FieldOption[] | string[] | unknown[]): FieldOption[];
+/**
+ * Props interface for the SchemaForm component
+ *
+ * SchemaForm is a standalone form generator that creates dynamic forms
+ * from JSON Schema definitions without requiring FlowDrop workflow nodes.
+ *
+ * @example
+ * ```typescript
+ * const props: SchemaFormProps = {
+ *   schema: {
+ *     type: "object",
+ *     properties: {
+ *       name: { type: "string", title: "Name" },
+ *       age: { type: "number", title: "Age" }
+ *     },
+ *     required: ["name"]
+ *   },
+ *   values: { name: "John", age: 30 },
+ *   onChange: (values) => console.log("Changed:", values),
+ *   showActions: true,
+ *   onSave: (values) => console.log("Saved:", values)
+ * };
+ * ```
+ */
+export interface SchemaFormProps {
+    /**
+     * JSON Schema definition for the form.
+     * Should follow JSON Schema draft-07 format with type: "object".
+     * Properties define the form fields to render.
+     */
+    schema: {
+        type: "object";
+        properties: Record<string, FieldSchema>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+    /**
+     * Current form values as key-value pairs.
+     * Keys should correspond to properties defined in the schema.
+     * Missing values will use schema defaults if defined.
+     */
+    values?: Record<string, unknown>;
+    /**
+     * Callback fired whenever any field value changes.
+     * Receives the complete updated values object.
+     * Use this for controlled form state management.
+     * @param values - Updated form values
+     */
+    onChange?: (values: Record<string, unknown>) => void;
+    /**
+     * Whether to display Save and Cancel action buttons.
+     * When false, the form operates in "inline" mode without buttons.
+     * @default false
+     */
+    showActions?: boolean;
+    /**
+     * Label text for the save button.
+     * Only used when showActions is true.
+     * @default "Save"
+     */
+    saveLabel?: string;
+    /**
+     * Label text for the cancel button.
+     * Only used when showActions is true.
+     * @default "Cancel"
+     */
+    cancelLabel?: string;
+    /**
+     * Callback fired when the Save button is clicked.
+     * Receives the final form values after collecting from DOM.
+     * @param values - Final form values
+     */
+    onSave?: (values: Record<string, unknown>) => void;
+    /**
+     * Callback fired when the Cancel button is clicked.
+     * Use this to reset form state or close modals.
+     */
+    onCancel?: () => void;
+    /**
+     * Whether the form is in a loading state.
+     * Disables all inputs and shows a loading spinner on the save button.
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * Whether the form is disabled.
+     * Prevents all interactions including save.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Custom CSS class to apply to the form container.
+     * Use for additional styling customization.
+     */
+    class?: string;
+}

package/dist/index.d.ts

@@ -30,6 +30,8 @@ export { default as MarkdownDisplay } from './components/MarkdownDisplay.svelte'
 export { default as ConfigForm } from './components/ConfigForm.svelte';
 export { default as ConfigModal } from './components/ConfigModal.svelte';
 export { default as ConfigPanel } from './components/ConfigPanel.svelte';
+export { default as SchemaForm } from './components/SchemaForm.svelte';
+export type { SchemaFormProps, FieldSchema, FieldType, FieldFormat, FieldOption } from './components/form/types.js';
 export { default as ReadOnlyDetails } from './components/ReadOnlyDetails.svelte';
 export { default as ConnectionLine } from './components/ConnectionLine.svelte';
 export { default as LogsSidebar } from './components/LogsSidebar.svelte';

package/dist/index.js

@@ -31,6 +31,7 @@ export { default as MarkdownDisplay } from './components/MarkdownDisplay.svelte'
 export { default as ConfigForm } from './components/ConfigForm.svelte';
 export { default as ConfigModal } from './components/ConfigModal.svelte';
 export { default as ConfigPanel } from './components/ConfigPanel.svelte';
+export { default as SchemaForm } from './components/SchemaForm.svelte';
 export { default as ReadOnlyDetails } from './components/ReadOnlyDetails.svelte';
 export { default as ConnectionLine } from './components/ConnectionLine.svelte';
 export { default as LogsSidebar } from './components/LogsSidebar.svelte';

package/package.json

@@ -2,7 +2,7 @@
 	"name": "@d34dman/flowdrop",
 	"license": "MIT",
 	"private": false,
-	"version": "0.0.27",
+	"version": "0.0.28",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",
@@ -161,4 +161,4 @@
 			"static"
 		]
 	}
-}
+}