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

package/dist/src/display/avatar/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/display/avatar/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EAGb,UAAU,EAEb,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAM1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,iBAAS,YAAY,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC,eAAe,CAAC,CA+BpE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKT,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/display/avatar/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EAGb,UAAU,EAEb,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAM1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,iBAAS,YAAY,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC,eAAe,CAAC,CA+BpE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,MAAM;IACf;;;;;;;;;;;;;;;;;;;;;;OAsBG;;;QAGC;;;;;;;;;;;WAWG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGD,CAAC"}

package/dist/src/display/avatar/index.js

@@ -96,8 +96,43 @@ function createAvatar(style) {
  * ```
  */
 export const Avatar = {
+    /**
+     * Creates an Avatar component with optional image and fallback.
+     *
+     * @param style - Avatar configuration and styling
+     * @returns An East expression representing the avatar component
+     *
+     * @remarks
+     * Avatar displays user profile images. When no image is provided or fails
+     * to load, it shows initials from the name or a default icon.
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Avatar, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Avatar.Root({
+     *         name: "Jane Smith",
+     *         colorPalette: "blue",
+     *     });
+     * });
+     * ```
+     */
     Root: createAvatar,
     Types: {
+        /**
+         * Type for Avatar component data.
+         *
+         * @remarks
+         * Avatar displays user profile images or initials/icons as fallback.
+         *
+         * @property src - Image URL for the avatar
+         * @property name - User name (used for initials fallback)
+         * @property size - Size of the avatar
+         * @property variant - Visual variant (solid, subtle, outline)
+         * @property colorPalette - Color scheme for fallback avatar
+         */
         Avatar: AvatarType,
     },
 };

package/dist/src/display/avatar/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/display/avatar/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,UAAU,EACV,OAAO,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAE1D,kBAAkB;AAClB,OAAO,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAE1D,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,SAAS,YAAY,CAAC,KAAmB;IACrC,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,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,MAAM,YAAY,GAAG,KAAK,EAAE,OAAO;QAC/B,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YAChC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,gBAAgB,CAAC;YAC5D,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,iBAAiB,GAAG,KAAK,EAAE,YAAY;QACzC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;YACrC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,eAAe,CAAC;YAChE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;QACzB,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE;QAChC,GAAG,EAAE,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC;QAC/B,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC;QACjC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QACpE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC7E,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KAC/F,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE;QACH,MAAM,EAAE,UAAU;KACrB;CACK,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/display/avatar/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,UAAU,EACV,OAAO,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAE1D,kBAAkB;AAClB,OAAO,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAE1D,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,SAAS,YAAY,CAAC,KAAmB;IACrC,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,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,MAAM,YAAY,GAAG,KAAK,EAAE,OAAO;QAC/B,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YAChC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,gBAAgB,CAAC;YAC5D,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,iBAAiB,GAAG,KAAK,EAAE,YAAY;QACzC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;YACrC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,eAAe,CAAC;YAChE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;QACzB,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE;QAChC,GAAG,EAAE,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC;QAC/B,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC;QACjC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QACpE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC7E,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KAC/F,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE;QACH;;;;;;;;;;;WAWG;QACH,MAAM,EAAE,UAAU;KACrB;CACK,CAAC"}

package/dist/src/display/badge/index.d.ts

@@ -53,8 +53,43 @@ declare function createBadge(value: SubtypeExprOrValue<StringType>, style?: Badg
  * ```
  */
 export declare const Badge: {
+    /**
+     * Creates a Badge component with value and optional styling.
+     *
+     * @param value - The badge text content
+     * @param style - Optional styling configuration
+     * @returns An East expression representing the badge component
+     *
+     * @remarks
+     * Badge is used to display short labels, counts, or status indicators.
+     * Common uses include notification counts, status labels, and category tags.
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Badge, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Badge.Root("Active", {
+     *         colorPalette: "green",
+     *         variant: "solid",
+     *     });
+     * });
+     * ```
+     */
     readonly Root: typeof createBadge;
     readonly Types: {
+        /**
+         * Type for Badge component data.
+         *
+         * @remarks
+         * Badge displays short labels, counts, or status indicators.
+         *
+         * @property value - The badge text content
+         * @property variant - Visual variant (solid, subtle, outline)
+         * @property colorPalette - Color scheme for the badge
+         * @property size - Size of the badge
+         */
         readonly Badge: import("@elaraai/east").StructType<{
             value: StringType;
             variant: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{

package/dist/src/display/badge/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/display/badge/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EAEb,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAMxD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,iBAAS,WAAW,CAChB,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACrC,KAAK,CAAC,EAAE,UAAU,GACnB,QAAQ,CAAC,eAAe,CAAC,CAyB3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKR,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/display/badge/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EAEb,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAMxD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,iBAAS,WAAW,CAChB,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACrC,KAAK,CAAC,EAAE,UAAU,GACnB,QAAQ,CAAC,eAAe,CAAC,CAyB3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,KAAK;IACd;;;;;;;;;;;;;;;;;;;;;;;OAuBG;;;QAGC;;;;;;;;;;WAUG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGD,CAAC"}

package/dist/src/display/badge/index.js

@@ -80,8 +80,43 @@ function createBadge(value, style) {
  * ```
  */
 export const Badge = {
+    /**
+     * Creates a Badge component with value and optional styling.
+     *
+     * @param value - The badge text content
+     * @param style - Optional styling configuration
+     * @returns An East expression representing the badge component
+     *
+     * @remarks
+     * Badge is used to display short labels, counts, or status indicators.
+     * Common uses include notification counts, status labels, and category tags.
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Badge, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Badge.Root("Active", {
+     *         colorPalette: "green",
+     *         variant: "solid",
+     *     });
+     * });
+     * ```
+     */
     Root: createBadge,
     Types: {
+        /**
+         * Type for Badge component data.
+         *
+         * @remarks
+         * Badge displays short labels, counts, or status indicators.
+         *
+         * @property value - The badge text content
+         * @property variant - Visual variant (solid, subtle, outline)
+         * @property colorPalette - Color scheme for the badge
+         * @property size - Size of the badge
+         */
         Badge: BadgeType,
     },
 };

package/dist/src/display/badge/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/display/badge/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,UAAU,EACV,OAAO,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AAExD,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AAExD,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAS,WAAW,CAChB,KAAqC,EACrC,KAAkB;IAElB,MAAM,YAAY,GAAG,KAAK,EAAE,OAAO;QAC/B,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YAChC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,gBAAgB,CAAC;YAC5D,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,iBAAiB,GAAG,KAAK,EAAE,YAAY;QACzC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;YACrC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,eAAe,CAAC;YAChE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;QACzB,CAAC,CAAC,SAAS,CAAC;IAEhB,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,OAAO,EAAE;QAC/B,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC7E,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC5F,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KACvE,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;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/display/badge/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,UAAU,EACV,OAAO,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AAExD,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AAExD,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAS,WAAW,CAChB,KAAqC,EACrC,KAAkB;IAElB,MAAM,YAAY,GAAG,KAAK,EAAE,OAAO;QAC/B,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YAChC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,gBAAgB,CAAC;YAC5D,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,iBAAiB,GAAG,KAAK,EAAE,YAAY;QACzC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;YACrC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,eAAe,CAAC;YAChE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;QACzB,CAAC,CAAC,SAAS,CAAC;IAEhB,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,OAAO,EAAE;QAC/B,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC7E,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC5F,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KACvE,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACjB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE;QACH;;;;;;;;;;WAUG;QACH,KAAK,EAAE,SAAS;KACnB;CACK,CAAC"}

package/dist/src/display/icon/index.d.ts

@@ -73,11 +73,50 @@ declare function createIcon(prefix: IconPrefix, name: IconName, style?: IconStyl
  * ```
  */
 export declare const Icon: {
-    /** Creates an Icon component */
+    /**
+     * Creates an Icon component.
+     *
+     * @param prefix - The Font Awesome icon prefix (e.g., "fas", "far", "fab")
+     * @param name - The Font Awesome icon name (e.g., "user", "home", "chevron-right")
+     * @param style - Optional styling configuration
+     * @returns An East expression representing the Icon component
+     *
+     * @remarks
+     * Both prefix and name are typesafe using Font Awesome's TypeScript types.
+     * Common prefixes:
+     * - `fas` - Solid icons (filled)
+     * - `far` - Regular icons (outlined)
+     * - `fab` - Brand icons (logos)
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Icon, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Icon.Root("fas", "user");
+     * });
+     *
+     * const styledExample = East.function([], UIComponentType, $ => {
+     *     return Icon.Root("fas", "heart", {
+     *         color: "red.500",
+     *         size: "xl",
+     *     });
+     * });
+     * ```
+     */
     readonly Root: typeof createIcon;
-    /** Type definitions */
     readonly Types: {
-        /** Icon struct type */
+        /**
+         * Type for Icon component data.
+         *
+         * @remarks
+         * Icon displays a Font Awesome icon with optional styling.
+         *
+         * @property name - The Font Awesome icon name (e.g., "user", "home", "chevron-right")
+         * @property prefix - The Font Awesome prefix (e.g., "fas", "far", "fab")
+         * @property style - Optional styling configuration
+         */
         readonly Icon: import("@elaraai/east").StructType<{
             name: import("@elaraai/east").StringType;
             prefix: import("@elaraai/east").StringType;
@@ -112,7 +151,17 @@ export declare const Icon: {
                 }>>;
             }>>;
         }>;
-        /** Icon style struct type */
+        /**
+         * Style type for the Icon component.
+         *
+         * @remarks
+         * All properties are optional and wrapped in OptionType.
+         *
+         * @property size - Icon size (xs, sm, md, lg, xl, 2xl)
+         * @property variant - Icon style/weight (solid, regular, light, thin, brands)
+         * @property color - Icon color (CSS color or Chakra color token)
+         * @property colorPalette - Color scheme for the icon
+         */
         readonly Style: import("@elaraai/east").StructType<{
             size: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
                 xs: import("@elaraai/east").NullType;
@@ -143,7 +192,19 @@ export declare const Icon: {
                 pink: import("@elaraai/east").NullType;
             }>>;
         }>;
-        /** Icon size variant type */
+        /**
+         * Size options for Icon component.
+         *
+         * @remarks
+         * Maps to Font Awesome size classes.
+         *
+         * @property xs - Extra small icon
+         * @property sm - Small icon
+         * @property md - Medium icon (default)
+         * @property lg - Large icon
+         * @property xl - Extra large icon
+         * @property 2xl - 2x large icon
+         */
         readonly Size: import("@elaraai/east").VariantType<{
             xs: import("@elaraai/east").NullType;
             sm: import("@elaraai/east").NullType;
@@ -152,7 +213,18 @@ export declare const Icon: {
             xl: import("@elaraai/east").NullType;
             "2xl": import("@elaraai/east").NullType;
         }>;
-        /** Icon variant (solid/regular/brands) type */
+        /**
+         * Font Awesome icon style/variant.
+         *
+         * @remarks
+         * Determines which icon set to use.
+         *
+         * @property solid - Solid filled icons (fas)
+         * @property regular - Regular outlined icons (far)
+         * @property light - Light weight icons (fal) - requires FA Pro
+         * @property thin - Thin weight icons (fat) - requires FA Pro
+         * @property brands - Brand logos (fab)
+         */
         readonly Variant: import("@elaraai/east").VariantType<{
             solid: import("@elaraai/east").NullType;
             regular: import("@elaraai/east").NullType;

package/dist/src/display/icon/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/display/icon/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAGlF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAKH,KAAK,SAAS,EACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,YAAY,EACZ,eAAe,EACf,aAAa,EACb,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,QAAQ,GAChB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,iBAAS,UAAU,CACf,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,QAAQ,EACd,KAAK,CAAC,EAAE,SAAS,GAClB,QAAQ,CAAC,eAAe,CAAC,CA6B3B;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,IAAI;IACb,gCAAgC;;IAEhC,uBAAuB;;QAEnB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEvB,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAE7B,6BAA6B;;;;;;;;;QAE7B,+CAA+C;;;;;;;;;CAG7C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/display/icon/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAGlF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAKH,KAAK,SAAS,EACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,YAAY,EACZ,eAAe,EACf,aAAa,EACb,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,QAAQ,GAChB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,iBAAS,UAAU,CACf,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,QAAQ,EACd,KAAK,CAAC,EAAE,SAAS,GAClB,QAAQ,CAAC,eAAe,CAAC,CA6B3B;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,IAAI;IACb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;;;QAGC;;;;;;;;;WASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;WAUG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;;;WAYG;;;;;;;;;QAEH;;;;;;;;;;;WAWG;;;;;;;;;CAGD,CAAC"}

package/dist/src/display/icon/index.js

@@ -106,17 +106,89 @@ function createIcon(prefix, name, style) {
  * ```
  */
 export const Icon = {
-    /** Creates an Icon component */
+    /**
+     * Creates an Icon component.
+     *
+     * @param prefix - The Font Awesome icon prefix (e.g., "fas", "far", "fab")
+     * @param name - The Font Awesome icon name (e.g., "user", "home", "chevron-right")
+     * @param style - Optional styling configuration
+     * @returns An East expression representing the Icon component
+     *
+     * @remarks
+     * Both prefix and name are typesafe using Font Awesome's TypeScript types.
+     * Common prefixes:
+     * - `fas` - Solid icons (filled)
+     * - `far` - Regular icons (outlined)
+     * - `fab` - Brand icons (logos)
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Icon, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Icon.Root("fas", "user");
+     * });
+     *
+     * const styledExample = East.function([], UIComponentType, $ => {
+     *     return Icon.Root("fas", "heart", {
+     *         color: "red.500",
+     *         size: "xl",
+     *     });
+     * });
+     * ```
+     */
     Root: createIcon,
-    /** Type definitions */
     Types: {
-        /** Icon struct type */
+        /**
+         * Type for Icon component data.
+         *
+         * @remarks
+         * Icon displays a Font Awesome icon with optional styling.
+         *
+         * @property name - The Font Awesome icon name (e.g., "user", "home", "chevron-right")
+         * @property prefix - The Font Awesome prefix (e.g., "fas", "far", "fab")
+         * @property style - Optional styling configuration
+         */
         Icon: IconType,
-        /** Icon style struct type */
+        /**
+         * Style type for the Icon component.
+         *
+         * @remarks
+         * All properties are optional and wrapped in OptionType.
+         *
+         * @property size - Icon size (xs, sm, md, lg, xl, 2xl)
+         * @property variant - Icon style/weight (solid, regular, light, thin, brands)
+         * @property color - Icon color (CSS color or Chakra color token)
+         * @property colorPalette - Color scheme for the icon
+         */
         Style: IconStyleType,
-        /** Icon size variant type */
+        /**
+         * Size options for Icon component.
+         *
+         * @remarks
+         * Maps to Font Awesome size classes.
+         *
+         * @property xs - Extra small icon
+         * @property sm - Small icon
+         * @property md - Medium icon (default)
+         * @property lg - Large icon
+         * @property xl - Extra large icon
+         * @property 2xl - 2x large icon
+         */
         Size: IconSizeType,
-        /** Icon variant (solid/regular/brands) type */
+        /**
+         * Font Awesome icon style/variant.
+         *
+         * @remarks
+         * Determines which icon set to use.
+         *
+         * @property solid - Solid filled icons (fas)
+         * @property regular - Regular outlined icons (far)
+         * @property light - Light weight icons (fal) - requires FA Pro
+         * @property thin - Thin weight icons (fat) - requires FA Pro
+         * @property brands - Brand logos (fab)
+         */
         Variant: IconVariantType,
     },
 };

package/dist/src/display/icon/index.js.map

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

package/dist/src/display/stat/index.d.ts

@@ -4,8 +4,8 @@
  */
 import { type ExprType, type SubtypeExprOrValue, StringType } from "@elaraai/east";
 import { UIComponentType } from "../../component.js";
-import { type StatStyle } from "./types.js";
-export { StatType, StatIndicatorType, StatIndicator, type StatStyle, type StatIndicatorLiteral } from "./types.js";
+import { StatIndicator, type StatStyle } from "./types.js";
+export { type StatStyle, type StatIndicatorLiteral } from "./types.js";
 /**
  * Creates a Stat component with label, value, and optional trend info.
  *
@@ -65,8 +65,64 @@ declare function createStat(label: SubtypeExprOrValue<StringType>, value: Subtyp
  * ```
  */
 export declare const Stat: {
+    /**
+     * Creates a Stat component with label, value, and optional trend info.
+     *
+     * @param label - The stat label/title
+     * @param value - The main stat value
+     * @param style - Optional styling configuration
+     * @returns An East expression representing the stat component
+     *
+     * @remarks
+     * Stat is used to display key metrics or KPIs with optional trend indicators
+     * and help text describing changes.
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Stat, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Stat.Root("Growth", "+23.36%", {
+     *         helpText: "From last week",
+     *         indicator: "up",
+     *     });
+     * });
+     * ```
+     */
     readonly Root: typeof createStat;
+    /**
+     * Helper function to create stat indicator values.
+     *
+     * @param direction - The indicator direction ("up" or "down")
+     * @returns An East expression representing the stat indicator
+     *
+     * @example
+     * ```ts
+     * import { Stat } from "@elaraai/east-ui";
+     *
+     * // Dynamic indicator based on value
+     * const stat = Stat.Root("Profit", value, {
+     *   indicator: condition.ifElse(
+     *     $ => Stat.Indicator("up"),
+     *     $ => Stat.Indicator("down")
+     *   ),
+     * });
+     * ```
+     */
+    readonly Indicator: typeof StatIndicator;
     readonly Types: {
+        /**
+         * Type for Stat component data.
+         *
+         * @remarks
+         * Stat displays a key metric with optional label, help text, and trend indicator.
+         *
+         * @property label - The stat label/title
+         * @property value - The main stat value
+         * @property helpText - Optional help text or trend description
+         * @property indicator - Optional trend indicator (up/down)
+         */
         readonly Stat: import("@elaraai/east").StructType<{
             label: StringType;
             value: StringType;
@@ -76,6 +132,15 @@ export declare const Stat: {
                 down: import("@elaraai/east").NullType;
             }>>;
         }>;
+        /**
+         * Indicator types for Stat component.
+         *
+         * @remarks
+         * Used to show trend direction.
+         *
+         * @property up - Positive trend (usually green)
+         * @property down - Negative trend (usually red)
+         */
         readonly Indicator: import("@elaraai/east").VariantType<{
             up: import("@elaraai/east").NullType;
             down: import("@elaraai/east").NullType;

package/dist/src/display/stat/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/display/stat/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EAEb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAGzE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMnH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,iBAAS,UAAU,CACf,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACrC,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACrC,KAAK,CAAC,EAAE,SAAS,GAClB,QAAQ,CAAC,eAAe,CAAC,CAkB3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;CAMP,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/display/stat/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EAEb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAA+B,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAGxF,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,iBAAS,UAAU,CACf,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACrC,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACrC,KAAK,CAAC,EAAE,SAAS,GAClB,QAAQ,CAAC,eAAe,CAAC,CAkB3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,IAAI;IACb;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;;IAEH;;;;;;;;;;;;;;;;;;OAkBG;;;QAGC;;;;;;;;;;WAUG;;;;;;;;;;QAEH;;;;;;;;WAQG;;;;;;CAGD,CAAC"}

package/dist/src/display/stat/index.js

@@ -4,9 +4,9 @@
  */
 import { East, StringType, variant, } from "@elaraai/east";
 import { UIComponentType } from "../../component.js";
-import { StatType, StatIndicatorType } from "./types.js";
-// Re-export types
-export { StatType, StatIndicatorType, StatIndicator } from "./types.js";
+import { StatType, StatIndicatorType, StatIndicator } from "./types.js";
+// Re-export types (only TypeScript interfaces, not East types - those go through Stat.Types)
+export {} from "./types.js";
 // ============================================================================
 // Stat Function
 // ============================================================================
@@ -86,9 +86,74 @@ function createStat(label, value, style) {
  * ```
  */
 export const Stat = {
+    /**
+     * Creates a Stat component with label, value, and optional trend info.
+     *
+     * @param label - The stat label/title
+     * @param value - The main stat value
+     * @param style - Optional styling configuration
+     * @returns An East expression representing the stat component
+     *
+     * @remarks
+     * Stat is used to display key metrics or KPIs with optional trend indicators
+     * and help text describing changes.
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Stat, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Stat.Root("Growth", "+23.36%", {
+     *         helpText: "From last week",
+     *         indicator: "up",
+     *     });
+     * });
+     * ```
+     */
     Root: createStat,
+    /**
+     * Helper function to create stat indicator values.
+     *
+     * @param direction - The indicator direction ("up" or "down")
+     * @returns An East expression representing the stat indicator
+     *
+     * @example
+     * ```ts
+     * import { Stat } from "@elaraai/east-ui";
+     *
+     * // Dynamic indicator based on value
+     * const stat = Stat.Root("Profit", value, {
+     *   indicator: condition.ifElse(
+     *     $ => Stat.Indicator("up"),
+     *     $ => Stat.Indicator("down")
+     *   ),
+     * });
+     * ```
+     */
+    Indicator: StatIndicator,
     Types: {
+        /**
+         * Type for Stat component data.
+         *
+         * @remarks
+         * Stat displays a key metric with optional label, help text, and trend indicator.
+         *
+         * @property label - The stat label/title
+         * @property value - The main stat value
+         * @property helpText - Optional help text or trend description
+         * @property indicator - Optional trend indicator (up/down)
+         */
         Stat: StatType,
+        /**
+         * Indicator types for Stat component.
+         *
+         * @remarks
+         * Used to show trend direction.
+         *
+         * @property up - Positive trend (usually green)
+         * @property down - Negative trend (usually red)
+         */
         Indicator: StatIndicatorType,
     },
 };

package/dist/src/display/stat/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/display/stat/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,UAAU,EACV,OAAO,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAkB,MAAM,YAAY,CAAC;AAEzE,kBAAkB;AAClB,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAA6C,MAAM,YAAY,CAAC;AAEnH,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,SAAS,UAAU,CACf,KAAqC,EACrC,KAAqC,EACrC,KAAiB;IAEjB,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,cAAc,GAAG,KAAK,EAAE,SAAS;QACnC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;YAClC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,iBAAiB,CAAC;YAC/D,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;QACtB,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;QAC9B,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC;QACzC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KACtF,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAChB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE;QACH,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,iBAAiB;KAC/B;CACK,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/display/stat/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,UAAU,EACV,OAAO,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAC;AAExF,6FAA6F;AAC7F,OAAO,EAA6C,MAAM,YAAY,CAAC;AAEvE,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,SAAS,UAAU,CACf,KAAqC,EACrC,KAAqC,EACrC,KAAiB;IAEjB,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,cAAc,GAAG,KAAK,EAAE,SAAS;QACnC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;YAClC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,iBAAiB,CAAC;YAC/D,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;QACtB,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;QAC9B,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC;QACzC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KACtF,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAChB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,IAAI,EAAE,UAAU;IAChB;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,EAAE,aAAa;IACxB,KAAK,EAAE;QACH;;;;;;;;;;WAUG;QACH,IAAI,EAAE,QAAQ;QACd;;;;;;;;WAQG;QACH,SAAS,EAAE,iBAAiB;KAC/B;CACK,CAAC"}

package/dist/src/display/tag/index.d.ts

@@ -59,8 +59,45 @@ declare function createTag(label: SubtypeExprOrValue<StringType>, style?: TagSty
  * ```
  */
 export declare const Tag: {
+    /**
+     * Creates a Tag component with label and optional styling.
+     *
+     * @param label - The tag text content
+     * @param style - Optional styling configuration
+     * @returns An East expression representing the tag component
+     *
+     * @remarks
+     * Tag is used for categorization and filtering. Common uses include
+     * filter chips, labels, and removable categories.
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Tag, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Tag.Root("Featured", {
+     *         colorPalette: "blue",
+     *         variant: "solid",
+     *     });
+     * });
+     * ```
+     */
     readonly Root: typeof createTag;
     readonly Types: {
+        /**
+         * Type for Tag component data.
+         *
+         * @remarks
+         * Tag is used for categorization, filtering, and labeling items.
+         * Unlike Badge, Tags can be closable/removable.
+         *
+         * @property label - The tag text content
+         * @property variant - Visual variant (solid, subtle, outline)
+         * @property colorPalette - Color scheme for the tag
+         * @property size - Size of the tag (sm, md, lg, xl)
+         * @property closable - Whether the tag shows a close button
+         */
         readonly Tag: import("@elaraai/east").StructType<{
             label: StringType;
             variant: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
@@ -88,6 +125,17 @@ export declare const Tag: {
             }>>;
             closable: import("@elaraai/east").OptionType<BooleanType>;
         }>;
+        /**
+         * Size variant type for Tag component.
+         *
+         * @remarks
+         * Tag supports sm, md, lg, and xl sizes (no xs).
+         *
+         * @property sm - Small size
+         * @property md - Medium size (default)
+         * @property lg - Large size
+         * @property xl - Extra large size
+         */
         readonly Size: import("@elaraai/east").VariantType<{
             sm: import("@elaraai/east").NullType;
             md: import("@elaraai/east").NullType;