Add Springboard docs CLI and jamapp support infrastructure

.npmrc

@@ -0,0 +1,2 @@
+registry=http://localhost:4873/
+//localhost:4873/:_authToken=fake

packages/jamtools/core/package.json

@@ -50,6 +50,22 @@
       "types": "./dist/modules/midi_files/midi_file_parser/midi_file_parser.d.ts",
       "import": "./dist/modules/midi_files/midi_file_parser/midi_file_parser.js"
     },
+    "./modules/midi_files/midi_files_module": {
+      "types": "./dist/modules/midi_files/midi_files_module.d.ts",
+      "import": "./dist/modules/midi_files/midi_files_module.js"
+    },
+    "./modules/io/io_dependencies": {
+      "types": "./dist/modules/io/io_dependencies_types.d.ts",
+      "node": {
+        "import": "./dist/modules/io/io_dependencies.node.js"
+      },
+      "browser": {
+        "import": "./dist/modules/io/io_dependencies.browser.js"
+      },
+      "default": {
+        "import": "./dist/modules/io/io_dependencies.js"
+      }
+    },
     "./modules/macro_module/registered_macro_types": {
       "types": "./dist/modules/macro_module/registered_macro_types.d.ts",
       "import": "./dist/modules/macro_module/registered_macro_types.js"

packages/jamtools/core/src/modules/io/io_dependencies.browser.ts

@@ -0,0 +1,12 @@
+import {BrowserQwertyService} from '@jamtools/core/services/browser/browser_qwerty_service';
+import {BrowserMidiService} from '@jamtools/core/services/browser/browser_midi_service';
+import type {IoDeps} from './io_dependencies_types';
+
+export const createIoDependencies = async (): Promise<IoDeps> => {
+    const qwerty = new BrowserQwertyService(document);
+    const midi = new BrowserMidiService();
+    return {
+        qwerty,
+        midi,
+    };
+};

packages/jamtools/core/src/modules/io/io_dependencies.node.ts

@@ -0,0 +1,21 @@
+import {NodeQwertyService} from '@jamtools/core/services/node/node_qwerty_service';
+import {NodeMidiService} from '@jamtools/core/services/node/node_midi_service';
+import {MockMidiService} from '@jamtools/core/test/services/mock_midi_service';
+import {MockQwertyService} from '@jamtools/core/test/services/mock_qwerty_service';
+import type {IoDeps} from './io_dependencies_types';
+
+export const createIoDependencies = async (): Promise<IoDeps> => {
+    if (process.env.DISABLE_IO === 'true') {
+        return {
+            qwerty: new MockQwertyService(),
+            midi: new MockMidiService(),
+        };
+    }
+
+    const qwerty = new NodeQwertyService();
+    const midi = new NodeMidiService();
+    return {
+        qwerty,
+        midi,
+    };
+};

packages/jamtools/core/src/modules/io/io_dependencies.ts

@@ -0,0 +1,11 @@
+import {MockMidiService} from '@jamtools/core/test/services/mock_midi_service';
+import {MockQwertyService} from '@jamtools/core/test/services/mock_qwerty_service';
+import type {IoDeps} from './io_dependencies_types';
+
+// Default implementation for testing
+export const createIoDependencies = async (): Promise<IoDeps> => {
+    return {
+        qwerty: new MockQwertyService(),
+        midi: new MockMidiService(),
+    };
+};

packages/jamtools/core/src/modules/io/io_dependencies_types.ts

@@ -0,0 +1,8 @@
+import {MidiService, QwertyService} from '@jamtools/core/types/io_types';
+
+export type IoDeps = {
+    midi: MidiService;
+    qwerty: QwertyService;
+}
+
+export type CreateIoDependencies = () => Promise<IoDeps>;

packages/jamtools/core/src/modules/io/io_module.tsx

@@ -7,60 +7,18 @@ import springboard from 'springboard';
 import {StateSupervisor} from 'springboard/services/states/shared_state_service';
 import {ModuleAPI} from 'springboard/engine/module_api';
 import {MidiEvent} from '@jamtools/core/modules/macro_module/macro_module_types';
-import {MockMidiService} from '@jamtools/core/test/services/mock_midi_service';
-import {MockQwertyService} from '@jamtools/core/test/services/mock_qwerty_service';
 
-import {MidiService, QwertyService} from '@jamtools/core/types/io_types';
+import type {IoDeps, CreateIoDependencies} from './io_dependencies_types';
+import {createIoDependencies as defaultCreateIoDependencies} from './io_dependencies';
 
-type IoDeps = {
-    midi: MidiService;
-    qwerty: QwertyService;
-}
-
-let createIoDependencies = async (): Promise<IoDeps> => {
-    return {
-        qwerty: new MockQwertyService(),
-        midi: new MockMidiService(),
-    };
-};
-
-// @platform "browser"
-createIoDependencies = async () => {
-    const {BrowserQwertyService} = await import('@jamtools/core/services/browser/browser_qwerty_service');
-    const {BrowserMidiService} = await import('@jamtools/core/services/browser/browser_midi_service');
-
-    const qwerty = new BrowserQwertyService(document);
-    const midi = new BrowserMidiService();
-    return {
-        qwerty,
-        midi,
-    };
-};
-// @platform end
-
-// @platform "node"
-createIoDependencies = async () => {
-    if (process.env.DISABLE_IO === 'true') {
-        return {
-            qwerty: new MockQwertyService(),
-            midi: new MockMidiService(),
-        };
-    }
-
-    const {NodeQwertyService} = await import('@jamtools/core/services/node/node_qwerty_service');
-    const {NodeMidiService} = await import('@jamtools/core/services/node/node_midi_service');
-
-    const qwerty = new NodeQwertyService();
-    const midi = new NodeMidiService();
-    return {
-        qwerty,
-        midi,
-    };
+// Wrapper object to allow mutation for testing
+const ioDepsConfig = {
+    createIoDependencies: defaultCreateIoDependencies
 };
-// @platform end
 
-export const setIoDependencyCreator = (func: typeof createIoDependencies) => {
-    createIoDependencies = func;
+export const setIoDependencyCreator = (func: CreateIoDependencies) => {
+    // This is used for testing to override the platform-specific implementation
+    ioDepsConfig.createIoDependencies = func;
 };
 
 type IoState = {
@@ -120,7 +78,7 @@ export class IoModule implements Module<IoState> {
     };
 
     initialize = async (moduleAPI: ModuleAPI) => {
-        this.ioDeps = await createIoDependencies();
+        this.ioDeps = await ioDepsConfig.createIoDependencies();
 
         this.qwertyInputSubject = this.ioDeps.qwerty.onInputEvent;
         this.midiInputSubject = this.ioDeps.midi.onInputEvent;

packages/jamtools/core/src/modules/midi_files/midi_file_parser/midi_file_parser.ts

@@ -1,6 +1,8 @@
 import midi from 'midi-file';
 
-import {Midi} from '@tonejs/midi';
+import tonejs from '@tonejs/midi';
+import type {Midi} from '@tonejs/midi';
+const {Midi: MidiClass} = tonejs;
 
 type SustainedNote = {
     midiNumber: number;
@@ -19,7 +21,7 @@ export type ParsedMidiFile = {
 
 export class MidiFileParser {
     parseWithTonejsMidiBuffer = (input: Buffer) => {
-        const parsed = new Midi(input);
+        const parsed = new MidiClass(input);
         return this.parseWithTonejsMidiData(parsed);
     };
 

packages/springboard/package.json

@@ -132,6 +132,10 @@
       "types": "./dist/platforms/browser/services/browser_kvstore_service.d.ts",
       "import": "./dist/platforms/browser/services/browser_kvstore_service.js"
     },
+    "./platforms/browser/services/browser_session_kvstore_service": {
+      "types": "./dist/platforms/browser/services/browser_session_kvstore_service.d.ts",
+      "import": "./dist/platforms/browser/services/browser_session_kvstore_service.js"
+    },
     "./platforms/cloudflare-workers/entrypoints/cloudflare_entrypoint": {
       "types": "./dist/platforms/cloudflare-workers/entrypoints/cloudflare_entrypoint.d.ts",
       "import": "./dist/platforms/cloudflare-workers/entrypoints/cloudflare_entrypoint.js"

packages/springboard/vite-plugin/src/plugins/dev.ts

@@ -244,7 +244,7 @@ export function springboardDev(options: NormalizedOptions): Plugin {
 
             // Check if the changed file is within the project root (excludes node_modules, etc.)
             // and is not a generated file (excludes .springboard/, dist/, etc.)
-            const isUserCode = isNodePlatformActive &&
+            const isUserCode = hasNode &&
                 file.startsWith(options.root) &&
                 !file.includes(path.sep + 'node_modules' + path.sep) &&
                 !file.includes(path.sep + '.springboard' + path.sep) &&

scripts/run-all-folders.sh

@@ -62,6 +62,7 @@ publish_package() {
     environment="npm"
   else
     export NPM_CONFIG_REGISTRY="http://localhost:4873"
+    # export NPM_CONFIG_REGISTRY="http://10.0.1.1:4873"
     environment="local Verdaccio"
   fi
 

verdaccio/docker-compose.yml

@@ -4,7 +4,7 @@ services:
   verdaccio:
     image: verdaccio/verdaccio
     container_name: 'verdaccio'
-    network_mode: 'host'
+    # network_mode: 'host'
 #    networks:
 #      - verdaccio-network
     environment:
@@ -17,4 +17,4 @@ services:
       - './plugins:/verdaccio/plugins'
 # networks:
 #  verdaccio-network:
-#    external: true
+#    external: true

verdaccio/run.sh

@@ -0,0 +1,19 @@
+# export BASE_PATH="/var/lib/docker/volumes/dowo0cwkww0swc0kg0wgw44k_vibe-kanban-worktrees/_data/e1e4-copy-jamtools-fe/springboard/verdaccio"
+# VERDACCIO_CONFIG_PATH="$BASE_PATH/config" \
+# VERDACCIO_STORAGE_PATH="$BASE_PATH/storage" \
+# VERDACCIO_PLUGINS_PATH="$BASE_PATH/plugins" \
+# docker compose up
+
+echo "registry=http://localhost:4873/" >> ../.npmrc
+echo "//localhost:4873/:_authToken=fake" >> ../.npmrc
+
+npx verdaccio --config ./config/config.yaml
+
+# curl -L -o $HOME/bin/jq https://github.com/jqlang/jq/releases/latest/download/jq-linux64
+# chmod +x "$HOME/bin/jq"
+# export PATH=$PATH:$HOME/bin
+
+# export npm_config__authToken=fake
+# export npm_config_registry=http://localhost:4873/
+# ./scripts/run-all-folders.sh 0.0.1-dev-jamapp-3
+