@mindcraft-lang/bridge-app 0.1.1

package/README.md

@@ -0,0 +1,44 @@
+# @mindcraft-lang/bridge-app
+
+App-side client for the Mindcraft bridge.
+
+Wraps `@mindcraft-lang/bridge-client` with app-role-specific behavior: automatic join code
+management and the `"app"` WebSocket path. Apps that connect to the bridge should depend on
+this package rather than using `bridge-client` directly.
+
+## Usage
+
+```typescript
+import { createAppBridge } from "@mindcraft-lang/bridge-app";
+import { createCompilationFeature } from "@mindcraft-lang/bridge-app/compilation";
+
+const bridge = createAppBridge({
+  app: { id: "my-app", name: "My App", projectId: "p1", projectName: "Project" },
+  bridgeUrl: "ws://localhost:6464",
+  workspace: myWorkspaceAdapter,
+  features: [createCompilationFeature({ compiler })],
+});
+
+bridge.start();
+```
+
+The bridge facade supports:
+
+- `start()` / `stop()` -- lifecycle management
+- `requestSync()` -- request a full workspace sync from the VS Code extension
+- `snapshot()` -- current connection status and join code
+- `onStateChange(...)` / `onRemoteChange(...)` -- event subscriptions
+
+Optional features (like compilation) attach through the `features` array and receive
+a `AppBridgeFeatureContext` with workspace access, sync hooks, and diagnostic/status
+publication helpers.
+
+## Install
+
+```sh
+npm install @mindcraft-lang/bridge-app
+```
+
+## License
+
+MIT

package/dist/app-bridge.d.ts

@@ -0,0 +1,56 @@
+import type { ConnectionStatus, ExportedFileSystem, FileSystemNotification } from "@mindcraft-lang/bridge-client";
+import type { CompileDiagnosticEntry } from "@mindcraft-lang/bridge-protocol";
+export type WorkspaceSnapshot = ExportedFileSystem;
+export type WorkspaceChange = FileSystemNotification;
+export type AppBridgeState = ConnectionStatus;
+export type DiagnosticEntry = CompileDiagnosticEntry;
+export interface AppBridge {
+    start(): void;
+    stop(): void;
+    requestSync(): Promise<void>;
+    snapshot(): AppBridgeSnapshot;
+    onStateChange(listener: (state: AppBridgeState) => void): () => void;
+    onRemoteChange(listener: (change: WorkspaceChange) => void): () => void;
+}
+export interface AppBridgeSnapshot {
+    status: AppBridgeState;
+    joinCode?: string;
+}
+export interface AppBridgeOptions {
+    app: {
+        id: string;
+        name: string;
+        projectId: string;
+        projectName: string;
+    };
+    bridgeUrl: string;
+    workspace: WorkspaceAdapter;
+    features?: readonly AppBridgeFeature[];
+}
+export interface WorkspaceAdapter {
+    exportSnapshot(): WorkspaceSnapshot;
+    applyRemoteChange(change: WorkspaceChange): void;
+    onLocalChange(listener: (change: WorkspaceChange) => void): () => void;
+}
+export interface AppBridgeFeature {
+    attach(context: AppBridgeFeatureContext): () => void;
+}
+export interface AppBridgeFeatureContext {
+    snapshot(): AppBridgeSnapshot;
+    workspaceSnapshot(): WorkspaceSnapshot;
+    onStateChange(listener: (state: AppBridgeState) => void): () => void;
+    onRemoteChange(listener: (change: WorkspaceChange) => void): () => void;
+    onDidSync(listener: () => void): () => void;
+    publishDiagnostics(file: string, diagnostics: readonly DiagnosticEntry[]): void;
+    publishStatus(update: AppBridgeFeatureStatus): void;
+}
+export interface AppBridgeFeatureStatus {
+    file: string;
+    success: boolean;
+    diagnosticCount: {
+        error: number;
+        warning: number;
+    };
+}
+export declare function createAppBridge(options: AppBridgeOptions): AppBridge;
+//# sourceMappingURL=app-bridge.d.ts.map

package/dist/app-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-bridge.d.ts","sourceRoot":"","sources":["../src/app-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAClH,OAAO,KAAK,EAAoB,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAGhG,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AACrD,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAC9C,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,QAAQ,IAAI,iBAAiB,CAAC;IAC9B,aAAa,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrE,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACzE;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,IAAI,iBAAiB,CAAC;IACpC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IACjD,aAAa,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,IAAI,iBAAiB,CAAC;IAC9B,iBAAiB,IAAI,iBAAiB,CAAC;IACvC,aAAa,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrE,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACxE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAAC;IAChF,aAAa,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAEpE"}

package/dist/app-bridge.js

@@ -0,0 +1,197 @@
+import { AppProject } from "./app-project.js";
+export function createAppBridge(options) {
+    return new AppBridgeController(options);
+}
+class AppBridgeController {
+    _options;
+    _stateListeners = new Set();
+    _remoteChangeListeners = new Set();
+    _syncListeners = new Set();
+    _diagnosticVersions = new Map();
+    _featureDisposers = [];
+    _project;
+    _workspaceUnsub;
+    _projectUnsubs = [];
+    _status = "disconnected";
+    _joinCode;
+    constructor(options) {
+        this._options = options;
+    }
+    start() {
+        if (this._project) {
+            return;
+        }
+        this.attachFeatures();
+        const project = new AppProject({
+            appName: this._options.app.name,
+            projectId: this._options.app.projectId,
+            projectName: this._options.app.projectName,
+            bridgeUrl: this._options.bridgeUrl,
+            filesystem: this._options.workspace.exportSnapshot(),
+        });
+        this._project = project;
+        this._workspaceUnsub = this._options.workspace.onLocalChange((change) => {
+            project.files.toRemote.applyNotification(change);
+        });
+        this._projectUnsubs = [
+            project.session.addEventListener("status", (status) => {
+                this.setStatus(status);
+            }),
+            project.onJoinCodeChange((joinCode) => {
+                this.setJoinCode(joinCode);
+            }),
+            project.onRemoteFileChange((change) => {
+                this._options.workspace.applyRemoteChange(change);
+                this.emitRemoteChange(change);
+            }),
+            project.onDidSync(() => {
+                this.emitDidSync();
+            }),
+        ];
+        project.session.start();
+    }
+    stop() {
+        const project = this._project;
+        if (!project) {
+            this.setJoinCode(undefined);
+            this.setStatus("disconnected");
+            return;
+        }
+        project.session.stop();
+        this.disposeProjectBindings();
+        this._project = undefined;
+        this.setJoinCode(undefined);
+        this.disposeFeatures();
+    }
+    async requestSync() {
+        const project = this.requireProject();
+        await project.requestSync();
+    }
+    snapshot() {
+        return {
+            status: this._status,
+            joinCode: this._joinCode,
+        };
+    }
+    onStateChange(listener) {
+        this._stateListeners.add(listener);
+        return () => {
+            this._stateListeners.delete(listener);
+        };
+    }
+    onRemoteChange(listener) {
+        this._remoteChangeListeners.add(listener);
+        return () => {
+            this._remoteChangeListeners.delete(listener);
+        };
+    }
+    attachFeatures() {
+        if (this._featureDisposers.length > 0) {
+            return;
+        }
+        const features = this._options.features ?? [];
+        const context = {
+            snapshot: () => this.snapshot(),
+            workspaceSnapshot: () => this._options.workspace.exportSnapshot(),
+            onStateChange: (listener) => this.onStateChange(listener),
+            onRemoteChange: (listener) => this.onRemoteChange(listener),
+            onDidSync: (listener) => this.onDidSync(listener),
+            publishDiagnostics: (file, diagnostics) => {
+                this.publishDiagnostics(file, diagnostics);
+            },
+            publishStatus: (update) => {
+                this.publishStatus(update);
+            },
+        };
+        for (const feature of features) {
+            this._featureDisposers.push(feature.attach(context));
+        }
+    }
+    disposeFeatures() {
+        for (const dispose of this._featureDisposers.splice(0)) {
+            dispose();
+        }
+    }
+    onDidSync(listener) {
+        this._syncListeners.add(listener);
+        return () => {
+            this._syncListeners.delete(listener);
+        };
+    }
+    emitDidSync() {
+        for (const listener of this._syncListeners) {
+            listener();
+        }
+    }
+    emitRemoteChange(change) {
+        for (const listener of this._remoteChangeListeners) {
+            listener(change);
+        }
+    }
+    publishDiagnostics(file, diagnostics) {
+        const project = this._project;
+        if (!project || this._status !== "connected") {
+            return;
+        }
+        const version = (this._diagnosticVersions.get(file) ?? 0) + 1;
+        this._diagnosticVersions.set(file, version);
+        const message = {
+            type: "compile:diagnostics",
+            payload: {
+                file,
+                version,
+                diagnostics: [...diagnostics],
+            },
+        };
+        project.session.send(message);
+    }
+    publishStatus(update) {
+        const project = this._project;
+        if (!project || this._status !== "connected") {
+            return;
+        }
+        const message = {
+            type: "compile:status",
+            payload: {
+                file: update.file,
+                success: update.success,
+                diagnosticCount: {
+                    error: update.diagnosticCount.error,
+                    warning: update.diagnosticCount.warning,
+                },
+            },
+        };
+        project.session.send(message);
+    }
+    setStatus(status) {
+        if (this._status === status) {
+            return;
+        }
+        this._status = status;
+        for (const listener of this._stateListeners) {
+            listener(status);
+        }
+    }
+    setJoinCode(joinCode) {
+        if (this._joinCode === joinCode) {
+            return;
+        }
+        this._joinCode = joinCode;
+        for (const listener of this._stateListeners) {
+            listener(this._status);
+        }
+    }
+    disposeProjectBindings() {
+        this._workspaceUnsub?.();
+        this._workspaceUnsub = undefined;
+        for (const unsub of this._projectUnsubs.splice(0)) {
+            unsub();
+        }
+    }
+    requireProject() {
+        if (!this._project) {
+            throw new Error("Bridge not started");
+        }
+        return this._project;
+    }
+}

package/dist/app-project.d.ts

@@ -0,0 +1,27 @@
+import type { ExportedFileSystem } from "@mindcraft-lang/bridge-client";
+import { Project } from "@mindcraft-lang/bridge-client";
+import type { AppClientMessage, AppServerMessage, FileSystemNotification } from "@mindcraft-lang/bridge-protocol";
+import { CompilationManager, type CompilationProvider } from "./compilation.js";
+export interface AppProjectOptions {
+    appName: string;
+    projectId: string;
+    projectName: string;
+    bridgeUrl: string;
+    filesystem: ExportedFileSystem;
+    compilationProvider?: CompilationProvider;
+}
+export declare class AppProject extends Project<AppClientMessage, AppServerMessage> {
+    private _joinCode;
+    private readonly _joinCodeListeners;
+    private readonly _sessionUnsubs;
+    private readonly _compilation;
+    private readonly _remoteFileChangeListeners;
+    constructor(options: AppProjectOptions);
+    get compilation(): CompilationManager | undefined;
+    get joinCode(): string | undefined;
+    onJoinCodeChange(fn: (joinCode: string | undefined) => void): () => void;
+    onRemoteFileChange(fn: (ev: FileSystemNotification) => void): () => void;
+    private wireJoinCode;
+    private setJoinCode;
+}
+//# sourceMappingURL=app-project.d.ts.map

package/dist/app-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-project.d.ts","sourceRoot":"","sources":["../src/app-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,OAAO,EAAuB,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAClH,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,qBAAa,UAAW,SAAQ,OAAO,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IACzE,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqD;IACxF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAmD;gBAElF,OAAO,EAAE,iBAAiB;IAgCtC,IAAI,WAAW,IAAI,kBAAkB,GAAG,SAAS,CAEhD;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED,gBAAgB,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI;IAOxE,kBAAkB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,sBAAsB,KAAK,IAAI,GAAG,MAAM,IAAI;IAOxE,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,WAAW;CAOpB"}

package/dist/app-project.js

@@ -0,0 +1,65 @@
+import { Project } from "@mindcraft-lang/bridge-client";
+import { CompilationManager } from "./compilation.js";
+export class AppProject extends Project {
+    _joinCode;
+    _joinCodeListeners = new Set();
+    _sessionUnsubs = [];
+    _compilation;
+    _remoteFileChangeListeners = new Set();
+    constructor(options) {
+        const projectOptions = {
+            ...options,
+            wsPath: "app",
+        };
+        super(projectOptions);
+        this.wireJoinCode();
+        if (options.compilationProvider) {
+            this._compilation = new CompilationManager(options.compilationProvider, (msg) => this.session.send(msg), () => this.session.status === "connected");
+            this._sessionUnsubs.push(this.onDidSync(() => {
+                this._compilation?.sendDiagnostics();
+            }));
+        }
+        this.fromRemoteFileChange = (ev) => {
+            if (this._compilation) {
+                this._compilation.handleFileChange(ev);
+            }
+            for (const fn of this._remoteFileChangeListeners) {
+                fn(ev);
+            }
+        };
+    }
+    get compilation() {
+        return this._compilation;
+    }
+    get joinCode() {
+        return this._joinCode;
+    }
+    onJoinCodeChange(fn) {
+        this._joinCodeListeners.add(fn);
+        return () => {
+            this._joinCodeListeners.delete(fn);
+        };
+    }
+    onRemoteFileChange(fn) {
+        this._remoteFileChangeListeners.add(fn);
+        return () => {
+            this._remoteFileChangeListeners.delete(fn);
+        };
+    }
+    wireJoinCode() {
+        this._sessionUnsubs.push(this.session.on("session:welcome", (msg) => {
+            this.setJoinCode(msg.payload.joinCode);
+        }));
+        this._sessionUnsubs.push(this.session.on("session:joinCode", (msg) => {
+            this.setJoinCode(msg.payload.joinCode);
+        }));
+    }
+    setJoinCode(joinCode) {
+        if (this._joinCode === joinCode)
+            return;
+        this._joinCode = joinCode;
+        for (const fn of this._joinCodeListeners) {
+            fn(joinCode);
+        }
+    }
+}

package/dist/compilation.d.ts

@@ -0,0 +1,47 @@
+import type { AppClientMessage, CompileDiagnosticEntry, FileSystemNotification } from "@mindcraft-lang/bridge-protocol";
+import type { AppBridgeFeature, DiagnosticEntry, WorkspaceChange, WorkspaceSnapshot } from "./app-bridge.js";
+export interface DiagnosticSnapshot {
+    files: ReadonlyMap<string, readonly DiagnosticEntry[]>;
+}
+export interface WorkspaceCompiler {
+    replaceWorkspace(snapshot: WorkspaceSnapshot): void;
+    applyWorkspaceChange(change: WorkspaceChange): void;
+    compile(): DiagnosticSnapshot;
+    onDidCompile(listener: (snapshot: DiagnosticSnapshot) => void): () => void;
+}
+export interface CompilationFeatureOptions {
+    compiler: WorkspaceCompiler;
+    publishStatus?: boolean;
+}
+export interface CompilationResult {
+    files: Map<string, CompileDiagnosticEntry[]>;
+}
+export interface CompilationProvider {
+    fileWritten(path: string, content: string): void;
+    fileDeleted(path: string): void;
+    fileRenamed(oldPath: string, newPath: string): void;
+    fullSync(files: Iterable<[string, {
+        kind: string;
+        content?: string;
+    }]>): void;
+    compileAll(): CompilationResult;
+}
+export declare function createCompilationFeature(options: CompilationFeatureOptions): AppBridgeFeature;
+export declare class CompilationManager {
+    private readonly _provider;
+    private readonly _send;
+    private readonly _isConnected;
+    private readonly _versions;
+    private readonly _previousFiles;
+    private readonly _compilationListeners;
+    private _lastResult;
+    private readonly _removalListeners;
+    constructor(provider: CompilationProvider, send: (msg: AppClientMessage) => void, isConnected: () => boolean);
+    handleFileChange(ev: FileSystemNotification): void;
+    onCompilation(fn: (result: CompilationResult) => void): () => void;
+    onRemoval(fn: (path: string) => void): () => void;
+    sendDiagnostics(): void;
+    private compileAndEmit;
+    private emitDiagnostics;
+}
+//# sourceMappingURL=compilation.d.ts.map

package/dist/compilation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compilation.d.ts","sourceRoot":"","sources":["../src/compilation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACxH,OAAO,KAAK,EACV,gBAAgB,EAGhB,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpD,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IACpD,OAAO,IAAI,kBAAkB,CAAC;IAC9B,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9E,UAAU,IAAI,iBAAiB,CAAC;CACjC;AAwBD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,gBAAgB,CA8E7F;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAkD;IACxF,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqC;gBAE3D,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,EAAE,WAAW,EAAE,MAAM,OAAO;IAM5G,gBAAgB,CAAC,EAAE,EAAE,sBAAsB,GAAG,IAAI;IAsBlD,aAAa,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAOlE,SAAS,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAOjD,eAAe,IAAI,IAAI;IAUvB,OAAO,CAAC,cAAc;IAoCtB,OAAO,CAAC,eAAe;CAyBxB"}

package/dist/compilation.js

@@ -0,0 +1,195 @@
+function buildFeatureStatus(file, diagnostics) {
+    let errorCount = 0;
+    let warningCount = 0;
+    for (const diagnostic of diagnostics) {
+        if (diagnostic.severity === "error") {
+            errorCount++;
+        }
+        else if (diagnostic.severity === "warning") {
+            warningCount++;
+        }
+    }
+    return {
+        file,
+        success: errorCount === 0,
+        diagnosticCount: {
+            error: errorCount,
+            warning: warningCount,
+        },
+    };
+}
+export function createCompilationFeature(options) {
+    return {
+        attach(context) {
+            let lastSnapshot;
+            const previousDiagnosticFiles = new Set();
+            const publishStatus = options.publishStatus ?? true;
+            const publishSnapshot = (snapshot) => {
+                if (context.snapshot().status !== "connected") {
+                    return;
+                }
+                const currentFiles = new Set();
+                for (const [file, diagnostics] of snapshot.files) {
+                    currentFiles.add(file);
+                    if (diagnostics.length > 0 || previousDiagnosticFiles.has(file)) {
+                        context.publishDiagnostics(file, diagnostics);
+                        if (publishStatus) {
+                            context.publishStatus(buildFeatureStatus(file, diagnostics));
+                        }
+                    }
+                }
+                for (const file of previousDiagnosticFiles) {
+                    if (!currentFiles.has(file)) {
+                        context.publishDiagnostics(file, []);
+                        if (publishStatus) {
+                            context.publishStatus(buildFeatureStatus(file, []));
+                        }
+                    }
+                }
+                previousDiagnosticFiles.clear();
+                for (const [file, diagnostics] of snapshot.files) {
+                    if (diagnostics.length > 0) {
+                        previousDiagnosticFiles.add(file);
+                    }
+                }
+            };
+            const compileAndPublish = () => {
+                const snapshot = options.compiler.compile();
+                if (lastSnapshot !== snapshot) {
+                    lastSnapshot = snapshot;
+                    publishSnapshot(snapshot);
+                }
+            };
+            const compileUnsub = options.compiler.onDidCompile((snapshot) => {
+                lastSnapshot = snapshot;
+                publishSnapshot(snapshot);
+            });
+            options.compiler.replaceWorkspace(context.workspaceSnapshot());
+            compileAndPublish();
+            const remoteChangeUnsub = context.onRemoteChange((change) => {
+                options.compiler.applyWorkspaceChange(change);
+                compileAndPublish();
+            });
+            const syncUnsub = context.onDidSync(() => {
+                if (lastSnapshot) {
+                    publishSnapshot(lastSnapshot);
+                }
+            });
+            return () => {
+                syncUnsub();
+                remoteChangeUnsub();
+                compileUnsub();
+            };
+        },
+    };
+}
+export class CompilationManager {
+    _provider;
+    _send;
+    _isConnected;
+    _versions = new Map();
+    _previousFiles = new Set();
+    _compilationListeners = new Set();
+    _lastResult;
+    _removalListeners = new Set();
+    constructor(provider, send, isConnected) {
+        this._provider = provider;
+        this._send = send;
+        this._isConnected = isConnected;
+    }
+    handleFileChange(ev) {
+        switch (ev.action) {
+            case "write":
+                this._provider.fileWritten(ev.path, ev.content);
+                break;
+            case "delete":
+                this._provider.fileDeleted(ev.path);
+                break;
+            case "rename":
+                this._provider.fileRenamed(ev.oldPath, ev.newPath);
+                break;
+            case "import":
+                this._provider.fullSync(ev.entries);
+                break;
+            case "mkdir":
+            case "rmdir":
+                return;
+        }
+        this.compileAndEmit();
+    }
+    onCompilation(fn) {
+        this._compilationListeners.add(fn);
+        return () => {
+            this._compilationListeners.delete(fn);
+        };
+    }
+    onRemoval(fn) {
+        this._removalListeners.add(fn);
+        return () => {
+            this._removalListeners.delete(fn);
+        };
+    }
+    sendDiagnostics() {
+        if (!this._lastResult || !this._isConnected())
+            return;
+        for (const [file, diagnostics] of this._lastResult.files) {
+            if (diagnostics.length > 0) {
+                this.emitDiagnostics(file, diagnostics);
+            }
+        }
+    }
+    compileAndEmit() {
+        const result = this._provider.compileAll();
+        this._lastResult = result;
+        for (const fn of this._compilationListeners) {
+            fn(result);
+        }
+        if (!this._isConnected())
+            return;
+        const currentFiles = new Set();
+        for (const [file, diagnostics] of result.files) {
+            currentFiles.add(file);
+            if (diagnostics.length > 0 || this._previousFiles.has(file)) {
+                this.emitDiagnostics(file, diagnostics);
+            }
+        }
+        for (const file of this._previousFiles) {
+            if (!currentFiles.has(file)) {
+                this.emitDiagnostics(file, []);
+                for (const fn of this._removalListeners) {
+                    fn(file);
+                }
+            }
+        }
+        this._previousFiles.clear();
+        for (const [file, diagnostics] of result.files) {
+            if (diagnostics.length > 0) {
+                this._previousFiles.add(file);
+            }
+        }
+    }
+    emitDiagnostics(file, diagnostics) {
+        const version = (this._versions.get(file) ?? 0) + 1;
+        this._versions.set(file, version);
+        this._send({
+            type: "compile:diagnostics",
+            payload: { file, version, diagnostics },
+        });
+        let errorCount = 0;
+        let warningCount = 0;
+        for (const d of diagnostics) {
+            if (d.severity === "error")
+                errorCount++;
+            else if (d.severity === "warning")
+                warningCount++;
+        }
+        this._send({
+            type: "compile:status",
+            payload: {
+                file,
+                success: errorCount === 0,
+                diagnosticCount: { error: errorCount, warning: warningCount },
+            },
+        });
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { AppBridge, AppBridgeFeature, AppBridgeFeatureContext, AppBridgeFeatureStatus, AppBridgeOptions, AppBridgeSnapshot, AppBridgeState, DiagnosticEntry, WorkspaceAdapter, WorkspaceChange, WorkspaceSnapshot, } from "./app-bridge.js";
+export { createAppBridge } from "./app-bridge.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export { createAppBridge } from "./app-bridge.js";

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@mindcraft-lang/bridge-app",
+  "version": "0.1.1",
+  "description": "App-side client for the Mindcraft bridge",
+  "license": "MIT",
+  "type": "module",
+  "author": "humanapp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/humanapp/mindcraft-lang.git",
+    "directory": "packages/bridge-app"
+  },
+  "bugs": {
+    "url": "https://github.com/humanapp/mindcraft-lang/issues"
+  },
+  "homepage": "https://github.com/humanapp/mindcraft-lang/tree/main/packages/bridge-app#readme",
+  "keywords": [
+    "mindcraft",
+    "visual-programming",
+    "tile-based",
+    "typescript",
+    "vscode",
+    "language",
+    "education",
+    "stem",
+    "coding",
+    "game-development",
+    "creative-coding",
+    "kodu",
+    "project-spark"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.js",
+      "import": "./dist/index.js"
+    },
+    "./compilation": {
+      "types": "./dist/compilation.d.ts",
+      "browser": "./dist/compilation.js",
+      "import": "./dist/compilation.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "build:prod": "tsc --build",
+    "clean": "tsc --build --clean",
+    "watch": "tsc --build --watch",
+    "lint:only": "biome lint ./src",
+    "check:only": "biome check ./src",
+    "format:only": "biome format ./src",
+    "lint": "biome lint ./src --write",
+    "check": "biome check ./src --write",
+    "pretest": "npm run build",
+    "test": "tsx --tsconfig tsconfig.spec.json --test $(find test -name '*.spec.ts')",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.spec.json",
+    "format": "biome format ./src --write",
+    "release:patch": "node ../../scripts/release.js patch",
+    "release:minor": "node ../../scripts/release.js minor",
+    "release:major": "node ../../scripts/release.js major"
+  },
+  "dependencies": {
+    "@mindcraft-lang/bridge-client": "^0.1.1",
+    "@mindcraft-lang/bridge-protocol": "^0.1.5"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.15",
+    "@types/node": "^25.3.0",
+    "tsx": "^4.21.0",
+    "typescript": "~5.9.3"
+  }
+}