@miaixz/ui 0.5.0

package/dist/components/page-layout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/page-layout/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC","sourcesContent":["export * from \"./page-layout.js\";\nexport type * from \"./page-layout.types.js\";\n"]}

package/dist/components/page-layout/page-layout.d.ts

@@ -0,0 +1,74 @@
+import type { AppShellProps, ClusterProps, GridProps, PageBodyProps, PageHeaderProps, PageProps, PageToolbarProps, ScrollRegionProps, SidebarLayoutProps, SplitLayoutProps, StackProps, StickyProps } from "./page-layout.types.js";
+/**
+ * Provides the root grid for product navigation, header, and main content.
+ *
+ * @public
+ */
+export declare const AppShell: import("react").ForwardRefExoticComponent<AppShellProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Establishes the width, spacing, and semantic main region of a page.
+ *
+ * @public
+ */
+export declare const Page: import("react").ForwardRefExoticComponent<PageProps & import("react").RefAttributes<HTMLElement>>;
+/**
+ * Renders a page title area with description, metadata, and actions.
+ *
+ * @public
+ */
+export declare const PageHeader: import("react").ForwardRefExoticComponent<PageHeaderProps & import("react").RefAttributes<HTMLElement>>;
+/**
+ * Wraps the primary page content with standardized vertical rhythm.
+ *
+ * @public
+ */
+export declare const PageBody: import("react").ForwardRefExoticComponent<PageBodyProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Aligns page-level filters, search, and primary actions.
+ *
+ * @public
+ */
+export declare const PageToolbar: import("react").ForwardRefExoticComponent<PageToolbarProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Arranges children vertically using a design-token gap.
+ *
+ * @public
+ */
+export declare const Stack: import("react").ForwardRefExoticComponent<StackProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Arranges wrapping inline content with controlled alignment and spacing.
+ *
+ * @public
+ */
+export declare const Cluster: import("react").ForwardRefExoticComponent<ClusterProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Creates a responsive auto-fit grid with configurable minimum column width.
+ *
+ * @public
+ */
+export declare const Grid: import("react").ForwardRefExoticComponent<GridProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Creates a responsive primary-secondary split layout.
+ *
+ * @public
+ */
+export declare const SplitLayout: import("react").ForwardRefExoticComponent<SplitLayoutProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Creates a localized sidebar and content layout that collapses responsively.
+ *
+ * @public
+ */
+export declare const SidebarLayout: import("react").ForwardRefExoticComponent<SidebarLayoutProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Creates a bounded, keyboard-focusable overflow region.
+ *
+ * @public
+ */
+export declare const ScrollRegion: import("react").ForwardRefExoticComponent<ScrollRegionProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Keeps content pinned to a viewport edge within its scrolling container.
+ *
+ * @public
+ */
+export declare const Sticky: import("react").ForwardRefExoticComponent<StickyProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=page-layout.d.ts.map

package/dist/components/page-layout/page-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-layout.d.ts","sourceRoot":"","sources":["../../../src/components/page-layout/page-layout.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,aAAa,EACb,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAEhC;;;;GAIG;AACH,eAAO,MAAM,QAAQ,0GAoBnB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,IAAI,mGAWf,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU,yGAiBrB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,QAAQ,0GAKnB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,6GAkBtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,KAAK,uGAKhB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,OAAO,yGAYlB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,IAAI,sGAef,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,6GAYtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa,+GAgBxB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,8GAcvB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,MAAM,wGAKjB,CAAC"}

package/dist/components/page-layout/page-layout.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { classNames } from "../../internal/class-names.js";
+import { useMiaixzLocale } from "../../i18n/index.js";
+/**
+ * Provides the root grid for product navigation, header, and main content.
+ *
+ * @public
+ */
+export const AppShell = forwardRef(function AppShell({ header, sidebar, headerClassName, sidebarClassName, mainClassName, className, children, ...props }, ref) {
+    return (_jsxs("div", { ...props, ref: ref, className: classNames("miaixz-shell", className), children: [_jsx("header", { className: classNames("miaixz-shell-header", headerClassName), children: header }), _jsx("aside", { className: classNames("miaixz-shell-sidebar", sidebarClassName), children: sidebar }), _jsx("main", { className: classNames("miaixz-shell-main", mainClassName), children: children })] }));
+});
+/**
+ * Establishes the width, spacing, and semantic main region of a page.
+ *
+ * @public
+ */
+export const Page = forwardRef(function Page({ fullWidth = false, className, ...props }, ref) {
+    return (_jsx("section", { ...props, ref: ref, className: classNames("miaixz-page", fullWidth && "miaixz-layout-full-width", className) }));
+});
+/**
+ * Renders a page title area with description, metadata, and actions.
+ *
+ * @public
+ */
+export const PageHeader = forwardRef(function PageHeader({ title, eyebrow, description, actions, headingLevel = 1, className, children, ...props }, ref) {
+    const Heading = `h${headingLevel}`;
+    return (_jsxs("header", { ...props, ref: ref, className: classNames("miaixz-page-header", className), children: [_jsxs("div", { className: "miaixz-page-header-content", children: [eyebrow !== undefined && _jsx("div", { className: "miaixz-page-eyebrow", children: eyebrow }), _jsx(Heading, { className: "miaixz-page-title", children: title }), description !== undefined && _jsx("p", { className: "miaixz-page-description", children: description }), children] }), actions !== undefined && _jsx("div", { className: "miaixz-page-actions", children: actions })] }));
+});
+/**
+ * Wraps the primary page content with standardized vertical rhythm.
+ *
+ * @public
+ */
+export const PageBody = forwardRef(function PageBody({ className, ...props }, ref) {
+    return _jsx("div", { ...props, ref: ref, className: classNames("miaixz-page-body", className) });
+});
+/**
+ * Aligns page-level filters, search, and primary actions.
+ *
+ * @public
+ */
+export const PageToolbar = forwardRef(function PageToolbar({ leading, actions, sticky = false, className, children, ...props }, ref) {
+    return (_jsxs("div", { ...props, ref: ref, className: classNames("miaixz-page-toolbar", sticky && "miaixz-page-toolbar-sticky", className), children: [_jsx("div", { className: "miaixz-page-toolbar-leading", children: leading ?? children }), actions !== undefined && _jsx("div", { className: "miaixz-page-toolbar-actions", children: actions })] }));
+});
+/**
+ * Arranges children vertically using a design-token gap.
+ *
+ * @public
+ */
+export const Stack = forwardRef(function Stack({ className, ...props }, ref) {
+    return _jsx("div", { ...props, ref: ref, className: classNames("miaixz-layout-stack", className) });
+});
+/**
+ * Arranges wrapping inline content with controlled alignment and spacing.
+ *
+ * @public
+ */
+export const Cluster = forwardRef(function Cluster({ justify = "start", className, ...props }, ref) {
+    return (_jsx("div", { ...props, ref: ref, "data-justify": justify, className: classNames("miaixz-layout-cluster", className) }));
+});
+/**
+ * Creates a responsive auto-fit grid with configurable minimum column width.
+ *
+ * @public
+ */
+export const Grid = forwardRef(function Grid({ minItemWidth = "standard", className, ...props }, ref) {
+    return (_jsx("div", { ...props, ref: ref, className: classNames("miaixz-layout-grid", minItemWidth === "wide" && "miaixz-layout-grid-wide", className) }));
+});
+/**
+ * Creates a responsive primary-secondary split layout.
+ *
+ * @public
+ */
+export const SplitLayout = forwardRef(function SplitLayout({ ratio = "equal", className, ...props }, ref) {
+    return (_jsx("div", { ...props, ref: ref, "data-ratio": ratio, className: classNames("miaixz-layout-split", className) }));
+});
+/**
+ * Creates a localized sidebar and content layout that collapses responsively.
+ *
+ * @public
+ */
+export const SidebarLayout = forwardRef(function SidebarLayout({ sidebar, sidebarLabel, stickySidebar = true, contentClassName, className, children, ...props }, ref) {
+    const { t } = useMiaixzLocale();
+    return (_jsxs("div", { ...props, ref: ref, className: classNames("miaixz-layout-sidebar-content", className), children: [_jsx("aside", { "aria-label": sidebarLabel ?? t("ui.sectionNavigation.label"), className: classNames("miaixz-layout-sidebar", stickySidebar && "miaixz-layout-sticky"), children: sidebar }), _jsx("div", { className: classNames("miaixz-layout-sidebar-main", contentClassName), children: children })] }));
+});
+/**
+ * Creates a bounded, keyboard-focusable overflow region.
+ *
+ * @public
+ */
+export const ScrollRegion = forwardRef(function ScrollRegion({ label, className, tabIndex, ...props }, ref) {
+    return (_jsx("div", { ...props, ref: ref, "aria-label": label, role: label ? "region" : undefined, tabIndex: tabIndex ?? 0, className: classNames("miaixz-layout-scroll-region", className) }));
+});
+/**
+ * Keeps content pinned to a viewport edge within its scrolling container.
+ *
+ * @public
+ */
+export const Sticky = forwardRef(function Sticky({ className, ...props }, ref) {
+    return _jsx("div", { ...props, ref: ref, className: classNames("miaixz-layout-sticky", className) });
+});
+//# sourceMappingURL=page-layout.js.map

package/dist/components/page-layout/page-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-layout.js","sourceRoot":"","sources":["../../../src/components/page-layout/page-layout.tsx"],"names":[],"mappings":"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","sourcesContent":["import { forwardRef } from \"react\";\n\nimport { classNames } from \"../../internal/class-names.js\";\nimport { useMiaixzLocale } from \"../../i18n/index.js\";\nimport type {\n  AppShellProps,\n  ClusterProps,\n  GridProps,\n  PageBodyProps,\n  PageHeaderProps,\n  PageProps,\n  PageToolbarProps,\n  ScrollRegionProps,\n  SidebarLayoutProps,\n  SplitLayoutProps,\n  StackProps,\n  StickyProps,\n} from \"./page-layout.types.js\";\n\n/**\n * Provides the root grid for product navigation, header, and main content.\n *\n * @public\n */\nexport const AppShell = forwardRef<HTMLDivElement, AppShellProps>(function AppShell(\n  {\n    header,\n    sidebar,\n    headerClassName,\n    sidebarClassName,\n    mainClassName,\n    className,\n    children,\n    ...props\n  },\n  ref,\n) {\n  return (\n    <div {...props} ref={ref} className={classNames(\"miaixz-shell\", className)}>\n      <header className={classNames(\"miaixz-shell-header\", headerClassName)}>{header}</header>\n      <aside className={classNames(\"miaixz-shell-sidebar\", sidebarClassName)}>{sidebar}</aside>\n      <main className={classNames(\"miaixz-shell-main\", mainClassName)}>{children}</main>\n    </div>\n  );\n});\n\n/**\n * Establishes the width, spacing, and semantic main region of a page.\n *\n * @public\n */\nexport const Page = forwardRef<HTMLElement, PageProps>(function Page(\n  { fullWidth = false, className, ...props },\n  ref,\n) {\n  return (\n    <section\n      {...props}\n      ref={ref}\n      className={classNames(\"miaixz-page\", fullWidth && \"miaixz-layout-full-width\", className)}\n    />\n  );\n});\n\n/**\n * Renders a page title area with description, metadata, and actions.\n *\n * @public\n */\nexport const PageHeader = forwardRef<HTMLElement, PageHeaderProps>(function PageHeader(\n  { title, eyebrow, description, actions, headingLevel = 1, className, children, ...props },\n  ref,\n) {\n  const Heading = `h${headingLevel}` as \"h1\" | \"h2\" | \"h3\";\n\n  return (\n    <header {...props} ref={ref} className={classNames(\"miaixz-page-header\", className)}>\n      <div className=\"miaixz-page-header-content\">\n        {eyebrow !== undefined && <div className=\"miaixz-page-eyebrow\">{eyebrow}</div>}\n        <Heading className=\"miaixz-page-title\">{title}</Heading>\n        {description !== undefined && <p className=\"miaixz-page-description\">{description}</p>}\n        {children}\n      </div>\n      {actions !== undefined && <div className=\"miaixz-page-actions\">{actions}</div>}\n    </header>\n  );\n});\n\n/**\n * Wraps the primary page content with standardized vertical rhythm.\n *\n * @public\n */\nexport const PageBody = forwardRef<HTMLDivElement, PageBodyProps>(function PageBody(\n  { className, ...props },\n  ref,\n) {\n  return <div {...props} ref={ref} className={classNames(\"miaixz-page-body\", className)} />;\n});\n\n/**\n * Aligns page-level filters, search, and primary actions.\n *\n * @public\n */\nexport const PageToolbar = forwardRef<HTMLDivElement, PageToolbarProps>(function PageToolbar(\n  { leading, actions, sticky = false, className, children, ...props },\n  ref,\n) {\n  return (\n    <div\n      {...props}\n      ref={ref}\n      className={classNames(\n        \"miaixz-page-toolbar\",\n        sticky && \"miaixz-page-toolbar-sticky\",\n        className,\n      )}\n    >\n      <div className=\"miaixz-page-toolbar-leading\">{leading ?? children}</div>\n      {actions !== undefined && <div className=\"miaixz-page-toolbar-actions\">{actions}</div>}\n    </div>\n  );\n});\n\n/**\n * Arranges children vertically using a design-token gap.\n *\n * @public\n */\nexport const Stack = forwardRef<HTMLDivElement, StackProps>(function Stack(\n  { className, ...props },\n  ref,\n) {\n  return <div {...props} ref={ref} className={classNames(\"miaixz-layout-stack\", className)} />;\n});\n\n/**\n * Arranges wrapping inline content with controlled alignment and spacing.\n *\n * @public\n */\nexport const Cluster = forwardRef<HTMLDivElement, ClusterProps>(function Cluster(\n  { justify = \"start\", className, ...props },\n  ref,\n) {\n  return (\n    <div\n      {...props}\n      ref={ref}\n      data-justify={justify}\n      className={classNames(\"miaixz-layout-cluster\", className)}\n    />\n  );\n});\n\n/**\n * Creates a responsive auto-fit grid with configurable minimum column width.\n *\n * @public\n */\nexport const Grid = forwardRef<HTMLDivElement, GridProps>(function Grid(\n  { minItemWidth = \"standard\", className, ...props },\n  ref,\n) {\n  return (\n    <div\n      {...props}\n      ref={ref}\n      className={classNames(\n        \"miaixz-layout-grid\",\n        minItemWidth === \"wide\" && \"miaixz-layout-grid-wide\",\n        className,\n      )}\n    />\n  );\n});\n\n/**\n * Creates a responsive primary-secondary split layout.\n *\n * @public\n */\nexport const SplitLayout = forwardRef<HTMLDivElement, SplitLayoutProps>(function SplitLayout(\n  { ratio = \"equal\", className, ...props },\n  ref,\n) {\n  return (\n    <div\n      {...props}\n      ref={ref}\n      data-ratio={ratio}\n      className={classNames(\"miaixz-layout-split\", className)}\n    />\n  );\n});\n\n/**\n * Creates a localized sidebar and content layout that collapses responsively.\n *\n * @public\n */\nexport const SidebarLayout = forwardRef<HTMLDivElement, SidebarLayoutProps>(function SidebarLayout(\n  { sidebar, sidebarLabel, stickySidebar = true, contentClassName, className, children, ...props },\n  ref,\n) {\n  const { t } = useMiaixzLocale();\n  return (\n    <div {...props} ref={ref} className={classNames(\"miaixz-layout-sidebar-content\", className)}>\n      <aside\n        aria-label={sidebarLabel ?? t(\"ui.sectionNavigation.label\")}\n        className={classNames(\"miaixz-layout-sidebar\", stickySidebar && \"miaixz-layout-sticky\")}\n      >\n        {sidebar}\n      </aside>\n      <div className={classNames(\"miaixz-layout-sidebar-main\", contentClassName)}>{children}</div>\n    </div>\n  );\n});\n\n/**\n * Creates a bounded, keyboard-focusable overflow region.\n *\n * @public\n */\nexport const ScrollRegion = forwardRef<HTMLDivElement, ScrollRegionProps>(function ScrollRegion(\n  { label, className, tabIndex, ...props },\n  ref,\n) {\n  return (\n    <div\n      {...props}\n      ref={ref}\n      aria-label={label}\n      role={label ? \"region\" : undefined}\n      tabIndex={tabIndex ?? 0}\n      className={classNames(\"miaixz-layout-scroll-region\", className)}\n    />\n  );\n});\n\n/**\n * Keeps content pinned to a viewport edge within its scrolling container.\n *\n * @public\n */\nexport const Sticky = forwardRef<HTMLDivElement, StickyProps>(function Sticky(\n  { className, ...props },\n  ref,\n) {\n  return <div {...props} ref={ref} className={classNames(\"miaixz-layout-sticky\", className)} />;\n});\n"]}

package/dist/components/page-layout/page-layout.types.d.ts

@@ -0,0 +1,188 @@
+import type { HTMLAttributes, ReactNode } from "react";
+/**
+ * Configures the root application shell.
+ *
+ * @public
+ */
+export interface AppShellProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Supplies global header content.
+     */
+    header: ReactNode;
+    /**
+     * Supplies global navigation content.
+     */
+    sidebar: ReactNode;
+    /**
+     * Adds a class to the main content region.
+     */
+    mainClassName?: string;
+    /**
+     * Adds a class to the header region.
+     */
+    headerClassName?: string;
+    /**
+     * Adds a class to the sidebar region.
+     */
+    sidebarClassName?: string;
+}
+/**
+ * Configures the standard page container.
+ *
+ * @public
+ */
+export interface PageProps extends HTMLAttributes<HTMLElement> {
+    /**
+     * Removes the page maximum-width constraint.
+     *
+     * @defaultValue `false`
+     */
+    fullWidth?: boolean;
+}
+/**
+ * Configures a page title and action region.
+ *
+ * @public
+ */
+export interface PageHeaderProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    /**
+     * Supplies the page heading.
+     */
+    title: ReactNode;
+    /**
+     * Displays compact context above the heading.
+     */
+    eyebrow?: ReactNode;
+    /**
+     * Displays supporting page description content.
+     */
+    description?: ReactNode;
+    /**
+     * Displays page-level actions.
+     */
+    actions?: ReactNode;
+    /**
+     * Selects the semantic heading level.
+     *
+     * @defaultValue `1`
+     */
+    headingLevel?: 1 | 2 | 3;
+}
+/**
+ * Configures the primary page content region.
+ *
+ * @public
+ */
+export interface PageBodyProps extends HTMLAttributes<HTMLDivElement> {
+}
+/**
+ * Configures a page-level toolbar.
+ *
+ * @public
+ */
+export interface PageToolbarProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Supplies leading filters, search, or contextual content.
+     */
+    leading?: ReactNode;
+    /**
+     * Supplies trailing toolbar actions.
+     */
+    actions?: ReactNode;
+    /**
+     * Keeps the toolbar visible within its scrolling container.
+     *
+     * @defaultValue `false`
+     */
+    sticky?: boolean;
+}
+/**
+ * Configures a vertical stack layout.
+ *
+ * @public
+ */
+export interface StackProps extends HTMLAttributes<HTMLDivElement> {
+}
+/**
+ * Configures a wrapping inline cluster layout.
+ *
+ * @public
+ */
+export interface ClusterProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Selects the horizontal distribution of items.
+     *
+     * @defaultValue `"start"`
+     */
+    justify?: "start" | "between" | "end";
+}
+/**
+ * Configures a responsive auto-fit grid.
+ *
+ * @public
+ */
+export interface GridProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Selects the minimum responsive item width.
+     *
+     * @defaultValue `"standard"`
+     */
+    minItemWidth?: "standard" | "wide";
+}
+/**
+ * Configures a responsive two-column split layout.
+ *
+ * @public
+ */
+export interface SplitLayoutProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Selects the relative width of the two regions.
+     *
+     * @defaultValue `"equal"`
+     */
+    ratio?: "equal" | "primary" | "secondary";
+}
+/**
+ * Configures a local sidebar and content layout.
+ *
+ * @public
+ */
+export interface SidebarLayoutProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Supplies the local sidebar content.
+     */
+    sidebar: ReactNode;
+    /**
+     * Overrides the localized sidebar landmark label.
+     */
+    sidebarLabel?: string;
+    /**
+     * Keeps the sidebar visible while its content scrolls.
+     *
+     * @defaultValue `true`
+     */
+    stickySidebar?: boolean;
+    /**
+     * Adds a class to the main content region.
+     */
+    contentClassName?: string;
+}
+/**
+ * Configures a bounded overflow region.
+ *
+ * @public
+ */
+export interface ScrollRegionProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Provides an accessible region label and landmark role.
+     */
+    label?: string;
+}
+/**
+ * Configures a sticky content wrapper.
+ *
+ * @public
+ */
+export interface StickyProps extends HTMLAttributes<HTMLDivElement> {
+}
+//# sourceMappingURL=page-layout.types.d.ts.map

package/dist/components/page-layout/page-layout.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-layout.types.d.ts","sourceRoot":"","sources":["../../../src/components/page-layout/page-layout.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc,CAAC,cAAc,CAAC;IACnE;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAClB;;OAEG;IACH,OAAO,EAAE,SAAS,CAAC;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAU,SAAQ,cAAc,CAAC,WAAW,CAAC;IAC5D;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IACjF;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc,CAAC,cAAc,CAAC;CAAG;AAExE;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACtE;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc,CAAC,cAAc,CAAC;CAAG;AAErE;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,cAAc,CAAC,cAAc,CAAC;IAClE;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAU,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC/D;;;;OAIG;IACH,YAAY,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACtE;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACxE;;OAEG;IACH,OAAO,EAAE,SAAS,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACvE;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc,CAAC,cAAc,CAAC;CAAG"}

package/dist/components/page-layout/page-layout.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=page-layout.types.js.map

package/dist/components/page-layout/page-layout.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-layout.types.js","sourceRoot":"","sources":["../../../src/components/page-layout/page-layout.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { HTMLAttributes, ReactNode } from \"react\";\n\n/**\n * Configures the root application shell.\n *\n * @public\n */\nexport interface AppShellProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * Supplies global header content.\n   */\n  header: ReactNode;\n  /**\n   * Supplies global navigation content.\n   */\n  sidebar: ReactNode;\n  /**\n   * Adds a class to the main content region.\n   */\n  mainClassName?: string;\n  /**\n   * Adds a class to the header region.\n   */\n  headerClassName?: string;\n  /**\n   * Adds a class to the sidebar region.\n   */\n  sidebarClassName?: string;\n}\n\n/**\n * Configures the standard page container.\n *\n * @public\n */\nexport interface PageProps extends HTMLAttributes<HTMLElement> {\n  /**\n   * Removes the page maximum-width constraint.\n   *\n   * @defaultValue `false`\n   */\n  fullWidth?: boolean;\n}\n\n/**\n * Configures a page title and action region.\n *\n * @public\n */\nexport interface PageHeaderProps extends Omit<HTMLAttributes<HTMLElement>, \"title\"> {\n  /**\n   * Supplies the page heading.\n   */\n  title: ReactNode;\n  /**\n   * Displays compact context above the heading.\n   */\n  eyebrow?: ReactNode;\n  /**\n   * Displays supporting page description content.\n   */\n  description?: ReactNode;\n  /**\n   * Displays page-level actions.\n   */\n  actions?: ReactNode;\n  /**\n   * Selects the semantic heading level.\n   *\n   * @defaultValue `1`\n   */\n  headingLevel?: 1 | 2 | 3;\n}\n\n/**\n * Configures the primary page content region.\n *\n * @public\n */\nexport interface PageBodyProps extends HTMLAttributes<HTMLDivElement> {}\n\n/**\n * Configures a page-level toolbar.\n *\n * @public\n */\nexport interface PageToolbarProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * Supplies leading filters, search, or contextual content.\n   */\n  leading?: ReactNode;\n  /**\n   * Supplies trailing toolbar actions.\n   */\n  actions?: ReactNode;\n  /**\n   * Keeps the toolbar visible within its scrolling container.\n   *\n   * @defaultValue `false`\n   */\n  sticky?: boolean;\n}\n\n/**\n * Configures a vertical stack layout.\n *\n * @public\n */\nexport interface StackProps extends HTMLAttributes<HTMLDivElement> {}\n\n/**\n * Configures a wrapping inline cluster layout.\n *\n * @public\n */\nexport interface ClusterProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * Selects the horizontal distribution of items.\n   *\n   * @defaultValue `\"start\"`\n   */\n  justify?: \"start\" | \"between\" | \"end\";\n}\n\n/**\n * Configures a responsive auto-fit grid.\n *\n * @public\n */\nexport interface GridProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * Selects the minimum responsive item width.\n   *\n   * @defaultValue `\"standard\"`\n   */\n  minItemWidth?: \"standard\" | \"wide\";\n}\n\n/**\n * Configures a responsive two-column split layout.\n *\n * @public\n */\nexport interface SplitLayoutProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * Selects the relative width of the two regions.\n   *\n   * @defaultValue `\"equal\"`\n   */\n  ratio?: \"equal\" | \"primary\" | \"secondary\";\n}\n\n/**\n * Configures a local sidebar and content layout.\n *\n * @public\n */\nexport interface SidebarLayoutProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * Supplies the local sidebar content.\n   */\n  sidebar: ReactNode;\n  /**\n   * Overrides the localized sidebar landmark label.\n   */\n  sidebarLabel?: string;\n  /**\n   * Keeps the sidebar visible while its content scrolls.\n   *\n   * @defaultValue `true`\n   */\n  stickySidebar?: boolean;\n  /**\n   * Adds a class to the main content region.\n   */\n  contentClassName?: string;\n}\n\n/**\n * Configures a bounded overflow region.\n *\n * @public\n */\nexport interface ScrollRegionProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * Provides an accessible region label and landmark role.\n   */\n  label?: string;\n}\n\n/**\n * Configures a sticky content wrapper.\n *\n * @public\n */\nexport interface StickyProps extends HTMLAttributes<HTMLDivElement> {}\n"]}

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

@@ -0,0 +1,4 @@
+export { getPaginationEntries, Pagination } from "./pagination.js";
+export type { MiaixzPaginationEntry } from "./pagination.js";
+export type { PaginationProps } from "./pagination.types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/pagination/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/pagination/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/components/pagination/index.js

@@ -0,0 +1,2 @@
+export { getPaginationEntries, Pagination } from "./pagination.js";
+//# sourceMappingURL=index.js.map

package/dist/components/pagination/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/pagination/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["export { getPaginationEntries, Pagination } from \"./pagination.js\";\nexport type { MiaixzPaginationEntry } from \"./pagination.js\";\nexport type { PaginationProps } from \"./pagination.types.js\";\n"]}

package/dist/components/pagination/pagination.d.ts

@@ -0,0 +1,24 @@
+import type { PaginationProps } from "./pagination.types.js";
+/**
+ * Represents a visible page number or a directional pagination ellipsis.
+ *
+ * @public
+ */
+export type MiaixzPaginationEntry = number | "ellipsis-start" | "ellipsis-end";
+/**
+ * Builds visible page numbers and ellipses around the active page.
+ *
+ * @param page - Current one-based page.
+ * @param pageCount - Total number of pages.
+ * @param siblingCount - Page count displayed on either side of the current page.
+ * @returns Stable pagination entries suitable for rendering and testing.
+ * @public
+ */
+export declare function getPaginationEntries(page: number, pageCount: number, siblingCount?: number): MiaixzPaginationEntry[];
+/**
+ * Renders localized previous, page-number, and next navigation controls.
+ *
+ * @public
+ */
+export declare const Pagination: import("react").ForwardRefExoticComponent<PaginationProps & import("react").RefAttributes<HTMLElement>>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/components/pagination/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/components/pagination/pagination.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAE/E;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,SAAI,GACf,qBAAqB,EAAE,CAezB;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,yGA4ErB,CAAC"}

package/dist/components/pagination/pagination.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { classNames } from "../../internal/class-names.js";
+import { useMiaixzLocale } from "../../i18n/index.js";
+import { Icon } from "../icon/index.js";
+/**
+ * Builds visible page numbers and ellipses around the active page.
+ *
+ * @param page - Current one-based page.
+ * @param pageCount - Total number of pages.
+ * @param siblingCount - Page count displayed on either side of the current page.
+ * @returns Stable pagination entries suitable for rendering and testing.
+ * @public
+ */
+export function getPaginationEntries(page, pageCount, siblingCount = 1) {
+    const total = Math.max(1, pageCount);
+    const current = Math.min(Math.max(1, page), total);
+    const visibleSlots = siblingCount * 2 + 5;
+    if (total <= visibleSlots)
+        return Array.from({ length: total }, (_, index) => index + 1);
+    const left = Math.max(2, current - siblingCount);
+    const right = Math.min(total - 1, current + siblingCount);
+    const entries = [1];
+    if (left > 2)
+        entries.push("ellipsis-start");
+    for (let value = left; value <= right; value += 1)
+        entries.push(value);
+    if (right < total - 1)
+        entries.push("ellipsis-end");
+    entries.push(total);
+    return entries;
+}
+/**
+ * Renders localized previous, page-number, and next navigation controls.
+ *
+ * @public
+ */
+export const Pagination = forwardRef(function Pagination({ page, pageCount, onPageChange, siblingCount = 1, label, previousLabel, nextLabel, summary, className, ...props }, ref) {
+    const { t } = useMiaixzLocale();
+    const resolvedLabel = label ?? t("ui.pagination.label");
+    const resolvedPreviousLabel = previousLabel ?? t("ui.pagination.previous");
+    const resolvedNextLabel = nextLabel ?? t("ui.pagination.next");
+    const total = Math.max(1, pageCount);
+    const current = Math.min(Math.max(1, page), total);
+    const entries = getPaginationEntries(current, total, Math.max(0, siblingCount));
+    return (_jsxs("nav", { ...props, ref: ref, "aria-label": resolvedLabel, className: classNames("miaixz-pagination", className), children: [summary !== undefined && _jsx("span", { className: "miaixz-pagination-summary", children: summary }), _jsxs("ul", { className: "miaixz-pagination-list", children: [_jsx("li", { children: _jsx("button", { type: "button", className: "miaixz-pagination-item", disabled: current <= 1, "aria-label": resolvedPreviousLabel, onClick: () => onPageChange(current - 1), children: _jsx(Icon, { name: "ChevronLeft", size: "control" }) }) }), entries.map((entry) => (_jsx("li", { children: typeof entry === "number" ? (_jsx("button", { type: "button", className: "miaixz-pagination-item", "aria-current": entry === current ? "page" : undefined, "aria-label": t("ui.pagination.page", { page: entry }), onClick: () => onPageChange(entry), children: entry })) : (_jsx("span", { className: "miaixz-pagination-ellipsis", "aria-hidden": "true", children: "\u2026" })) }, entry))), _jsx("li", { children: _jsx("button", { type: "button", className: "miaixz-pagination-item", disabled: current >= total, "aria-label": resolvedNextLabel, onClick: () => onPageChange(current + 1), children: _jsx(Icon, { name: "ChevronRight", size: "control" }) }) })] })] }));
+});
+//# sourceMappingURL=pagination.js.map

package/dist/components/pagination/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/components/pagination/pagination.tsx"],"names":[],"mappings":"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","sourcesContent":["import { forwardRef } from \"react\";\n\nimport { classNames } from \"../../internal/class-names.js\";\nimport { useMiaixzLocale } from \"../../i18n/index.js\";\nimport { Icon } from \"../icon/index.js\";\nimport type { PaginationProps } from \"./pagination.types.js\";\n\n/**\n * Represents a visible page number or a directional pagination ellipsis.\n *\n * @public\n */\nexport type MiaixzPaginationEntry = number | \"ellipsis-start\" | \"ellipsis-end\";\n\n/**\n * Builds visible page numbers and ellipses around the active page.\n *\n * @param page - Current one-based page.\n * @param pageCount - Total number of pages.\n * @param siblingCount - Page count displayed on either side of the current page.\n * @returns Stable pagination entries suitable for rendering and testing.\n * @public\n */\nexport function getPaginationEntries(\n  page: number,\n  pageCount: number,\n  siblingCount = 1,\n): MiaixzPaginationEntry[] {\n  const total = Math.max(1, pageCount);\n  const current = Math.min(Math.max(1, page), total);\n  const visibleSlots = siblingCount * 2 + 5;\n  if (total <= visibleSlots) return Array.from({ length: total }, (_, index) => index + 1);\n\n  const left = Math.max(2, current - siblingCount);\n  const right = Math.min(total - 1, current + siblingCount);\n  const entries: MiaixzPaginationEntry[] = [1];\n\n  if (left > 2) entries.push(\"ellipsis-start\");\n  for (let value = left; value <= right; value += 1) entries.push(value);\n  if (right < total - 1) entries.push(\"ellipsis-end\");\n  entries.push(total);\n  return entries;\n}\n\n/**\n * Renders localized previous, page-number, and next navigation controls.\n *\n * @public\n */\nexport const Pagination = forwardRef<HTMLElement, PaginationProps>(function Pagination(\n  {\n    page,\n    pageCount,\n    onPageChange,\n    siblingCount = 1,\n    label,\n    previousLabel,\n    nextLabel,\n    summary,\n    className,\n    ...props\n  },\n  ref,\n) {\n  const { t } = useMiaixzLocale();\n  const resolvedLabel = label ?? t(\"ui.pagination.label\");\n  const resolvedPreviousLabel = previousLabel ?? t(\"ui.pagination.previous\");\n  const resolvedNextLabel = nextLabel ?? t(\"ui.pagination.next\");\n  const total = Math.max(1, pageCount);\n  const current = Math.min(Math.max(1, page), total);\n  const entries = getPaginationEntries(current, total, Math.max(0, siblingCount));\n\n  return (\n    <nav\n      {...props}\n      ref={ref}\n      aria-label={resolvedLabel}\n      className={classNames(\"miaixz-pagination\", className)}\n    >\n      {summary !== undefined && <span className=\"miaixz-pagination-summary\">{summary}</span>}\n      <ul className=\"miaixz-pagination-list\">\n        <li>\n          <button\n            type=\"button\"\n            className=\"miaixz-pagination-item\"\n            disabled={current <= 1}\n            aria-label={resolvedPreviousLabel}\n            onClick={() => onPageChange(current - 1)}\n          >\n            <Icon name=\"ChevronLeft\" size=\"control\" />\n          </button>\n        </li>\n        {entries.map((entry) => (\n          <li key={entry}>\n            {typeof entry === \"number\" ? (\n              <button\n                type=\"button\"\n                className=\"miaixz-pagination-item\"\n                aria-current={entry === current ? \"page\" : undefined}\n                aria-label={t(\"ui.pagination.page\", { page: entry })}\n                onClick={() => onPageChange(entry)}\n              >\n                {entry}\n              </button>\n            ) : (\n              <span className=\"miaixz-pagination-ellipsis\" aria-hidden=\"true\">\n                …\n              </span>\n            )}\n          </li>\n        ))}\n        <li>\n          <button\n            type=\"button\"\n            className=\"miaixz-pagination-item\"\n            disabled={current >= total}\n            aria-label={resolvedNextLabel}\n            onClick={() => onPageChange(current + 1)}\n          >\n            <Icon name=\"ChevronRight\" size=\"control\" />\n          </button>\n        </li>\n      </ul>\n    </nav>\n  );\n});\n"]}

package/dist/components/pagination/pagination.types.d.ts

@@ -0,0 +1,43 @@
+import type { HTMLAttributes, ReactNode } from "react";
+/**
+ * Configures controlled page-number navigation.
+ *
+ * @public
+ */
+export interface PaginationProps extends Omit<HTMLAttributes<HTMLElement>, "onChange"> {
+    /**
+     * Selects the current one-based page.
+     */
+    page: number;
+    /**
+     * Supplies the total number of pages.
+     */
+    pageCount: number;
+    /**
+     * Receives a requested one-based page.
+     */
+    onPageChange: (page: number) => void;
+    /**
+     * Controls the page count shown on either side of the current page.
+     *
+     * @defaultValue `1`
+     */
+    siblingCount?: number;
+    /**
+     * Overrides the localized navigation label.
+     */
+    label?: string;
+    /**
+     * Overrides the localized previous-page label.
+     */
+    previousLabel?: string;
+    /**
+     * Overrides the localized next-page label.
+     */
+    nextLabel?: string;
+    /**
+     * Displays optional pagination summary content.
+     */
+    summary?: ReactNode;
+}
+//# sourceMappingURL=pagination.types.d.ts.map

package/dist/components/pagination/pagination.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.types.d.ts","sourceRoot":"","sources":["../../../src/components/pagination/pagination.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IACpF;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB"}

package/dist/components/pagination/pagination.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pagination.types.js.map

package/dist/components/pagination/pagination.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.types.js","sourceRoot":"","sources":["../../../src/components/pagination/pagination.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { HTMLAttributes, ReactNode } from \"react\";\n\n/**\n * Configures controlled page-number navigation.\n *\n * @public\n */\nexport interface PaginationProps extends Omit<HTMLAttributes<HTMLElement>, \"onChange\"> {\n  /**\n   * Selects the current one-based page.\n   */\n  page: number;\n  /**\n   * Supplies the total number of pages.\n   */\n  pageCount: number;\n  /**\n   * Receives a requested one-based page.\n   */\n  onPageChange: (page: number) => void;\n  /**\n   * Controls the page count shown on either side of the current page.\n   *\n   * @defaultValue `1`\n   */\n  siblingCount?: number;\n  /**\n   * Overrides the localized navigation label.\n   */\n  label?: string;\n  /**\n   * Overrides the localized previous-page label.\n   */\n  previousLabel?: string;\n  /**\n   * Overrides the localized next-page label.\n   */\n  nextLabel?: string;\n  /**\n   * Displays optional pagination summary content.\n   */\n  summary?: ReactNode;\n}\n"]}

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

@@ -0,0 +1,3 @@
+export { Panel, PanelSection } from "./panel.js";
+export type { PanelProps, PanelSectionProps } from "./panel.types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/panel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/panel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/components/panel/index.js

@@ -0,0 +1,2 @@
+export { Panel, PanelSection } from "./panel.js";
+//# sourceMappingURL=index.js.map

package/dist/components/panel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/panel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { Panel, PanelSection } from \"./panel.js\";\nexport type { PanelProps, PanelSectionProps } from \"./panel.types.js\";\n"]}

package/dist/components/panel/panel.d.ts

@@ -0,0 +1,14 @@
+import type { PanelProps, PanelSectionProps } from "./panel.types.js";
+/**
+ * Renders a framed content surface with optional header, actions, and footer.
+ *
+ * @public
+ */
+export declare const Panel: import("react").ForwardRefExoticComponent<PanelProps & import("react").RefAttributes<HTMLElement>>;
+/**
+ * Divides a panel into consistently spaced semantic sections.
+ *
+ * @public
+ */
+export declare const PanelSection: import("react").ForwardRefExoticComponent<PanelSectionProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=panel.d.ts.map

package/dist/components/panel/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../../src/components/panel/panel.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,KAAK,oGA+ChB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,8GAKvB,CAAC"}