@gnome-ui/react 1.25.0 → 1.27.0

package/README.md

@@ -72,6 +72,7 @@ export default function App() {
 | [`Blockquote`](https://eljijuna.github.io/gnome-ui/?path=/docs/components-blockquote--docs) | Styled pull-quote with left-border accent; default, info, warning, error, success variants; optional icon and attribution |
 | [`Spinner`](https://eljijuna.github.io/gnome-ui/?path=/docs/components-spinner--docs) | Indeterminate loading indicator; sm/md/lg sizes |
 | [`ProgressBar`](https://eljijuna.github.io/gnome-ui/?path=/docs/components-progressbar--docs) | Determinate (0–1) and indeterminate progress indicator |
+| [`CountDownTimer`](https://eljijuna.github.io/gnome-ui/?path=/docs/components-countdowntimer--docs) | Countdown timer showing remaining time until a specified date; `date`, `time`, or `datetime` formats; executes callback on completion |
 | [`StatusPage`](https://eljijuna.github.io/gnome-ui/?path=/docs/components-statuspage--docs) | Empty-state page with icon, title, description, and optional actions; `compact` prop for sidebars/popovers |
 | [`Separator`](https://eljijuna.github.io/gnome-ui/?path=/docs/components-separator--docs) | Horizontal/vertical dividing line between content groups |
 | [`Chip`](https://eljijuna.github.io/gnome-ui/?path=/docs/components-chip--docs) | Compact pill-shaped label for tags, filters, and multi-select; static, removable, and selectable modes |

package/dist/components/CountDownTimer/CountDownTimer.d.ts

@@ -0,0 +1,20 @@
+import { HTMLAttributes } from 'react';
+export type CountDownVariant = "accent" | "destructive" | "success" | "warning";
+export interface CountDownTimerProps extends HTMLAttributes<HTMLDivElement> {
+    /** Start date for the countdown */
+    start: Date;
+    /** End date for the countdown */
+    end: Date;
+    /** Format to display: "date", "time", or "datetime" */
+    format?: "date" | "time" | "datetime";
+    /** Visual style variant. Defaults to `"accent"`. */
+    variant?: CountDownVariant;
+    /** Callback action to execute when countdown reaches zero */
+    action?: () => void;
+}
+/**
+ * CountDown timer component that displays remaining time and executes an action when time runs out.
+ *
+ * @see https://developer.gnome.org/hig/patterns/
+ */
+export declare function CountDownTimer({ start, end, format, variant, action, className, ...props }: CountDownTimerProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/CountDownTimer/index.d.ts

@@ -0,0 +1,2 @@
+export { CountDownTimer } from './CountDownTimer';
+export type { CountDownTimerProps, CountDownVariant } from './CountDownTimer';

package/dist/components/Sidebar/SidebarSection.d.ts

@@ -1,32 +1,38 @@
 import { HTMLAttributes, ReactNode } from 'react';
+import { IconDefinition } from '@gnome-ui/icons';
+export interface SidebarSectionHandle {
+    expand: () => void;
+    collapse: () => void;
+    toggle: () => void;
+}
 export interface SidebarSectionProps extends HTMLAttributes<HTMLElement> {
     /**
      * Section heading. Rendered in small caps above the items.
      * Omit for an untitled section (e.g. the first group in a sidebar).
      */
     title?: string;
+    /** Icon rendered left of the title. Same type as `SidebarItem.icon`. */
+    icon?: IconDefinition;
+    /** Whether the section body can be toggled open/closed. Defaults to `false`. */
+    collapsible?: boolean;
+    /** Initial open state when `collapsible` is true. Defaults to `true`. */
+    defaultOpen?: boolean;
+    /** Controlled open state. */
+    open?: boolean;
+    /** Called when open state changes. */
+    onOpenChange?: (open: boolean) => void;
     children?: ReactNode;
 }
 /**
  * Named group of `SidebarItem` entries inside a `Sidebar`.
  *
- * Sections are separated by a thin divider. The title is optional —
- * omit it for the primary section when the grouping is self-evident.
+ * Sections are separated by a thin divider. The title and icon are optional.
+ * When `collapsible` is true the body can be toggled via the header button or
+ * imperatively via a `ref` (`expand`, `collapse`, `toggle`).
  *
- * Mirrors the `AdwSidebar` section model (libadwaita 1.9 / GNOME 50).
+ * In rail (icon-only) mode the body is always visible regardless of open state.
+ * When a sidebar filter is active and no children match, the section is hidden.
  *
- * @example
- * ```tsx
- * <Sidebar>
- *   <SidebarSection title="Mailboxes">
- *     <SidebarItem label="Inbox" icon={GoHome} active />
- *     <SidebarItem label="Sent"  icon={Share} />
- *   </SidebarSection>
- *   <SidebarSection title="Tags">
- *     <SidebarItem label="Work"     icon={Star} />
- *     <SidebarItem label="Personal" icon={Star} />
- *   </SidebarSection>
- * </Sidebar>
- * ```
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.Sidebar.html
  */
-export declare function SidebarSection({ title, children, className, ...props }: SidebarSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare const SidebarSection: import('react').ForwardRefExoticComponent<SidebarSectionProps & import('react').RefAttributes<SidebarSectionHandle>>;

package/dist/components/Sidebar/index.d.ts

@@ -1,6 +1,6 @@
 export { Sidebar, SidebarCollapsedContext, useSidebarCollapsed } from './Sidebar';
 export type { SidebarProps } from './Sidebar';
 export { SidebarSection } from './SidebarSection';
-export type { SidebarSectionProps } from './SidebarSection';
+export type { SidebarSectionProps, SidebarSectionHandle } from './SidebarSection';
 export { SidebarItem } from './SidebarItem';
 export type { SidebarItemProps, SidebarMenuEntry } from './SidebarItem';