@heymantle/litho 0.0.1

package/dist/cjs/components/Layout.js

@@ -0,0 +1,228 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get LayoutContext () {
+        return LayoutContext;
+    },
+    get default () {
+        return _default;
+    }
+});
+var _jsxruntime = require("react/jsx-runtime");
+var _react = /*#__PURE__*/ _interop_require_wildcard(require("react"));
+var _tailwindvariants = require("tailwind-variants");
+var _AppProvider = require("../components/AppProvider");
+var _LayoutSection = /*#__PURE__*/ _interop_require_default(require("./LayoutSection"));
+var _Text = /*#__PURE__*/ _interop_require_default(require("./Text"));
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+var LayoutContext = /*#__PURE__*/ (0, _react.createContext)();
+var styles = (0, _tailwindvariants.tv)({
+    base: "Litho-Layout flex flex-col gap-4 w-full max-w-full",
+    variants: {
+        hasSidebarSection: {
+            true: ""
+        }
+    },
+    compoundVariants: [
+        {
+            hasSidebarSection: true,
+            embedded: false,
+            className: "@lg:flex-row @lg:gap-5"
+        },
+        {
+            hasSidebarSection: true,
+            embedded: true,
+            className: "@lg-embed:flex-row @lg-embed:items-start @lg-embed:gap-5"
+        }
+    ],
+    defaultVariants: {
+        hasSidebarSection: false,
+        embedded: false
+    }
+});
+/**
+ * Layout component for structuring content.
+ *
+ * The `Layout` component organizes its children into a flexible and responsive layout.
+ * If no `Layout.Section` or `Layout.AnnotatedSection` children are found, it wraps the
+ * children inside a default `Layout.Section`.
+ *
+ * @param {Object} props - Component props.
+ * @param {React.ReactNode} props.children - The content to render inside the layout.
+ * @returns {JSX.Element} The rendered layout component.
+ */ function Layout() {
+    var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+    var embedded = (0, _react.useContext)(_AppProvider.FrameContext).embedded;
+    var children = props.children;
+    var analyzeChildren = function(children) {
+        var depth = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 0;
+        if (depth > 3) return {
+            sections: [],
+            hasSection: false,
+            parentHasSidebar: false
+        };
+        var sections = [];
+        var hasSection = false;
+        var parentHasSidebar = false;
+        _react.default.Children.forEach(children, function(child) {
+            if (/*#__PURE__*/ _react.default.isValidElement(child)) {
+                var type = child.type, childProps = child.props;
+                if ([
+                    "Layout.Section",
+                    "Layout.AnnotatedSection"
+                ].includes(type === null || type === void 0 ? void 0 : type.displayName)) {
+                    hasSection = true;
+                }
+                if ((type === null || type === void 0 ? void 0 : type.displayName) === "Layout.Section") {
+                    sections.push(child);
+                    if (childProps.sidebar === true || childProps.sidebar === "slim") {
+                        parentHasSidebar = true;
+                    }
+                }
+                var childAnalysis = analyzeChildren(childProps === null || childProps === void 0 ? void 0 : childProps.children, depth + 1);
+                sections = sections.concat(childAnalysis.sections);
+                hasSection = hasSection || childAnalysis.hasSection;
+                parentHasSidebar = parentHasSidebar || childAnalysis.parentHasSidebar;
+            }
+        });
+        return {
+            sections: sections,
+            hasSection: hasSection,
+            parentHasSidebar: parentHasSidebar
+        };
+    };
+    var _useMemo = (0, _react.useMemo)(function() {
+        return analyzeChildren(children);
+    }, [
+        children
+    ]), sections = _useMemo.sections, hasSection = _useMemo.hasSection, parentHasSidebar = _useMemo.parentHasSidebar;
+    var hasSidebarSection = sections.length > 0;
+    var classes = styles({
+        hasSidebarSection: hasSidebarSection,
+        embedded: embedded
+    });
+    var wrappedChildren = hasSection ? children : /*#__PURE__*/ (0, _jsxruntime.jsx)(Layout.Section, {
+        children: children
+    });
+    return /*#__PURE__*/ (0, _jsxruntime.jsx)(LayoutContext.Provider, {
+        value: {
+            parentHasSidebar: parentHasSidebar
+        },
+        children: /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
+            className: classes,
+            children: wrappedChildren
+        })
+    });
+}
+var annotatedSectionStyles = (0, _tailwindvariants.tv)({
+    base: "Litho-Layout__AnnotatedSection w-full flex flex-col gap-1 border-edge-subdued dark:border-tint-alt-2 pb-5",
+    variants: {
+        embedded: {
+            true: "@md-embed:grid @md-embed:grid-cols-12 @md-embed:gap-8 @md-embed:border-b @md-embed:last:border-b-0",
+            false: "@md:grid @md:grid-cols-12 @md:gap-8 @md:border-b @md:last:border-b-0"
+        }
+    },
+    defaultVariants: {
+        embedded: false
+    }
+});
+/**
+ * AnnotatedSection component for displaying a titled section with optional description.
+ *
+ * The `AnnotatedSection` organizes content into two main areas:
+ * - Annotation: Displays a title and description.
+ * - Content: Displays the main content provided as children.
+ *
+ * @param {Object} props - Component props.
+ * @param {React.ReactNode} props.children - The main content of the section.
+ * @param {string|React.ReactNode} [props.title] - The title for the annotated section.
+ * @param {string|React.ReactNode} [props.description] - A brief description for the annotated section.
+ * @returns {JSX.Element} The rendered annotated section component.
+ */ function AnnotatedSection() {
+    var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+    var children = props.children, title = props.title, description = props.description;
+    var embedded = (0, _react.useContext)(_AppProvider.FrameContext).embedded;
+    var annotatedSectionClasses = annotatedSectionStyles({
+        embedded: embedded
+    });
+    return /*#__PURE__*/ (0, _jsxruntime.jsxs)("div", {
+        className: annotatedSectionClasses,
+        children: [
+            /*#__PURE__*/ (0, _jsxruntime.jsxs)("div", {
+                className: "Litho-Layout__Annotation flex flex-col gap-1 @md:col-span-4 py-2",
+                children: [
+                    title && (typeof title === "string" ? /*#__PURE__*/ (0, _jsxruntime.jsx)(_Text.default, {
+                        variant: "headingMd",
+                        children: title
+                    }) : title),
+                    description && (typeof description === "string" ? /*#__PURE__*/ (0, _jsxruntime.jsx)(_Text.default, {
+                        color: "subdued",
+                        children: description
+                    }) : description)
+                ]
+            }),
+            /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
+                className: "Litho-Layout__AnnotationContent @md:col-span-8",
+                children: children
+            })
+        ]
+    });
+}
+AnnotatedSection.displayName = "Layout.AnnotatedSection";
+Layout.AnnotatedSection = AnnotatedSection;
+Layout.Section = _LayoutSection.default;
+var _default = Layout;

package/dist/cjs/components/LayoutSection.js

@@ -0,0 +1,133 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return _default;
+    }
+});
+var _jsxruntime = require("react/jsx-runtime");
+var _react = /*#__PURE__*/ _interop_require_wildcard(require("react"));
+var _tailwindvariants = require("tailwind-variants");
+var _AppProvider = require("../components/AppProvider");
+var _Layout = require("./Layout");
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+var sectionStyles = (0, _tailwindvariants.tv)({
+    base: "Litho-Layout__Section",
+    variants: {
+        sidebar: {
+            true: "",
+            slim: ""
+        },
+        sibling: {
+            none: "w-full",
+            sidebar: "flex-1 basis-0 min-w-0"
+        }
+    },
+    compoundVariants: [
+        {
+            sidebar: true,
+            embedded: true,
+            className: "@lg-embed:w-1/3 @lg-embed:max-w-80 @xl-embed:max-w-120 @lg-embed:w-1/3 @lg-embed:max-w-120"
+        },
+        {
+            sidebar: true,
+            embedded: false,
+            className: "@lg:w-1/3 @lg:max-w-80 @xl:max-w-120 @lg:w-1/3 @lg:max-w-120"
+        },
+        {
+            sidebar: "slim",
+            embedded: true,
+            className: "@lg-embed:w-1/3 @lg-embed:max-w-80 @lg-embed:w-1/3 @lg-embed:max-w-80"
+        },
+        {
+            sidebar: "slim",
+            embedded: false,
+            className: "@lg:w-1/3 @lg:max-w-80 @lg:w-1/3 @lg:max-w-80"
+        }
+    ],
+    defaultVariants: {
+        sidebar: false,
+        embedded: false
+    }
+});
+/**
+ * Section component for flexible content grouping.
+ *
+ * The `Section` allows for configuring its layout, supporting sidebar and slim variants.
+ *
+ * @param {Object} props - Component props.
+ * @param {React.ReactNode} props.children - The content to render inside the section.
+ * @param {boolean|"slim"} [props.sidebar=false] - Configures the section layout:
+ *  - `true`: Makes it a sidebar with a 1/3 basis.
+ *  - `"slim"`: Makes it a slim sidebar with a max width of 320px.
+ *  - `false`: Allows it to grow.
+ * @params {boolean|integer} props.sticky - Specify whether the section becomes sticky or not
+ * @returns {JSX.Element} The rendered section component.
+ */ function Section() {
+    var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+    var children = props.children, _props_sidebar = props.sidebar, sidebar = _props_sidebar === void 0 ? false : _props_sidebar, className = props.className, sticky = props.sticky;
+    var embedded = (0, _react.useContext)(_AppProvider.FrameContext).embedded;
+    var parentHasSidebar = (0, _react.useContext)(_Layout.LayoutContext).parentHasSidebar;
+    var sectionClasses = sectionStyles({
+        sidebar: sidebar,
+        sticky: sticky,
+        sibling: sidebar ? undefined : parentHasSidebar ? "sidebar" : "none",
+        embedded: embedded
+    });
+    return /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
+        className: "".concat(sectionClasses).concat(className ? " ".concat(className) : ""),
+        children: sticky ? /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
+            className: "sticky".concat(typeof sticky === "boolean" ? " top-[calc(var(--litho-top-bar-height)+var(--spacing)*4)]" : ""),
+            style: typeof sticky === "number" ? {
+                top: sticky
+            } : undefined,
+            children: children
+        }) : children
+    });
+}
+Section.displayName = "Layout.Section";
+var _default = Section;

package/dist/cjs/components/Link.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return _default;
+    }
+});
+var _jsxruntime = require("react/jsx-runtime");
+var _tailwindvariants = require("tailwind-variants");
+var styles = (0, _tailwindvariants.tv)({
+    base: "Litho-Link cursor-pointer hover:underline",
+    variants: {
+        monochrome: {
+            true: "text-normal hover:text-higher"
+        },
+        removeUnderline: {
+            true: "no-underline",
+            false: "underline"
+        },
+        bold: {
+            true: "font-medium no-underline",
+            false: "font-normal"
+        },
+        disabled: {
+            true: "text-lowest hover:text-lowest cursor-default hover:no-underline",
+            false: ""
+        }
+    },
+    compoundVariants: [
+        {
+            monochrome: false,
+            disabled: false,
+            color: "link",
+            className: "text-link hover:text-link-lower"
+        },
+        {
+            disabled: false,
+            monochrome: false,
+            color: "info",
+            className: "text-info-alt-fg dark:text-info-alt-fg-dark"
+        },
+        {
+            disabled: false,
+            monochrome: false,
+            color: "critical",
+            className: "text-critical-alt-fg dark:text-critical-alt-fg-dark"
+        },
+        {
+            disabled: false,
+            monochrome: false,
+            color: "success",
+            className: "text-success-alt-fg dark:text-success-alt-fg-dark"
+        },
+        {
+            disabled: false,
+            monochrome: false,
+            color: "warning",
+            className: "text-warning-alt-fg dark:text-warning-alt-fg-dark"
+        },
+        {
+            disabled: false,
+            monochrome: false,
+            color: "attention",
+            className: "text-attention-alt-fg dark:text-attention-alt-fg-dark"
+        },
+        {
+            disabled: false,
+            monochrome: false,
+            color: "highlight",
+            className: "text-highlight-alt-fg dark:text-highlight-alt-fg-dark"
+        },
+        {
+            disabled: false,
+            monochrome: false,
+            color: "neutral",
+            className: "text-neutral-alt-fg dark:text-neutral-alt-fg-dark"
+        }
+    ],
+    defaultVariants: {
+        monochrome: false,
+        removeUnderline: false,
+        bold: false,
+        disabled: false,
+        color: "link"
+    }
+});
+/**
+ * Renders an accessible link with customizable styling based on variants.
+ *
+ * @param {Object} props - Props for the Link component.
+ * @param {string} props.url - The URL the link points to.
+ * @param {React.ReactNode} props.children - Content to display within the link.
+ * @param {Function} [props.onClick] - Optional click event handler for the link.
+ * @param {boolean} [props.external=false] - If true, opens the link in a new tab.
+ * @param {string} [props.target] - Optional target attribute for specifying where to open the link.
+ * @param {string} [props.id] - Optional id attribute for the link.
+ * @param {boolean} [props.monochrome=false] - If true, applies monochrome color scheme.
+ * @param {boolean} [props.removeUnderline=false] - If true, removes underline from the link.
+ * @param {string} [props.accessibilityLabel] - Optional aria-label for accessibility.
+ * @param {string} [props.dataPrimaryLink] - Optional data attribute for custom tracking.
+ * 
+ * @returns {JSX.Element} Rendered link element.
+ */ function Link() {
+    var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+    var url = props.url, children = props.children, onClick = props.onClick, external = props.external, target = props.target, _props_bold = props.bold, bold = _props_bold === void 0 ? false : _props_bold, _props_disabled = props.disabled, disabled = _props_disabled === void 0 ? false : _props_disabled, id = props.id, monochrome = props.monochrome, removeUnderline = props.removeUnderline, accessibilityLabel = props.accessibilityLabel, dataPrimaryLink = props.dataPrimaryLink, color = props.color, className = props.className;
+    var classes = styles({
+        monochrome: monochrome,
+        removeUnderline: removeUnderline,
+        bold: bold,
+        disabled: disabled,
+        color: color
+    });
+    return /*#__PURE__*/ (0, _jsxruntime.jsx)("a", {
+        href: disabled ? undefined : url,
+        className: "".concat(classes).concat(className ? " ".concat(className) : ""),
+        onClick: disabled ? undefined : onClick,
+        target: target ? target : external ? "_blank" : undefined,
+        id: id,
+        "aria-label": accessibilityLabel,
+        "data-primary-link": dataPrimaryLink,
+        children: children
+    });
+}
+Link.displayName = "Link";
+var _default = Link;

package/dist/cjs/components/List.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return _default;
+    }
+});
+var _jsxruntime = require("react/jsx-runtime");
+var _tailwindvariants = require("tailwind-variants");
+var styles = (0, _tailwindvariants.tv)({
+    base: "Litho-List list-outside ml-5",
+    variants: {
+        type: {
+            bullet: "list-disc",
+            number: "list-decimal"
+        },
+        spacing: {
+            loose: "space-y-2",
+            normal: "space-y-1",
+            tight: "space-y-0"
+        }
+    }
+});
+/**
+ * List component for rendering unordered or ordered lists.
+ *
+ * @param {Object} props - Component props.
+ * @param {React.ReactNode} props.children - The list items to render inside the list.
+ * @param {'normal' | 'loose' | 'tight'} [props.spacing='normal'] - Controls vertical spacing between list items.
+ * @param {'bullet' | 'number'} [props.type='bullet'] - Determines list type: bullet (unordered) or number (ordered).
+ * @param {string} [props.className] - Additional class names to apply to the list container.
+ * @returns {JSX.Element} The rendered List component.
+ */ function List() {
+    var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+    var children = props.children, _props_spacing = props.spacing, spacing = _props_spacing === void 0 ? 'normal' : _props_spacing, _props_type = props.type, type = _props_type === void 0 ? 'bullet' : _props_type, className = props.className;
+    var classes = styles({
+        spacing: spacing,
+        type: type
+    });
+    var Element = type === 'bullet' ? 'ul' : 'ol';
+    return /*#__PURE__*/ (0, _jsxruntime.jsx)(Element, {
+        className: "".concat(classes).concat(className ? " ".concat(className) : ''),
+        children: children
+    });
+}
+var itemStyles = (0, _tailwindvariants.tv)({
+    base: "Litho-ListItem text-left leading-4"
+});
+/**
+ * Item component for individual list items in the List component.
+ *
+ * @param {Object} props - Component props.
+ * @param {React.ReactNode} props.children - The content of the list item.
+ * @param {string} [props.className] - Additional class names to apply to the list item.
+ * @returns {JSX.Element} The rendered Item component.
+ */ function Item() {
+    var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+    var children = props.children, className = props.className;
+    var itemClasses = itemStyles();
+    return /*#__PURE__*/ (0, _jsxruntime.jsx)("li", {
+        className: "".concat(itemClasses).concat(className ? " ".concat(className) : ''),
+        children: children
+    });
+}
+List.Item = Item;
+var _default = List;