@timeax/digital-service-engine 0.3.4 → 0.3.5

package/dist/workspace/index.d.cts

@@ -186,6 +186,75 @@ interface BaseFieldUI {
     /** Host-defined prop names → runtime default values (untyped base) */
     defaults?: Record<string, unknown>;
 }
+type Ui = (UiString | UiNumber | UiBoolean | UiAnyOf | UiArray | UiObject) & {
+    description: string;
+    label: string;
+};
+/** string */
+interface UiString {
+    type: "string";
+    enum?: string[];
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+}
+/** number */
+interface UiNumber {
+    type: "number";
+    minimum?: number;
+    maximum?: number;
+    multipleOf?: number;
+}
+/** boolean */
+interface UiBoolean {
+    type: "boolean";
+}
+/** enumerated choices */
+interface UiAnyOf {
+    type: "anyOf";
+    multiple?: boolean;
+    items: Array<{
+        type: "string" | "number" | "boolean";
+        title?: string;
+        description?: string;
+        value: string | number | boolean;
+    }>;
+}
+/** arrays: homogeneous (item) or tuple (items) */
+interface UiArray {
+    type: "array";
+    label: string;
+    description: string;
+    item?: Ui;
+    items?: Ui[];
+    editable?: boolean;
+    /**
+     * Optional: allowed shapes for new items.
+     * Key = label shown in UI picker
+     * Value = schema for the new element
+     */
+    shape?: Record<string, Ui>;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+}
+/** objects: nested props */
+interface UiObject {
+    type: "object";
+    label: string;
+    description: string;
+    editable?: boolean;
+    fields: Record<string, Ui>;
+    /**
+     * Optional: allowed shapes for dynamically added keys.
+     * Key = human-readable name shown in UI picker
+     * Value = schema applied to the value of the new key
+     */
+    shape?: Record<string, Ui>;
+    required?: string[];
+    order?: string[];
+}
 type FieldValidationValueBy = "value" | "length" | "eval";
 type FieldValidationOp = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "between" | "in" | "nin" | "truthy" | "falsy" | "match";
 type FieldValidationRule = {
@@ -1692,6 +1761,59 @@ type QuantityRule = {
     fallback?: number;
 };
 
+/** Matches your InputWrapper’s expectations */
+type InputKind = string;
+type InputVariant = "default" | (string & {});
+type AdapterCtx = {
+    field: Field;
+    props: ServiceProps;
+};
+type Adapter = {
+    valueProp?: string;
+    changeProp?: string;
+    errorProp?: string;
+    /** normalize what the host emitted into what we store in form-palette */
+    getValue?: (next: unknown, current: unknown, ctx: AdapterCtx) => unknown;
+    /** REQUIRED if field.options exists */
+    getSelectedOptions?: (next: unknown, current: unknown, ctx: AdapterCtx) => string[];
+    /** For option-less action buttons (button: true with no options) */
+    isActive?: (stored: unknown, ctx: AdapterCtx) => boolean;
+    getInputPropsFromField?: (props: AdapterCtx) => any;
+    toValue?: (value: any) => any;
+};
+type InputOptionCapability = {
+    supported?: boolean;
+    autoCreate?: boolean;
+    defaultLabel?: string;
+    defaultValue?: string | number;
+};
+type InputMultiCapability = {
+    supported?: boolean;
+    autoEnable?: boolean;
+};
+type InputDescriptor = {
+    Component: React__default.ComponentType<Record<string, unknown>>;
+    adapter?: Adapter;
+    defaultProps?: Record<string, unknown>;
+    ui?: Record<string, Ui>;
+    options?: InputOptionCapability;
+    multi?: InputMultiCapability;
+};
+type VariantMap = Map<InputVariant, InputDescriptor>;
+type RegistryStore = Map<InputKind, VariantMap>;
+type Registry = {
+    get(kind: InputKind, variant?: InputVariant): InputDescriptor | undefined;
+    register(kind: InputKind, descriptor: InputDescriptor, variant?: InputVariant): void;
+    unregister(kind: InputKind, variant?: InputVariant): void;
+    registerMany(entries: Array<{
+        kind: InputKind;
+        descriptor: InputDescriptor;
+        variant?: InputVariant;
+    }>): void;
+    /** low-level escape hatch */
+    _store: RegistryStore;
+};
+
 declare class Editor {
     private readonly builder;
     private readonly api;
@@ -1763,7 +1885,14 @@ declare class Editor {
         id?: string;
         label: string;
         type: Field["type"];
-    }): void;
+    }): string;
+    addFieldFromDescriptor(registry: Registry, partial: Omit<Field, "id" | "label" | "type"> & {
+        id?: string;
+        label: string;
+        type: Field["type"];
+    }, opts?: {
+        variant?: InputVariant;
+    }): string;
     updateField(id: string, patch: Partial<Field>): void;
     removeField(id: string): void;
     remove(id: string): void;
@@ -1782,6 +1911,7 @@ declare class Editor {
     setPricingRoleMany(ids: readonly string[], role: "base" | "utility"): void;
     clearFieldDefaultsMany(ids: readonly string[]): void;
     clearFieldValidationMany(ids: readonly string[]): void;
+    setFieldMulti(fieldId: string, enabled: boolean): void;
     autoCreateOptionsMany(ids: readonly string[], makeOption?: (fieldId: string) => {
         id?: string;
         label: string;

package/dist/workspace/index.d.ts

@@ -186,6 +186,75 @@ interface BaseFieldUI {
     /** Host-defined prop names → runtime default values (untyped base) */
     defaults?: Record<string, unknown>;
 }
+type Ui = (UiString | UiNumber | UiBoolean | UiAnyOf | UiArray | UiObject) & {
+    description: string;
+    label: string;
+};
+/** string */
+interface UiString {
+    type: "string";
+    enum?: string[];
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+}
+/** number */
+interface UiNumber {
+    type: "number";
+    minimum?: number;
+    maximum?: number;
+    multipleOf?: number;
+}
+/** boolean */
+interface UiBoolean {
+    type: "boolean";
+}
+/** enumerated choices */
+interface UiAnyOf {
+    type: "anyOf";
+    multiple?: boolean;
+    items: Array<{
+        type: "string" | "number" | "boolean";
+        title?: string;
+        description?: string;
+        value: string | number | boolean;
+    }>;
+}
+/** arrays: homogeneous (item) or tuple (items) */
+interface UiArray {
+    type: "array";
+    label: string;
+    description: string;
+    item?: Ui;
+    items?: Ui[];
+    editable?: boolean;
+    /**
+     * Optional: allowed shapes for new items.
+     * Key = label shown in UI picker
+     * Value = schema for the new element
+     */
+    shape?: Record<string, Ui>;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+}
+/** objects: nested props */
+interface UiObject {
+    type: "object";
+    label: string;
+    description: string;
+    editable?: boolean;
+    fields: Record<string, Ui>;
+    /**
+     * Optional: allowed shapes for dynamically added keys.
+     * Key = human-readable name shown in UI picker
+     * Value = schema applied to the value of the new key
+     */
+    shape?: Record<string, Ui>;
+    required?: string[];
+    order?: string[];
+}
 type FieldValidationValueBy = "value" | "length" | "eval";
 type FieldValidationOp = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "between" | "in" | "nin" | "truthy" | "falsy" | "match";
 type FieldValidationRule = {
@@ -1692,6 +1761,59 @@ type QuantityRule = {
     fallback?: number;
 };
 
+/** Matches your InputWrapper’s expectations */
+type InputKind = string;
+type InputVariant = "default" | (string & {});
+type AdapterCtx = {
+    field: Field;
+    props: ServiceProps;
+};
+type Adapter = {
+    valueProp?: string;
+    changeProp?: string;
+    errorProp?: string;
+    /** normalize what the host emitted into what we store in form-palette */
+    getValue?: (next: unknown, current: unknown, ctx: AdapterCtx) => unknown;
+    /** REQUIRED if field.options exists */
+    getSelectedOptions?: (next: unknown, current: unknown, ctx: AdapterCtx) => string[];
+    /** For option-less action buttons (button: true with no options) */
+    isActive?: (stored: unknown, ctx: AdapterCtx) => boolean;
+    getInputPropsFromField?: (props: AdapterCtx) => any;
+    toValue?: (value: any) => any;
+};
+type InputOptionCapability = {
+    supported?: boolean;
+    autoCreate?: boolean;
+    defaultLabel?: string;
+    defaultValue?: string | number;
+};
+type InputMultiCapability = {
+    supported?: boolean;
+    autoEnable?: boolean;
+};
+type InputDescriptor = {
+    Component: React__default.ComponentType<Record<string, unknown>>;
+    adapter?: Adapter;
+    defaultProps?: Record<string, unknown>;
+    ui?: Record<string, Ui>;
+    options?: InputOptionCapability;
+    multi?: InputMultiCapability;
+};
+type VariantMap = Map<InputVariant, InputDescriptor>;
+type RegistryStore = Map<InputKind, VariantMap>;
+type Registry = {
+    get(kind: InputKind, variant?: InputVariant): InputDescriptor | undefined;
+    register(kind: InputKind, descriptor: InputDescriptor, variant?: InputVariant): void;
+    unregister(kind: InputKind, variant?: InputVariant): void;
+    registerMany(entries: Array<{
+        kind: InputKind;
+        descriptor: InputDescriptor;
+        variant?: InputVariant;
+    }>): void;
+    /** low-level escape hatch */
+    _store: RegistryStore;
+};
+
 declare class Editor {
     private readonly builder;
     private readonly api;
@@ -1763,7 +1885,14 @@ declare class Editor {
         id?: string;
         label: string;
         type: Field["type"];
-    }): void;
+    }): string;
+    addFieldFromDescriptor(registry: Registry, partial: Omit<Field, "id" | "label" | "type"> & {
+        id?: string;
+        label: string;
+        type: Field["type"];
+    }, opts?: {
+        variant?: InputVariant;
+    }): string;
     updateField(id: string, patch: Partial<Field>): void;
     removeField(id: string): void;
     remove(id: string): void;
@@ -1782,6 +1911,7 @@ declare class Editor {
     setPricingRoleMany(ids: readonly string[], role: "base" | "utility"): void;
     clearFieldDefaultsMany(ids: readonly string[]): void;
     clearFieldValidationMany(ids: readonly string[]): void;
+    setFieldMulti(fieldId: string, enabled: boolean): void;
     autoCreateOptionsMany(ids: readonly string[], makeOption?: (fieldId: string) => {
         id?: string;
         label: string;

package/dist/workspace/index.js

@@ -7422,6 +7422,11 @@ function rateIssueAffectsCandidate(error, candidateId, candidateFieldId, primary
   });
 }
 
+// src/react/inputs/registry.ts
+function resolveInputDescriptor(registry, kind, variant) {
+  return registry.get(kind, variant);
+}
+
 // src/react/canvas/editor/editor-ids.ts
 function uniqueId(ctx, base) {
   var _a, _b;
@@ -8332,6 +8337,7 @@ function addField(ctx, partial) {
       p.fields = ((_a2 = p.fields) != null ? _a2 : []).filter((f) => f.id !== id);
     })
   });
+  return id;
 }
 function updateField(ctx, id, patch) {
   let prev;
@@ -9768,6 +9774,36 @@ var Editor = class {
   addField(partial) {
     return addField(this.moduleCtx(), partial);
   }
+  addFieldFromDescriptor(registry, partial, opts) {
+    var _a, _b, _c, _d, _e;
+    const variant = (_b = opts == null ? void 0 : opts.variant) != null ? _b : typeof ((_a = partial == null ? void 0 : partial.meta) == null ? void 0 : _a.variant) === "string" ? partial.meta.variant : void 0;
+    const descriptor = resolveInputDescriptor(
+      registry,
+      String(partial.type),
+      variant
+    );
+    const nextMeta = {
+      ...(_c = partial.meta) != null ? _c : {}
+    };
+    if (((_d = descriptor == null ? void 0 : descriptor.multi) == null ? void 0 : _d.autoEnable) === true) {
+      nextMeta.multi = true;
+    }
+    const fieldInput = {
+      ...partial,
+      ...Object.keys(nextMeta).length ? { meta: nextMeta } : {}
+    };
+    const fieldId = this.addField(fieldInput);
+    if (((_e = descriptor == null ? void 0 : descriptor.options) == null ? void 0 : _e.autoCreate) === true) {
+      this.autoCreateOptionsMany([fieldId], () => {
+        var _a2, _b2, _c2, _d2;
+        return {
+          label: (_b2 = (_a2 = descriptor.options) == null ? void 0 : _a2.defaultLabel) != null ? _b2 : "Option label",
+          value: (_d2 = (_c2 = descriptor.options) == null ? void 0 : _c2.defaultValue) != null ? _d2 : "option"
+        };
+      });
+    }
+    return fieldId;
+  }
   updateField(id, patch) {
     return updateField(this.moduleCtx(), id, patch);
   }
@@ -9963,6 +9999,28 @@ var Editor = class {
       });
     });
   }
+  setFieldMulti(fieldId, enabled) {
+    const flag = enabled === true;
+    this.transact("setFieldMulti", () => {
+      this.patchProps((p) => {
+        var _a, _b;
+        const f = ((_a = p.fields) != null ? _a : []).find((x) => x.id === fieldId);
+        if (!f) return;
+        const currentMeta = (_b = f.meta) != null ? _b : {};
+        const nextMeta = { ...currentMeta };
+        if (flag) {
+          nextMeta.multi = true;
+        } else {
+          delete nextMeta.multi;
+        }
+        if (Object.keys(nextMeta).length === 0) {
+          delete f.meta;
+        } else {
+          f.meta = nextMeta;
+        }
+      });
+    });
+  }
   autoCreateOptionsMany(ids, makeOption) {
     const ordered = Array.from(new Set((ids != null ? ids : []).map((id) => String(id))));
     if (!ordered.length) return;