@plusui/library 0.1.0

package/react/PlusSelectItem.d.ts

@@ -0,0 +1,86 @@
+import React from "react";
+import { PlusSelectItem as PlusSelectItemElement } from "../dist/components/select-item/index.js";
+
+export type { PlusSelectItemElement };
+
+export interface PlusSelectItemProps
+  extends Pick<
+    React.AllHTMLAttributes<HTMLElement>,
+    | "children"
+    | "dir"
+    | "hidden"
+    | "id"
+    | "lang"
+    | "slot"
+    | "style"
+    | "title"
+    | "translate"
+    | "onClick"
+    | "onFocus"
+    | "onBlur"
+  > {
+  /** Disables the select item, preventing interaction.
+When disabled, the item cannot be clicked or selected. */
+  disabled?: boolean;
+
+  /** Indicates whether the select item is currently selected.
+The selected state is managed by the parent PlusSelect component. */
+  selected?: boolean;
+
+  /** Sets the size of the select item. */
+  size?: PlusSelectItemElement["size"];
+
+  /** Sets the text content of the select item.
+If provided, this will be used as the item's content and as the aria-label for accessibility.
+If not provided, the slotted content is used for accessibility. */
+  text?: PlusSelectItemElement["text"];
+
+  /** A space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements via the class selectors or functions like the method `Document.getElementsByClassName()`. */
+  className?: string;
+
+  /** Contains a space-separated list of the part names of the element that should be exposed on the host element. */
+  exportparts?: string;
+
+  /** Used for labels to link them with their inputs (using input id). */
+  htmlFor?: string;
+
+  /** Used to help React identify which items have changed, are added, or are removed within a list. */
+  key?: number | string;
+
+  /** Contains a space-separated list of the part names of the element. Part names allows CSS to select and style specific elements in a shadow tree via the ::part pseudo-element. */
+  part?: string;
+
+  /** A mutable ref object whose `.current` property is initialized to the passed argument (`initialValue`). The returned object will persist for the full lifetime of the component. */
+  ref?: any;
+
+  /** Allows developers to make HTML elements focusable, allow or prevent them from being sequentially focusable (usually with the `Tab` key, hence the name) and determine their relative ordering for sequential focus navigation. */
+  tabIndex?: number;
+
+  /** Emitted when the select item is clicked, handled by the parent PlusSelect component */
+  onClick?: (event: CustomEvent) => void;
+}
+
+/**
+ * A select item component that represents a selectable option within a select menu.
+ * Automatically registers itself as a select-item slot in the parent PlusSelect component.
+ * ---
+ *
+ *
+ * ### **Events:**
+ *  - **click** - Emitted when the select item is clicked, handled by the parent PlusSelect component
+ *
+ * ### **Slots:**
+ *  - _default_ - The default slot for select item content
+ *
+ * ### **CSS Properties:**
+ *  - **--i-bg-default** - Controls the default background color _(default: undefined)_
+ * - **--i-bg-hovered** - Controls the background color when hovered _(default: undefined)_
+ * - **--i-bg-pressed** - Controls the background color when pressed _(default: undefined)_
+ * - **--i-text-color** - Controls the text color _(default: undefined)_
+ * - **--i-selected-bg** - Controls the background color when selected _(default: undefined)_
+ *
+ * ### **CSS Parts:**
+ *  - **base** - The component's base wrapper
+ * - **item** - The listbox item element
+ */
+export const PlusSelectItem: React.ForwardRefExoticComponent<PlusSelectItemProps>;

package/react/PlusSelectItem.js

@@ -0,0 +1,37 @@
+import React, {
+  forwardRef,
+  useImperativeHandle,
+  useRef,
+  useEffect,
+} from "react";
+import "../dist/components/select-item/index.js";
+import { useEventListener } from "./react-utils.js";
+
+export const PlusSelectItem = forwardRef((props, forwardedRef) => {
+  const ref = useRef(null);
+  const { disabled, selected, size, text, ...filteredProps } = props;
+
+  /** Event listeners - run once */
+  useEventListener(ref, "click", props.onClick);
+
+  useImperativeHandle(forwardedRef, () => ({}));
+
+  return React.createElement(
+    "plus-select-item",
+    {
+      ref,
+      ...filteredProps,
+      size: props.size,
+      text: props.text,
+      class: props.className,
+      exportparts: props.exportparts,
+      for: props.htmlFor,
+      part: props.part,
+      tabindex: props.tabIndex,
+      disabled: props.disabled ? "" : undefined,
+      selected: props.selected ? "" : undefined,
+      style: { ...props.style },
+    },
+    props.children,
+  );
+});

package/react/PlusService.d.ts

@@ -0,0 +1,51 @@
+import React from "react";
+import { PlusService as PlusServiceElement } from "../dist/components/service/index.js";
+
+export type { PlusServiceElement };
+
+export interface PlusServiceProps
+  extends Pick<
+    React.AllHTMLAttributes<HTMLElement>,
+    | "children"
+    | "dir"
+    | "hidden"
+    | "id"
+    | "lang"
+    | "slot"
+    | "style"
+    | "title"
+    | "translate"
+    | "onClick"
+    | "onFocus"
+    | "onBlur"
+  > {
+  /** A space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements via the class selectors or functions like the method `Document.getElementsByClassName()`. */
+  className?: string;
+
+  /** Contains a space-separated list of the part names of the element that should be exposed on the host element. */
+  exportparts?: string;
+
+  /** Used for labels to link them with their inputs (using input id). */
+  htmlFor?: string;
+
+  /** Used to help React identify which items have changed, are added, or are removed within a list. */
+  key?: number | string;
+
+  /** Contains a space-separated list of the part names of the element. Part names allows CSS to select and style specific elements in a shadow tree via the ::part pseudo-element. */
+  part?: string;
+
+  /** A mutable ref object whose `.current` property is initialized to the passed argument (`initialValue`). The returned object will persist for the full lifetime of the component. */
+  ref?: any;
+
+  /** Allows developers to make HTML elements focusable, allow or prevent them from being sequentially focusable (usually with the `Tab` key, hence the name) and determine their relative ordering for sequential focus navigation. */
+  tabIndex?: number;
+}
+
+/**
+ * A utility component to automatically set up the UI infrastructure for global services.
+ * Currently sets up the necessary containers for the ToastService.
+ * Place this component once at the root of your application.
+ * ---
+ *
+ */
+export const PlusService: React.ForwardRefExoticComponent<PlusServiceProps>;

package/react/PlusService.js

@@ -0,0 +1,20 @@
+import React, { forwardRef, useImperativeHandle } from "react";
+import "../dist/components/service/index.js";
+
+export const PlusService = forwardRef((props, forwardedRef) => {
+  useImperativeHandle(forwardedRef, () => ({}));
+
+  return React.createElement(
+    "plus-service",
+    {
+      ...props,
+      class: props.className,
+      exportparts: props.exportparts,
+      for: props.htmlFor,
+      part: props.part,
+      tabindex: props.tabIndex,
+      style: { ...props.style },
+    },
+    props.children,
+  );
+});

package/react/PlusSvgIcon.d.ts

@@ -0,0 +1,52 @@
+import React from "react";
+import { PlusSvgIcon as PlusSvgIconElement } from "../dist/components/svg-icon/index.js";
+
+export type { PlusSvgIconElement };
+
+export interface PlusSvgIconProps
+  extends Pick<
+    React.AllHTMLAttributes<HTMLElement>,
+    | "children"
+    | "dir"
+    | "hidden"
+    | "id"
+    | "lang"
+    | "slot"
+    | "style"
+    | "title"
+    | "translate"
+    | "onClick"
+    | "onFocus"
+    | "onBlur"
+  > {
+  /** undefined */
+  iconName?: PlusSvgIconElement["iconName"];
+
+  /** A space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements via the class selectors or functions like the method `Document.getElementsByClassName()`. */
+  className?: string;
+
+  /** Contains a space-separated list of the part names of the element that should be exposed on the host element. */
+  exportparts?: string;
+
+  /** Used for labels to link them with their inputs (using input id). */
+  htmlFor?: string;
+
+  /** Used to help React identify which items have changed, are added, or are removed within a list. */
+  key?: number | string;
+
+  /** Contains a space-separated list of the part names of the element. Part names allows CSS to select and style specific elements in a shadow tree via the ::part pseudo-element. */
+  part?: string;
+
+  /** A mutable ref object whose `.current` property is initialized to the passed argument (`initialValue`). The returned object will persist for the full lifetime of the component. */
+  ref?: any;
+
+  /** Allows developers to make HTML elements focusable, allow or prevent them from being sequentially focusable (usually with the `Tab` key, hence the name) and determine their relative ordering for sequential focus navigation. */
+  tabIndex?: number;
+}
+
+/**
+ *
+ * ---
+ *
+ */
+export const PlusSvgIcon: React.ForwardRefExoticComponent<PlusSvgIconProps>;

package/react/PlusSvgIcon.js

@@ -0,0 +1,23 @@
+import React, { forwardRef, useImperativeHandle } from "react";
+import "../dist/components/svg-icon/index.js";
+
+export const PlusSvgIcon = forwardRef((props, forwardedRef) => {
+  const { iconName, ...filteredProps } = props;
+
+  useImperativeHandle(forwardedRef, () => ({}));
+
+  return React.createElement(
+    "plus-svg-icon",
+    {
+      ...filteredProps,
+      iconName: props.iconName,
+      class: props.className,
+      exportparts: props.exportparts,
+      for: props.htmlFor,
+      part: props.part,
+      tabindex: props.tabIndex,
+      style: { ...props.style },
+    },
+    props.children,
+  );
+});

package/react/PlusTab.d.ts

@@ -0,0 +1,99 @@
+import React from "react";
+import { PlusTab as PlusTabElement } from "../dist/components/tab/index.js";
+
+export type { PlusTabElement };
+
+export interface PlusTabProps
+  extends Pick<
+    React.AllHTMLAttributes<HTMLElement>,
+    | "children"
+    | "dir"
+    | "hidden"
+    | "id"
+    | "lang"
+    | "slot"
+    | "style"
+    | "title"
+    | "translate"
+    | "onClick"
+    | "onFocus"
+    | "onBlur"
+  > {
+  /** Indicates if the tab is currently selected */
+  active?: boolean;
+
+  /** Disables the tab interaction */
+  disabled?: boolean;
+
+  /** Enables the dismiss button to remove the tab */
+  dismissible?: boolean;
+
+  /** Truncates the text if it's too long */
+  truncate?: boolean;
+
+  /** Use animated indicator instead of border for active tab
+This is controlled by the parent tab-group */
+  animated?: boolean;
+
+  /** Sets the value of the tab, used for identification and selection */
+  value?: PlusTabElement["value"];
+
+  /** Sets the size of the tab
+- sm: Small size
+- md: Medium size
+- lg: Large size */
+  size?: PlusTabElement["size"];
+
+  /** Sets the orientation of the tabs
+- horizontal: Tabs arranged horizontally
+- vertical: Tabs arranged vertically */
+  orientation?: PlusTabElement["orientation"];
+
+  /** Icon to display before the tab content */
+  prefixIcon?: PlusTabElement["prefixIcon"];
+
+  /** Icon to display after the tab content */
+  suffixIcon?: PlusTabElement["suffixIcon"];
+
+  /** A space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements via the class selectors or functions like the method `Document.getElementsByClassName()`. */
+  className?: string;
+
+  /** Contains a space-separated list of the part names of the element that should be exposed on the host element. */
+  exportparts?: string;
+
+  /** Used for labels to link them with their inputs (using input id). */
+  htmlFor?: string;
+
+  /** Used to help React identify which items have changed, are added, or are removed within a list. */
+  key?: number | string;
+
+  /** Contains a space-separated list of the part names of the element. Part names allows CSS to select and style specific elements in a shadow tree via the ::part pseudo-element. */
+  part?: string;
+
+  /** A mutable ref object whose `.current` property is initialized to the passed argument (`initialValue`). The returned object will persist for the full lifetime of the component. */
+  ref?: any;
+
+  /** Allows developers to make HTML elements focusable, allow or prevent them from being sequentially focusable (usually with the `Tab` key, hence the name) and determine their relative ordering for sequential focus navigation. */
+  tabIndex?: number;
+}
+
+/**
+ * Tab component that represents a single tab in a tab group.
+ * ---
+ *
+ *
+ * ### **Slots:**
+ *  - _default_ - The default slot for tab content
+ * - **prefix** - Content to be placed before the tab content
+ * - **suffix** - Content to be placed after the tab content
+ *
+ * ### **CSS Properties:**
+ *  - **--text-color** - Controls the text color of the tab _(default: undefined)_
+ * - **--active-color** - Controls the color of the active indicator _(default: undefined)_
+ * - **--bg-default** - Controls the default background color _(default: undefined)_
+ * - **--bg-hovered** - Controls the background color when hovered _(default: undefined)_
+ *
+ * ### **CSS Parts:**
+ *  - **tab** - The component's base wrapper
+ */
+export const PlusTab: React.ForwardRefExoticComponent<PlusTabProps>;

package/react/PlusTab.js

@@ -0,0 +1,44 @@
+import React, { forwardRef, useImperativeHandle } from "react";
+import "../dist/components/tab/index.js";
+
+export const PlusTab = forwardRef((props, forwardedRef) => {
+  const {
+    active,
+    disabled,
+    dismissible,
+    truncate,
+    animated,
+    value,
+    size,
+    orientation,
+    prefixIcon,
+    suffixIcon,
+    ...filteredProps
+  } = props;
+
+  useImperativeHandle(forwardedRef, () => ({}));
+
+  return React.createElement(
+    "plus-tab",
+    {
+      ...filteredProps,
+      value: props.value,
+      size: props.size,
+      orientation: props.orientation,
+      "prefix-icon": props.prefixIcon || props["prefix-icon"],
+      "suffix-icon": props.suffixIcon || props["suffix-icon"],
+      class: props.className,
+      exportparts: props.exportparts,
+      for: props.htmlFor,
+      part: props.part,
+      tabindex: props.tabIndex,
+      active: props.active ? "" : undefined,
+      disabled: props.disabled ? "" : undefined,
+      dismissible: props.dismissible ? "" : undefined,
+      truncate: props.truncate ? "" : undefined,
+      animated: props.animated ? "" : undefined,
+      style: { ...props.style },
+    },
+    props.children,
+  );
+});

package/react/PlusTabGroup.d.ts

@@ -0,0 +1,93 @@
+import React from "react";
+import { PlusTabGroup as PlusTabGroupElement } from "../dist/components/tab-group/index.js";
+
+export type { PlusTabGroupElement };
+
+export interface PlusTabGroupProps
+  extends Pick<
+    React.AllHTMLAttributes<HTMLElement>,
+    | "children"
+    | "dir"
+    | "hidden"
+    | "id"
+    | "lang"
+    | "slot"
+    | "style"
+    | "title"
+    | "translate"
+    | "onClick"
+    | "onFocus"
+    | "onBlur"
+  > {
+  /** Disables all tabs */
+  disabled?: boolean;
+
+  /** Enables the dismiss button on all tabs */
+  dismissible?: boolean;
+
+  /** Enables animated sliding indicator for active tab */
+  animated?: boolean;
+
+  /** Sets the size of the tabs
+- sm: Small size
+- md: Medium size
+- lg: Large size */
+  size?: PlusTabGroupElement["size"];
+
+  /** Sets the orientation of the tabs
+- horizontal: Tabs arranged horizontally
+- vertical: Tabs arranged vertically */
+  orientation?: PlusTabGroupElement["orientation"];
+
+  /** Currently active tab value */
+  value?: PlusTabGroupElement["value"];
+
+  /** A space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements via the class selectors or functions like the method `Document.getElementsByClassName()`. */
+  className?: string;
+
+  /** Contains a space-separated list of the part names of the element that should be exposed on the host element. */
+  exportparts?: string;
+
+  /** Used for labels to link them with their inputs (using input id). */
+  htmlFor?: string;
+
+  /** Used to help React identify which items have changed, are added, or are removed within a list. */
+  key?: number | string;
+
+  /** Contains a space-separated list of the part names of the element. Part names allows CSS to select and style specific elements in a shadow tree via the ::part pseudo-element. */
+  part?: string;
+
+  /** A mutable ref object whose `.current` property is initialized to the passed argument (`initialValue`). The returned object will persist for the full lifetime of the component. */
+  ref?: any;
+
+  /** Allows developers to make HTML elements focusable, allow or prevent them from being sequentially focusable (usually with the `Tab` key, hence the name) and determine their relative ordering for sequential focus navigation. */
+  tabIndex?: number;
+
+  /** Emitted when a tab is selected with the tab's value */
+  onPlusTabsChange?: (event: CustomEvent) => void;
+}
+
+/**
+ * Tab group component that manages a set of tabs and panels.
+ * ---
+ *
+ *
+ * ### **Events:**
+ *  - **plus-tabs-change** - Emitted when a tab is selected with the tab's value
+ *
+ * ### **Slots:**
+ *  - **tablist** - Slot for tabs
+ * - **panels** - Slot for tab panels
+ *
+ * ### **CSS Properties:**
+ *  - **--tabs-gap** - Controls the gap between tabs _(default: undefined)_
+ * - **--tabs-indicator-color** - Controls the color of the active tab indicator _(default: undefined)_
+ * - **--tabs-indicator-height** - Controls the height of the animated indicator _(default: undefined)_
+ *
+ * ### **CSS Parts:**
+ *  - **group** - The component's base wrapper
+ * - **tablist** - The tabs container
+ * - **panels** - The tab panels container
+ * - **indicator** - The animated indicator element (when animated=true)
+ */
+export const PlusTabGroup: React.ForwardRefExoticComponent<PlusTabGroupProps>;

package/react/PlusTabGroup.js

@@ -0,0 +1,47 @@
+import React, {
+  forwardRef,
+  useImperativeHandle,
+  useRef,
+  useEffect,
+} from "react";
+import "../dist/components/tab-group/index.js";
+import { useEventListener } from "./react-utils.js";
+
+export const PlusTabGroup = forwardRef((props, forwardedRef) => {
+  const ref = useRef(null);
+  const {
+    disabled,
+    dismissible,
+    animated,
+    size,
+    orientation,
+    value,
+    ...filteredProps
+  } = props;
+
+  /** Event listeners - run once */
+  useEventListener(ref, "plus-tabs-change", props.onPlusTabsChange);
+
+  useImperativeHandle(forwardedRef, () => ({}));
+
+  return React.createElement(
+    "plus-tab-group",
+    {
+      ref,
+      ...filteredProps,
+      size: props.size,
+      orientation: props.orientation,
+      value: props.value,
+      class: props.className,
+      exportparts: props.exportparts,
+      for: props.htmlFor,
+      part: props.part,
+      tabindex: props.tabIndex,
+      disabled: props.disabled ? "" : undefined,
+      dismissible: props.dismissible ? "" : undefined,
+      animated: props.animated ? "" : undefined,
+      style: { ...props.style },
+    },
+    props.children,
+  );
+});

package/react/PlusTabPanel.d.ts

@@ -0,0 +1,64 @@
+import React from "react";
+import { PlusTabPanel as PlusTabPanelElement } from "../dist/components/tab-panel/index.js";
+
+export type { PlusTabPanelElement };
+
+export interface PlusTabPanelProps
+  extends Pick<
+    React.AllHTMLAttributes<HTMLElement>,
+    | "children"
+    | "dir"
+    | "hidden"
+    | "id"
+    | "lang"
+    | "slot"
+    | "style"
+    | "title"
+    | "translate"
+    | "onClick"
+    | "onFocus"
+    | "onBlur"
+  > {
+  /** Indicates if the panel is currently visible */
+  active?: boolean;
+
+  /** Sets the value of the tab panel, used for matching with a tab */
+  value?: PlusTabPanelElement["value"];
+
+  /** Custom CSS class to apply to the panel */
+  panelClass?: PlusTabPanelElement["panelClass"];
+
+  /** A space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements via the class selectors or functions like the method `Document.getElementsByClassName()`. */
+  className?: string;
+
+  /** Contains a space-separated list of the part names of the element that should be exposed on the host element. */
+  exportparts?: string;
+
+  /** Used for labels to link them with their inputs (using input id). */
+  htmlFor?: string;
+
+  /** Used to help React identify which items have changed, are added, or are removed within a list. */
+  key?: number | string;
+
+  /** Contains a space-separated list of the part names of the element. Part names allows CSS to select and style specific elements in a shadow tree via the ::part pseudo-element. */
+  part?: string;
+
+  /** A mutable ref object whose `.current` property is initialized to the passed argument (`initialValue`). The returned object will persist for the full lifetime of the component. */
+  ref?: any;
+
+  /** Allows developers to make HTML elements focusable, allow or prevent them from being sequentially focusable (usually with the `Tab` key, hence the name) and determine their relative ordering for sequential focus navigation. */
+  tabIndex?: number;
+}
+
+/**
+ * Tab panel component that displays content associated with a tab.
+ * ---
+ *
+ *
+ * ### **Slots:**
+ *  - _default_ - The default slot for tab panel content
+ *
+ * ### **CSS Parts:**
+ *  - **panel** - The component's base wrapper
+ */
+export const PlusTabPanel: React.ForwardRefExoticComponent<PlusTabPanelProps>;

package/react/PlusTabPanel.js

@@ -0,0 +1,25 @@
+import React, { forwardRef, useImperativeHandle } from "react";
+import "../dist/components/tab-panel/index.js";
+
+export const PlusTabPanel = forwardRef((props, forwardedRef) => {
+  const { active, value, panelClass, ...filteredProps } = props;
+
+  useImperativeHandle(forwardedRef, () => ({}));
+
+  return React.createElement(
+    "plus-tab-panel",
+    {
+      ...filteredProps,
+      value: props.value,
+      panelClass: props.panelClass,
+      class: props.className,
+      exportparts: props.exportparts,
+      for: props.htmlFor,
+      part: props.part,
+      tabindex: props.tabIndex,
+      active: props.active ? "" : undefined,
+      style: { ...props.style },
+    },
+    props.children,
+  );
+});