@ram_28/kf-ai-sdk 2.0.1 → 2.0.3

package/dist/useFilter-DPNLKY3H.js

@@ -0,0 +1,118 @@
+import { useRef as k, useMemo as h, useState as O, useCallback as a } from "react";
+const c = (r) => "Condition" in r, H = (r) => "LHSField" in r, x = (r) => () => {
+  const o = Math.random().toString(36).substring(2, 9);
+  return `filter_${Date.now()}_${o}_${++r.current}`;
+}, B = (r, o) => r.id ? r : { ...r, id: o() }, g = (r, o) => r.map((t) => {
+  const n = B(t, o);
+  return c(n) ? {
+    ...n,
+    Condition: g(n.Condition, o)
+  } : n;
+}), G = (r) => r.map((o) => {
+  if (c(o)) {
+    const { id: d, ...f } = o;
+    return {
+      ...f,
+      Condition: G(o.Condition)
+    };
+  }
+  const { id: t, ...n } = o;
+  return n;
+}), v = (r, o) => {
+  for (const t of r) {
+    if (t.id === o)
+      return t;
+    if (c(t)) {
+      const n = v(t.Condition, o);
+      if (n) return n;
+    }
+  }
+}, p = (r, o, t) => r.map((n) => n.id === o ? t(n) : c(n) ? {
+  ...n,
+  Condition: p(n.Condition, o, t)
+} : n), I = (r, o) => r.filter((t) => t.id !== o).map((t) => c(t) ? {
+  ...t,
+  Condition: I(t.Condition, o)
+} : t), l = (r, o, t) => r.map((n) => n.id === o && c(n) ? {
+  ...n,
+  Condition: [...n.Condition, t]
+} : c(n) ? {
+  ...n,
+  Condition: l(n.Condition, o, t)
+} : n);
+function L(r = {}) {
+  const o = k(0), t = h(() => x(o), []), [n, d] = O(
+    () => g(r.conditions || [], t)
+  ), [f, S] = O(
+    r.operator || "And"
+  ), w = h(() => {
+    if (n.length !== 0)
+      return {
+        Operator: f,
+        Condition: G(n)
+      };
+  }, [n, f]), F = n.length > 0, R = a(
+    (i, s) => {
+      const u = t(), e = { ...i, id: u };
+      return d(s ? (C) => l(C, s, e) : (C) => [...C, e]), u;
+    },
+    []
+  ), T = a(
+    (i, s) => {
+      const u = t(), e = {
+        id: u,
+        Operator: i,
+        Condition: []
+      };
+      return d(s ? (C) => l(C, s, e) : (C) => [...C, e]), u;
+    },
+    []
+  ), _ = a(
+    (i, s) => {
+      d(
+        (u) => p(u, i, (e) => c(e) ? e : { ...e, ...s })
+      );
+    },
+    []
+  ), $ = a(
+    (i, s) => {
+      d(
+        (u) => p(u, i, (e) => c(e) ? { ...e, Operator: s } : e)
+      );
+    },
+    []
+  ), b = a((i) => {
+    d((s) => I(s, i));
+  }, []), y = a(
+    (i) => v(n, i),
+    [n]
+  ), A = a(() => {
+    d([]);
+  }, []), M = a((i) => {
+    S(i);
+  }, []);
+  return {
+    // State
+    operator: f,
+    items: n,
+    payload: w,
+    hasConditions: F,
+    // Add operations
+    addCondition: R,
+    addConditionGroup: T,
+    // Update operations
+    updateCondition: _,
+    updateGroupOperator: $,
+    // Remove & access
+    removeCondition: b,
+    getCondition: y,
+    // Utility
+    clearAllConditions: A,
+    setRootOperator: M
+  };
+}
+export {
+  c as a,
+  H as i,
+  L as u
+};

package/dist/utils/formatting.d.ts

@@ -1,4 +1,12 @@
-import type { CurrencyValueType, JSONValueType } from '../types/base-fields';
+/** Currency value format - supports both object and string representations */
+type CurrencyValueType = {
+    value: number;
+    currency: string;
+} | string;
+/** Valid JSON value types */
+type JSONValueType = string | number | boolean | null | {
+    [key: string]: JSONValueType;
+} | JSONValueType[];
 /**
  * Data formatting utilities for display and conversion
  */
@@ -49,4 +57,5 @@ export declare function formatTextArea(value: string, maxLines?: number): string
  * Generic formatter that automatically detects field type and formats accordingly
  */
 export declare function formatFieldValue(value: any, fieldType?: 'id' | 'string' | 'textarea' | 'number' | 'boolean' | 'date' | 'datetime' | 'currency' | 'json' | 'array'): string;
+export {};
 //# sourceMappingURL=formatting.d.ts.map

package/dist/utils/formatting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../sdk/utils/formatting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE7E;;GAEG;AAEH;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAc/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAcrE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,OAAO,GAAG,QAAQ,GAAG,MAAiB,GAAG,MAAM,CAY7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,OAAO,GAAG,QAAQ,GAAG,MAAiB,GAAG,MAAM,CAYjG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,MAAM,CAMzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAM3E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC/B,SAAS,GAAE,MAAa,GACvB,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAQT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,CAU5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAYvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,GAAG,EACV,SAAS,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GACpH,MAAM,CAsCR"}
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../sdk/utils/formatting.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,KAAK,iBAAiB,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnC,MAAM,CAAC;AAEX,6BAA6B;AAC7B,KAAK,aAAa,GACd,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;CAAE,GAChC,aAAa,EAAE,CAAC;AAEpB;;GAEG;AAEH;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAc/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAcrE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,OAAO,GAAG,QAAQ,GAAG,MAAiB,GAAG,MAAM,CAY7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,OAAO,GAAG,QAAQ,GAAG,MAAiB,GAAG,MAAM,CAYjG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,MAAM,CAMzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAM3E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC/B,SAAS,GAAE,MAAa,GACvB,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAQT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,CAU5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAYvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,GAAG,EACV,SAAS,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GACpH,MAAM,CAsCR"}

package/dist/workflow/Activity.d.ts

@@ -0,0 +1,85 @@
+import type { ActivityInstanceType } from "./ActivityInstance";
+import type { ActivityInstanceFieldsType, ActivityOperations } from "./types";
+import type { ListOptionsType, ListResponseType, MetricOptionsType, MetricResponseType } from "../types/common";
+import { BaseField } from "../bdo/fields/BaseField";
+/**
+ * Abstract base class for workflow activities.
+ *
+ * Extend this class to define typed activity input fields.
+ * Each activity is a typed class with field definitions and data operations.
+ *
+ * @template TEntity - The full entity type with all fields
+ * @template TEditable - Fields the user can edit
+ * @template TReadonly - Fields that are read-only (computed / system)
+ *
+ * @example
+ * ```typescript
+ * class EmployeeInputActivity extends Activity<
+ *   EmployeeInputEntityType,
+ *   EmployeeInputEditable,
+ *   EmployeeInputReadonly
+ * > {
+ *   readonly meta = {
+ *     businessProcessId: "SimpleLeaveProcess",
+ *     activityId: "EMPLOYEE_INPUT",
+ *   };
+ *
+ *   readonly StartDate = new DateTimeField({ id: "StartDate", label: "Start Date" });
+ *   readonly EndDate = new DateTimeField({ id: "EndDate", label: "End Date" });
+ *   readonly LeaveDays = new NumberField({ id: "LeaveDays", label: "Leave Days", editable: false });
+ * }
+ *
+ * const activity = new EmployeeInputActivity();
+ * const items = await activity.getInstanceList({ Page: 1, PageSize: 10 });
+ * const instance = await activity.getInstance("inst_123");
+ * instance.StartDate.get();  // typed value
+ * instance.StartDate.set("2026-03-01");
+ * await instance.update({ StartDate: "2026-03-01" });
+ * ```
+ */
+export declare abstract class Activity<TEntity extends Record<string, unknown>, TEditable extends Record<string, unknown> = TEntity, TReadonly extends Record<string, unknown> = {}> {
+    /**
+     * Activity metadata — identifies the business process and activity
+     */
+    abstract readonly meta: {
+        readonly businessProcessId: string;
+        readonly activityId: string;
+    };
+    /**
+     * Get ActivityOperations for this activity.
+     * @internal
+     */
+    private _ops;
+    private _fieldsCache;
+    /**
+     * Discover BaseField instances from subclass properties.
+     * @internal
+     */
+    private _discoverFields;
+    /**
+     * List activity instances with optional filtering/pagination.
+     */
+    getInstanceList(options?: ListOptionsType): Promise<ListResponseType<ActivityInstanceFieldsType & TEntity>>;
+    /**
+     * Get aggregated metrics for activity instances.
+     */
+    instanceMetrics(options: Omit<MetricOptionsType, "Type">): Promise<MetricResponseType>;
+    /**
+     * Get a typed ActivityInstance with field accessors and persistence methods.
+     *
+     * @param instanceId - The activity instance identifier
+     * @returns ActivityInstance with typed field accessors
+     */
+    getInstance(instanceId: string): Promise<ActivityInstanceType<TEntity, TEditable, TReadonly>>;
+    /**
+     * Get discovered fields — used internally by useActivityForm hook.
+     * @internal
+     */
+    _getFields(): Record<string, BaseField<unknown>>;
+    /**
+     * Get ActivityOperations — used internally by useActivityForm hook.
+     * @internal
+     */
+    _getOps(): ActivityOperations<TEntity>;
+}
+//# sourceMappingURL=Activity.d.ts.map

package/dist/workflow/Activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Activity.d.ts","sourceRoot":"","sources":["../../sdk/workflow/Activity.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAMpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,8BAAsB,QAAQ,CAC5B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAEnD,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE;IAE9C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;QACtB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,CAAC;IAMF;;;OAGG;IACH,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,YAAY,CAAmD;IAEvE;;;OAGG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACG,eAAe,CACnB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,gBAAgB,CAAC,0BAA0B,GAAG,OAAO,CAAC,CAAC;IAIlE;;OAEG;IACG,eAAe,CACnB,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GACvC,OAAO,CAAC,kBAAkB,CAAC;IAI9B;;;;;OAKG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAgB/D;;;OAGG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAIhD;;;OAGG;IACH,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC;CAGvC"}

package/dist/workflow/ActivityInstance.d.ts

@@ -0,0 +1,96 @@
+import type { ValidationResultType, BaseFieldMetaType } from "../bdo/core/types";
+import type { BaseField } from "../bdo/fields/BaseField";
+import type { ActivityOperations, ActivityProgressType } from "./types";
+import type { CreateUpdateResponseType } from "../types/common";
+/**
+ * Editable field accessor — has get(), set(), validate(), meta
+ */
+export interface EditableFieldAccessor<T> {
+    readonly label: string;
+    readonly required: boolean;
+    readonly readOnly: boolean;
+    readonly defaultValue: unknown;
+    readonly meta: BaseFieldMetaType;
+    get(): T | undefined;
+    set(value: T): void;
+    validate(): ValidationResultType;
+}
+/**
+ * Readonly field accessor — has get(), validate(), meta (NO set)
+ */
+export interface ReadonlyFieldAccessor<T> {
+    readonly label: string;
+    readonly required: boolean;
+    readonly readOnly: boolean;
+    readonly defaultValue: unknown;
+    readonly meta: BaseFieldMetaType;
+    get(): T | undefined;
+    validate(): ValidationResultType;
+}
+type EditableAccessors<T> = {
+    [K in keyof T]: EditableFieldAccessor<T[K]>;
+};
+type ReadonlyAccessors<T> = {
+    [K in keyof T]: ReadonlyFieldAccessor<T[K]>;
+};
+/**
+ * Full ActivityInstance type with field accessors and persistence methods.
+ */
+export type ActivityInstanceType<TEntity extends Record<string, unknown>, TEditable extends Record<string, unknown> = TEntity, TReadonly extends Record<string, unknown> = {}> = ActivityInstance<TEntity, TEditable> & EditableAccessors<TEditable> & ReadonlyAccessors<TReadonly> & {
+    readonly _id: string;
+};
+/**
+ * ActivityInstance wraps a single activity instance record with:
+ * - BDO Item-style field accessors (get/set/meta/validate)
+ * - Workflow persistence methods (update, save, complete, progress)
+ *
+ * @template TEntity - Full entity type (all fields)
+ * @template TEditable - Editable subset of fields
+ */
+export declare class ActivityInstance<TEntity extends Record<string, unknown>, TEditable extends Record<string, unknown> = TEntity> {
+    readonly _id: string;
+    private readonly _data;
+    private readonly _ops;
+    private readonly _fields;
+    private readonly _accessorCache;
+    constructor(ops: ActivityOperations<TEntity>, instanceId: string, data: Record<string, unknown>, fields: Record<string, BaseField<unknown>>);
+    /**
+     * Convert the instance to a plain object
+     */
+    toJSON(): Partial<TEntity>;
+    /**
+     * Validate all fields and return combined results
+     */
+    validate(): ValidationResultType;
+    /**
+     * Regular update — calls ActivityOperations.update()
+     */
+    update(data: Partial<TEditable>): Promise<CreateUpdateResponseType>;
+    /**
+     * Commit draft — calls ActivityOperations.draftEnd()
+     */
+    save(data: Partial<TEditable>): Promise<CreateUpdateResponseType>;
+    /**
+     * Complete the activity — calls ActivityOperations.complete()
+     */
+    complete(): Promise<CreateUpdateResponseType>;
+    /**
+     * Get activity progress — calls ActivityOperations.progress()
+     */
+    progress(): Promise<ActivityProgressType>;
+    /** @internal */
+    _getAccessor(fieldId: string): EditableFieldAccessor<unknown> | ReadonlyFieldAccessor<unknown>;
+}
+/**
+ * Creates an ActivityInstance with Proxy-based field accessors.
+ * Fields are discovered from the provided fields map.
+ *
+ * @param ops - ActivityOperations for API calls
+ * @param instanceId - The activity instance ID
+ * @param data - Raw instance data from the API
+ * @param fields - Map of field name -> BaseField instance
+ * @returns Proxied ActivityInstance with typed field accessors
+ */
+export declare function createActivityInstance<TEntity extends Record<string, unknown>, TEditable extends Record<string, unknown> = TEntity, TReadonly extends Record<string, unknown> = {}>(ops: ActivityOperations<TEntity>, instanceId: string, data: TEntity, fields: Record<string, BaseField<unknown>>): ActivityInstanceType<TEntity, TEditable, TReadonly>;
+export {};
+//# sourceMappingURL=ActivityInstance.d.ts.map

package/dist/workflow/ActivityInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityInstance.d.ts","sourceRoot":"","sources":["../../sdk/workflow/ActivityInstance.ts"],"names":[],"mappings":"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"}

package/dist/workflow/client.d.ts

@@ -0,0 +1,39 @@
+import type { ActivityOperations, WorkflowStartResponseType } from "./types";
+/**
+ * Workflow client for Business Process / Activity operations.
+ *
+ * @example
+ * ```typescript
+ * const wf = new Workflow<LeaveType>("SimpleLeaveProcess");
+ *
+ * // Start workflow
+ * const { activityId, activityInstanceId } = await wf.start();
+ *
+ * // Get activity operations
+ * const act = wf.activity("EMPLOYEE_INPUT");
+ *
+ * // Instance operations (instanceId as first param)
+ * await act.read("inst_123");
+ * await act.draftStart("inst_123", data);
+ * await act.draftEnd("inst_123", data);
+ * await act.complete("inst_123");
+ *
+ * // List operations
+ * await act.list({ Page: 1, PageSize: 10 });
+ * await act.metric({ Metric: [...] });
+ * ```
+ */
+export declare class Workflow<T = any> {
+    private bp_id;
+    constructor(bp_id: string);
+    /**
+     * Start a new workflow instance
+     */
+    start(): Promise<WorkflowStartResponseType>;
+    /**
+     * Get all operations for a specific activity
+     * @param activity_id - Activity identifier
+     */
+    activity(activity_id: string): ActivityOperations<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/workflow/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../sdk/workflow/client.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAEV,kBAAkB,EAElB,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,QAAQ,CAAC,CAAC,GAAG,GAAG;IAC3B,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,EAAE,MAAM;IAIzB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAgBjD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC;CAiIrD"}

package/dist/workflow/components/useActivityForm/createActivityItemProxy.d.ts

@@ -0,0 +1,16 @@
+import type { UseFormReturn, FieldValues } from "react-hook-form";
+import type { FormItemType } from "../../../components/hooks/useForm/types";
+import type { Activity } from "../../Activity";
+import type { ExtractActivityEditable, ExtractActivityReadonly } from "./types";
+/**
+ * Creates a Proxy-based Item that delegates to RHF for state management.
+ *
+ * Key principle: Item has NO state. It's a view over RHF's state.
+ * Editable fields get set(), readonly fields do not.
+ *
+ * @param activity - The Activity instance for field metadata
+ * @param form - The RHF useForm return object
+ * @returns FormItemType proxy
+ */
+export declare function createActivityItemProxy<A extends Activity<any, any, any>>(activity: A, form: UseFormReturn<FieldValues>): FormItemType<ExtractActivityEditable<A>, ExtractActivityReadonly<A>>;
+//# sourceMappingURL=createActivityItemProxy.d.ts.map

package/dist/workflow/components/useActivityForm/createActivityItemProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createActivityItemProxy.d.ts","sourceRoot":"","sources":["../../../../sdk/workflow/components/useActivityForm/createActivityItemProxy.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAQ,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGxE,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACvE,QAAQ,EAAE,CAAC,EACX,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,GAC/B,YAAY,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC,CA2FtE"}

package/dist/workflow/components/useActivityForm/createActivityResolver.d.ts

@@ -0,0 +1,22 @@
+import type { FieldValues } from "react-hook-form";
+import type { Activity } from "../../Activity";
+/**
+ * Creates a React Hook Form resolver for Activity field validation.
+ *
+ * Validates only editable fields using BaseField.validate().
+ * Readonly fields (editable: false) are skipped.
+ *
+ * @param activity - The Activity instance with field definitions
+ * @returns RHF Resolver function
+ */
+export declare function createActivityResolver<A extends Activity<any, any, any>>(activity: A): (values: FieldValues, _context: any, options: any) => Promise<{
+    values: FieldValues;
+    errors: {};
+} | {
+    values: {};
+    errors: Record<string, {
+        type: string;
+        message: string;
+    }>;
+}>;
+//# sourceMappingURL=createActivityResolver.d.ts.map

package/dist/workflow/components/useActivityForm/createActivityResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createActivityResolver.d.ts","sourceRoot":"","sources":["../../../../sdk/workflow/components/useActivityForm/createActivityResolver.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACtE,QAAQ,EAAE,CAAC,IAGG,QAAQ,WAAW,EAAE,UAAU,GAAG,EAAE,SAAS,GAAG;;;;;;cACvB,MAAM;iBAAW,MAAM;;GAkC/D"}

package/dist/workflow/components/useActivityForm/index.d.ts

@@ -0,0 +1,3 @@
+export { useActivityForm } from './useActivityForm';
+export type { UseActivityFormOptions, UseActivityFormReturn, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/components/useActivityForm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../sdk/workflow/components/useActivityForm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,SAAS,CAAC"}

package/dist/workflow/components/useActivityForm/types.d.ts

@@ -0,0 +1,80 @@
+import type { UseFormWatch, UseFormSetValue, UseFormGetValues, UseFormReset, UseFormTrigger, Control, FieldErrors } from "react-hook-form";
+import type { Activity } from "../../Activity";
+import type { HandleSubmitType, FormItemType, FormRegisterType, EditableFormFieldAccessorType, ReadonlyFormFieldAccessorType } from "../../../components/hooks/useForm/types";
+export type { HandleSubmitType, FormItemType, FormRegisterType, EditableFormFieldAccessorType, ReadonlyFormFieldAccessorType, };
+/** Extract TEntity from an Activity instance */
+export type ExtractActivityEntity<A> = A extends Activity<infer E, any, any> ? E : never;
+/** Extract TEditable from an Activity instance */
+export type ExtractActivityEditable<A> = A extends Activity<any, infer E, any> ? E : never;
+/** Extract TReadonly from an Activity instance */
+export type ExtractActivityReadonly<A> = A extends Activity<any, any, infer R> ? R : never;
+/** All accessible fields (editable + readonly) */
+export type AllActivityFields<A> = ExtractActivityEditable<A> & ExtractActivityReadonly<A>;
+/**
+ * useActivityForm hook options.
+ *
+ * The Activity instance already carries businessProcessId, activityId, and field definitions.
+ * Options only contain runtime configuration.
+ */
+export interface UseActivityFormOptions<A extends Activity<any, any, any>> {
+    /** Activity instance identifier */
+    activity_instance_id: string;
+    /** Default form values */
+    defaultValues?: Partial<ExtractActivityEditable<A>>;
+    /**
+     * Validation mode — controls when validation runs
+     * @default "onBlur"
+     */
+    mode?: "onBlur" | "onChange" | "onSubmit" | "onTouched" | "all";
+    /**
+     * Whether to enable activity.read() on mount
+     * @default true
+     */
+    enabled?: boolean;
+}
+/**
+ * useActivityForm hook return type — mirrors useForm return structure
+ */
+export interface UseActivityFormReturn<A extends Activity<any, any, any>> {
+    /** Item proxy with typed field accessors */
+    item: FormItemType<ExtractActivityEditable<A>, ExtractActivityReadonly<A>>;
+    /** The Activity instance */
+    activity: A;
+    /** Smart register with auto-disable for readonly fields */
+    register: FormRegisterType<ExtractActivityEditable<A>, ExtractActivityReadonly<A>>;
+    /** Handle form submission — calls activity.update() + activity.draftEnd() */
+    handleSubmit: HandleSubmitType<AllActivityFields<A>>;
+    /** Handle form completion — calls activity.complete() */
+    handleComplete: HandleSubmitType<AllActivityFields<A>>;
+    /** Watch field values */
+    watch: UseFormWatch<AllActivityFields<A>>;
+    /** Set field value programmatically */
+    setValue: UseFormSetValue<ExtractActivityEditable<A>>;
+    /** Get current field values */
+    getValues: UseFormGetValues<AllActivityFields<A>>;
+    /** Reset form to default values */
+    reset: UseFormReset<AllActivityFields<A>>;
+    /** Trigger validation for specific fields or all fields */
+    trigger: UseFormTrigger<AllActivityFields<A>>;
+    /** RHF control object (for Controller components) */
+    control: Control<AllActivityFields<A>>;
+    /** Form validation errors */
+    errors: FieldErrors<AllActivityFields<A>>;
+    /** Form is valid */
+    isValid: boolean;
+    /** Form has been modified */
+    isDirty: boolean;
+    /** Form is currently submitting (save or complete) */
+    isSubmitting: boolean;
+    /** Form submission was successful */
+    isSubmitSuccessful: boolean;
+    /** True during activity.read() */
+    isLoading: boolean;
+    /** Schema/data load error */
+    loadError: Error | null;
+    /** Any error active */
+    hasError: boolean;
+    /** Clear all form errors */
+    clearErrors: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflow/components/useActivityForm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../sdk/workflow/components/useActivityForm/types.ts"],"names":[],"mappings":"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"}

package/dist/workflow/components/useActivityForm/useActivityForm.d.ts

@@ -0,0 +1,4 @@
+import type { Activity } from "../../Activity";
+import type { UseActivityFormOptions, UseActivityFormReturn } from "./types";
+export declare function useActivityForm<A extends Activity<any, any, any>>(activity: A, options: UseActivityFormOptions<A>): UseActivityFormReturn<A>;
+//# sourceMappingURL=useActivityForm.d.ts.map

package/dist/workflow/components/useActivityForm/useActivityForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActivityForm.d.ts","sourceRoot":"","sources":["../../../../sdk/workflow/components/useActivityForm/useActivityForm.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAUjB,wBAAgB,eAAe,CAC7B,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAEjC,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACjC,qBAAqB,CAAC,CAAC,CAAC,CAkW1B"}

package/dist/workflow/index.d.ts

@@ -0,0 +1,8 @@
+export { Workflow } from './client';
+export { Activity } from './Activity';
+export { ActivityInstance } from './ActivityInstance';
+export type { ActivityInstanceType, EditableFieldAccessor, ReadonlyFieldAccessor, } from './ActivityInstance';
+export type { ActivityInstanceFieldsType, ActivityOperations, ActivityProgressType, WorkflowStartResponseType, } from './types';
+export { useActivityForm } from './components/useActivityForm';
+export type { UseActivityFormOptions, UseActivityFormReturn, } from './components/useActivityForm';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../sdk/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC"}

package/dist/workflow/types.d.ts

@@ -0,0 +1,53 @@
+import type { ListOptionsType, ListResponseType, MetricOptionsType, MetricResponseType, DraftResponseType, CreateUpdateResponseType } from "../types/common";
+import type { StringFieldType, SelectFieldType, DateTimeFieldType, ReferenceFieldType } from "../types/base-fields";
+import type { UserRefType } from "../types/base-fields";
+/**
+ * Response from Workflow.start()
+ */
+export interface WorkflowStartResponseType {
+    activityId: string;
+    activityInstanceId: string;
+}
+/**
+ * Response from the activity progress endpoint
+ */
+export interface ActivityProgressType {
+    Stage?: string;
+    Progress?: number;
+    [key: string]: any;
+}
+/**
+ * System fields present on every activity instance response.
+ * Returned alongside activity-specific fields from `list()` and `read()`.
+ */
+export type ActivityInstanceFieldsType = {
+    _id: StringFieldType;
+    Status: SelectFieldType<"InProgress" | "Completed">;
+    AssignedTo: ReferenceFieldType<UserRefType>;
+    CompletedAt: DateTimeFieldType;
+};
+/**
+ * Unified activity operations — returned by Workflow.activity(activityId)
+ *
+ * List-level methods operate on the activity as a whole.
+ * Instance-level methods accept `instanceId` as their first parameter.
+ */
+export interface ActivityOperations<T> {
+    /** List activity instances (POST .../list) */
+    list(options?: ListOptionsType): Promise<ListResponseType<ActivityInstanceFieldsType & T>>;
+    /** Get activity metrics (POST .../metric) */
+    metric(options: Omit<MetricOptionsType, "Type">): Promise<MetricResponseType>;
+    /** Read the activity instance data (GET .../read) */
+    read(instanceId: string): Promise<ActivityInstanceFieldsType & T>;
+    /** Update the activity instance (POST .../update) */
+    update(instanceId: string, data: Partial<T>): Promise<CreateUpdateResponseType>;
+    /** Start a draft edit session (PATCH .../draft) */
+    draftStart(instanceId: string, data: Partial<T>): Promise<DraftResponseType>;
+    /** End a draft edit session and commit (POST .../draft) */
+    draftEnd(instanceId: string, data: Partial<T>): Promise<CreateUpdateResponseType>;
+    /** Complete the activity (POST .../done) */
+    complete(instanceId: string): Promise<CreateUpdateResponseType>;
+    /** Get activity progress (GET .../progress) */
+    progress(instanceId: string): Promise<ActivityProgressType>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflow/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../sdk/workflow/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,GAAG,EAAE,eAAe,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC,YAAY,GAAG,WAAW,CAAC,CAAC;IACpD,UAAU,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,WAAW,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IAGnC,8CAA8C;IAC9C,IAAI,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,0BAA0B,GAAG,CAAC,CAAC,CAAC,CAAC;IAE3F,6CAA6C;IAC7C,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAI9E,qDAAqD;IACrD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,GAAG,CAAC,CAAC,CAAC;IAElE,qDAAqD;IACrD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAEhF,mDAAmD;IACnD,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE7E,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAElF,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAEhE,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC7D"}

package/dist/workflow.cjs

@@ -0,0 +1 @@
+"use strict";var F=Object.defineProperty;var U=(c,s,t)=>s in c?F(c,s,{enumerable:!0,configurable:!0,writable:!0,value:t}):c[s]=t;var b=(c,s,t)=>U(c,typeof s!="symbol"?s+"":s,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("./client-DtPpfJc1.cjs"),L=require("./BaseField-Drp0-OxL.cjs"),f=require("react"),p=require("./index.esm-DuwT11sx.cjs"),N=require("./error-handling-CAoD0Kwb.cjs");class q{constructor(s){b(this,"bp_id");this.bp_id=s}async start(){const s=await fetch(`${d.getApiBaseUrl()}/api/app/process/${this.bp_id}/start`,{method:"POST",headers:d.getDefaultHeaders()});if(!s.ok)throw new Error(`Failed to start process: ${s.statusText}`);return s.json()}activity(s){const t=`/api/app/process/${this.bp_id}/${s}`;return{async list(i){const a={Type:"List",...i},e=await fetch(`${d.getApiBaseUrl()}${t}/list`,{method:"POST",headers:d.getDefaultHeaders(),body:JSON.stringify(a)});if(!e.ok)throw new Error(`Failed to list activities: ${e.statusText}`);return e.json()},async metric(i){const a={Type:"Metric",...i},e=await fetch(`${d.getApiBaseUrl()}${t}/metric`,{method:"POST",headers:d.getDefaultHeaders(),body:JSON.stringify(a)});if(!e.ok)throw new Error(`Failed to get activity metrics: ${e.statusText}`);return e.json()},async read(i){const a=await fetch(`${d.getApiBaseUrl()}${t}/${i}/read`,{method:"GET",headers:d.getDefaultHeaders()});if(!a.ok)throw new Error(`Failed to read activity: ${a.statusText}`);return(await a.json()).Data},async update(i,a){const e=await fetch(`${d.getApiBaseUrl()}${t}/${i}/update`,{method:"POST",headers:d.getDefaultHeaders(),body:JSON.stringify(a)});if(!e.ok)throw new Error(`Failed to update activity: ${e.statusText}`);return e.json()},async draftStart(i,a){const e=await fetch(`${d.getApiBaseUrl()}${t}/${i}/draft`,{method:"PATCH",headers:d.getDefaultHeaders(),body:JSON.stringify(a)});if(!e.ok)throw new Error(`Failed to start draft: ${e.statusText}`);return e.json()},async draftEnd(i,a){const e=await fetch(`${d.getApiBaseUrl()}${t}/${i}/draft`,{method:"POST",headers:d.getDefaultHeaders(),body:JSON.stringify(a)});if(!e.ok)throw new Error(`Failed to end draft: ${e.statusText}`);return e.json()},async complete(i){const a=await fetch(`${d.getApiBaseUrl()}${t}/${i}/done`,{method:"POST",headers:d.getDefaultHeaders()});if(!a.ok)throw new Error(`Failed to complete activity: ${a.statusText}`);return a.json()},async progress(i){const a=await fetch(`${d.getApiBaseUrl()}${t}/${i}/progress`,{method:"GET",headers:d.getDefaultHeaders()});if(!a.ok)throw new Error(`Failed to get activity progress: ${a.statusText}`);return a.json()}}}}class x{constructor(s,t,i,a){b(this,"_id");b(this,"_data");b(this,"_ops");b(this,"_fields");b(this,"_accessorCache",new Map);this._ops=s,this._id=t,this._data={...i},this._fields=a}toJSON(){return{...this._data}}validate(){const s=[];for(const[t,i]of Object.entries(this._fields)){const a=this._data[t],e=i.validate(a);e.valid||s.push(...e.errors)}return{valid:s.length===0,errors:s}}async update(s){return this._ops.update(this._id,s)}async save(s){return this._ops.draftEnd(this._id,s)}async complete(){return this._ops.complete(this._id)}async progress(){return this._ops.progress(this._id)}_getAccessor(s){if(this._accessorCache.has(s))return this._accessorCache.get(s);const t=this._fields[s],i=(t==null?void 0:t.meta)??{_id:s,Name:s,Type:"String"},a=(t==null?void 0:t.readOnly)??!1,e=()=>t?t.validate(this._data[s]):{valid:!0,errors:[]};let r;return a?r={label:(t==null?void 0:t.label)??s,required:(t==null?void 0:t.required)??!1,readOnly:!0,defaultValue:t==null?void 0:t.defaultValue,meta:i,get:()=>this._data[s],validate:e}:r={label:(t==null?void 0:t.label)??s,required:(t==null?void 0:t.required)??!1,readOnly:!1,defaultValue:t==null?void 0:t.defaultValue,meta:i,get:()=>this._data[s],set:y=>{this._data[s]=y},validate:e},this._accessorCache.set(s,r),r}}function G(c,s,t,i){const a=new x(c,s,t,i);return new Proxy(a,{get(e,r,y){return r==="validate"||r==="toJSON"||r==="update"||r==="save"||r==="complete"||r==="progress"||r==="_ops"||r==="_data"||r==="_fields"||r==="_accessorCache"||r==="_getAccessor"||typeof r=="symbol"?Reflect.get(e,r,y):r==="_id"?e._id:e._getAccessor(r)},has(e,r){return typeof r=="symbol"?!1:r==="validate"||r==="toJSON"||r==="update"||r==="save"||r==="complete"||r==="progress"||r==="_id"?!0:r in e._fields},ownKeys(e){return[...Object.keys(e._fields),"_id","validate","toJSON","update","save","complete","progress"]},getOwnPropertyDescriptor(e,r){if(typeof r!="symbol")return{configurable:!0,enumerable:r!=="validate"&&r!=="toJSON"&&r!=="update"&&r!=="save"&&r!=="complete"&&r!=="progress"}}})}class K{constructor(){b(this,"_fieldsCache",null)}_ops(){return new q(this.meta.businessProcessId).activity(this.meta.activityId)}_discoverFields(){if(this._fieldsCache)return this._fieldsCache;const s={};for(const t of Object.keys(this)){const i=this[t];i instanceof L.BaseField&&(s[t]=i)}return this._fieldsCache=s,s}async getInstanceList(s){return this._ops().list(s)}async instanceMetrics(s){return this._ops().metric(s)}async getInstance(s){const t=this._ops(),i=await t.read(s),a=this._discoverFields();return G(t,s,i,a)}_getFields(){return this._discoverFields()}_getOps(){return this._ops()}}function W(c){return async(s,t,i)=>{const a={},e=c._getFields(),r=(i==null?void 0:i.names)??Object.keys(e);for(const y of r){const w=e[y];if(!w||w.readOnly)continue;const $=s[y],O=w.validate($);!O.valid&&O.errors.length>0&&(a[y]={type:"validate",message:O.errors[0]||`${y} is invalid`})}return Object.keys(a).length===0?{values:s,errors:{}}:{values:{},errors:a}}}function z(c,s){const t=c._getFields();return new Proxy({},{get(i,a){if(typeof a=="symbol")return;if(a==="toJSON")return()=>s.getValues();if(a==="validate")return()=>s.trigger();const e=t[a],r=(e==null?void 0:e.meta)??{_id:a,Name:a,Type:"String"},y=(e==null?void 0:e.readOnly)??!1,w=()=>e?e.validate(s.getValues(a)):{valid:!0,errors:[]};return y?{label:(e==null?void 0:e.label)??a,required:(e==null?void 0:e.required)??!1,readOnly:!0,defaultValue:e==null?void 0:e.defaultValue,meta:r,get:()=>s.getValues(a),validate:w}:{label:(e==null?void 0:e.label)??a,required:(e==null?void 0:e.required)??!1,readOnly:!1,defaultValue:e==null?void 0:e.defaultValue,meta:r,get:()=>s.getValues(a),set:S=>{s.setValue(a,S,{shouldDirty:!0,shouldTouch:!0,shouldValidate:!1})},validate:w}},has(i,a){return typeof a=="symbol"?!1:a==="toJSON"||a==="validate"?!0:a in t},ownKeys(i){return[...Object.keys(t),"toJSON","validate"]},getOwnPropertyDescriptor(i,a){if(typeof a!="symbol")return{configurable:!0,enumerable:a!=="toJSON"&&a!=="validate"}}})}function Q(c,s){const{activity_instance_id:t,defaultValues:i={},mode:a="onBlur",enabled:e=!0}=s,[r,y]=f.useState(!1),[w,$]=f.useState(null),[O,S]=f.useState(!1),j=f.useRef(!1),A=f.useRef(null),T=f.useMemo(()=>c._getFields(),[c]),V=f.useMemo(()=>Object.keys(T).filter(u=>T[u].readOnly),[T]),J=f.useMemo(()=>W(c),[c]),n=p.useForm({mode:a,defaultValues:i,resolver:J}),P=f.useMemo(()=>z(c,n),[c,n]),v=f.useMemo(()=>c._getOps(),[c]);f.useEffect(()=>{if(!e)return;let u=!0;return(async()=>{y(!0),$(null);try{const o=await v.read(t);if(!u)return;o&&typeof o=="object"&&n.reset({...i,...o})}catch(o){if(!u)return;console.error("Failed to read activity data:",o),$(N.toError(o))}finally{u&&y(!1)}})(),()=>{u=!1}},[e,v,t]);const k=f.useCallback(async u=>{V.length!==0&&(j.current||(A.current&&clearTimeout(A.current),A.current=setTimeout(async()=>{if(!j.current){j.current=!0;try{const l=n.getValues(),o={},h=new Set(V);Object.keys(l).forEach(_=>{h.has(_)||(o[_]=l[_])});const g=await v.draftStart(t,o);g&&typeof g=="object"&&Object.entries(g).forEach(([_,m])=>{h.has(_)&&n.getValues(_)!==m&&n.setValue(_,m,{shouldDirty:!1,shouldValidate:!1})})}catch(l){console.warn("Draft computation failed:",l)}finally{j.current=!1}}},300)))},[v,V,n]),R=f.useCallback((u,l)=>{const o=T[u],h=o?o.readOnly:!1,g=l==null?void 0:l.onBlur,_=async C=>{g&&await g(C);let B=!0;a==="onBlur"||a==="onTouched"||a==="all"?B=await n.trigger(u):B=!n.getFieldState(u,n.formState).error,B&&await k(u)},m=n.register(u,{...l,onBlur:_,...h?{disabled:!0}:{}});return h?{...m,disabled:!0}:m},[n,T,k,a]),H=f.useCallback((u,l)=>n.handleSubmit(async(o,h)=>{S(!0);try{const g={},_=new Set(V);Object.keys(o).forEach(m=>{!_.has(m)&&o[m]!==void 0&&(g[m]=o[m])}),await v.update(t,g),await v.draftEnd(t,g),await(u==null?void 0:u(o,h))}catch(g){l==null||l(N.toError(g),h)}finally{S(!1)}},(o,h)=>{l==null||l(o,h)}),[n,v,V]),M=f.useCallback((u,l)=>n.handleSubmit(async(o,h)=>{S(!0);try{await v.complete(t),await(u==null?void 0:u(o,h))}catch(g){l==null||l(N.toError(g),h)}finally{S(!1)}},(o,h)=>{l==null||l(o,h)}),[n,v]),D=f.useCallback(()=>{n.clearErrors()},[n]),E=!!w;return{item:P,activity:c,register:R,handleSubmit:H,handleComplete:M,watch:n.watch,setValue:n.setValue,getValues:n.getValues,reset:n.reset,trigger:n.trigger,control:n.control,errors:n.formState.errors,isValid:n.formState.isValid,isDirty:n.formState.isDirty,isSubmitting:n.formState.isSubmitting||O,isSubmitSuccessful:n.formState.isSubmitSuccessful,isLoading:r,loadError:w,hasError:E,clearErrors:D}}exports.Activity=K;exports.ActivityInstance=x;exports.Workflow=q;exports.useActivityForm=Q;