@heymantle/litho 0.0.3 → 0.0.4

package/dist/esm/stories/Label.stories.js

@@ -0,0 +1,612 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { transformStorySource } from "../utilities/transformers.js";
+import Label from "../components/Label.js";
+import Text from "../components/Text.js";
+import Card from "../components/Card.js";
+import TextField from "../components/TextField.js";
+import VerticalStack from "../components/VerticalStack.js";
+import Box from "../components/Box.js";
+export default {
+    title: 'Litho/Label',
+    component: Label,
+    parameters: {
+        layout: 'padded',
+        docs: {
+            description: {
+                component: "A Label component that provides accessible and semantic labeling for form elements. It supports required indicators, tooltips, and various styling options."
+            },
+            source: {
+                transform: transformStorySource
+            }
+        }
+    },
+    args: {
+        children: 'Label text',
+        id: 'example-field'
+    },
+    tags: [
+        'autodocs'
+    ],
+    argTypes: {
+        children: {
+            control: 'text',
+            description: 'Content to display in the label'
+        },
+        id: {
+            control: 'text',
+            description: 'ID for associating with form elements'
+        },
+        hidden: {
+            control: 'boolean',
+            description: 'Whether the label is visually hidden'
+        },
+        requiredIndicator: {
+            control: 'boolean',
+            description: 'Whether to show required asterisk'
+        },
+        disabled: {
+            control: 'boolean',
+            description: 'Whether the label appears disabled'
+        },
+        tooltip: {
+            control: 'text',
+            description: 'Tooltip content for the label'
+        },
+        variant: {
+            control: 'select',
+            options: [
+                'bodyXs',
+                'bodySm',
+                'bodyMd',
+                'bodyLg'
+            ],
+            description: 'Text variant for the label'
+        },
+        fontWeight: {
+            control: 'select',
+            options: [
+                'normal',
+                'medium',
+                'semibold',
+                'bold'
+            ],
+            description: 'Font weight for the label'
+        },
+        color: {
+            control: 'select',
+            options: [
+                'subdued',
+                'default',
+                'critical',
+                'warning',
+                'success'
+            ],
+            description: 'Color of the label text'
+        }
+    }
+};
+export var Default = {
+    render: function(args) {
+        return /*#__PURE__*/ _jsx(Label, _object_spread({}, args));
+    }
+};
+export var Required = {
+    args: {
+        children: 'Required field',
+        requiredIndicator: true
+    },
+    parameters: {
+        docs: {
+            description: {
+                story: 'Label with required indicator (asterisk).'
+            }
+        }
+    }
+};
+export var WithTooltip = {
+    args: {
+        children: 'Field with help',
+        tooltip: 'This field provides additional information about the user.'
+    },
+    parameters: {
+        docs: {
+            description: {
+                story: 'Label with tooltip for additional context.'
+            }
+        }
+    }
+};
+export var Hidden = {
+    args: {
+        children: 'Screen reader only label',
+        hidden: true
+    },
+    render: function(args) {
+        return /*#__PURE__*/ _jsxs(VerticalStack, {
+            gap: "4",
+            children: [
+                /*#__PURE__*/ _jsx(Label, _object_spread({}, args)),
+                /*#__PURE__*/ _jsx(Text, {
+                    children: "The label above is hidden visually but accessible to screen readers."
+                })
+            ]
+        });
+    },
+    parameters: {
+        docs: {
+            description: {
+                story: 'Visually hidden label for screen readers.'
+            }
+        }
+    }
+};
+export var Disabled = {
+    args: {
+        children: 'Disabled field',
+        disabled: true
+    },
+    parameters: {
+        docs: {
+            description: {
+                story: 'Label in disabled state.'
+            }
+        }
+    }
+};
+export var Variants = {
+    render: function() {
+        return /*#__PURE__*/ _jsxs(VerticalStack, {
+            gap: "4",
+            children: [
+                /*#__PURE__*/ _jsx(Label, {
+                    variant: "bodyXs",
+                    children: "Extra Small Label"
+                }),
+                /*#__PURE__*/ _jsx(Label, {
+                    variant: "bodySm",
+                    children: "Small Label"
+                }),
+                /*#__PURE__*/ _jsx(Label, {
+                    variant: "bodyMd",
+                    children: "Medium Label (Default)"
+                }),
+                /*#__PURE__*/ _jsx(Label, {
+                    variant: "bodyLg",
+                    children: "Large Label"
+                })
+            ]
+        });
+    },
+    parameters: {
+        docs: {
+            description: {
+                story: 'Different text variants for labels.'
+            }
+        }
+    }
+};
+export var FontWeights = {
+    render: function() {
+        return /*#__PURE__*/ _jsxs(VerticalStack, {
+            gap: "4",
+            children: [
+                /*#__PURE__*/ _jsx(Label, {
+                    fontWeight: "normal",
+                    children: "Normal Weight"
+                }),
+                /*#__PURE__*/ _jsx(Label, {
+                    fontWeight: "medium",
+                    children: "Medium Weight"
+                }),
+                /*#__PURE__*/ _jsx(Label, {
+                    fontWeight: "semibold",
+                    children: "Semibold Weight"
+                }),
+                /*#__PURE__*/ _jsx(Label, {
+                    fontWeight: "bold",
+                    children: "Bold Weight"
+                })
+            ]
+        });
+    },
+    parameters: {
+        docs: {
+            description: {
+                story: 'Different font weights for labels.'
+            }
+        }
+    }
+};
+export var Colors = {
+    render: function() {
+        return /*#__PURE__*/ _jsxs(VerticalStack, {
+            gap: "4",
+            children: [
+                /*#__PURE__*/ _jsx(Label, {
+                    color: "subdued",
+                    children: "Subdued Color"
+                }),
+                /*#__PURE__*/ _jsx(Label, {
+                    color: "default",
+                    children: "Default Color"
+                }),
+                /*#__PURE__*/ _jsx(Label, {
+                    color: "critical",
+                    children: "Critical Color"
+                }),
+                /*#__PURE__*/ _jsx(Label, {
+                    color: "warning",
+                    children: "Warning Color"
+                }),
+                /*#__PURE__*/ _jsx(Label, {
+                    color: "success",
+                    children: "Success Color"
+                })
+            ]
+        });
+    },
+    parameters: {
+        docs: {
+            description: {
+                story: 'Different colors for labels.'
+            }
+        }
+    }
+};
+export var WithFormFields = {
+    render: function() {
+        return /*#__PURE__*/ _jsx(Card, {
+            title: "User Registration",
+            padded: true,
+            children: /*#__PURE__*/ _jsxs(VerticalStack, {
+                gap: "6",
+                children: [
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "2",
+                        children: [
+                            /*#__PURE__*/ _jsx(Label, {
+                                id: "firstName",
+                                requiredIndicator: true,
+                                children: "First Name"
+                            }),
+                            /*#__PURE__*/ _jsx(TextField, {
+                                id: "firstName",
+                                placeholder: "Enter your first name"
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "2",
+                        children: [
+                            /*#__PURE__*/ _jsx(Label, {
+                                id: "lastName",
+                                requiredIndicator: true,
+                                children: "Last Name"
+                            }),
+                            /*#__PURE__*/ _jsx(TextField, {
+                                id: "lastName",
+                                placeholder: "Enter your last name"
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "2",
+                        children: [
+                            /*#__PURE__*/ _jsx(Label, {
+                                id: "email",
+                                requiredIndicator: true,
+                                tooltip: "We'll use this to send you important updates",
+                                children: "Email Address"
+                            }),
+                            /*#__PURE__*/ _jsx(TextField, {
+                                id: "email",
+                                type: "email",
+                                placeholder: "Enter your email"
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "2",
+                        children: [
+                            /*#__PURE__*/ _jsx(Label, {
+                                id: "phone",
+                                children: "Phone Number (Optional)"
+                            }),
+                            /*#__PURE__*/ _jsx(TextField, {
+                                id: "phone",
+                                type: "tel",
+                                placeholder: "Enter your phone number"
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "2",
+                        children: [
+                            /*#__PURE__*/ _jsx(Label, {
+                                id: "bio",
+                                tooltip: "Tell us a bit about yourself",
+                                children: "Bio"
+                            }),
+                            /*#__PURE__*/ _jsx(TextField, {
+                                id: "bio",
+                                multiline: 3,
+                                placeholder: "Write a short bio..."
+                            })
+                        ]
+                    })
+                ]
+            })
+        });
+    },
+    parameters: {
+        docs: {
+            description: {
+                story: 'Labels properly associated with form fields.'
+            }
+        }
+    }
+};
+export var FormValidationStates = {
+    render: function() {
+        return /*#__PURE__*/ _jsx(Card, {
+            title: "Form Validation Examples",
+            padded: true,
+            children: /*#__PURE__*/ _jsxs(VerticalStack, {
+                gap: "8",
+                children: [
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "4",
+                        children: [
+                            /*#__PURE__*/ _jsx(Text, {
+                                variant: "headingSm",
+                                children: "Success State"
+                            }),
+                            /*#__PURE__*/ _jsxs(VerticalStack, {
+                                gap: "2",
+                                children: [
+                                    /*#__PURE__*/ _jsx(Label, {
+                                        id: "validField",
+                                        color: "success",
+                                        requiredIndicator: true,
+                                        children: "Valid Field"
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        id: "validField",
+                                        value: "john@example.com"
+                                    })
+                                ]
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "4",
+                        children: [
+                            /*#__PURE__*/ _jsx(Text, {
+                                variant: "headingSm",
+                                children: "Error State"
+                            }),
+                            /*#__PURE__*/ _jsxs(VerticalStack, {
+                                gap: "2",
+                                children: [
+                                    /*#__PURE__*/ _jsx(Label, {
+                                        id: "errorField",
+                                        color: "critical",
+                                        requiredIndicator: true,
+                                        children: "Invalid Field"
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        id: "errorField",
+                                        error: true,
+                                        value: "invalid-email"
+                                    })
+                                ]
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "4",
+                        children: [
+                            /*#__PURE__*/ _jsx(Text, {
+                                variant: "headingSm",
+                                children: "Warning State"
+                            }),
+                            /*#__PURE__*/ _jsxs(VerticalStack, {
+                                gap: "2",
+                                children: [
+                                    /*#__PURE__*/ _jsx(Label, {
+                                        id: "warningField",
+                                        color: "warning",
+                                        children: "Field with Warning"
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        id: "warningField",
+                                        value: "example@tempmail.com"
+                                    })
+                                ]
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "4",
+                        children: [
+                            /*#__PURE__*/ _jsx(Text, {
+                                variant: "headingSm",
+                                children: "Disabled State"
+                            }),
+                            /*#__PURE__*/ _jsxs(VerticalStack, {
+                                gap: "2",
+                                children: [
+                                    /*#__PURE__*/ _jsx(Label, {
+                                        id: "disabledField",
+                                        disabled: true,
+                                        children: "Disabled Field"
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        id: "disabledField",
+                                        disabled: true,
+                                        value: "Cannot edit this"
+                                    })
+                                ]
+                            })
+                        ]
+                    })
+                ]
+            })
+        });
+    },
+    parameters: {
+        docs: {
+            description: {
+                story: 'Labels in different validation states with corresponding field colors.'
+            }
+        }
+    }
+};
+export var AccessibilityExample = {
+    render: function() {
+        return /*#__PURE__*/ _jsx(Card, {
+            title: "Accessibility Features",
+            padded: true,
+            children: /*#__PURE__*/ _jsxs(VerticalStack, {
+                gap: "8",
+                children: [
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "4",
+                        children: [
+                            /*#__PURE__*/ _jsx(Text, {
+                                variant: "headingSm",
+                                children: "Proper Label Association"
+                            }),
+                            /*#__PURE__*/ _jsxs(VerticalStack, {
+                                gap: "4",
+                                children: [
+                                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                                        gap: "2",
+                                        children: [
+                                            /*#__PURE__*/ _jsx(Label, {
+                                                id: "accessible-username",
+                                                requiredIndicator: true,
+                                                children: "Username"
+                                            }),
+                                            /*#__PURE__*/ _jsx(TextField, {
+                                                id: "accessible-username",
+                                                placeholder: "Enter username"
+                                            })
+                                        ]
+                                    }),
+                                    /*#__PURE__*/ _jsx(Text, {
+                                        color: "subdued",
+                                        variant: "bodySm",
+                                        children: "The label is properly associated with the input using the 'for' attribute and matching IDs."
+                                    })
+                                ]
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "4",
+                        children: [
+                            /*#__PURE__*/ _jsx(Text, {
+                                variant: "headingSm",
+                                children: "Screen Reader Only Label"
+                            }),
+                            /*#__PURE__*/ _jsxs(VerticalStack, {
+                                gap: "4",
+                                children: [
+                                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                                        gap: "2",
+                                        children: [
+                                            /*#__PURE__*/ _jsx(Label, {
+                                                id: "sr-only-field",
+                                                hidden: true,
+                                                children: "Hidden label for screen readers"
+                                            }),
+                                            /*#__PURE__*/ _jsx(TextField, {
+                                                id: "sr-only-field",
+                                                placeholder: "This field has a hidden label"
+                                            })
+                                        ]
+                                    }),
+                                    /*#__PURE__*/ _jsx(Text, {
+                                        color: "subdued",
+                                        variant: "bodySm",
+                                        children: "The label above is hidden visually but still accessible to screen readers."
+                                    })
+                                ]
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                        gap: "4",
+                        children: [
+                            /*#__PURE__*/ _jsx(Text, {
+                                variant: "headingSm",
+                                children: "Label with Additional Context"
+                            }),
+                            /*#__PURE__*/ _jsxs(VerticalStack, {
+                                gap: "4",
+                                children: [
+                                    /*#__PURE__*/ _jsxs(VerticalStack, {
+                                        gap: "2",
+                                        children: [
+                                            /*#__PURE__*/ _jsx(Label, {
+                                                id: "context-field",
+                                                requiredIndicator: true,
+                                                tooltip: "Your API key can be found in your account settings",
+                                                children: "API Key"
+                                            }),
+                                            /*#__PURE__*/ _jsx(TextField, {
+                                                id: "context-field",
+                                                placeholder: "Enter your API key"
+                                            })
+                                        ]
+                                    }),
+                                    /*#__PURE__*/ _jsx(Text, {
+                                        color: "subdued",
+                                        variant: "bodySm",
+                                        children: "The tooltip provides additional context without cluttering the interface."
+                                    })
+                                ]
+                            })
+                        ]
+                    })
+                ]
+            })
+        });
+    },
+    parameters: {
+        docs: {
+            description: {
+                story: 'Examples demonstrating accessibility features and best practices.'
+            }
+        }
+    }
+};