@elaraai/east-ui 0.0.1-beta.2 → 0.0.1-beta.4

package/dist/src/forms/field/index.js

@@ -129,8 +129,50 @@ function createField(label, control, style) {
  * ```
  */
 export const Field = {
+    /**
+     * Creates a Field component wrapping a form control with label and messages.
+     *
+     * @param label - Label text for the field
+     * @param control - The form control component (Input, Select, Checkbox, etc.)
+     * @param style - Optional configuration for helper text, error text, and states
+     * @returns An East expression representing the field component
+     *
+     * @remarks
+     * Field provides a consistent way to present form controls with labels,
+     * helper text, and validation messages. It wraps any form control component.
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Field, Input, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Field.Root(
+     *         "Email",
+     *         Input.String("", { placeholder: "Enter email" }),
+     *         { helperText: "We'll never share your email" }
+     *     );
+     * });
+     * ```
+     */
     Root: createField,
     Types: {
+        /**
+         * The concrete East type for Field component data.
+         *
+         * @remarks
+         * Field wraps a form control (Input, Select, Checkbox, etc.) with
+         * a label and optional helper/error text for form field presentation.
+         *
+         * @property label - Label text for the field
+         * @property control - The form control component (Input, Select, etc.)
+         * @property helperText - Optional descriptive help text
+         * @property errorText - Optional validation error message
+         * @property required - Whether the field is required
+         * @property disabled - Whether the field is disabled
+         * @property invalid - Whether the field is in an invalid state
+         * @property readOnly - Whether the field is read-only
+         */
         Field: FieldType,
     },
 };

package/dist/src/forms/field/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/forms/field/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,OAAO,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAmB,MAAM,YAAY,CAAC;AAE7C,kBAAkB;AAClB,OAAO,EAAmB,MAAM,YAAY,CAAC;AAE7C,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;IAChC,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,eAAe;IACxB,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC;IAClC,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC;IACjC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;IACjC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;IACjC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC;IAChC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;CACpC,CAAC,CAAC;AAOH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,SAAS,WAAW,CAChB,KAAqC,EACrC,OAAkC,EAClC,KAAkB;IAElB,MAAM,cAAc,GAAG,CAAC,GAA+C,EAAE,EAAE;QACvE,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,GAAgD,EAAE,EAAE;QACtE,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC;IAEF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE;QAC/B,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC;QAC7C,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC;QAC3C,QAAQ,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;QACvC,QAAQ,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;QACvC,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC;QACrC,QAAQ,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;KAC1C,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACjB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE;QACH,KAAK,EAAE,SAAS;KACnB;CACK,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/forms/field/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,OAAO,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAmB,MAAM,YAAY,CAAC;AAE7C,kBAAkB;AAClB,OAAO,EAAmB,MAAM,YAAY,CAAC;AAE7C,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;IAChC,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,eAAe;IACxB,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC;IAClC,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC;IACjC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;IACjC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;IACjC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC;IAChC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;CACpC,CAAC,CAAC;AAOH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,SAAS,WAAW,CAChB,KAAqC,EACrC,OAAkC,EAClC,KAAkB;IAElB,MAAM,cAAc,GAAG,CAAC,GAA+C,EAAE,EAAE;QACvE,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,GAAgD,EAAE,EAAE;QACtE,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC;IAEF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE;QAC/B,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC;QAC7C,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC;QAC3C,QAAQ,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;QACvC,QAAQ,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;QACvC,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC;QACrC,QAAQ,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;KAC1C,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACjB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE;QACH;;;;;;;;;;;;;;;WAeG;QACH,KAAK,EAAE,SAAS;KACnB;CACK,CAAC"}

package/dist/src/forms/fieldset/index.d.ts

@@ -67,11 +67,38 @@ declare function createFieldset(content: SubtypeExprOrValue<ArrayType<UIComponen
  * ```
  */
 export declare const Fieldset: {
-    /** Creates a Fieldset component */
+    /**
+     * Creates a Fieldset component.
+     *
+     * @param content - Array of UI components (typically Field components)
+     * @param style - Optional style and configuration options
+     * @returns An East expression representing the Fieldset component
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Fieldset, Field, Input, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Fieldset.Root([
+     *         Field.Root("First Name", Input.String("", { placeholder: "First name" })),
+     *         Field.Root("Last Name", Input.String("", { placeholder: "Last name" })),
+     *     ], {
+     *         legend: "Personal Information",
+     *     });
+     * });
+     * ```
+     */
     readonly Root: typeof createFieldset;
-    /** Type definitions */
     readonly Types: {
-        /** Fieldset style struct type */
+        /**
+         * Style type for Fieldset component.
+         *
+         * @remarks
+         * Contains optional styling properties for the fieldset.
+         *
+         * @property size - Size of the fieldset (sm, md, lg)
+         */
         readonly Style: import("@elaraai/east").StructType<{
             size: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
                 xs: import("@elaraai/east").NullType;

package/dist/src/forms/fieldset/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/forms/fieldset/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAGvB,SAAS,EACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAEH,KAAK,aAAa,EACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,iBAAiB,EACjB,KAAK,aAAa,GACrB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,iBAAS,cAAc,CACnB,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,EACvD,KAAK,CAAC,EAAE,aAAa,GACtB,QAAQ,CAAC,eAAe,CAAC,CAmB3B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,QAAQ;IACjB,mCAAmC;;IAEnC,uBAAuB;;QAEnB,iCAAiC;;;;;;;;;;CAG/B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/forms/fieldset/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAGvB,SAAS,EACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAEH,KAAK,aAAa,EACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,iBAAiB,EACjB,KAAK,aAAa,GACrB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,iBAAS,cAAc,CACnB,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,EACvD,KAAK,CAAC,EAAE,aAAa,GACtB,QAAQ,CAAC,eAAe,CAAC,CAmB3B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,QAAQ;IACjB;;;;;;;;;;;;;;;;;;;;;OAqBG;;;QAGC;;;;;;;WAOG;;;;;;;;;;CAGD,CAAC"}

package/dist/src/forms/fieldset/index.js

@@ -93,11 +93,38 @@ function createFieldset(content, style) {
  * ```
  */
 export const Fieldset = {
-    /** Creates a Fieldset component */
+    /**
+     * Creates a Fieldset component.
+     *
+     * @param content - Array of UI components (typically Field components)
+     * @param style - Optional style and configuration options
+     * @returns An East expression representing the Fieldset component
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Fieldset, Field, Input, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Fieldset.Root([
+     *         Field.Root("First Name", Input.String("", { placeholder: "First name" })),
+     *         Field.Root("Last Name", Input.String("", { placeholder: "Last name" })),
+     *     ], {
+     *         legend: "Personal Information",
+     *     });
+     * });
+     * ```
+     */
     Root: createFieldset,
-    /** Type definitions */
     Types: {
-        /** Fieldset style struct type */
+        /**
+         * Style type for Fieldset component.
+         *
+         * @remarks
+         * Contains optional styling properties for the fieldset.
+         *
+         * @property size - Size of the fieldset (sm, md, lg)
+         */
         Style: FieldsetStyleType,
     },
 };

package/dist/src/forms/fieldset/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/forms/fieldset/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,OAAO,EACP,SAAS,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACH,iBAAiB,GAEpB,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACH,iBAAiB,GAEpB,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAS,cAAc,CACnB,OAAuD,EACvD,KAAqB;IAErB,yCAAyC;IACzC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAI;QACzB,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC7B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;YACjD,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACjB,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE;QAClC,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC3F,UAAU,EAAE,KAAK,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QACvG,SAAS,EAAE,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QACpG,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,KAAK,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QACjG,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC9F,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;YAC1C,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;SACnC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KACjD,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,mCAAmC;IACnC,IAAI,EAAE,cAAc;IACpB,uBAAuB;IACvB,KAAK,EAAE;QACH,iCAAiC;QACjC,KAAK,EAAE,iBAAiB;KAC3B;CACK,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/forms/fieldset/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,OAAO,EACP,SAAS,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACH,iBAAiB,GAEpB,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACH,iBAAiB,GAEpB,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAS,cAAc,CACnB,OAAuD,EACvD,KAAqB;IAErB,yCAAyC;IACzC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAI;QACzB,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC7B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;YACjD,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACjB,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE;QAClC,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC3F,UAAU,EAAE,KAAK,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QACvG,SAAS,EAAE,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QACpG,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,KAAK,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QACjG,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC9F,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;YAC1C,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;SACnC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KACjD,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE;QACH;;;;;;;WAOG;QACH,KAAK,EAAE,iBAAiB;KAC3B;CACK,CAAC"}

package/dist/src/forms/file-upload/index.d.ts

@@ -77,11 +77,47 @@ declare function createFileUpload(style?: FileUploadStyle): ExprType<UIComponent
  * ```
  */
 export declare const FileUpload: {
-    /** Creates a FileUpload component */
+    /**
+     * Creates a FileUpload component.
+     *
+     * @param style - Configuration options for the file upload
+     * @returns An East expression representing the FileUpload component
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { FileUpload, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return FileUpload.Root({
+     *         accept: "image/*",
+     *         maxFiles: 5n,
+     *     });
+     * });
+     * ```
+     */
     readonly Root: typeof createFileUpload;
-    /** Type definitions */
     readonly Types: {
-        /** FileUpload struct type */
+        /**
+         * Type for FileUpload component data.
+         *
+         * @remarks
+         * FileUpload is a form control for uploading files with drag-and-drop support.
+         *
+         * @property accept - Accepted file types (MIME type pattern, e.g., "image/*" or ".pdf,.doc")
+         * @property maxFiles - Maximum number of files allowed
+         * @property maxFileSize - Maximum file size in bytes
+         * @property minFileSize - Minimum file size in bytes
+         * @property directory - Whether to allow folder/directory upload
+         * @property disabled - Whether the upload is disabled
+         * @property required - Whether file upload is required
+         * @property allowDrop - Whether to allow drag-and-drop
+         * @property capture - Camera capture mode for mobile devices
+         * @property name - Form input name attribute
+         * @property label - Label text for the upload area
+         * @property dropzoneText - Text shown in the dropzone area
+         * @property triggerText - Text for the upload trigger button
+         */
         readonly FileUpload: import("@elaraai/east").StructType<{
             accept: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
             maxFiles: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
@@ -100,7 +136,15 @@ export declare const FileUpload: {
             dropzoneText: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
             triggerText: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
         }>;
-        /** File capture variant type */
+        /**
+         * Capture mode for camera access on mobile devices.
+         *
+         * @remarks
+         * Controls which camera to use when capturing media files.
+         *
+         * @property user - Front-facing camera (selfie mode)
+         * @property environment - Rear-facing camera
+         */
         readonly Capture: import("@elaraai/east").VariantType<{
             user: import("@elaraai/east").NullType;
             environment: import("@elaraai/east").NullType;

package/dist/src/forms/file-upload/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/forms/file-upload/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EAGhB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAGH,KAAK,eAAe,EACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,cAAc,EACd,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,GAC1B,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,iBAAS,gBAAgB,CACrB,KAAK,CAAC,EAAE,eAAe,GACxB,QAAQ,CAAC,eAAe,CAAC,CAkC3B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,UAAU;IACnB,qCAAqC;;IAErC,uBAAuB;;QAEnB,6BAA6B;;;;;;;;;;;;;;;;;;;QAE7B,gCAAgC;;;;;;CAG9B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/forms/file-upload/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EAGhB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAGH,KAAK,eAAe,EACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,cAAc,EACd,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,GAC1B,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,iBAAS,gBAAgB,CACrB,KAAK,CAAC,EAAE,eAAe,GACxB,QAAQ,CAAC,eAAe,CAAC,CAkC3B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,UAAU;IACnB;;;;;;;;;;;;;;;;;;OAkBG;;;QAGC;;;;;;;;;;;;;;;;;;;WAmBG;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;WAQG;;;;;;CAGD,CAAC"}

package/dist/src/forms/file-upload/index.js

@@ -116,13 +116,57 @@ function createFileUpload(style) {
  * ```
  */
 export const FileUpload = {
-    /** Creates a FileUpload component */
+    /**
+     * Creates a FileUpload component.
+     *
+     * @param style - Configuration options for the file upload
+     * @returns An East expression representing the FileUpload component
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { FileUpload, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return FileUpload.Root({
+     *         accept: "image/*",
+     *         maxFiles: 5n,
+     *     });
+     * });
+     * ```
+     */
     Root: createFileUpload,
-    /** Type definitions */
     Types: {
-        /** FileUpload struct type */
+        /**
+         * Type for FileUpload component data.
+         *
+         * @remarks
+         * FileUpload is a form control for uploading files with drag-and-drop support.
+         *
+         * @property accept - Accepted file types (MIME type pattern, e.g., "image/*" or ".pdf,.doc")
+         * @property maxFiles - Maximum number of files allowed
+         * @property maxFileSize - Maximum file size in bytes
+         * @property minFileSize - Minimum file size in bytes
+         * @property directory - Whether to allow folder/directory upload
+         * @property disabled - Whether the upload is disabled
+         * @property required - Whether file upload is required
+         * @property allowDrop - Whether to allow drag-and-drop
+         * @property capture - Camera capture mode for mobile devices
+         * @property name - Form input name attribute
+         * @property label - Label text for the upload area
+         * @property dropzoneText - Text shown in the dropzone area
+         * @property triggerText - Text for the upload trigger button
+         */
         FileUpload: FileUploadType,
-        /** File capture variant type */
+        /**
+         * Capture mode for camera access on mobile devices.
+         *
+         * @remarks
+         * Controls which camera to use when capturing media files.
+         *
+         * @property user - Front-facing camera (selfie mode)
+         * @property environment - Rear-facing camera
+         */
         Capture: FileCaptureType,
     },
 };

package/dist/src/forms/file-upload/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/forms/file-upload/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/forms/file-upload/index.ts"],"names":[],"mappings":"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"}

package/dist/src/forms/input/index.d.ts

@@ -19,30 +19,39 @@ declare function DateTimeInput(value: SubtypeExprOrValue<DateTimeType>, style?:
  *
  * @example
  * ```ts
- * import { Input } from "@elaraai/east-ui";
+ * import { East } from "@elaraai/east";
+ * import { Input, UIComponentType } from "@elaraai/east-ui";
  *
- * // String input (accepts plain strings)
- * const nameInput = Input.String("John", {
- *   placeholder: "Enter name",
- *   variant: "outline",
+ * // String input
+ * const stringExample = East.function([], UIComponentType, $ => {
+ *     return Input.String("John", {
+ *         placeholder: "Enter name",
+ *         variant: "outline",
+ *     });
  * });
  *
  * // Integer input with constraints
- * const ageInput = Input.Integer(East.value(25n, IntegerType), {
- *   min: 0n,
- *   max: 150n,
+ * const integerExample = East.function([], UIComponentType, $ => {
+ *     return Input.Integer(25n, {
+ *         min: 0n,
+ *         max: 150n,
+ *     });
  * });
  *
  * // Float input with precision
- * const priceInput = Input.Float(East.value(19.99, FloatType), {
- *   min: 0,
- *   precision: 2n,
+ * const floatExample = East.function([], UIComponentType, $ => {
+ *     return Input.Float(19.99, {
+ *         min: 0,
+ *         precision: 2n,
+ *     });
  * });
  *
  * // DateTime input
- * const dateInput = Input.DateTime(East.value(new Date(), DateTimeType), {
- *   showTime: true,
- *   format: "yyyy-MM-dd HH:mm",
+ * const dateExample = East.function([], UIComponentType, $ => {
+ *     return Input.DateTime(new Date(), {
+ *         showTime: true,
+ *         format: "yyyy-MM-dd HH:mm",
+ *     });
  * });
  * ```
  */
@@ -51,8 +60,33 @@ export declare const Input: {
     readonly Integer: typeof IntegerInput;
     readonly Float: typeof FloatInput;
     readonly DateTime: typeof DateTimeInput;
+    /**
+     * Creates an input variant expression.
+     *
+     * @param inputVariant - The input variant style
+     * @returns An East expression representing the input variant
+     *
+     * @example
+     * ```ts
+     * import { InputVariant } from "@elaraai/east-ui";
+     *
+     * InputVariant("outline");
+     * InputVariant("subtle");
+     * ```
+     */
     readonly Variant: typeof InputVariant;
     readonly Types: {
+        /**
+         * Type for String input component data.
+         *
+         * @property value - The current string value
+         * @property placeholder - Placeholder text when empty
+         * @property variant - Input appearance variant
+         * @property size - Size of the input
+         * @property maxLength - Maximum character count
+         * @property pattern - Regex pattern for validation
+         * @property disabled - Whether the input is disabled
+         */
         readonly String: import("@elaraai/east").StructType<{
             value: StringType;
             placeholder: import("@elaraai/east").OptionType<StringType>;
@@ -71,6 +105,17 @@ export declare const Input: {
             pattern: import("@elaraai/east").OptionType<StringType>;
             disabled: import("@elaraai/east").OptionType<BooleanType>;
         }>;
+        /**
+         * Type for Integer input component data.
+         *
+         * @property value - The current integer value
+         * @property min - Minimum allowed value
+         * @property max - Maximum allowed value
+         * @property step - Step increment for stepper controls
+         * @property variant - Input appearance variant
+         * @property size - Size of the input
+         * @property disabled - Whether the input is disabled
+         */
         readonly Integer: import("@elaraai/east").StructType<{
             value: IntegerType;
             min: import("@elaraai/east").OptionType<IntegerType>;
@@ -89,6 +134,18 @@ export declare const Input: {
             }>>;
             disabled: import("@elaraai/east").OptionType<BooleanType>;
         }>;
+        /**
+         * Type for Float input component data.
+         *
+         * @property value - The current float value
+         * @property min - Minimum allowed value
+         * @property max - Maximum allowed value
+         * @property step - Step increment for stepper controls
+         * @property precision - Number of decimal places
+         * @property variant - Input appearance variant
+         * @property size - Size of the input
+         * @property disabled - Whether the input is disabled
+         */
         readonly Float: import("@elaraai/east").StructType<{
             value: FloatType;
             min: import("@elaraai/east").OptionType<FloatType>;
@@ -108,6 +165,18 @@ export declare const Input: {
             }>>;
             disabled: import("@elaraai/east").OptionType<BooleanType>;
         }>;
+        /**
+         * Type for DateTime input component data.
+         *
+         * @property value - The current DateTime value
+         * @property min - Minimum allowed date/time
+         * @property max - Maximum allowed date/time
+         * @property showTime - Whether to show time picker
+         * @property format - Display format string
+         * @property variant - Input appearance variant
+         * @property size - Size of the input
+         * @property disabled - Whether the input is disabled
+         */
         readonly DateTime: import("@elaraai/east").StructType<{
             value: DateTimeType;
             min: import("@elaraai/east").OptionType<DateTimeType>;
@@ -127,6 +196,16 @@ export declare const Input: {
             }>>;
             disabled: import("@elaraai/east").OptionType<BooleanType>;
         }>;
+        /**
+         * Variant type for Input appearance styles.
+         *
+         * @remarks
+         * Create instances using the {@link InputVariant} function.
+         *
+         * @property outline - Outlined input with border (default)
+         * @property subtle - Input with muted background
+         * @property flushed - Underlined input without border
+         */
         readonly Variant: import("@elaraai/east").VariantType<{
             outline: import("@elaraai/east").NullType;
             subtle: import("@elaraai/east").NullType;

package/dist/src/forms/input/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/forms/input/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,EAEd,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEH,YAAY,EAKZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GAC3B,MAAM,YAAY,CAAC;AAMpB,iBAAS,WAAW,CAChB,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACrC,KAAK,CAAC,EAAE,gBAAgB,GACzB,QAAQ,CAAC,eAAe,CAAC,CAqC3B;AAED,iBAAS,YAAY,CACjB,KAAK,EAAE,kBAAkB,CAAC,WAAW,CAAC,EACtC,KAAK,CAAC,EAAE,iBAAiB,GAC1B,QAAQ,CAAC,eAAe,CAAC,CAmC3B;AAED,iBAAS,UAAU,CACf,KAAK,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACpC,KAAK,CAAC,EAAE,eAAe,GACxB,QAAQ,CAAC,eAAe,CAAC,CA0C3B;AAED,iBAAS,aAAa,CAClB,KAAK,EAAE,kBAAkB,CAAC,YAAY,CAAC,EACvC,KAAK,CAAC,EAAE,kBAAkB,GAC3B,QAAQ,CAAC,eAAe,CAAC,CAyC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAaR,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/forms/input/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,EAEd,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEH,YAAY,EAKZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GAC3B,MAAM,YAAY,CAAC;AAMpB,iBAAS,WAAW,CAChB,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACrC,KAAK,CAAC,EAAE,gBAAgB,GACzB,QAAQ,CAAC,eAAe,CAAC,CAqC3B;AAED,iBAAS,YAAY,CACjB,KAAK,EAAE,kBAAkB,CAAC,WAAW,CAAC,EACtC,KAAK,CAAC,EAAE,iBAAiB,GAC1B,QAAQ,CAAC,eAAe,CAAC,CAmC3B;AAED,iBAAS,UAAU,CACf,KAAK,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACpC,KAAK,CAAC,EAAE,eAAe,GACxB,QAAQ,CAAC,eAAe,CAAC,CA0C3B;AAED,iBAAS,aAAa,CAClB,KAAK,EAAE,kBAAkB,CAAC,YAAY,CAAC,EACvC,KAAK,CAAC,EAAE,kBAAkB,GAC3B,QAAQ,CAAC,eAAe,CAAC,CAyC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,KAAK;;;;;IAKd;;;;;;;;;;;;;OAaG;;;QAGC;;;;;;;;;;WAUG;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;WAUG;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;;WAWG;;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;;WAWG;;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;WASG;;;;;;;CAGD,CAAC"}

package/dist/src/forms/input/index.js

@@ -181,30 +181,39 @@ function DateTimeInput(value, style) {
  *
  * @example
  * ```ts
- * import { Input } from "@elaraai/east-ui";
+ * import { East } from "@elaraai/east";
+ * import { Input, UIComponentType } from "@elaraai/east-ui";
  *
- * // String input (accepts plain strings)
- * const nameInput = Input.String("John", {
- *   placeholder: "Enter name",
- *   variant: "outline",
+ * // String input
+ * const stringExample = East.function([], UIComponentType, $ => {
+ *     return Input.String("John", {
+ *         placeholder: "Enter name",
+ *         variant: "outline",
+ *     });
  * });
  *
  * // Integer input with constraints
- * const ageInput = Input.Integer(East.value(25n, IntegerType), {
- *   min: 0n,
- *   max: 150n,
+ * const integerExample = East.function([], UIComponentType, $ => {
+ *     return Input.Integer(25n, {
+ *         min: 0n,
+ *         max: 150n,
+ *     });
  * });
  *
  * // Float input with precision
- * const priceInput = Input.Float(East.value(19.99, FloatType), {
- *   min: 0,
- *   precision: 2n,
+ * const floatExample = East.function([], UIComponentType, $ => {
+ *     return Input.Float(19.99, {
+ *         min: 0,
+ *         precision: 2n,
+ *     });
  * });
  *
  * // DateTime input
- * const dateInput = Input.DateTime(East.value(new Date(), DateTimeType), {
- *   showTime: true,
- *   format: "yyyy-MM-dd HH:mm",
+ * const dateExample = East.function([], UIComponentType, $ => {
+ *     return Input.DateTime(new Date(), {
+ *         showTime: true,
+ *         format: "yyyy-MM-dd HH:mm",
+ *     });
  * });
  * ```
  */
@@ -213,12 +222,82 @@ export const Input = {
     Integer: IntegerInput,
     Float: FloatInput,
     DateTime: DateTimeInput,
+    /**
+     * Creates an input variant expression.
+     *
+     * @param inputVariant - The input variant style
+     * @returns An East expression representing the input variant
+     *
+     * @example
+     * ```ts
+     * import { InputVariant } from "@elaraai/east-ui";
+     *
+     * InputVariant("outline");
+     * InputVariant("subtle");
+     * ```
+     */
     Variant: InputVariant,
     Types: {
+        /**
+         * Type for String input component data.
+         *
+         * @property value - The current string value
+         * @property placeholder - Placeholder text when empty
+         * @property variant - Input appearance variant
+         * @property size - Size of the input
+         * @property maxLength - Maximum character count
+         * @property pattern - Regex pattern for validation
+         * @property disabled - Whether the input is disabled
+         */
         String: StringInputType,
+        /**
+         * Type for Integer input component data.
+         *
+         * @property value - The current integer value
+         * @property min - Minimum allowed value
+         * @property max - Maximum allowed value
+         * @property step - Step increment for stepper controls
+         * @property variant - Input appearance variant
+         * @property size - Size of the input
+         * @property disabled - Whether the input is disabled
+         */
         Integer: IntegerInputType,
+        /**
+         * Type for Float input component data.
+         *
+         * @property value - The current float value
+         * @property min - Minimum allowed value
+         * @property max - Maximum allowed value
+         * @property step - Step increment for stepper controls
+         * @property precision - Number of decimal places
+         * @property variant - Input appearance variant
+         * @property size - Size of the input
+         * @property disabled - Whether the input is disabled
+         */
         Float: FloatInputType,
+        /**
+         * Type for DateTime input component data.
+         *
+         * @property value - The current DateTime value
+         * @property min - Minimum allowed date/time
+         * @property max - Maximum allowed date/time
+         * @property showTime - Whether to show time picker
+         * @property format - Display format string
+         * @property variant - Input appearance variant
+         * @property size - Size of the input
+         * @property disabled - Whether the input is disabled
+         */
         DateTime: DateTimeInputType,
+        /**
+         * Variant type for Input appearance styles.
+         *
+         * @remarks
+         * Create instances using the {@link InputVariant} function.
+         *
+         * @property outline - Outlined input with border (default)
+         * @property subtle - Input with muted background
+         * @property flushed - Underlined input without border
+         */
         Variant: InputVariantType,
     },
 };