you know, it'd be great if typescript didn't suck as often as it does

Author: KTrain5169

packages/types/CHANGELOG.md

@@ -19,6 +19,12 @@ For prereleases:
 - Pre-release versions (x.x.x-pre.x) are unstable releases for the designated API version. These contain work-in-progress types and annotations. Pre-release versions are not meant to be used except for trying out new API interfaces and giving feedback, and may change without prior programmatic or verbal notice. Pre-release versions are meant to be used with new builds from the `dev` branch of the base extension repo.
 - Release candidates (x.x.x-rc.x) are stable previews for the designated API version. These contain types that are more or less finalized for the designated release. Breaking changes should not be expected, both in type signature and functionality, but will always be highlighted in the changelog if necessary. This is also meant for feedback, but only for more subtle feedback before releasing that version such that it simply just contains bug fixes and very minor changes.
 
+## 1.0.0-pre.16
+
+### Changed
+
+- `ActionForcePriorityEnum`, which was previously a re-export of `neuro-game-sdk`'s enum, is now a wrapper object const that remains compatible with existing uses. This was done so we can add our own JSDoc annotations and so we can get proper type documentation generated for our docs. 
+
 ## 1.0.0-pre.15
 
 ### Breaking changes

packages/types/src/index.ts

@@ -2,6 +2,37 @@ import type { ActionHandlerResult, ActionValidationResult, Diff, DiffPlus, DiffR
 import type { CompanionAPI, CompanionAPIConstructor } from './companions/register';
 import type * as vscode from 'vscode';
 
+import { ActionForcePriorityEnum as _ActionForcePriorityEnum } from 'neuro-game-sdk';
+
+// don't worry I hate this too
+interface ActionForcePriorityEnumInterface {
+    /** Sets the priority to low. Is the default for action forces is the `priority` parameter is unspecified. */
+    readonly LOW: _ActionForcePriorityEnum.LOW,
+    /** Sets the priority to medium. Speeds Neuro's speaking up. */
+    readonly MEDIUM: _ActionForcePriorityEnum.MEDIUM,
+    /** Sets the priority to high. Processes the action force as soon as possible, which may cause Neuro to speed up or cut herself off. */
+    readonly HIGH: _ActionForcePriorityEnum.HIGH,
+    /** Sets the priority to critical. Use with caution; will force Neuro to respond at once, immediately.  */
+    readonly CRITICAL: _ActionForcePriorityEnum.CRITICAL,
+}
+
+/**
+ * This is a wrapper re-export around {@link _ActionForcePriorityEnum `neuro-game-sdk`'s ActionForcePriorityEnum}, so we can have proper a proper page for this on docs,
+ * and add our own member-level JSDoc annotations.
+ * Members are the same as the upstream enum's members.
+ * 
+ * @example
+ * ActionForcePriorityEnum.LOW // equivalent to low priority action force
+ * 
+ * @see https://github.com/VedalAI/neuro-sdk/blob/main/API/SPECIFICATION.md#parameters-5
+ */
+export const ActionForcePriorityEnum: ActionForcePriorityEnumInterface = {
+    LOW: _ActionForcePriorityEnum.LOW,
+    MEDIUM: _ActionForcePriorityEnum.MEDIUM,
+    HIGH: _ActionForcePriorityEnum.HIGH,
+    CRITICAL: _ActionForcePriorityEnum.CRITICAL,
+} as const;
+
 interface ActionValidationUtils {
     /**
      * Function to return an object that indicates handler success.
@@ -255,4 +286,3 @@ type ItselfOrArray<T> = T | T[];
 
 export * from './actions';
 export * from './companions';
-export { ActionForcePriorityEnum } from 'neuro-game-sdk';

packages/types/tsconfig.json

@@ -37,7 +37,6 @@
     // Recommended Options
     "strict": true,
     "jsx": "react-jsx",
-    "isolatedModules": true,
     "isolatedDeclarations": true,
     "noUncheckedSideEffectImports": true,
     "moduleDetection": "force",