prime-ui-kit 0.3.1 → 0.4.0

package/dist/layout/sidebar/Sidebar.d.ts

@@ -10,8 +10,16 @@ export type { SidebarLayoutMode, SidebarRootProps, SidebarSize };
 export { useSidebarContext };
 /** @deprecated Используйте `responsive` из `Sidebar.Root`. */
 export type SidebarResponsive = boolean;
-export type SidebarNavPanelProps = React.ComponentPropsWithoutRef<"nav">;
-declare function SidebarNavPanel({ className, id, ...rest }: SidebarNavPanelProps): import("react/jsx-runtime").JSX.Element;
+export type SidebarToggleButtonProps = Omit<React.ComponentPropsWithoutRef<"button">, "children" | "aria-label"> & {
+    openLabel?: string;
+    closedLabel?: string;
+    placement?: "inline" | "edge";
+};
+export type SidebarNavPanelProps = React.ComponentPropsWithoutRef<"nav"> & {
+    /** По умолчанию рендерится встроенная кнопка сворачивания на грани панели (`placement="edge"`). Состояние — через `Sidebar.Root` (`state` / `onStateChange`) или `useSidebarContext`. */
+    showToggle?: boolean;
+};
+declare function SidebarNavPanel({ className, id, showToggle, children, ...rest }: SidebarNavPanelProps): import("react/jsx-runtime").JSX.Element;
 declare namespace SidebarNavPanel {
     var displayName: string;
 }
@@ -47,11 +55,6 @@ declare function SidebarText({ className, ...rest }: SidebarTextProps): import("
 declare namespace SidebarText {
     var displayName: string;
 }
-export type SidebarToggleButtonProps = Omit<React.ComponentPropsWithoutRef<"button">, "children" | "aria-label"> & {
-    openLabel?: string;
-    closedLabel?: string;
-    placement?: "inline" | "edge";
-};
 export type SidebarIdentityButtonProps = Omit<React.ComponentPropsWithoutRef<"button">, "children"> & {
     leading?: React.ReactNode;
     title: React.ReactNode;

package/dist/layout/sidebar/Sidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../../src/layout/sidebar/Sidebar.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../../src/layout/sidebar/Sidebar.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AAKhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAIxC,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,EACxC,UAAU,GAAG,YAAY,CAC1B,GAAG;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC/B,CAAC;AAkDF,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,GAAG;IACzE,yLAAyL;IACzL,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,iBAAS,eAAe,CAAC,EACvB,SAAS,EACT,EAAE,EACF,UAAiB,EACjB,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,oBAAoB,2CAgBtB;kBAtBQ,eAAe;;;AA0BxB,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;AAE1E,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,kBAAkB,2CAEhE;kBAFQ,aAAa;;;AAMtB,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAE1E,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,qBAAqB,2CAEtE;kBAFQ,gBAAgB;;;AAMzB,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAE3E,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,sBAAsB,2CAExE;kBAFQ,iBAAiB;;;AAM1B,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,EACtD,IAAI,CACL,CAAC;AAEF,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,IAAiB,EAAE,GAAG,IAAI,EAAE,EAAE,mBAAmB,2CASrF;kBATQ,cAAc;;;AAavB,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,GAAG;IAC1E,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC7B,CAAC;AAEF,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,OAAiB,EAAE,GAAG,IAAI,EAAE,EAAE,kBAAkB,2CAOnF;kBAPQ,aAAa;;;AAWtB,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAEtE,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,gBAAgB,2CAE5D;kBAFQ,WAAW;;;AAMpB,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,EACxC,UAAU,CACX,GAAG;IACF,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,CAAC;AAyCF,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,wBAAwB,CAAC,SAAS,CAAC,GAAG;IAC1E,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B,CAAC;AAmHF,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,iBAAiB,2CAcvF;kBAdQ,YAAY;;;AAkBrB,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAE3E,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,sBAAsB,2CAYlF;kBAZQ,iBAAiB;;;AAgB1B,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AAExF,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,OAAwB,EAAE,GAAG,IAAI,EAAE,EAAE,qBAAqB,2CAEhG;kBAFQ,gBAAgB;;;AAMzB,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAEpE,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,gBAAgB,2CAE5D;kBAFQ,WAAW;;;AAMpB,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAExE,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,oBAAoB,2CAEpE;kBAFQ,eAAe;;;AAMxB,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAE1E,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,oBAAoB,2CAEpE;kBAFQ,eAAe;;;AAMxB,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAE3E,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,qBAAqB,2CAEtE;kBAFQ,gBAAgB;;;AAMzB,MAAM,MAAM,wBAAwB,GAAG,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAE9E,iBAAS,mBAAmB,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,wBAAwB,2CAE5E;kBAFQ,mBAAmB;;;AAM5B,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,GAAG;IAC9E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,CAAC;AAcF,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,GAAG;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAuHF,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,GAAG;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAYF,MAAM,MAAM,0BAA0B,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,OAAO,CAAC,GAAG;IACxF,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AA0BF,MAAM,MAAM,wBAAwB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9F,iBAAS,mBAAmB,CAAC,EAAE,SAAS,EAAE,IAAiB,EAAE,GAAG,IAAI,EAAE,EAAE,wBAAwB,2CAS/F;kBATQ,mBAAmB;;;AAa5B,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAE3E,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,sBAAsB,2CAExE;kBAFQ,iBAAiB;;;AAM1B,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAE/E,iBAAS,sBAAsB,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,2BAA2B,2CAOlF;kBAPQ,sBAAsB;;;AAW/B,MAAM,MAAM,uBAAuB,GAAG,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAE5E,iBAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,uBAAuB,2CAE1E;kBAFQ,kBAAkB;;;AAM3B,MAAM,MAAM,8BAA8B,GAAG,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;AAYtF,MAAM,MAAM,4BAA4B,GAAG,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAElF,iBAAS,uBAAuB,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,4BAA4B,2CAEpF;kBAFQ,uBAAuB;;;AAMhC,MAAM,MAAM,4BAA4B,GAAG,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAElF,iBAAS,uBAAuB,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,4BAA4B,2CAEpF;kBAFQ,uBAAuB;;;AAMhC,MAAM,MAAM,4BAA4B,GAAG,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAEjF,iBAAS,uBAAuB,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,4BAA4B,2CAEpF;kBAFQ,uBAAuB;;;AAMhC,MAAM,MAAM,0BAA0B,GAAG,sBAAsB,CAAC;AAQhE,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA7pBN,MAAM;sBACJ,MAAM;oBACR,QAAQ,GAAG,MAAM;;;kBAuJnB,KAAK,CAAC,SAAS;eAClB,KAAK,CAAC,SAAS;mBACX,KAAK,CAAC,SAAS;mBACf,KAAK,CAAC,SAAS;;;;;;;;iBAqQjB,OAAO;kBACN,OAAO;kBACP,KAAK,CAAC,SAAS;;;iBAyHhB,OAAO;;;kBAcN,KAAK,CAAC,SAAS;;;mBAzJd,KAAK,CAAC,SAAS;;;;;;iBAgBjB,OAAO;kBACN,OAAO;kBACP,KAAK,CAAC,SAAS;;;CA0RzB,CAAC"}

package/dist/layout/sidebar/SidebarRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SidebarRoot.d.ts","sourceRoot":"","sources":["../../../../src/layout/sidebar/SidebarRoot.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EACL,KAAK,uBAAuB,EAG5B,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,GAAG;IACzF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,kBAAkB;IAClB,IAAI,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IACnD,kBAAkB;IAClB,WAAW,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC1D,kBAAkB;IAClB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClD,kBAAkB;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kBAAkB;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB;IAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B,CAAC;AAiBF,QAAA,MAAM,WAAW;cArCL,KAAK,CAAC,SAAS;WAClB,WAAW;WACX,WAAW;YACV,iBAAiB;mBACV,iBAAiB;oBAChB,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;IAClD,kBAAkB;WACX,iBAAiB,GAAG,uBAAuB;IAClD,kBAAkB;kBACJ,iBAAiB,GAAG,uBAAuB;IACzD,kBAAkB;mBACH,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;IACjD,kBAAkB;WACX,OAAO;IACd,kBAAkB;kBACJ,OAAO;IACrB,kBAAkB;mBACH,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI;iBACzB,OAAO;kBACN,UAAU;qCAgSxB,CAAC;AAIH,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"SidebarRoot.d.ts","sourceRoot":"","sources":["../../../../src/layout/sidebar/SidebarRoot.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EACL,KAAK,uBAAuB,EAG5B,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,GAAG;IACzF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,kBAAkB;IAClB,IAAI,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IACnD,kBAAkB;IAClB,WAAW,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC1D,kBAAkB;IAClB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClD,kBAAkB;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kBAAkB;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB;IAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B,CAAC;AAiBF,QAAA,MAAM,WAAW;cArCL,KAAK,CAAC,SAAS;WAClB,WAAW;WACX,WAAW;YACV,iBAAiB;mBACV,iBAAiB;oBAChB,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;IAClD,kBAAkB;WACX,iBAAiB,GAAG,uBAAuB;IAClD,kBAAkB;kBACJ,iBAAiB,GAAG,uBAAuB;IACzD,kBAAkB;mBACH,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;IACjD,kBAAkB;WACX,OAAO;IACd,kBAAkB;kBACJ,OAAO;IACrB,kBAAkB;mBACH,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI;iBACzB,OAAO;kBACN,UAAU;qCAwQxB,CAAC;AAIH,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/layout/sidebar/examples/01-app-shell-nav.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Primary app layout: `AppShell.Template` nav slot holds `Sidebar` with `sidebarSlot="page-nav"`.
+ * `NavPanel` включает встроенную кнопку на грани (`data-placement="edge"`); режим — через `Sidebar.Root`.
+ */
+export default function SidebarExampleAppShellNav(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=01-app-shell-nav.d.ts.map

package/dist/layout/sidebar/examples/01-app-shell-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"01-app-shell-nav.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/01-app-shell-nav.tsx"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,4CAgFhD"}

package/dist/layout/sidebar/examples/02-collapsible-desktop.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Desktop collapse: встроенная кнопка на грани переключает expanded ↔ compact (не оверлей мобильного режима).
+ * С `responsive={false}` узкое окно сохраняет инлайн-рейл.
+ */
+export default function SidebarExampleCollapsibleDesktop(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=02-collapsible-desktop.d.ts.map

package/dist/layout/sidebar/examples/02-collapsible-desktop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"02-collapsible-desktop.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/02-collapsible-desktop.tsx"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,gCAAgC,4CAgEvD"}

package/dist/layout/sidebar/examples/03-controlled-state.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Контролируемый режим: родитель задаёт `state` / `onStateChange`; кнопка на грани панели вызывает то же переключение через контекст.
+ */
+export default function SidebarExampleControlledState(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=03-controlled-state.d.ts.map

package/dist/layout/sidebar/examples/03-controlled-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"03-controlled-state.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/03-controlled-state.tsx"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,6BAA6B,4CAwEpD"}

package/dist/layout/sidebar/examples/04-router-navigation.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SPA routes: `Sidebar.MenuRouterLink` wraps React Router `NavLink`. Wrap the tree in a router
+ * (`BrowserRouter` in apps; `MemoryRouter` in tests and docs).
+ */
+export default function SidebarExampleRouterNavigation(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=04-router-navigation.d.ts.map

package/dist/layout/sidebar/examples/04-router-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"04-router-navigation.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/04-router-navigation.tsx"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,8BAA8B,4CAqErD"}

package/dist/layout/sidebar/examples/05-responsive-behavior.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Responsive mode (default `responsive={true}`): below the narrow breakpoint the panel becomes a drawer
+ * with backdrop and optional floating open control. Constants such as `SIDEBAR_MEDIA_QUERY_NARROW` match
+ * the kit implementation (single source of truth for JS and CSS).
+ */
+export default function SidebarExampleResponsiveBehavior(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=05-responsive-behavior.d.ts.map

package/dist/layout/sidebar/examples/05-responsive-behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"05-responsive-behavior.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/05-responsive-behavior.tsx"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,gCAAgC,4CA6CvD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prime-ui-kit",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "React 19 UI kit: CSS Modules, semantic design tokens (--prime-sys-*), composable components — forms, modals, selects, tables, navigation, overlays. TypeScript, ESM, a11y-oriented.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -64,6 +64,9 @@
     "dist",
     "src/styles/*.css",
     "src/components/**/COMPONENT.md",
+    "src/layout/**/COMPONENT.md",
+    "src/components/**/examples/**",
+    "src/layout/**/examples/**",
     "LICENSE"
   ],
   "publishConfig": {

package/src/components/accordion/COMPONENT.md

@@ -1,6 +1,6 @@
 # Accordion
 
-**Проектирование по умолчанию:** при проектировании экранов и примеров изначально выбирай **`m`** для `size` (где есть ось размера), если явно не оговорено иное.
+**Default sizing:** when designing screens and examples, start with **`m`** for `size` wherever a size axis exists unless the scenario explicitly needs another value.
 
 ## About
 
@@ -26,25 +26,101 @@ A compound disclosure pattern: each item has a header trigger and expandable bod
 - Put label text, optional **`Accordion.Icon`**, and optional **`Accordion.Arrow`** inside the trigger as needed.
 - **`Accordion.Content`** renders an outer **`section`** (ARIA region) and an inner padded block; `className` applies to the inner block; `style` is merged onto the outer node with the animation height variable.
 
-### Minimal example
+### Canonical example
+
+Single open section at a time, **`layout="grouped"`** (one frame), **`Accordion.Icon as={LucideIcon}`** plus **`Accordion.Arrow`** on each trigger, and rich body copy with a **`LinkButton`**. For **`size`** steps, **`type="multiple"`** / **`layout="separate"`**, disabled and **`collapsible={false}`**, controlled **`value`**, **`Accordion.Arrow`** with **`openIcon` / `closeIcon`**, **`Accordion.Icon as="span"`**, and full-bleed width in preview, see the runnable **`./examples/*.tsx`** files and the playground snippets listed below (full source in those files—avoid duplicating long demos here).
+
+**Imports:** in this repo use the **`@/…`** paths shown; published apps import the same components from **`prime-ui-kit`**.
 
 ```tsx
-import { Accordion } from "prime-ui-kit";
+import { Accordion } from "@/components/accordion/Accordion";
+import { LinkButton } from "@/components/link-button/LinkButton";
+import { Typography } from "@/components/typography/Typography";
+import { Package, ShieldCheck, Truck } from "lucide-react";
 
 export function Example() {
   return (
-    <Accordion.Root type="single">
-      <Accordion.Item value="one">
+    <Accordion.Root type="single" size="m" layout="grouped" defaultValue="delivery" collapsible>
+      <Accordion.Item value="delivery">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={Truck} />
+            <span>Delivery &amp; tracking</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" tone="muted">
+            Orders ship within one business day. Tracking links are sent by email when the carrier
+            scans the package.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="returns">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={Package} />
+            <span>Returns</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" tone="muted">
+            Unopened items in original packaging are returnable within 30 days. Opened goods may
+            qualify for store credit—see the policy for exceptions.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="compliance">
         <Accordion.Header>
-          <Accordion.Trigger>Section title</Accordion.Trigger>
+          <Accordion.Trigger>
+            <Accordion.Icon as={ShieldCheck} />
+            <span>Compliance</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
         </Accordion.Header>
-        <Accordion.Content>Section body.</Accordion.Content>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" tone="muted">
+            We process card data in line with PCI DSS. For regional privacy questions, read the
+            notices linked below.
+          </Typography.Root>
+          <LinkButton.Root href="#" size="s">
+            Privacy &amp; data processing
+          </LinkButton.Root>
+        </Accordion.Content>
       </Accordion.Item>
     </Accordion.Root>
   );
 }
 ```
 
+### Examples (source)
+
+| File | Intent |
+|------|--------|
+| [`./examples/01-faq-marketing.tsx`](./examples/01-faq-marketing.tsx) | FAQ: `type="single"`, `layout="grouped"`, **`Accordion.Icon as={Icon}`** + default chevron (**aligns with** `playground/snippets/accordion/composition.tsx`). |
+| [`./examples/02-settings-panels.tsx`](./examples/02-settings-panels.tsx) | Settings: **`type="multiple"`**, **`layout="separate"`**, **`defaultValue`** as string array (**aligns with** `playground/snippets/accordion/variants-layout-type.tsx`). |
+| [`./examples/03-checkout-order-summary.tsx`](./examples/03-checkout-order-summary.tsx) | Checkout: **`Accordion.Arrow openIcon` / `closeIcon`** (plus default chevron on another item) and links in the body (**aligns with** `playground/snippets/accordion/features-arrow.tsx`). |
+| [`./examples/04-api-docs-sections.tsx`](./examples/04-api-docs-sections.tsx) | Controlled **`value`** + **`onValueChange`** with `type="single"` (**aligns with** `playground/snippets/accordion/controlled.tsx`). |
+| [`./examples/05-knowledge-base-categories.tsx`](./examples/05-knowledge-base-categories.tsx) | **`collapsible={false}`**, **`Accordion.Item disabled`**, **`defaultValue`** (**aligns with** `playground/snippets/accordion/states.tsx`). |
+
+### Playground snippets
+
+Demos wired from [`playground/sections/AccordionSection.tsx`](../../../playground/sections/AccordionSection.tsx) (Russian copy; same public API as this doc):
+
+| Snippet | Intent |
+|---------|--------|
+| [`playground/snippets/accordion/sizes.tsx`](../../../playground/snippets/accordion/sizes.tsx) | **`size`**: `s` / `m` / `l` / `xl` ladder. |
+| [`playground/snippets/accordion/variants-layout-type.tsx`](../../../playground/snippets/accordion/variants-layout-type.tsx) | **`layout`** `grouped` vs `separate`; **`type="multiple"`** with array **`defaultValue`**. |
+| [`playground/snippets/accordion/states.tsx`](../../../playground/snippets/accordion/states.tsx) | **`disabled`**, initial **`defaultValue`**, **`collapsible={false}`** in `single`. |
+| [`playground/snippets/accordion/controlled.tsx`](../../../playground/snippets/accordion/controlled.tsx) | External buttons + **`value` / `onValueChange`**. |
+| [`playground/snippets/accordion/composition.tsx`](../../../playground/snippets/accordion/composition.tsx) | Trigger row: **`Accordion.Icon as={Icon}`**, label in **`span`**, **`Accordion.Arrow`**. |
+| [`playground/snippets/accordion/full-width.tsx`](../../../playground/snippets/accordion/full-width.tsx) | Root fills preview column (**`examplePreviewBleed`** in playground). |
+| [`playground/snippets/accordion/icon-as.tsx`](../../../playground/snippets/accordion/icon-as.tsx) | **`Accordion.Icon as="span"`** with arbitrary child markup (e.g. Lucide as child). |
+| [`playground/snippets/accordion/features-arrow.tsx`](../../../playground/snippets/accordion/features-arrow.tsx) | **`openIcon` / `closeIcon`** vs default rotating chevron. |
+
+**LLM note:** Prefer reading **`./examples/*.tsx`** and the **`playground/snippets/accordion/*.tsx`** files for full markup and prop combinations; this page keeps the contract (rules + API tables) authoritative.
+
 ## Rules
 
 - Use **`type="single"`** for at most one open item, **`type="multiple"`** for any subset open; `defaultValue` is a string or string array matching the type.

package/src/components/accordion/examples/01-faq-marketing.tsx

@@ -0,0 +1,63 @@
+import { CreditCard, Package, Truck } from "lucide-react";
+import { Accordion } from "@/components/accordion/Accordion";
+import { Typography } from "@/components/typography/Typography";
+
+import styles from "./examples.module.css";
+
+/**
+ * FAQ-style marketing page: single expansion, grouped frame, triggers with icons and chevron.
+ */
+export default function AccordionExampleFaqMarketing() {
+  return (
+    <Accordion.Root type="single" size="m" layout="grouped" defaultValue="shipping">
+      <Accordion.Item value="shipping">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={Truck} />
+            <span>When will my order ship?</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <div className={styles.bodyStack}>
+            <Typography.Root as="p" variant="body-default" className={styles.lead}>
+              Most in-stock orders leave our warehouse within one business day. You will receive a
+              tracking link by email as soon as the carrier scans the package.
+            </Typography.Root>
+          </div>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="returns">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={Package} />
+            <span>What is your return policy?</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" className={styles.lead}>
+            Unopened items in original packaging can be returned within 30 days for a full refund.
+            Opened consumables may be eligible for store credit—contact support with your order
+            number.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="payment">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={CreditCard} />
+            <span>Which payment methods do you accept?</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" className={styles.lead}>
+            We accept major cards, digital wallets, and purchase orders for approved business
+            accounts. All transactions are processed over encrypted connections.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+    </Accordion.Root>
+  );
+}

package/src/components/accordion/examples/02-settings-panels.tsx

@@ -0,0 +1,68 @@
+import { Bell, Lock, User } from "lucide-react";
+import { Accordion } from "@/components/accordion/Accordion";
+import { Typography } from "@/components/typography/Typography";
+
+import styles from "./examples.module.css";
+
+/**
+ * Account settings: compare several open sections at once with `type="multiple"` and card-like
+ * `layout="separate"`.
+ */
+export default function AccordionExampleSettingsPanels() {
+  return (
+    <Accordion.Root
+      type="multiple"
+      size="m"
+      layout="separate"
+      defaultValue={["profile", "notifications"]}
+    >
+      <Accordion.Item value="profile">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={User} />
+            <span>Profile</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <div className={styles.bodyStack}>
+            <Typography.Root as="p" variant="body-default" className={styles.lead}>
+              Update your display name, avatar, and public contact details. Changes apply across all
+              signed-in devices after you save.
+            </Typography.Root>
+          </div>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="notifications">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={Bell} />
+            <span>Notifications</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" className={styles.lead}>
+            Choose email, push, and in-app channels. Digest mode bundles low-priority updates into
+            one daily summary.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="security">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={Lock} />
+            <span>Security</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" className={styles.lead}>
+            Manage passwords, two-factor authentication, and active sessions. We recommend enabling
+            an authenticator app for administrator roles.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+    </Accordion.Root>
+  );
+}

package/src/components/accordion/examples/03-checkout-order-summary.tsx

@@ -0,0 +1,89 @@
+import { Minus, Plus } from "lucide-react";
+import { Accordion } from "@/components/accordion/Accordion";
+import { LinkButton } from "@/components/link-button/LinkButton";
+import { Typography } from "@/components/typography/Typography";
+
+import styles from "./examples.module.css";
+
+/**
+ * Checkout flow: custom open/close icons on the arrow, dense copy, and a policy link in the body.
+ */
+export default function AccordionExampleCheckoutOrderSummary() {
+  return (
+    <Accordion.Root type="single" size="m" layout="grouped" defaultValue="totals">
+      <Accordion.Item value="totals">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <span>Order totals</span>
+            <Accordion.Arrow openIcon={Plus} closeIcon={Minus} />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <div className={styles.bodyStack}>
+            <div className={styles.row}>
+              <Typography.Root as="span" variant="body-default">
+                Subtotal
+              </Typography.Root>
+              <Typography.Root as="span" variant="body-default">
+                $124.00
+              </Typography.Root>
+            </div>
+            <div className={styles.row}>
+              <Typography.Root as="span" variant="body-default" tone="muted">
+                Estimated tax
+              </Typography.Root>
+              <Typography.Root as="span" variant="body-default" tone="muted">
+                $9.92
+              </Typography.Root>
+            </div>
+            <div className={styles.row}>
+              <Typography.Root as="span" variant="body-small" weight="semibold">
+                Due today
+              </Typography.Root>
+              <Typography.Root as="span" variant="body-small" weight="semibold">
+                $133.92
+              </Typography.Root>
+            </div>
+          </div>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="delivery">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <span>Delivery window</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" className={styles.lead}>
+            Arrives Tuesday–Thursday depending on carrier volume. You can reschedule from the
+            confirmation email.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="terms">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <span>Terms &amp; privacy</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <div className={styles.stack}>
+            <Typography.Root as="p" variant="body-small" className={styles.lead}>
+              By placing this order you agree to our terms of sale and refund policy.
+            </Typography.Root>
+            <div className={styles.actions}>
+              <LinkButton.Root href="#" size="s">
+                Terms of sale
+              </LinkButton.Root>
+              <LinkButton.Root href="#" size="s">
+                Privacy policy
+              </LinkButton.Root>
+            </div>
+          </div>
+        </Accordion.Content>
+      </Accordion.Item>
+    </Accordion.Root>
+  );
+}

package/src/components/accordion/examples/04-api-docs-sections.tsx

@@ -0,0 +1,89 @@
+import { BookOpen, Code2, Webhook } from "lucide-react";
+import * as React from "react";
+import { Accordion } from "@/components/accordion/Accordion";
+import { Typography } from "@/components/typography/Typography";
+
+import styles from "./examples.module.css";
+
+/**
+ * Long-form API reference: controlled `value` / `onValueChange` so another part of the page (or
+ * deep link) can sync which section is open.
+ */
+export default function AccordionExampleApiDocsSections() {
+  const [open, setOpen] = React.useState<string>("auth");
+
+  return (
+    <Accordion.Root
+      type="single"
+      size="m"
+      layout="grouped"
+      value={open}
+      onValueChange={(next) => {
+        if (typeof next === "string") setOpen(next);
+      }}
+    >
+      <Accordion.Item value="auth">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={BookOpen} />
+            <span>Authentication</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <div className={styles.bodyStack}>
+            <Typography.Root as="p" variant="body-default" className={styles.lead}>
+              Send a bearer token in the{" "}
+              <Typography.Root as="span" variant="caption" weight="medium">
+                Authorization
+              </Typography.Root>{" "}
+              header. Tokens expire after twelve hours; refresh using the endpoint described in the
+              session guide.
+            </Typography.Root>
+          </div>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="webhooks">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={Webhook} />
+            <span>Webhooks</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" className={styles.lead}>
+            Register HTTPS endpoints to receive signed event payloads. Retry policy uses exponential
+            backoff for non-2xx responses up to three days.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="errors">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={Code2} />
+            <span>Error format</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" className={styles.lead}>
+            Errors return JSON with{" "}
+            <Typography.Root as="span" variant="caption" weight="medium">
+              code
+            </Typography.Root>
+            ,{" "}
+            <Typography.Root as="span" variant="caption" weight="medium">
+              message
+            </Typography.Root>
+            , and optional{" "}
+            <Typography.Root as="span" variant="caption" weight="medium">
+              details
+            </Typography.Root>{" "}
+            for validation issues.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+    </Accordion.Root>
+  );
+}

package/src/components/accordion/examples/05-knowledge-base-categories.tsx

@@ -0,0 +1,66 @@
+import { FileQuestion, LifeBuoy, ShieldCheck } from "lucide-react";
+import { Accordion } from "@/components/accordion/Accordion";
+import { Typography } from "@/components/typography/Typography";
+
+import styles from "./examples.module.css";
+
+/**
+ * Support hub: `collapsible={false}` keeps one section pinned open once chosen, and a disabled item
+ * marks content that is not yet available for the user’s plan.
+ */
+export default function AccordionExampleKnowledgeBaseCategories() {
+  return (
+    <Accordion.Root
+      type="single"
+      size="m"
+      layout="separate"
+      defaultValue="basics"
+      collapsible={false}
+    >
+      <Accordion.Item value="basics">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={LifeBuoy} />
+            <span>Getting started</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" className={styles.lead}>
+            New here? Complete the workspace checklist, invite teammates, and connect your first
+            data source from the integrations directory.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="billing" disabled>
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={ShieldCheck} />
+            <span>Billing &amp; contracts (Enterprise)</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" className={styles.lead}>
+            Contract terms and invoice history appear here when your organization upgrades.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+      <Accordion.Item value="troubleshoot">
+        <Accordion.Header>
+          <Accordion.Trigger>
+            <Accordion.Icon as={FileQuestion} />
+            <span>Troubleshooting</span>
+            <Accordion.Arrow />
+          </Accordion.Trigger>
+        </Accordion.Header>
+        <Accordion.Content>
+          <Typography.Root as="p" variant="body-default" className={styles.lead}>
+            Common fixes: clear the local cache, verify outbound firewall rules for our API hosts,
+            and confirm your SDK is on a supported major version.
+          </Typography.Root>
+        </Accordion.Content>
+      </Accordion.Item>
+    </Accordion.Root>
+  );
+}