Note about standalone API

Signed-off-by: worksofliam <[email protected]>

Author: worksofliam

src/content/docs/dev/api.md

@@ -65,4 +65,54 @@ export function loadBase(): CodeForIBMi|undefined {
 export function getInstance(): Instance|undefined {
   return (baseExtension && baseExtension.isActive && baseExtension.exports ? baseExtension.exports.instance : undefined);
 }
-```
+```
+
+## Outside of VS Code
+
+**This is not production ready**.
+
+<details>
+<summary>Click to expand</summary>
+
+On the main branch of vscode-ibmi, the IBM i API is written so it is can be portable and used outside of the VS Code namespace (this is how the vitest tests work). Until we publish the API as a standalone package, you will need to manually import the API.
+
+After using `npm i github:codefori/vscode-ibmi`, you will need to cleanup/remove everything but the `src/api` directory.
+
+```ts
+//#webpack.config.js
+
+function prepareIbmiApi() {
+  const ibmiApi = path.join(__dirname, `node_modules`, `vscode-ibmi`, `src`, `api`);
+  const ibmiPackage = path.join(__dirname, `node_modules`, `vscode-ibmi`, `src`);
+
+  const checkDirectory = (dir) => {
+    if (fs.existsSync(dir)) {
+      const files = fs.readdirSync(dir);
+      files.forEach(file => {
+        const filePath = path.join(dir, file);
+        const stat = fs.lstatSync(filePath);
+        const canDelete = !ibmiApi.startsWith(filePath) && !filePath.startsWith(ibmiApi);
+        if (stat.isDirectory()) {
+          // If the directory is not the api directory, delete it
+          if (canDelete) {
+            fs.rmdirSync(filePath, { recursive: true });
+            // console.log(`Deleted directory: ${filePath}`);
+          } else {
+            checkDirectory(filePath);
+          }
+        } else if (stat.isFile()) {
+          if (canDelete) {
+            fs.unlinkSync(filePath);
+            // console.log(`Deleted file: ${filePath}`);
+          }
+        }
+      });
+    }
+  }
+
+  checkDirectory(ibmiPackage);
+}
+```
+
+You will also need to enable `allowTsInNodeModules: true` with `ts-loader` in webpack.
+</details>