prime-ui-kit 0.7.11 → 0.9.0

package/dist/internal/ControlSizeContext.d.ts

@@ -1,11 +1,7 @@
 import * as React from "react";
-import type { InputSize } from "@/internal/states";
-/** Размер «контрольной поверхности» (поля, кнопки, селект и т.д.) для каскада в дочерние `Icon`. */
-export type ControlSurfaceSize = "xs" | InputSize;
-/** Для Badge / Tag / Kbd: в ярусе только s–xl, `xs` с контекста маппится в `s`. */
-export declare function controlSurfaceToInputSize(surface: ControlSurfaceSize): InputSize;
+import type { ControlSize } from "@/internal/states";
 export type ControlSizeProviderProps = {
-    value: ControlSurfaceSize;
+    value: ControlSize;
     children: React.ReactNode;
 };
 export declare function ControlSizeProvider({ value, children }: ControlSizeProviderProps): import("react/jsx-runtime").JSX.Element;
@@ -13,5 +9,5 @@ export declare namespace ControlSizeProvider {
     var displayName: string;
 }
 /** Для `Icon`: если `size` не передан явно, берётся из ближайшего контрола. */
-export declare function useOptionalControlSize(): ControlSurfaceSize | undefined;
+export declare function useOptionalControlSize(): ControlSize | undefined;
 //# sourceMappingURL=ControlSizeContext.d.ts.map

package/dist/internal/ControlSizeContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ControlSizeContext.d.ts","sourceRoot":"","sources":["../../../src/internal/ControlSizeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,oGAAoG;AACpG,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAC;AAElD,mFAAmF;AACnF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,CAEhF;AAKD,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,wBAAwB,2CAEhF;yBAFe,mBAAmB;;;AAMnC,+EAA+E;AAC/E,wBAAgB,sBAAsB,IAAI,kBAAkB,GAAG,SAAS,CAEvE"}
+{"version":3,"file":"ControlSizeContext.d.ts","sourceRoot":"","sources":["../../../src/internal/ControlSizeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,wBAAwB,2CAEhF;yBAFe,mBAAmB;;;AAMnC,+EAA+E;AAC/E,wBAAgB,sBAAsB,IAAI,WAAW,GAAG,SAAS,CAEhE"}

package/dist/internal/FieldFrame.d.ts

@@ -0,0 +1,48 @@
+import * as React from "react";
+import type { ControlSize } from "@/internal/states";
+/** Field props shared by Select, TagSelect and Datepicker (the same contract as `Input.Root`). */
+export type FieldFrameProps = {
+    label?: React.ReactNode;
+    /** Red `*` after the label; the control gets native `required` / `aria-required`. */
+    required?: boolean;
+    /** Muted `labels.optional` marker after the label. */
+    optional?: boolean;
+    hint?: React.ReactNode;
+    /** Error message; replaces the hint in the same slot and implies `invalid`. */
+    error?: React.ReactNode;
+    /**
+     * Draws the focus ring on the field (default). `false` sets `data-focus-ring="false"` on it and
+     * hides only the visual ring — focus, keyboard and ARIA are unchanged, the error ring still shows.
+     * Turn it off only where focus is otherwise obvious; WCAG 2.4.7.
+     */
+    focusRing?: boolean;
+};
+export declare function hasFieldError(error: React.ReactNode): boolean;
+export type FieldIds = {
+    controlId: string;
+    /** Id of the label element (rendered only when `label` is set). */
+    labelId: string;
+    hintId: string;
+    errorId: string;
+    /** `aria-describedby` of the control: caller ids + hint or error. */
+    describedBy: string | undefined;
+    invalid: boolean;
+};
+/** Ids and validation state of a framed field. */
+export declare function useFieldFrame(explicitId: string | undefined, { hint, error, invalid }: {
+    hint?: React.ReactNode;
+    error?: React.ReactNode;
+    invalid?: boolean;
+}, ariaDescribedBy?: string): FieldIds;
+type FieldFrameRenderProps = FieldFrameProps & {
+    size: ControlSize;
+    ids: FieldIds;
+    disabled?: boolean;
+    optionalLabel: string;
+    className?: string;
+    children: React.ReactNode;
+};
+/** Label row · control · support row (hint or error), spaced by the tier's `label-gap` / `hint-gap`. */
+export declare function FieldFrame({ size, ids, label, required, optional, hint, error, disabled, optionalLabel, className, children, }: FieldFrameRenderProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=FieldFrame.d.ts.map

package/dist/internal/FieldFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldFrame.d.ts","sourceRoot":"","sources":["../../../src/internal/FieldFrame.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,kGAAkG;AAClG,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,GAAG,OAAO,CAE7D;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EAChG,eAAe,CAAC,EAAE,MAAM,GACvB,QAAQ,CAmBV;AAED,KAAK,qBAAqB,GAAG,eAAe,GAAG;IAC7C,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,QAAQ,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,wGAAwG;AACxG,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,GAAG,EACH,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,aAAa,EACb,SAAS,EACT,QAAQ,GACT,EAAE,qBAAqB,2CAyCvB"}

package/dist/internal/layoutPxFromPrimitives.d.ts

@@ -4,10 +4,4 @@
  */
 export declare function getRootFontSizePx(): number;
 export declare function remToPx(rem: string, rootPx?: number): number;
-/** Зазор панели от якоря: `spaces.layout.s`. */
-export declare function getFloatingPanelOffsetPx(): number;
-/** Зазор listbox от триггера Select: `spaces.layout.xs`. */
-export declare function getFloatingSelectListboxOffsetPx(): number;
-/** Внутренний отступ от края вьюпорта при расчёте позиции / max-height. */
-export declare function getFloatingViewportPadPx(): number;
 //# sourceMappingURL=layoutPxFromPrimitives.d.ts.map

package/dist/internal/layoutPxFromPrimitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layoutPxFromPrimitives.d.ts","sourceRoot":"","sources":["../../../src/internal/layoutPxFromPrimitives.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAO1C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAA4B,GAAG,MAAM,CAGjF;AAED,gDAAgD;AAChD,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,4DAA4D;AAC5D,wBAAgB,gCAAgC,IAAI,MAAM,CAEzD;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD"}
+{"version":3,"file":"layoutPxFromPrimitives.d.ts","sourceRoot":"","sources":["../../../src/internal/layoutPxFromPrimitives.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAO1C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAA4B,GAAG,MAAM,CAGjF"}

package/dist/internal/states.d.ts

@@ -1,89 +1,26 @@
-export declare const interactionStates: readonly ["default", "hover", "active", "focus", "focus-visible", "disabled"];
-export declare const selectionStates: readonly ["selected", "checked", "indeterminate"];
-export declare const validationStates: readonly ["valid", "invalid", "readonly", "required"];
-export declare const asyncStates: readonly ["idle", "loading", "success", "error"];
-export declare const disclosureStates: readonly ["open", "closed"];
-export declare const componentVariants: {
-    readonly button: readonly ["primary", "neutral", "error"];
-    readonly input: readonly ["default", "error"];
-    readonly textarea: readonly ["default", "error"];
-    readonly checkbox: readonly ["default", "error"];
-    readonly radio: readonly ["default", "error"];
-    readonly switch: readonly ["default", "error"];
-    readonly select: readonly ["default", "error"];
-    readonly modal: readonly ["default"];
-};
-export declare const componentSizes: {
-    readonly buttonGroup: readonly ["s", "m", "l", "xl"];
-    readonly button: readonly ["s", "m", "l", "xl"];
-    readonly input: readonly ["s", "m", "l", "xl"];
-    readonly textarea: readonly ["s", "m", "l", "xl"];
-    readonly checkbox: readonly ["s", "m", "l", "xl"];
-    readonly radio: readonly ["s", "m", "l", "xl"];
-    readonly switch: readonly ["s", "m", "l", "xl"];
-    readonly select: readonly ["s", "m", "l", "xl"];
-    readonly fileUpload: readonly ["s", "m", "l", "xl"];
-    readonly linkButton: readonly ["s", "m", "l", "xl"];
-    readonly breadcrumb: readonly ["s", "m", "l", "xl"];
-    readonly divider: readonly ["s", "m", "l", "xl"];
-    readonly label: readonly ["s", "m", "l", "xl"];
-    readonly hint: readonly ["s", "m", "l", "xl"];
-    readonly banner: readonly ["s", "m", "l", "xl"];
-    readonly digitInput: readonly ["s", "m", "l", "xl"];
-    readonly kbd: readonly ["s", "m", "l", "xl"];
-    readonly slider: readonly ["s", "m", "l", "xl"];
-    readonly tabs: readonly ["s", "m", "l", "xl"];
-    readonly pagination: readonly ["s", "m", "l", "xl"];
-    readonly stepper: readonly ["s", "m", "l", "xl"];
-    readonly accordion: readonly ["s", "m", "l", "xl"];
-    readonly dropdown: readonly ["s", "m", "l", "xl"];
-    readonly progressBar: readonly ["s", "m", "l", "xl"];
-    readonly sidebar: readonly ["s", "m", "l", "xl"];
-    readonly drawer: readonly ["s", "m", "l", "xl"];
-    readonly dataTable: readonly ["s", "m", "l", "xl"];
-    readonly emptyPage: readonly ["s", "m", "l", "xl"];
-};
-export declare const buttonModes: readonly ["filled", "stroke", "lighter", "ghost", "fancy"];
-export type InteractionState = (typeof interactionStates)[number];
-export type SelectionState = (typeof selectionStates)[number];
-export type ValidationState = (typeof validationStates)[number];
-export type AsyncState = (typeof asyncStates)[number];
-export type DisclosureState = (typeof disclosureStates)[number];
-export type ButtonVariant = (typeof componentVariants.button)[number];
-export type InputVariant = (typeof componentVariants.input)[number];
-export type TextareaVariant = (typeof componentVariants.textarea)[number];
-export type CheckboxVariant = (typeof componentVariants.checkbox)[number];
-export type RadioVariant = (typeof componentVariants.radio)[number];
-export type SwitchVariant = (typeof componentVariants.switch)[number];
-export type SelectVariant = (typeof componentVariants.select)[number];
-export type ModalVariant = (typeof componentVariants.modal)[number];
-export type ButtonGroupSize = (typeof componentSizes.buttonGroup)[number];
-export type ButtonSize = (typeof componentSizes.button)[number];
-export type InputSize = (typeof componentSizes.input)[number];
-export type TextareaSize = (typeof componentSizes.textarea)[number];
-export type CheckboxSize = (typeof componentSizes.checkbox)[number];
-export type RadioSize = (typeof componentSizes.radio)[number];
-export type SwitchSize = (typeof componentSizes.switch)[number];
-export type SelectSize = (typeof componentSizes.select)[number];
-export type FileUploadSize = (typeof componentSizes.fileUpload)[number];
-export type LinkButtonSize = (typeof componentSizes.linkButton)[number];
-export type BreadcrumbSize = (typeof componentSizes.breadcrumb)[number];
-export type DividerSize = (typeof componentSizes.divider)[number];
-export type LabelSize = (typeof componentSizes.label)[number];
-export type HintSize = (typeof componentSizes.hint)[number];
-export type BannerSize = (typeof componentSizes.banner)[number];
-export type DigitInputSize = (typeof componentSizes.digitInput)[number];
-export type KbdSize = (typeof componentSizes.kbd)[number];
-export type SliderSize = (typeof componentSizes.slider)[number];
-export type TabsSize = (typeof componentSizes.tabs)[number];
-export type PaginationSize = (typeof componentSizes.pagination)[number];
-export type StepperSize = (typeof componentSizes.stepper)[number];
-export type AccordionSize = (typeof componentSizes.accordion)[number];
-export type DropdownSize = (typeof componentSizes.dropdown)[number];
-export type ProgressBarSize = (typeof componentSizes.progressBar)[number];
-export type SidebarSize = (typeof componentSizes.sidebar)[number];
-export type DrawerSize = (typeof componentSizes.drawer)[number];
-export type DataTableSize = (typeof componentSizes.dataTable)[number];
-export type EmptyPageSize = (typeof componentSizes.emptyPage)[number];
-export type ButtonMode = (typeof buttonModes)[number];
+/**
+ * Shared API vocabulary (docs/foundation.md §10). One name per concept; components import
+ * these types instead of declaring their own aliases.
+ */
+/** Control size tiers: xs 28 · s 32 · m 36 · l 40 · xl 48. Default is always `m`. */
+export declare const controlSizes: readonly ["xs", "s", "m", "l", "xl"];
+export type ControlSize = (typeof controlSizes)[number];
+/** Visual treatment. */
+export declare const variants: readonly ["solid", "soft", "outline", "ghost"];
+export type Variant = (typeof variants)[number];
+/** Semantic color. Destructive is `danger`. */
+export declare const tones: readonly ["neutral", "accent", "success", "warning", "danger", "info"];
+export type Tone = (typeof tones)[number];
+/** Decorative palette color (Badge, Tag, Avatar). */
+export declare const paletteColors: readonly ["gray", "blue", "green", "orange", "red", "yellow", "purple", "sky", "pink", "teal"];
+export type PaletteColor = (typeof paletteColors)[number];
+/** Values of `data-state`. */
+export declare const dataStates: readonly ["open", "closed", "checked", "unchecked", "indeterminate", "active", "inactive"];
+export type DataState = (typeof dataStates)[number];
+/**
+ * Text color (Typography, Icon). `default` is primary text, `secondary` and `muted` are the
+ * two quieter steps; the rest map to the semantic `*-text` colors.
+ */
+export declare const textTones: readonly ["default", "secondary", "muted", "accent", "success", "warning", "danger"];
+export type TextTone = (typeof textTones)[number];
 //# sourceMappingURL=states.d.ts.map

package/dist/internal/states.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../src/internal/states.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../src/internal/states.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qFAAqF;AACrF,eAAO,MAAM,YAAY,sCAAuC,CAAC;AACjE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,wBAAwB;AACxB,eAAO,MAAM,QAAQ,gDAAiD,CAAC;AACvE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,+CAA+C;AAC/C,eAAO,MAAM,KAAK,wEAAyE,CAAC;AAC5F,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C,qDAAqD;AACrD,eAAO,MAAM,aAAa,gGAWhB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,8BAA8B;AAC9B,eAAO,MAAM,UAAU,4FAQb,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,SAAS,sFAQZ,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/internal/useFieldDescriptions.d.ts

@@ -0,0 +1,18 @@
+export type FieldDescriptions = {
+    hintId: string;
+    errorId: string;
+    /** An error part is mounted. */
+    hasError: boolean;
+    /** `aria-describedby` for the control: caller ids + mounted hint + mounted error. */
+    describedBy: string | undefined;
+    /** Call from a mounted hint part's layout effect; returns the cleanup. */
+    registerHint: () => () => void;
+    /** Call from a mounted error part's layout effect; returns the cleanup. */
+    registerError: () => () => void;
+};
+/**
+ * Ids and `aria-describedby` for compound fields whose hint/error are separate parts
+ * (Checkbox, Radio, Switch): parts register themselves while mounted.
+ */
+export declare function useFieldDescriptions(inputId: string, ariaDescribedBy?: string): FieldDescriptions;
+//# sourceMappingURL=useFieldDescriptions.d.ts.map

package/dist/internal/useFieldDescriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldDescriptions.d.ts","sourceRoot":"","sources":["../../../src/internal/useFieldDescriptions.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,qFAAqF;IACrF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,0EAA0E;IAC1E,YAAY,EAAE,MAAM,MAAM,IAAI,CAAC;IAC/B,2EAA2E;IAC3E,aAAa,EAAE,MAAM,MAAM,IAAI,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAwBjG"}

package/dist/layout/app-shell/AppShell.d.ts

@@ -1,50 +1,46 @@
 import * as React from "react";
-export type AppShellRootProps = {
+export type AppShellRootProps = React.HTMLAttributes<HTMLDivElement> & {
+    /** Viewport-high shell: only `AppShell.Main` scrolls. Otherwise the document scrolls. */
     fillViewport?: boolean;
-    className?: string;
-    children?: React.ReactNode;
-} & React.HTMLAttributes<HTMLDivElement>;
-export type AppShellNavProps = {
-    className?: string;
-    children?: React.ReactNode;
-} & React.HTMLAttributes<HTMLDivElement>;
-declare function AppShellNav({ className, children, ...rest }: AppShellNavProps): import("react/jsx-runtime").JSX.Element;
+};
+export type AppShellNavProps = React.HTMLAttributes<HTMLDivElement>;
+/** Navigation column (usually `Sidebar.Root`); sits on the canvas. */
+declare function AppShellNav({ className, ...rest }: AppShellNavProps): import("react/jsx-runtime").JSX.Element;
 declare namespace AppShellNav {
     var displayName: string;
 }
-export type AppShellMainProps = {
-    className?: string;
-    children?: React.ReactNode;
-} & React.HTMLAttributes<HTMLElement>;
-export type AppShellTemplateProps = {
-    fillViewport?: boolean;
-    className?: string;
-    /** Навигация: `Sidebar.Root` или `nav`. */
-    nav: React.ReactNode;
+export type AppShellHeaderProps = React.HTMLAttributes<HTMLElement>;
+/** `full` (default): the whole panel with responsive gutters; `contained`: centered, up to `--prime-layout-content-max-width` (long-read pages). */
+export type AppShellContentWidth = "contained" | "full";
+export type AppShellMainProps = React.HTMLAttributes<HTMLElement> & {
+    contentWidth?: AppShellContentWidth;
+};
+export type AppShellTemplateProps = Omit<AppShellRootProps, "children"> & {
+    /** Navigation column content, usually `Sidebar.Root`. */
+    nav?: React.ReactNode;
+    /** `AppShell.Header` content; no header row when omitted. */
+    header?: React.ReactNode;
     children?: React.ReactNode;
-    navProps?: Omit<AppShellNavProps, "children">;
     mainProps?: Omit<AppShellMainProps, "children">;
-} & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "ref">;
+};
 export declare const AppShell: {
-    Root: React.ForwardRefExoticComponent<{
+    Root: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+        /** Viewport-high shell: only `AppShell.Main` scrolls. Otherwise the document scrolls. */
         fillViewport?: boolean;
-        className?: string;
-        children?: React.ReactNode;
-    } & React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+    } & React.RefAttributes<HTMLDivElement>>;
     Nav: typeof AppShellNav;
-    Main: React.ForwardRefExoticComponent<{
-        className?: string;
-        children?: React.ReactNode;
-    } & React.HTMLAttributes<HTMLElement> & React.RefAttributes<HTMLElement>>;
-    Template: React.ForwardRefExoticComponent<{
-        fillViewport?: boolean;
-        className?: string;
-        /** Навигация: `Sidebar.Root` или `nav`. */
-        nav: React.ReactNode;
+    Header: React.ForwardRefExoticComponent<AppShellHeaderProps & React.RefAttributes<HTMLElement>>;
+    Main: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+        contentWidth?: AppShellContentWidth;
+    } & React.RefAttributes<HTMLElement>>;
+    Template: React.ForwardRefExoticComponent<Omit<AppShellRootProps, "children"> & {
+        /** Navigation column content, usually `Sidebar.Root`. */
+        nav?: React.ReactNode;
+        /** `AppShell.Header` content; no header row when omitted. */
+        header?: React.ReactNode;
         children?: React.ReactNode;
-        navProps?: Omit<AppShellNavProps, "children">;
         mainProps?: Omit<AppShellMainProps, "children">;
-    } & Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "ref"> & React.RefAttributes<HTMLElement>>;
+    } & React.RefAttributes<HTMLElement>>;
 };
 export {};
 //# sourceMappingURL=AppShell.d.ts.map

package/dist/layout/app-shell/AppShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../../../src/layout/app-shell/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAW/B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AAmBzC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AAEzC,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,gBAAgB,2CAMtE;kBANQ,WAAW;;;AASpB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,GAAG,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;AAoCtC,MAAM,MAAM,qBAAqB,GAAG;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAC9C,SAAS,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;CACjD,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;AA6BnE,eAAO,MAAM,QAAQ;;uBAhHJ,OAAO;oBACV,MAAM;mBACP,KAAK,CAAC,SAAS;;;;oBAmCd,MAAM;mBACP,KAAK,CAAC,SAAS;;;uBAsCX,OAAO;oBACV,MAAM;QAClB,2CAA2C;aACtC,KAAK,CAAC,SAAS;mBACT,KAAK,CAAC,SAAS;mBACf,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;oBACjC,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC;;CAmChD,CAAC"}
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../../../src/layout/app-shell/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG;IACrE,yFAAyF;IACzF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AAEpE,sEAAsE;AACtE,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,gBAAgB,2CAE5D;kBAFQ,WAAW;;;AAiCpB,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;AAWpE,oJAAoJ;AACpJ,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,MAAM,CAAC;AAExD,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,GAAG;IAClE,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC,CAAC;AAgCF,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,GAAG;IACxE,yDAAyD;IACzD,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;CACjD,CAAC;AAuBF,eAAO,MAAM,QAAQ;;QAtHnB,yFAAyF;uBAC1E,OAAO;;;;;uBAsDP,oBAAoB;;;QAkCnC,yDAAyD;cACnD,KAAK,CAAC,SAAS;QACrB,6DAA6D;iBACpD,KAAK,CAAC,SAAS;mBACb,KAAK,CAAC,SAAS;oBACd,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC;;CA8BhD,CAAC"}

package/dist/layout/index.d.ts

@@ -1,8 +1,5 @@
-export type { AppShellMainProps, AppShellNavProps, AppShellRootProps, AppShellTemplateProps, } from "./app-shell/AppShell";
+export type { AppShellContentWidth, AppShellHeaderProps, AppShellMainProps, AppShellNavProps, AppShellRootProps, AppShellTemplateProps, } from "./app-shell/AppShell";
 export { AppShell } from "./app-shell/AppShell";
-export type { SidebarContentProps, SidebarFooterProps, SidebarGroupLabelProps, SidebarGroupProps, SidebarHeaderMainProps, SidebarHeaderProps, SidebarHeaderRowProps, SidebarIdentityButtonProps, SidebarMenuActionProps, SidebarMenuButtonProps, SidebarMenuIconProps, SidebarMenuItemProps, SidebarMenuLabelProps, SidebarMenuLinkProps, SidebarMenuProps, SidebarMenuRouterLinkProps, SidebarMenuTrailingProps, SidebarNavCategoryCountProps, SidebarNavCategoryLabelProps, SidebarNavCategoryPanelProps, SidebarNavCategoryProps, SidebarNavCategoryTriggerProps, SidebarNavDocTreeProps, SidebarNavPanelBodyProps, SidebarNavPanelHeadingProps, SidebarNavPanelProps, SidebarResponsive, SidebarRootProps, SidebarSize, SidebarTextProps, SidebarToggleButtonProps, } from "./sidebar/Sidebar";
-export { Sidebar, useSidebarContext } from "./sidebar/Sidebar";
-export type { StoredSidebarDesktopMode } from "./sidebar/sidebarDesktopStorage";
-export type { SidebarLayoutMode } from "./sidebar/sidebarLayout";
-export { SIDEBAR_LAYOUT_BREAKPOINT_MAX, SIDEBAR_MEDIA_QUERY_INLINE, SIDEBAR_MEDIA_QUERY_NARROW, SIDEBAR_MEDIA_QUERY_XS_HIDDEN, } from "./sidebar/sidebarLayout";
+export type { SidebarContentProps, SidebarFooterProps, SidebarGroupProps, SidebarHeaderProps, SidebarItemProps, SidebarLabels, SidebarMode, SidebarRootProps, SidebarToggleProps, } from "./sidebar/Sidebar";
+export { Sidebar, useSidebar } from "./sidebar/Sidebar";
 //# sourceMappingURL=index.d.ts.map

package/dist/layout/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/layout/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/layout/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}