@parallelworks/ui 0.1.0 → 0.2.0

package/dist/form/lib.d.ts

@@ -0,0 +1,15 @@
+import type { DynamicFormSchema } from './types/fieldTypes.js';
+/**
+ * Drops a schema flag the expression parser could not resolve. workflow.schema.json types
+ * `optional`/`hidden`/`ignore` as ["string", "boolean"], so a flag whose expression depends
+ * on something unavailable at form-render time (a list `[index]` outside a row, `needs.`,
+ * `env.`, a secret `var.`) arrives as the raw `${{…}}` string. That string is truthy, which
+ * inverts each flag's documented `false` default. Returning undefined lets the caller apply
+ * that default instead of reading an expression it never evaluated as "yes".
+ */
+export declare function resolvedFlag<T>(value: T): T | undefined;
+export declare function enforceOneMustBeTrue(items: Array<Record<string, unknown>>, options: DynamicFormSchema, promoteIndex: number): Array<Record<string, unknown>>;
+export declare function flattenGroups(schema: Record<string, any>): Record<string, any>;
+/**Not a pure function. Edits 'obj' passed into function */
+export declare function impureSetValueFromPath(obj: Record<string, any>, path: string, value: unknown): void;
+export declare function initializeValues(options: Record<string, any> | undefined, srcData?: Record<string, any>, ignoreDefaultStrings?: boolean): Record<string, any> | undefined;

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

@@ -0,0 +1,32 @@
+import type { TSetFormDirty } from '../Form.js';
+import type { FieldType, LabelPosition, SchemaField } from './fieldTypes.js';
+/** Intentionally loose to allow both manual types and schema-generated types. */
+interface FieldBase {
+    type?: string;
+    label?: string;
+    hidden?: boolean | string;
+    disabled?: boolean | string;
+    optional?: boolean | string;
+    tooltip?: string | string[];
+    default?: unknown;
+}
+export interface FieldComponentProps<TField extends FieldBase = FieldBase, TValue = unknown> {
+    field: TField;
+    label: string;
+    labelPosition: LabelPosition;
+    missing: boolean;
+    missingFields: string[];
+    values: Record<string, unknown>;
+    setFormDirty: TSetFormDirty;
+    onChange?: (val: unknown) => void;
+    disabled: boolean;
+    computeOn?: boolean;
+    spaceCompact?: boolean;
+    tooltipComponent?: React.ReactNode;
+    workflowForm?: boolean;
+    currentValue: TValue;
+    setFieldValue?: (field: string, value: unknown, shouldValidate?: boolean) => void;
+    setFieldTouched?: (field: string, isTouched?: boolean, shouldValidate?: boolean) => void;
+}
+export type FieldProps<T extends SchemaField['type'], TValue = unknown> = FieldComponentProps<FieldType<T>, TValue>;
+export {};

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

@@ -0,0 +1,80 @@
+import type { Inputs } from './workflow-schema.js';
+export type LabelPosition = 'left' | 'top';
+export type FieldResource = string | {
+    type: string;
+    id: string;
+    name?: string;
+    user?: string;
+};
+type InputFieldValue = Inputs[string];
+export type SchemaField = Exclude<InputFieldValue, {
+    labelPosition?: LabelPosition;
+}>;
+export type FieldType<T extends SchemaField['type']> = Extract<SchemaField, {
+    type: T;
+}> & RuntimeFieldExtensions;
+/** NOT part of the workflow JSON schema — added by the form system at runtime. */
+interface RuntimeFieldExtensions {
+    name?: string;
+    description?: string;
+    showInUI?: boolean;
+    noCollapse?: boolean;
+    enable_if?: string | boolean;
+    show_if?: string;
+    show_if_not?: string;
+    depends_on?: string;
+    secondaryField?: string | string[];
+    one_must_be_true?: boolean;
+    computeOn?: boolean;
+    labelPosition?: LabelPosition;
+    resetOnChange?: boolean;
+    options?: unknown;
+}
+/** Legacy — use schema types from workflow-schema.d.ts for new field components. */
+export interface BaseField extends RuntimeFieldExtensions {
+    type: string;
+    label?: string;
+    tooltip?: string | string[];
+    hidden?: boolean;
+    optional?: boolean;
+    ignore?: boolean;
+    collapsed?: boolean;
+    disabled?: boolean;
+    default?: unknown;
+}
+/** Permissive type for backward-compatible components; new code uses workflow-schema.d.ts types. */
+type AnyField = BaseField;
+interface WizardConfig {
+    /** Must be 'wizard' to activate wizard mode */
+    mode: 'wizard';
+    /** Navigation UI options */
+    navigation?: {
+        showSteps?: boolean;
+        showProgress?: boolean;
+        allowJump?: boolean;
+        hideStepNumbers?: boolean;
+    };
+    /** Label for the final submit button */
+    submitLabel?: string;
+    /** Use URL-based routing instead of component state */
+    urlBased?: boolean;
+}
+interface StepField extends BaseField {
+    type: 'step';
+    title: string;
+    description?: string;
+    options: Record<string, AnyField>;
+    validateOnNext?: boolean;
+    canSkip?: boolean;
+    nextLabel?: string;
+    prevLabel?: string;
+}
+export interface DynamicFormSchema {
+    $meta?: {
+        labelPosition?: LabelPosition;
+        spaceCompact?: boolean;
+        wizard?: WizardConfig;
+    };
+    [fieldName: string]: AnyField | StepField | DynamicFormSchema['$meta'] | undefined;
+}
+export {};