@elizaos/ui 2.0.0-alpha.25 → 2.0.0-alpha.334

package/packages/typescript/src/features/advanced-capabilities/form/builder.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @module builder
+ * @description Fluent builder API for defining forms and controls
+ */
+import type { JsonValue } from "../../../types/index.ts";
+import type { FormControl, FormControlDependency, FormControlOption, FormDefinition, FormDefinitionHooks } from "./types.ts";
+export declare class ControlBuilder {
+    private control;
+    constructor(key: string);
+    static field(key: string): ControlBuilder;
+    static text(key: string): ControlBuilder;
+    static email(key: string): ControlBuilder;
+    static number(key: string): ControlBuilder;
+    static boolean(key: string): ControlBuilder;
+    static select(key: string, options: FormControlOption[]): ControlBuilder;
+    static date(key: string): ControlBuilder;
+    static file(key: string): ControlBuilder;
+    type(type: string): this;
+    required(): this;
+    optional(): this;
+    hidden(): this;
+    sensitive(): this;
+    readonly(): this;
+    multiple(): this;
+    pattern(regex: string): this;
+    min(n: number): this;
+    max(n: number): this;
+    minLength(n: number): this;
+    maxLength(n: number): this;
+    enum(values: string[]): this;
+    options(opts: FormControlOption[]): this;
+    label(label: string): this;
+    ask(prompt: string): this;
+    description(desc: string): this;
+    hint(...hints: string[]): this;
+    example(value: string): this;
+    confirmThreshold(n: number): this;
+    accept(mimeTypes: string[]): this;
+    maxSize(bytes: number): this;
+    maxFiles(n: number): this;
+    roles(...roles: string[]): this;
+    default(value: JsonValue): this;
+    dependsOn(field: string, condition?: FormControlDependency["condition"], value?: JsonValue): this;
+    dbbind(columnName: string): this;
+    section(name: string): this;
+    order(n: number): this;
+    placeholder(text: string): this;
+    helpText(text: string): this;
+    widget(type: string): this;
+    i18n(locale: string, translations: {
+        label?: string;
+        description?: string;
+        askPrompt?: string;
+        helpText?: string;
+    }): this;
+    meta(key: string, value: JsonValue): this;
+    build(): FormControl;
+}
+export declare class FormBuilder {
+    private form;
+    constructor(id: string);
+    static create(id: string): FormBuilder;
+    name(name: string): this;
+    description(desc: string): this;
+    version(v: number): this;
+    control(builder: ControlBuilder | FormControl): this;
+    controls(...builders: (ControlBuilder | FormControl)[]): this;
+    required(...keys: string[]): this;
+    optional(...keys: string[]): this;
+    roles(...roles: string[]): this;
+    allowMultiple(): this;
+    noUndo(): this;
+    noSkip(): this;
+    noAutofill(): this;
+    maxUndoSteps(n: number): this;
+    ttl(config: {
+        minDays?: number;
+        maxDays?: number;
+        effortMultiplier?: number;
+    }): this;
+    noNudge(): this;
+    nudgeAfter(hours: number): this;
+    nudgeMessage(message: string): this;
+    onStart(workerName: string): this;
+    onFieldChange(workerName: string): this;
+    onReady(workerName: string): this;
+    onSubmit(workerName: string): this;
+    onCancel(workerName: string): this;
+    onExpire(workerName: string): this;
+    hooks(hooks: FormDefinitionHooks): this;
+    debug(): this;
+    i18n(locale: string, translations: {
+        name?: string;
+        description?: string;
+    }): this;
+    meta(key: string, value: JsonValue): this;
+    build(): FormDefinition;
+}
+export declare const Form: typeof FormBuilder;
+export declare const C: typeof ControlBuilder;
+//# sourceMappingURL=builder.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/form/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/form/builder.ts"],"names":[],"mappings":"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"}

package/packages/typescript/src/features/advanced-capabilities/form/builder.js

@@ -0,0 +1,362 @@
+/**
+ * @module builder
+ * @description Fluent builder API for defining forms and controls
+ */
+// ============================================================================
+// CONTROL BUILDER
+// ============================================================================
+export class ControlBuilder {
+    control;
+    constructor(key) {
+        this.control = { key };
+    }
+    // ═══ STATIC FACTORIES ═══
+    static field(key) {
+        return new ControlBuilder(key);
+    }
+    static text(key) {
+        return new ControlBuilder(key).type("text");
+    }
+    static email(key) {
+        return new ControlBuilder(key).type("email");
+    }
+    static number(key) {
+        return new ControlBuilder(key).type("number");
+    }
+    static boolean(key) {
+        return new ControlBuilder(key).type("boolean");
+    }
+    static select(key, options) {
+        return new ControlBuilder(key).type("select").options(options);
+    }
+    static date(key) {
+        return new ControlBuilder(key).type("date");
+    }
+    static file(key) {
+        return new ControlBuilder(key).type("file");
+    }
+    // ═══ TYPE ═══
+    type(type) {
+        this.control.type = type;
+        return this;
+    }
+    // ═══ BEHAVIOR ═══
+    required() {
+        this.control.required = true;
+        return this;
+    }
+    optional() {
+        this.control.required = false;
+        return this;
+    }
+    hidden() {
+        this.control.hidden = true;
+        return this;
+    }
+    sensitive() {
+        this.control.sensitive = true;
+        return this;
+    }
+    readonly() {
+        this.control.readonly = true;
+        return this;
+    }
+    multiple() {
+        this.control.multiple = true;
+        return this;
+    }
+    // ═══ VALIDATION ═══
+    pattern(regex) {
+        this.control.pattern = regex;
+        return this;
+    }
+    min(n) {
+        this.control.min = n;
+        return this;
+    }
+    max(n) {
+        this.control.max = n;
+        return this;
+    }
+    minLength(n) {
+        this.control.minLength = n;
+        return this;
+    }
+    maxLength(n) {
+        this.control.maxLength = n;
+        return this;
+    }
+    enum(values) {
+        this.control.enum = values;
+        return this;
+    }
+    options(opts) {
+        this.control.options = opts;
+        return this;
+    }
+    // ═══ AGENT HINTS ═══
+    label(label) {
+        this.control.label = label;
+        return this;
+    }
+    ask(prompt) {
+        this.control.askPrompt = prompt;
+        return this;
+    }
+    description(desc) {
+        this.control.description = desc;
+        return this;
+    }
+    hint(...hints) {
+        this.control.extractHints = hints;
+        return this;
+    }
+    example(value) {
+        this.control.example = value;
+        return this;
+    }
+    confirmThreshold(n) {
+        this.control.confirmThreshold = n;
+        return this;
+    }
+    // ═══ FILE OPTIONS ═══
+    accept(mimeTypes) {
+        this.control.file = { ...this.control.file, accept: mimeTypes };
+        return this;
+    }
+    maxSize(bytes) {
+        this.control.file = { ...this.control.file, maxSize: bytes };
+        return this;
+    }
+    maxFiles(n) {
+        this.control.file = { ...this.control.file, maxFiles: n };
+        return this;
+    }
+    // ═══ ACCESS ═══
+    roles(...roles) {
+        this.control.roles = roles;
+        return this;
+    }
+    // ═══ DEFAULTS & CONDITIONS ═══
+    default(value) {
+        this.control.defaultValue = value;
+        return this;
+    }
+    dependsOn(field, condition = "exists", value) {
+        this.control.dependsOn = { field, condition, value };
+        return this;
+    }
+    // ═══ DATABASE ═══
+    dbbind(columnName) {
+        this.control.dbbind = columnName;
+        return this;
+    }
+    // ═══ UI ═══
+    section(name) {
+        this.control.ui = { ...this.control.ui, section: name };
+        return this;
+    }
+    order(n) {
+        this.control.ui = { ...this.control.ui, order: n };
+        return this;
+    }
+    placeholder(text) {
+        this.control.ui = { ...this.control.ui, placeholder: text };
+        return this;
+    }
+    helpText(text) {
+        this.control.ui = { ...this.control.ui, helpText: text };
+        return this;
+    }
+    widget(type) {
+        this.control.ui = { ...this.control.ui, widget: type };
+        return this;
+    }
+    // ═══ I18N ═══
+    i18n(locale, translations) {
+        this.control.i18n = { ...this.control.i18n, [locale]: translations };
+        return this;
+    }
+    // ═══ META ═══
+    meta(key, value) {
+        this.control.meta = { ...this.control.meta, [key]: value };
+        return this;
+    }
+    // ═══ BUILD ═══
+    build() {
+        const key = this.control.key;
+        if (!key) {
+            throw new Error("Control key is required");
+        }
+        const control = {
+            key,
+            label: this.control.label || prettify(key),
+            type: this.control.type || "text",
+            ...this.control,
+        };
+        return control;
+    }
+}
+// ============================================================================
+// FORM BUILDER
+// ============================================================================
+export class FormBuilder {
+    form;
+    constructor(id) {
+        this.form = { id, controls: [] };
+    }
+    static create(id) {
+        return new FormBuilder(id);
+    }
+    // ═══ METADATA ═══
+    name(name) {
+        this.form.name = name;
+        return this;
+    }
+    description(desc) {
+        this.form.description = desc;
+        return this;
+    }
+    version(v) {
+        this.form.version = v;
+        return this;
+    }
+    // ═══ CONTROLS ═══
+    control(builder) {
+        const ctrl = builder instanceof ControlBuilder ? builder.build() : builder;
+        this.form.controls?.push(ctrl);
+        return this;
+    }
+    controls(...builders) {
+        for (const builder of builders) {
+            this.control(builder);
+        }
+        return this;
+    }
+    // ═══ SHORTHAND CONTROLS ═══
+    required(...keys) {
+        for (const key of keys) {
+            this.control(ControlBuilder.field(key).required());
+        }
+        return this;
+    }
+    optional(...keys) {
+        for (const key of keys) {
+            this.control(ControlBuilder.field(key));
+        }
+        return this;
+    }
+    // ═══ PERMISSIONS ═══
+    roles(...roles) {
+        this.form.roles = roles;
+        return this;
+    }
+    allowMultiple() {
+        this.form.allowMultiple = true;
+        return this;
+    }
+    // ═══ UX ═══
+    noUndo() {
+        this.form.ux = { ...this.form.ux, allowUndo: false };
+        return this;
+    }
+    noSkip() {
+        this.form.ux = { ...this.form.ux, allowSkip: false };
+        return this;
+    }
+    noAutofill() {
+        this.form.ux = { ...this.form.ux, allowAutofill: false };
+        return this;
+    }
+    maxUndoSteps(n) {
+        this.form.ux = { ...this.form.ux, maxUndoSteps: n };
+        return this;
+    }
+    // ═══ TTL ═══
+    ttl(config) {
+        this.form.ttl = { ...this.form.ttl, ...config };
+        return this;
+    }
+    // ═══ NUDGE ═══
+    noNudge() {
+        this.form.nudge = { ...this.form.nudge, enabled: false };
+        return this;
+    }
+    nudgeAfter(hours) {
+        this.form.nudge = { ...this.form.nudge, afterInactiveHours: hours };
+        return this;
+    }
+    nudgeMessage(message) {
+        this.form.nudge = { ...this.form.nudge, message };
+        return this;
+    }
+    // ═══ HOOKS ═══
+    onStart(workerName) {
+        this.form.hooks = { ...this.form.hooks, onStart: workerName };
+        return this;
+    }
+    onFieldChange(workerName) {
+        this.form.hooks = { ...this.form.hooks, onFieldChange: workerName };
+        return this;
+    }
+    onReady(workerName) {
+        this.form.hooks = { ...this.form.hooks, onReady: workerName };
+        return this;
+    }
+    onSubmit(workerName) {
+        this.form.hooks = { ...this.form.hooks, onSubmit: workerName };
+        return this;
+    }
+    onCancel(workerName) {
+        this.form.hooks = { ...this.form.hooks, onCancel: workerName };
+        return this;
+    }
+    onExpire(workerName) {
+        this.form.hooks = { ...this.form.hooks, onExpire: workerName };
+        return this;
+    }
+    hooks(hooks) {
+        this.form.hooks = { ...this.form.hooks, ...hooks };
+        return this;
+    }
+    // ═══ DEBUG ═══
+    debug() {
+        this.form.debug = true;
+        return this;
+    }
+    // ═══ I18N ═══
+    i18n(locale, translations) {
+        this.form.i18n = { ...this.form.i18n, [locale]: translations };
+        return this;
+    }
+    // ═══ META ═══
+    meta(key, value) {
+        this.form.meta = { ...this.form.meta, [key]: value };
+        return this;
+    }
+    // ═══ BUILD ═══
+    build() {
+        const id = this.form.id;
+        if (!id) {
+            throw new Error("Form id is required");
+        }
+        const form = {
+            id,
+            name: this.form.name || prettify(id),
+            controls: this.form.controls || [],
+            ...this.form,
+        };
+        return form;
+    }
+}
+// ============================================================================
+// SHORTHAND EXPORTS
+// ============================================================================
+export const Form = FormBuilder;
+export const C = ControlBuilder;
+// ============================================================================
+// UTILITY
+// ============================================================================
+function prettify(key) {
+    return key.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}

package/packages/typescript/src/features/advanced-capabilities/form/builtins.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @module builtins
+ * @description Built-in control types for the Form Plugin
+ *
+ * Standard control types available out of the box:
+ * text, number, email, boolean, select, date, file
+ */
+import type { ControlType } from "./types.ts";
+export declare const BUILTIN_TYPES: ControlType[];
+export declare const BUILTIN_TYPE_MAP: Map<string, ControlType>;
+export declare function registerBuiltinTypes(registerFn: (type: ControlType, options?: {
+    allowOverride?: boolean;
+}) => void): void;
+export declare function getBuiltinType(id: string): ControlType | undefined;
+export declare function isBuiltinType(id: string): boolean;
+//# sourceMappingURL=builtins.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/form/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/form/builtins.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAiC,MAAM,YAAY,CAAC;AAsR7E,eAAO,MAAM,aAAa,EAAE,WAAW,EAQtC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAErD,CAAC;AAEF,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,CACX,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,KACjC,IAAI,GACP,IAAI,CAIN;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAElE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD"}