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

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;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/display/tag/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EACV,WAAW,EAEd,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGjE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAMtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,iBAAS,SAAS,CACd,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACrC,KAAK,CAAC,EAAE,QAAQ,GACjB,QAAQ,CAAC,eAAe,CAAC,CA+B3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMN,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/display/tag/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EACV,WAAW,EAEd,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGjE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAMtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,iBAAS,SAAS,CACd,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACrC,KAAK,CAAC,EAAE,QAAQ,GACjB,QAAQ,CAAC,eAAe,CAAC,CA+B3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,GAAG;IACZ;;;;;;;;;;;;;;;;;;;;;;;OAuBG;;;QAGC;;;;;;;;;;;;WAYG;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;WAUG;;;;;;;;CAGD,CAAC"}

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

@@ -92,9 +92,57 @@ function createTag(label, style) {
  * ```
  */
 export 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",
+     *     });
+     * });
+     * ```
+     */
     Root: createTag,
     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
+         */
         Tag: TagType,
+        /**
+         * 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
+         */
         Size: TagSizeType,
     },
 };

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/display/tag/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,UAAU,EACV,WAAW,EACX,OAAO,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AAEjE,kBAAkB;AAClB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAsC,MAAM,YAAY,CAAC;AAEtF,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,SAAS,SAAS,CACd,KAAqC,EACrC,KAAgB;IAEhB,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,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,WAAW,CAAC;YACpD,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACjB,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE;QAC7B,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;QACpE,QAAQ,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;KAC1C,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACf,IAAI,EAAE,SAAS;IACf,KAAK,EAAE;QACH,GAAG,EAAE,OAAO;QACZ,IAAI,EAAE,WAAW;KACpB;CACK,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/display/tag/index.ts"],"names":[],"mappings":"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"}

package/dist/src/feedback/alert/index.d.ts

@@ -71,10 +71,59 @@ declare function createAlert(status: SubtypeExprOrValue<AlertStatusType> | Alert
  * ```
  */
 export declare const Alert: {
+    /**
+     * Creates an Alert component with status and optional styling.
+     *
+     * @param status - The alert status (info, warning, success, error) or AlertStatusType expression
+     * @param style - Optional styling configuration
+     * @returns An East expression representing the alert component
+     *
+     * @remarks
+     * Alert is used to display feedback messages to users. Different status
+     * types have appropriate color schemes (blue for info, yellow for warning,
+     * green for success, red for error).
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Alert, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Alert.Root("warning", {
+     *         title: "Warning",
+     *         description: "Your session will expire in 5 minutes",
+     *     });
+     * });
+     * ```
+     */
     readonly Root: typeof createAlert;
+    /**
+     * Helper function to create alert status values.
+     *
+     * @param status - The status string ("info", "warning", "success", "error")
+     * @returns An East expression representing the alert status
+     */
     readonly Status: typeof AlertStatus;
+    /**
+     * Helper function to create alert variant values.
+     *
+     * @param v - The variant string ("solid", "subtle", "outline")
+     * @returns An East expression representing the alert variant
+     */
     readonly Variant: typeof AlertVariant;
     readonly Types: {
+        /**
+         * Type for Alert component data.
+         *
+         * @remarks
+         * Alert displays feedback messages to users, indicating status of
+         * operations or important information.
+         *
+         * @property status - The status type (info, warning, success, error)
+         * @property title - Optional alert title
+         * @property description - Optional alert description
+         * @property variant - Visual variant (solid, subtle, outline)
+         */
         readonly Alert: import("@elaraai/east").StructType<{
             status: import("@elaraai/east").VariantType<{
                 info: import("@elaraai/east").NullType;
@@ -90,12 +139,27 @@ export declare const Alert: {
                 outline: import("@elaraai/east").NullType;
             }>>;
         }>;
+        /**
+         * Status types for Alert component.
+         *
+         * @property info - Informational alert
+         * @property warning - Warning alert
+         * @property success - Success/confirmation alert
+         * @property error - Error/danger alert
+         */
         readonly Status: import("@elaraai/east").VariantType<{
             info: import("@elaraai/east").NullType;
             warning: import("@elaraai/east").NullType;
             success: import("@elaraai/east").NullType;
             error: import("@elaraai/east").NullType;
         }>;
+        /**
+         * Variant types for Alert visual style.
+         *
+         * @property solid - Solid background alert
+         * @property subtle - Subtle/light background alert
+         * @property outline - Bordered alert
+         */
         readonly Variant: import("@elaraai/east").VariantType<{
             solid: import("@elaraai/east").NullType;
             subtle: import("@elaraai/east").NullType;

package/dist/src/feedback/alert/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/feedback/alert/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,EAEH,eAAe,EACf,WAAW,EAEX,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,kBAAkB,EAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,SAAS,EACT,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GAC3B,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,iBAAS,WAAW,CAChB,MAAM,EAAE,kBAAkB,CAAC,eAAe,CAAC,GAAG,kBAAkB,EAChE,KAAK,CAAC,EAAE,UAAU,GACnB,QAAQ,CAAC,eAAe,CAAC,CAsB3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASR,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/feedback/alert/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,EAEH,eAAe,EACf,WAAW,EAEX,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,kBAAkB,EAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,SAAS,EACT,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GAC3B,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,iBAAS,WAAW,CAChB,MAAM,EAAE,kBAAkB,CAAC,eAAe,CAAC,GAAG,kBAAkB,EAChE,KAAK,CAAC,EAAE,UAAU,GACnB,QAAQ,CAAC,eAAe,CAAC,CAsB3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,KAAK;IACd;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;;QAGC;;;;;;;;;;;WAWG;;;;;;;;;;;;;;;;QAEH;;;;;;;WAOG;;;;;;;QAEH;;;;;;WAMG;;;;;;;CAGD,CAAC"}

package/dist/src/feedback/alert/index.js

@@ -95,12 +95,76 @@ function createAlert(status, style) {
  * ```
  */
 export const Alert = {
+    /**
+     * Creates an Alert component with status and optional styling.
+     *
+     * @param status - The alert status (info, warning, success, error) or AlertStatusType expression
+     * @param style - Optional styling configuration
+     * @returns An East expression representing the alert component
+     *
+     * @remarks
+     * Alert is used to display feedback messages to users. Different status
+     * types have appropriate color schemes (blue for info, yellow for warning,
+     * green for success, red for error).
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Alert, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, $ => {
+     *     return Alert.Root("warning", {
+     *         title: "Warning",
+     *         description: "Your session will expire in 5 minutes",
+     *     });
+     * });
+     * ```
+     */
     Root: createAlert,
+    /**
+     * Helper function to create alert status values.
+     *
+     * @param status - The status string ("info", "warning", "success", "error")
+     * @returns An East expression representing the alert status
+     */
     Status: AlertStatus,
+    /**
+     * Helper function to create alert variant values.
+     *
+     * @param v - The variant string ("solid", "subtle", "outline")
+     * @returns An East expression representing the alert variant
+     */
     Variant: AlertVariant,
     Types: {
+        /**
+         * Type for Alert component data.
+         *
+         * @remarks
+         * Alert displays feedback messages to users, indicating status of
+         * operations or important information.
+         *
+         * @property status - The status type (info, warning, success, error)
+         * @property title - Optional alert title
+         * @property description - Optional alert description
+         * @property variant - Visual variant (solid, subtle, outline)
+         */
         Alert: AlertType,
+        /**
+         * Status types for Alert component.
+         *
+         * @property info - Informational alert
+         * @property warning - Warning alert
+         * @property success - Success/confirmation alert
+         * @property error - Error/danger alert
+         */
         Status: AlertStatusType,
+        /**
+         * Variant types for Alert visual style.
+         *
+         * @property solid - Solid background alert
+         * @property subtle - Subtle/light background alert
+         * @property outline - Bordered alert
+         */
         Variant: AlertVariantType,
     },
 };

package/dist/src/feedback/alert/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/feedback/alert/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,EACH,SAAS,EACT,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,GAGf,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACH,SAAS,EACT,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,GAIf,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,SAAS,WAAW,CAChB,MAAgE,EAChE,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,WAAW,GAAG,OAAO,MAAM,KAAK,QAAQ;QAC1C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,CAAC;QACpD,CAAC,CAAC,MAAM,CAAC;IAEb,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,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE;QAC/B,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC;QACnC,WAAW,EAAE,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC;QAC/C,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KAChF,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACjB,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,KAAK,EAAE;QACH,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,eAAe;QACvB,OAAO,EAAE,gBAAgB;KAC5B;CACK,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/feedback/alert/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,EACH,SAAS,EACT,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,GAGf,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACH,SAAS,EACT,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,GAIf,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,SAAS,WAAW,CAChB,MAAgE,EAChE,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,WAAW,GAAG,OAAO,MAAM,KAAK,QAAQ;QAC1C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,CAAC;QACpD,CAAC,CAAC,MAAM,CAAC;IAEb,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,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE;QAC/B,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC;QACnC,WAAW,EAAE,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC;QAC/C,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KAChF,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACjB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,IAAI,EAAE,WAAW;IACjB;;;;;OAKG;IACH,MAAM,EAAE,WAAW;IACnB;;;;;OAKG;IACH,OAAO,EAAE,YAAY;IACrB,KAAK,EAAE;QACH;;;;;;;;;;;WAWG;QACH,KAAK,EAAE,SAAS;QAChB;;;;;;;WAOG;QACH,MAAM,EAAE,eAAe;QACvB;;;;;;WAMG;QACH,OAAO,EAAE,gBAAgB;KAC5B;CACK,CAAC"}