chore(release): 3.7.1 [CI SKIP]

.releaserc.json

@@ -6,7 +6,8 @@
       {
         "preset": "angular",
         "releaseRules": [
-          {"type": "chore", "scope": "classes", "release": "patch"}
+          {"type": "chore", "scope": "classes", "release": "patch"},
+          {"type": "*", "scope": "docs", "release": false}
         ]
       }
     ],

CHANGELOG.md

@@ -1,3 +1,87 @@
+## [3.7.1](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.7.0...v3.7.1) (2022-10-24)
+
+
+### Bug Fixes
+
+* **Tabs:** temp remove until we have a way to grab it on beta ([25c33b2](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/25c33b2a05a30c3c72008c5f459c3b77f819db5a))
+
+# [3.7.0](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.6.1...v3.7.0) (2022-10-24)
+
+
+### Features
+
+* **modal:** support for latest steamos preview ([5f0470c](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/5f0470c351dc4ecb24ea3e928ff0b0199c399fa4))
+
+## [3.6.1](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.6.0...v3.6.1) (2022-10-19)
+
+
+### Bug Fixes
+
+* **plugin:** export RoutePatch ([#39](https://github.com/SteamDeckHomebrew/decky-frontend-lib/issues/39)) ([c44c66f](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/c44c66facd4e158aa4fe0a69f62a2ca3add805c1))
+
+# [3.6.0](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.5.6...v3.6.0) (2022-10-15)
+
+
+### Features
+
+* **plugin:** add alwaysRender ([2fc2060](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/2fc2060a6c0d9414d1c36a1a022fdc6f2cd7f8bb))
+
+## [3.5.6](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.5.5...v3.5.6) (2022-10-08)
+
+
+### Bug Fixes
+
+* **Dialog:** remove not exported dialog button ([#37](https://github.com/SteamDeckHomebrew/decky-frontend-lib/issues/37)) ([5a5218a](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/5a5218a7c43f6a90fc4de5f7a0cd524d1cd298d6))
+
+## [3.5.5](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.5.4...v3.5.5) (2022-10-08)
+
+
+### Bug Fixes
+
+* **sidebarnavigation:** no dont ([0ce1b54](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/0ce1b5499df699f602aa83ab87ad8b246d133eac))
+
+## [3.5.4](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.5.3...v3.5.4) (2022-10-08)
+
+
+### Bug Fixes
+
+* **sidebarnavigation:** allow null pags ([d6b00b0](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/d6b00b07337f7a9d38813eeec7c0a848d5c15f17))
+
+## [3.5.3](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.5.2...v3.5.3) (2022-10-08)
+
+
+### Bug Fixes
+
+* **tabs:** fix props and add example ([4024b76](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/4024b76918eea43e43a24c162a937877f18627f0))
+
+## [3.5.2](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.5.1...v3.5.2) (2022-10-08)
+
+
+### Bug Fixes
+
+* **Tabs:** make onShowTab required ([7161e75](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/7161e757e9c98d677510e03eb2606ce58152f3b1))
+
+## [3.5.1](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.5.0...v3.5.1) (2022-10-08)
+
+
+### Bug Fixes
+
+* **Tabs:** actually export it lmao ([0e0e0d2](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/0e0e0d204adc8d888f05e98edb6c1a1a171d00bb))
+
+# [3.5.0](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.4.0...v3.5.0) (2022-10-08)
+
+
+### Features
+
+* **Tabs:** initial tabs component, props, docs ([abbd3cd](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/abbd3cddae24039cbc9b7d955924431e8fbacf94))
+
+# [3.4.0](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.3.5...v3.4.0) (2022-10-06)
+
+
+### Features
+
+* **hooks:** Added useParams hook ([#36](https://github.com/SteamDeckHomebrew/decky-frontend-lib/issues/36)) ([e2920dd](https://github.com/SteamDeckHomebrew/decky-frontend-lib/commit/e2920dd91e81d915a2319280d8473df71a4e4232))
+
 ## [3.3.5](https://github.com/SteamDeckHomebrew/decky-frontend-lib/compare/v3.3.4...v3.3.5) (2022-10-02)
 
 

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "decky-frontend-lib",
-  "version": "3.3.5",
+  "version": "3.7.1",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "decky-frontend-lib",
-      "version": "3.3.5",
+      "version": "3.7.1",
       "license": "LGPL-2.1",
       "dependencies": {
         "minimist": "^1.2.6"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "decky-frontend-lib",
-  "version": "3.3.5",
+  "version": "3.7.1",
   "description": "A library for building decky plugins",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

src/deck-components/Dialog.tsx

@@ -51,13 +51,6 @@ export const DialogButtonSecondary = Object.values(CommonUIModule).find(
     mod?.render?.toString()?.includes('Secondary')
 ) as FC<DialogButtonProps>;
 
-export const DialogButtonSmall = Object.values(CommonUIModule).find(
-  (mod: any) =>
-    mod?.render?.toString()?.includes('Object.assign({type:"button"') &&
-    mod?.render?.toString()?.includes('DialogButton') &&
-    mod?.render?.toString()?.includes('Small')
-) as FC<DialogButtonProps>;
-
 // This is the "main" button. The Primary can act as a submit button, 
 // therefore secondary is chosen (also for backwards comp. reasons)
 export const DialogButton = DialogButtonSecondary;

src/deck-components/Modal.tsx

@@ -1,4 +1,5 @@
 import { FC, ReactNode } from 'react';
+import { findSP } from '../utils';
 import { findModuleChild } from '../webpack';
 
 // All of the popout options + strTitle are related. Proper usage is not yet known...
@@ -27,7 +28,7 @@ export interface ShowModalResult {
   Update: (modal: ReactNode) => void;
 }
 
-export const showModal: (modal: ReactNode, parent?: EventTarget, props?: ShowModalProps) => Promise<ShowModalResult> = findModuleChild((m) => {
+const showModalRaw: (modal: ReactNode, parent?: EventTarget, props?: ShowModalProps) => Promise<ShowModalResult> = findModuleChild((m) => {
   if (typeof m !== 'object') return undefined;
   for (let prop in m) {
     if (typeof m[prop] === 'function' && m[prop].toString().includes('bHideMainWindowForPopouts:!0')) {
@@ -36,6 +37,10 @@ export const showModal: (modal: ReactNode, parent?: EventTarget, props?: ShowMod
   }
 });
 
+export const showModal = (modal: ReactNode, parent?: EventTarget, props?: ShowModalProps): Promise<ShowModalResult> => {
+  return showModalRaw(modal, parent || findSP(), props)
+}
+
 export interface ModalRootProps {
   children?: ReactNode;
   onCancel?(): void;

src/deck-components/SidebarNavigation.tsx

@@ -2,7 +2,7 @@ import { ReactNode, VFC } from 'react';
 
 import { Module, findModuleChild } from '../webpack';
 
-export interface SidebarNavigationPages {
+export interface SidebarNavigationPage {
   title: string;
   content: ReactNode;
   icon?: ReactNode;
@@ -16,7 +16,7 @@ export interface SidebarNavigationPages {
 
 export interface SidebarNavigationProps {
   title?: string;
-  pages: SidebarNavigationPages[];
+  pages: SidebarNavigationPage[];
   showTitle?: boolean;
   disableRouteReporting?: boolean;
   page?: string;

src/deck-components/Tabs.tsx

@@ -0,0 +1,74 @@
+// import { FC, ReactNode } from 'react';
+// import { findModule } from '../webpack';
+// import { FooterLegendProps } from './FooterLegend';
+
+// /**
+//  * Individual tab objects for the Tabs component
+//  * 
+//  * `id` ID of this tab, can be used with activeTab to auto-focus a given tab
+//  * `title` Title shown in the header bar
+//  * `renderTabAddon` Return a {@link ReactNode} to render it next to the tab title, i.e. the counts for each tab on the Media page
+//  * `content` Content of the tab
+//  * `footer` Sets up button handlers and labels
+//  */
+// export interface Tab {
+//     id: string;
+//     title: string;
+//     renderTabAddon?: () => ReactNode;
+//     content: ReactNode;
+//     footer?: FooterLegendProps;
+// }
+
+// /**
+//  * Props for the {@link Tabs}
+//  * 
+//  * `tabs` array of {@link Tab}
+//  * `activeTab` tab currently active, needs to be one of the tabs {@link Tab.id}, must be set using a `useState` in the `onShowTab` handler
+//  * `onShowTab` Called when the active tab should change, needs to set `activeTab`. See example.
+//  * `autoFocusContents` Whether to automatically focus the tab contents or not.
+//  * `footer` Sets up button handlers and labels
+//  * 
+//  * @example
+//  * const Component: FC = () => {
+//  * const [currentTab, setCurrentTab] = useState<string>("Tab1");
+//  *
+//  * return (
+//  *   <Tabs
+//  *     title="Theme Manager"
+//  *     activeTab={currentTabRoute}
+//  *     onShowTab={(tabID: string) => {
+//  *        setCurrentTabRoute(tabID);
+//  *     }}
+//  *     tabs={[
+//  *       {
+//  *         title: "Tab 1",
+//  *         content: <Tab1Component />,
+//  *         id: "Tab1",
+//  *       },
+//  *       {
+//  *         title: "Tab 2",
+//  *         content: <Tab2Component />,
+//  *         id: "Tab2",
+//  *       },
+//  *     ]}
+//  *   />
+//  *  );
+//  * };
+//  */
+// export interface TabsProps {
+//     tabs: Tab[];
+//     activeTab: string;
+//     onShowTab: (tab: string) => void;
+//     autoFocusContents?: boolean;
+// }
+
+// /**
+//  * Tabs component as used in the library and media tabs. See {@link TabsProps}
+//  */
+// export const Tabs = Object.values(findModule((m) => {
+//     if (typeof m !== 'object') return false;
+//     for (let prop in m) {
+//         if (m[prop]?.Unbleed) return true;
+//     }
+//     return false;
+// })).find((x: any) => x?.type?.toString()?.includes("((function(") && x?.type?.toString()?.includes("[\"tabs\"")) as FC<TabsProps>;

src/deck-components/index.ts

@@ -17,6 +17,7 @@ export * from './SliderField';
 export * from './Spinner';
 export * from './static-classes';
 export * from './SteamSpinner';
+export * from './Tabs';
 export * from './TextField';
 export * from './Toggle';
 export * from './ToggleField';

src/deck-hooks/index.ts

@@ -0,0 +1 @@
+export * from './useParams'

src/deck-hooks/useParams.ts

@@ -0,0 +1,15 @@
+import { ReactRouter } from "../webpack";
+
+/**
+ * Get the current params from ReactRouter
+ * 
+ * @returns an object with the current ReactRouter params
+ * 
+ * @example
+ * import { useParams } from "decky-frontend-lib";
+ * 
+ * const { appid } = useParams<{ appid: string }>()
+ */
+export const useParams = Object.values(ReactRouter).find((val) =>
+  /return (\w)\?\1\.params:{}/.test(`${val}`)
+) as <T>() => T

src/index.ts

@@ -2,6 +2,7 @@
 export * from './custom-components';
 export * from './custom-hooks';
 export * from './deck-components';
+export * from './deck-hooks'
 export * from './plugin';
 export * from './webpack';
 export * from './utils';

src/plugin.tsx

@@ -6,6 +6,7 @@ export interface Plugin {
   icon: JSX.Element;
   content?: JSX.Element;
   onDismount?(): void;
+  alwaysRender?: boolean;
 }
 
 interface ServerResponseSuccess<TRes> {
@@ -20,7 +21,7 @@ interface ServerResponseError {
 
 export type ServerResponse<TRes> = ServerResponseSuccess<TRes> | ServerResponseError;
 
-type RoutePatch = (route: RouteProps) => RouteProps;
+export type RoutePatch = (route: RouteProps) => RouteProps;
 
 export interface RouterHook {
   addRoute(path: string, component: ComponentType, props?: Omit<RouteProps, 'path' | 'children'>): void;
@@ -37,8 +38,8 @@ export interface ToastData {
   icon?: ReactNode;
   className?: string;
   contentClassName?: string;
-  duration?: number
-  critical?: boolean
+  duration?: number;
+  critical?: boolean;
 }
 
 export interface Toaster {

src/utils/index.ts

@@ -7,4 +7,16 @@ export function joinClassNames(...classes: string[]): string {
 
 export function sleep(ms: number) {
     return new Promise(res => setTimeout(res, ms));
-}
+}
+
+/**
+ * Finds the SP window, since it is a render target as of {10-19-2022}'s beta
+ */
+export function findSP(): Window {
+    // old (SP as host)
+    if (document.title == 'SP') return window;
+    // new (SP as popup)
+    return FocusNavController.m_ActiveContext.m_rgGamepadNavigationTrees.find((x: any) => x.m_ID == 'root_1_').Root
+      .Element.ownerDocument.defaultView;
+  }
+