@wendoo/bridge-app 0.2.2

package/dist/app-environment-host.d.ts

@@ -0,0 +1,524 @@
+import type { ApprovedCatalogEntryLookup, ExtensionAddInputResolution, ExtensionCatalogMoves, ExtensionFetchTransport, ExtensionUpdateApplication, ExtensionUpdateCheck, ProjectCollectionProjectCommitResult, ProjectCollectionUnlockResult, ProjectFileSystem, ProjectManifest, UnstableDependency } from "@wendoo/app-host";
+import { AppHostError, type FileContent, type ProjectManager } from "@wendoo/app-host";
+import type { FolderInstalledExtensionMetadata } from "@wendoo/bridge-protocol";
+import type { IBrainDef, WendooEnvironment, WendooModule } from "@wendoo/core/app";
+import type { PersistedBrainJson } from "@wendoo/core/brain/model";
+import type { Localizer } from "@wendoo/core/localization";
+import type { ActionKey, IRngServices, ProfileNumerics } from "@wendoo/core/runtime";
+import type { Mount, WorkspaceCompileResult, WorkspaceDiagnosticEntry } from "@wendoo/ts-compiler";
+import type { AppBridgeState, ProjectFileChange } from "./app-bridge.js";
+import type { EmbeddedExtension, ExtensionResolutionWarning, FetchedExtensionContentMap } from "./embedded-extensions.js";
+import type { ExtensionCatalogEntry, ExtensionFetchFailures } from "./extension-catalog.js";
+import type { ExtensionInstallReport } from "./extension-install.js";
+import type { TileCompileDiagnostics, UserTileApplyResult, UserTileMetadata } from "./user-tile-registration.js";
+/** The outcome of one load's catalog-move application. */
+export interface CatalogMovesOutcome {
+    /** Reports of the per-move install transactions this load ran, in application order. */
+    readonly reports: readonly ExtensionInstallReport[];
+    /** Stable-coded findings for moves that could not be applied this load. */
+    readonly warnings: readonly ExtensionResolutionWarning[];
+}
+/** One diagnostic of the latest workspace compile, located at its workspace path. */
+export type WorkspaceCompileDiagnostic = WorkspaceDiagnosticEntry & {
+    /** Workspace path of the file the diagnostic is located in. */
+    readonly path: string;
+};
+/** Options for {@link AppEnvironmentHost}. */
+export interface AppEnvironmentHostOptions {
+    projectManager: ProjectManager;
+    /** Wendoo modules to register with the environment. */
+    modules: readonly WendooModule[];
+    /** Read-only content mounts supplied to the project compiler and remote VFS. */
+    mounts: readonly Mount[];
+    /**
+     * Extensions bundled with the host application. A project's `embedded:<repo>`
+     * dependency resolves against this record by the origin's repository segment,
+     * delivering the extension's content to the compiler as a mounted dependency
+     * keyed by its `<owner>/<repo>` coordinate. Empty when the app bundles none.
+     */
+    embeddedExtensions?: readonly EmbeddedExtension[];
+    /**
+     * Transport used to fetch remote (`gh:`) extension content at install time.
+     * When omitted, an install transaction needing a fetch refuses as
+     * unreachable; already-installed fetched extensions still load from their
+     * stored snapshots.
+     */
+    extensionFetchTransport?: ExtensionFetchTransport;
+    /**
+     * Curated catalog moves from the host's catalog, keyed by source coordinate.
+     * On project load a top-level manifest entry a move entry captures is
+     * rewritten to the entry's destination through an install transaction, and a
+     * transitive dependency reference an entry captures resolves through the
+     * destination. Empty when the host declares none.
+     */
+    catalogMoves?: ExtensionCatalogMoves;
+    /**
+     * Resolves a coordinate to the approved pin the host's catalog entry offers.
+     * An update check for a listed coordinate offers that pin and does not read
+     * the source. When omitted, every update check reads the source.
+     */
+    approvedCatalogEntry?: ApprovedCatalogEntryLookup;
+    /**
+     * Host-supplied RNG. The bridge app forwards this to
+     * {@link createWendooEnvironment} so brains pull randomness from the host
+     * (e.g. the simulator's seeded RNG). When omitted, the environment falls back
+     * to a default-seeded one, which draws the same sequence every run.
+     */
+    rng?: IRngServices;
+    /**
+     * Brain-observable numeric semantics for the host's device profile,
+     * forwarded to {@link createWendooEnvironment}. When omitted, the
+     * environment falls back to the f64 (native double-precision) default.
+     */
+    numerics?: ProfileNumerics;
+    /**
+     * Host-supplied display-time translation service, forwarded to
+     * {@link createWendooEnvironment}. When omitted, the environment falls
+     * back to the default localizer, which renders every source string as
+     * authored.
+     */
+    localizer?: Localizer;
+    /** When set, enables the optional bridge connection to a remote peer. */
+    bridgeUrl?: string;
+    /** Loads a previously persisted bridge binding token. */
+    loadBindingToken?: () => string | undefined;
+    /** Persists an updated bridge binding token. */
+    saveBindingToken?: (token: string) => void;
+    /** Invoked after every successful project compile. */
+    onDidCompile?: (result: WorkspaceCompileResult, tileResult: UserTileApplyResult | undefined) => void;
+}
+/**
+ * Glue layer that wires a {@link ProjectManager}, a {@link WendooEnvironment},
+ * the project compiler, user-tile registration, and (optionally) the bridge
+ * into a single host an app UI can drive.
+ */
+export declare class AppEnvironmentHost {
+    readonly env: WendooEnvironment;
+    readonly projectManager: ProjectManager;
+    private readonly mounts;
+    private readonly embeddedExtensions;
+    private readonly extensionFetchTransport;
+    private readonly catalogMoves;
+    private readonly approvedCatalogEntry;
+    private readonly onDidCompileCallback?;
+    private _installedSnapshots;
+    private _installedContent;
+    private _lastResolution;
+    private readonly _resolutionWarningsListeners;
+    private _fetchFailures;
+    private _lastCompileResult;
+    private _tileCompileDiagnostics;
+    private readonly _brainCache;
+    private readonly _defaultBrainCache;
+    private _projectRecordFailure;
+    private _pendingBrainRebuild;
+    private _docRevision;
+    private _vfsRevision;
+    private readonly _docRevisionListeners;
+    private readonly _vfsRevisionListeners;
+    private _brainDiagnosticsRevision;
+    private readonly _brainDiagnosticsListeners;
+    private _compileDiagnostics;
+    private readonly _compileDiagnosticsListeners;
+    private readonly _projectUnloadingListeners;
+    private readonly _projectLoadedListeners;
+    private _bridge;
+    private _bridgeUrl;
+    private _bridgeStatus;
+    private _bridgeJoinCode;
+    private readonly _bridgeStatusListeners;
+    private readonly _bridgeJoinCodeListeners;
+    private _bridgeStateUnsub;
+    private _remoteChangeUnsub;
+    private readonly _loadBindingToken;
+    private readonly _saveBindingToken;
+    private _lastUserTileMetadata;
+    private _compiler;
+    private _servedFileSystem;
+    private readonly _compilerControlledFilesListeners;
+    constructor(options: AppEnvironmentHostOptions);
+    get projectFileSystem(): ProjectFileSystem;
+    /**
+     * The file system whose exported snapshot carries both the raw project files
+     * and the compiler-controlled files (ambient declarations, `tsconfig.json`,
+     * and the installed-extensions tree), including extension-owned assets such
+     * as tile icons. Each `exportSnapshot()` reads the live compiler, so
+     * installing or uninstalling an extension is reflected without a rebuild.
+     * Falls back to the raw project file system until the compiler is wired.
+     */
+    get servedProjectFileSystem(): ProjectFileSystem;
+    get activeProjectManifest(): ProjectManifest | undefined;
+    /** Release bridge and project-manager resources owned by this host. */
+    dispose(): void;
+    initialize(defaultProjectName: string): Promise<void>;
+    /**
+     * Resolve the active project's extension dependency graph against the host's
+     * embed record and the project's stored fetched snapshots. Logs any conflict
+     * warnings. On this load path a dependency cycle is logged and resolution
+     * falls back to no extension dependencies, so the project still loads and
+     * unresolved imports surface as ordinary compiler diagnostics; an install
+     * transaction refuses on a cycle instead.
+     */
+    private resolveExtensions;
+    /** Replace the project's installed snapshot records, in memory and in the project store. */
+    private persistInstalledSnapshots;
+    /**
+     * Read the active project's stored extension records: the installed
+     * snapshots and the install log. Both are empty when the project has stored
+     * neither. Returns undefined when the store could not serve them, recording
+     * the failure on {@link AppEnvironmentHost.projectRecordFailure}. On
+     * undefined the caller must leave the stored records untouched.
+     */
+    private readStoredExtensionRecordsForLoad;
+    private initCompiler;
+    /**
+     * Persist source files whose user-action declaration had a stable `id` minted
+     * during compilation. Writes the updated text to the project file system and
+     * to the compiler's in-memory view.
+     */
+    private persistMintedActionIds;
+    saveBrainForKey(key: string, brainDef: IBrainDef): Promise<void>;
+    /**
+     * Serialize a brain into its persisted form: identifiers qualified by the
+     * active project's namespace are stored with the namespace absent.
+     */
+    serializeBrainForStorage(brainDef: IBrainDef): PersistedBrainJson;
+    removeBrain(key: string): Promise<void>;
+    loadBrainFromProject(key: string): Promise<IBrainDef | undefined>;
+    /**
+     * Returns the active project's in-memory brain for `key`, or undefined when none is cached. The
+     * cache is loaded on project load and updated by `saveBrainForKey` and `removeBrain`.
+     */
+    getCachedBrain(key: string): IBrainDef | undefined;
+    /** Returns the keys of the active project's cached brains, in cache order. */
+    getCachedBrainKeys(): readonly string[];
+    setDefaultBrain(key: string, brainDef: IBrainDef): void;
+    getDefaultBrain(key: string): IBrainDef | undefined;
+    private saveAllBrains;
+    /**
+     * Read the active project's stored brain record together with the raw stored
+     * text it was parsed from. Both are empty -- `raw` undefined, `record` `{}` --
+     * when the project has never stored a record. Throws {@link AppHostError} with
+     * code `BRAIN_RECORD_UNREADABLE` -- and no other error -- when a stored record
+     * exists but cannot be read or parsed.
+     */
+    private readStoredBrains;
+    /**
+     * Read the active project's stored brain record. Returns an empty record when
+     * the project has never stored one. Throws {@link AppHostError} with code
+     * `BRAIN_RECORD_UNREADABLE` -- and no other error -- when a stored record
+     * exists but cannot be read or parsed.
+     */
+    private loadBrainRecord;
+    /**
+     * Read the stored brains on a project-load path. Returns the record and the
+     * raw stored text, or undefined when they could not be read, recording the
+     * failure on {@link AppEnvironmentHost.projectRecordFailure}. On undefined the
+     * caller must leave the stored brains untouched.
+     */
+    private readStoredBrainsForLoad;
+    /**
+     * The first failure that stopped one of the active project's stored records
+     * from loading, or undefined when they all loaded. Its `code` names the
+     * record: `BRAIN_RECORD_UNREADABLE` for the saved brains,
+     * `EXTENSION_RECORD_UNREADABLE` for the installed-library snapshots and the
+     * install log. While it is set the brain cache is empty because a record
+     * could not be read, not because the project has no brains, every brain
+     * write refuses, and no write replaces a record that could not be read.
+     * Cleared when the project unloads.
+     */
+    get projectRecordFailure(): AppHostError | undefined;
+    /** True while the active project's stored extension records could not be read. */
+    private get extensionRecordUnreadable();
+    /**
+     * Deserialize the project's stored brains into the cache. Call after the
+     * load's catalog moves have applied: deserialization resolves saved tile
+     * references against the current action bundle. Caches nothing when the load
+     * already recorded a stored-record failure: the extension closure is then
+     * unknown, so no saved tile reference resolves.
+     */
+    private loadBrainsFromProject;
+    /**
+     * Reconcile the in-memory brain cache against the project store's current
+     * brain record: cached brains absent from the record are dropped, and
+     * record entries whose stored form differs from the cached brain are
+     * deserialized into the cache. Returns the changed and removed brain keys.
+     */
+    reconcileBrainsFromStore(): Promise<{
+        changed: readonly string[];
+        removed: readonly string[];
+    }>;
+    private deserializeBrainForKey;
+    /**
+     * Re-resolve every cached brain's tile references against the current
+     * catalogs by round-tripping it through its persisted form -- the same
+     * resolution a project load performs, so a tile whose library left the
+     * closure becomes a placeholder and a placeholder whose library returned
+     * becomes the real tile again. A brain whose round-trip fails keeps its
+     * current definition.
+     */
+    private refreshBrainCache;
+    updateProjectMetadata(updates: Partial<Pick<ProjectManifest, "name" | "description">>): Promise<void>;
+    /** The installed fetched-extension content available to the active project, keyed by reference. */
+    get installedExtensionContent(): FetchedExtensionContentMap;
+    /**
+     * The compiler-controlled file set of the active project's workspace: the
+     * generated `tsconfig.json`, ambient declarations, and the materialized
+     * installed-extensions tree. Undefined until the compiler is wired.
+     */
+    getCompilerControlledFiles(): ReadonlyMap<string, FileContent> | undefined;
+    /**
+     * Subscribe to compiler-controlled file set changes. The listener receives
+     * the full new set after each compile that changed it. Returns an
+     * unsubscribe function.
+     */
+    onCompilerControlledFilesChanged(listener: (files: ReadonlyMap<string, FileContent>) => void): () => void;
+    /** Install provenance of every installed fetched dependency, keyed by `<owner>/<repo>` origin. */
+    getInstalledExtensionMetadata(): Record<string, FolderInstalledExtensionMetadata>;
+    /**
+     * The installed libraries of the active project's resolved extension
+     * closure: one record per resolved origin, carrying the coordinate a
+     * compiled tile's identity namespace names and the display name the
+     * library's own `wendoo.json` declares. Empty until the compiler is
+     * wired.
+     */
+    get installedLibraries(): readonly Pick<ExtensionCatalogEntry, "coordinate" | "name">[];
+    /** The last recorded fetch failure per reference, keyed by the reference string as written. */
+    get extensionFetchFailures(): ExtensionFetchFailures;
+    /**
+     * Non-fatal warnings of the active project's latest extension resolution,
+     * including the stable-coded catalog-move findings the load's move
+     * application recorded. Empty until the compiler is wired.
+     */
+    get resolutionWarnings(): readonly ExtensionResolutionWarning[];
+    /**
+     * Subscribe to resolution-warning changes for `useSyncExternalStore`. The
+     * listener fires whenever the active project's latest resolution is
+     * replaced: on project load and switch, and after each install transaction.
+     * Returns an unsubscribe function.
+     */
+    subscribeToResolutionWarnings: (listener: () => void) => (() => void);
+    /** Snapshot of {@link resolutionWarnings} for `useSyncExternalStore`. */
+    getResolutionWarningsSnapshot: () => readonly ExtensionResolutionWarning[];
+    /** Record the latest resolution and notify resolution-warning subscribers. */
+    private setLastResolution;
+    /** Merge a load's catalog-move findings into the latest resolution's warnings, skipping duplicates. */
+    private absorbCatalogMovesOutcome;
+    /** Fetch one `gh:` reference's snapshot through the host's transport. */
+    private fetchSnapshot;
+    /** Materialize a resolution: dependencies, `wendoo.json`, and a recompile of the whole workspace. */
+    private applyResolution;
+    /** Rewrite `wendoo.json` from the store manifest, restoring the file after a refused transaction. */
+    private resyncManifestFile;
+    /**
+     * The active project's diagnostic state: the latest workspace compile's
+     * per-file diagnostics plus a fresh typecheck of every cached brain.
+     */
+    private captureProjectDiagnostics;
+    /**
+     * Append the transaction's events to the project's install log. Appends
+     * nothing while the stored extension records are unreadable: the log's
+     * existing entries are unknown, so a write would replace them with these
+     * events alone.
+     */
+    private appendInstallLogEvents;
+    /**
+     * The install and remove events between two resolved closures, plus the new
+     * resolution's warnings. An origin present in both closures records an
+     * install event when its winning reference or installed specifier changed
+     * (an update).
+     */
+    private installLogEventsForChange;
+    /**
+     * Apply an extensions-map change to the active project as one transaction:
+     * fetch content for every newly reachable `gh:` reference, resolve the
+     * transitive dependency graph, then commit -- persist the manifest entries
+     * and the fetched snapshots, re-materialize the installed-extensions tree,
+     * recompile the workspace, and re-typecheck the project's brains -- and
+     * report the diagnostic difference against the pre-change baseline.
+     *
+     * Improved, unchanged, and worsened outcomes all commit. The transaction
+     * refuses outright only on mechanics failures -- an unreachable source, a
+     * missing or unparseable manifest, a missing listed file, a dependency
+     * cycle, or stored extension records the store could not serve -- leaving
+     * the project unchanged. Every commit appends its install, remove, and
+     * resolution-warning events to the project's install log.
+     *
+     * @param extensions - The active project's next extensions map, keyed by coordinate.
+     * @param options.refetchReferences - References fetched fresh even when a stored snapshot matches.
+     */
+    updateProjectExtensions(extensions: Readonly<Record<string, string>>, options?: {
+        refetchReferences?: ReadonlySet<string>;
+    }): Promise<ExtensionInstallReport>;
+    /** Version lookup over the embed record and the project's persisted snapshot content. */
+    private moveVersionLookup;
+    /**
+     * Resolve a floating catalog-move destination for a coordinate to a pinned
+     * `gh:` reference: the coordinate's persisted snapshot pin when one exists,
+     * otherwise the highest stable published version listed by the host's
+     * transport. Returns undefined when no pin can be produced.
+     */
+    private resolveFloatingMoveReference;
+    /**
+     * Apply the host's curated catalog moves to the active project. Each
+     * captured top-level manifest entry is one move-application unit: its
+     * manifest rewrite, its saved-brain namespace rewrite (when the entry's
+     * final coordinate differs), and the fetches its chain requires run as one
+     * install transaction, rolled back together when the transaction refuses. A
+     * failed unit writes nothing, surfaces a stable-coded warning, and is
+     * retried on the next load, while other units proceed independently.
+     *
+     * Application interleaves apply, fetch, and re-apply: after each committed
+     * transaction the entries are re-applied with the versions the new content
+     * determines, and a transitive moved dependency whose content the project
+     * never persisted is healed by a fetch transaction, until nothing changes.
+     * A floating destination is resolved to a pin before its transaction runs;
+     * the pin is what the manifest receives. Returns undefined when the host
+     * declares no moves or the project is a true no-op; otherwise the
+     * transactions' reports and the load's stable-coded move warnings. Returns
+     * undefined without applying anything while the stored extension records are
+     * unreadable, so no move writes over a record the store could not serve.
+     */
+    applyCatalogMoves(): Promise<CatalogMovesOutcome | undefined>;
+    /**
+     * Rewrite every saved brain's foreign-namespace references from each rename's
+     * source coordinate to its target, persisting the rewritten brains record and
+     * re-deserializing the changed brains into the cache. Returns true when at
+     * least one brain changed.
+     *
+     * @param record - The stored brain record to rewrite, read by the caller; mutated in place.
+     * @param renames - The coordinate renames to apply, each a source and its target.
+     */
+    private renameBrainNamespaces;
+    /** Restore the brains record and cache to a pre-rewrite snapshot after a refused migration. */
+    private restoreBrains;
+    /**
+     * Normalize add-by-reference input to an installable extension reference: a
+     * complete reference, an `<owner>/<repo>` coordinate, or a GitHub repository
+     * URL. Input naming a repository without a version resolves to the
+     * repository's latest published version through the host's transport. Fails
+     * with a stable code when the input is unrecognized, no version can be
+     * resolved, or the host has no transport to resolve one through.
+     *
+     * @param input - The pasted add-field text.
+     */
+    resolveExtensionInstallInput(input: string): Promise<ExtensionAddInputResolution>;
+    /**
+     * Check one installed fetched dependency of the active project for newer
+     * content: a `@<pin>` reference against the host catalog's approved pin when
+     * the catalog lists the coordinate and against the source's published
+     * versions when it does not, a `#<branch>` reference against the branch's
+     * head commit. The check runs on request, reaches the source through the
+     * host's transport, and changes nothing.
+     *
+     * @param coordinate - The dependency's `<owner>/<repo>` coordinate in the project's extensions map.
+     */
+    checkExtensionUpdate(coordinate: string): Promise<ExtensionUpdateCheck>;
+    /**
+     * Apply one or more dependency updates to the active project as a single
+     * install transaction with one outcome: each update's coordinate takes its
+     * new reference in the extensions map, and each updated reference is fetched
+     * fresh, never satisfied from its stored snapshot. The report and the
+     * install log are those of {@link updateProjectExtensions}.
+     *
+     * @param updates - The updates to apply, as returned by update checks.
+     */
+    applyExtensionUpdates(updates: readonly ExtensionUpdateApplication[]): Promise<ExtensionInstallReport>;
+    /**
+     * Collect the active project's dependencies that are not stable for
+     * consumers: branch references, and pinned references whose content the
+     * project has no installed snapshot for. Exporting or publishing such a
+     * project should ask for confirmation first.
+     */
+    collectUnstableProjectDependencies(): Promise<readonly UnstableDependency[]>;
+    onProjectUnloading(listener: () => void): () => void;
+    onProjectLoaded(listener: () => void): () => void;
+    createProject(name: string): Promise<ProjectManifest>;
+    switchProject(id: string): Promise<void>;
+    switchProjectCollectionAndOpenProject(projectCollectionId: string, projectId: string): Promise<ProjectCollectionProjectCommitResult>;
+    switchProjectCollectionAndCreateProject(projectCollectionId: string, name: string): Promise<ProjectCollectionProjectCommitResult>;
+    /**
+     * Unlock a project collection and initialize the project environment when
+     * unlocking restores the active project.
+     *
+     * @param projectCollectionId - Project collection to unlock.
+     * @param pin - User-entered PIN or phrase.
+     * @returns The unlocked project collection and its ready access status.
+     */
+    unlockProjectCollection(projectCollectionId: string, pin: string): Promise<ProjectCollectionUnlockResult>;
+    /**
+     * Lock a project collection after flushing app-owned project state.
+     *
+     * @param projectCollectionId - Project collection to lock.
+     */
+    lockProjectCollection(projectCollectionId: string): Promise<void>;
+    private prepareProjectTransition;
+    private notifyProjectUnloading;
+    private completeProjectUnload;
+    private completeProjectTransition;
+    flushPendingBrainRebuilds(): void;
+    get lastUserTileMetadata(): readonly UserTileMetadata[] | undefined;
+    /**
+     * Error compile diagnostics of the user tile registered under `key` together
+     * with the defining source file's path, from the latest workspace compile.
+     * Undefined when the tile compiled cleanly, produced only warnings or infos,
+     * or is absent from the latest compile. Each stored diagnostic is the
+     * compiler's verbatim object, exposing `message`, `severity`, and
+     * `line`/`column`.
+     */
+    getTileCompileDiagnostics(key: ActionKey): TileCompileDiagnostics | undefined;
+    get docRevision(): number;
+    bumpDocRevision(): void;
+    bumpVfsRevision(): void;
+    subscribeToDocRevision: (listener: () => void) => (() => void);
+    /**
+     * Subscribe to brain-diagnostics revision changes for
+     * `useSyncExternalStore`. The revision bumps whenever the diagnostics a brain
+     * surfaces may have changed: after each extension transaction, after each brain
+     * save, and after each workspace compile (which can change a used tile's
+     * broken/clean status). Returns an unsubscribe function.
+     */
+    subscribeToBrainDiagnostics: (listener: () => void) => (() => void);
+    /** Snapshot of the current brain-diagnostics revision for `useSyncExternalStore`. */
+    getBrainDiagnosticsRevision: () => number;
+    private bumpBrainDiagnosticsRevision;
+    /**
+     * Subscribe to workspace-compile diagnostic changes for
+     * `useSyncExternalStore`. The listener fires after every workspace compile
+     * and on project unload. Returns an unsubscribe function.
+     */
+    subscribeToCompileDiagnostics: (listener: () => void) => (() => void);
+    /** Snapshot of the latest workspace compile's diagnostics for `useSyncExternalStore`; empty when clean. */
+    getCompileDiagnosticsSnapshot: () => readonly WorkspaceCompileDiagnostic[];
+    /** Record a compile's per-file diagnostics as one flat located list and notify subscribers. */
+    private setCompileDiagnostics;
+    getDocRevisionSnapshot: () => number;
+    subscribeToVfsRevision: (listener: () => void) => (() => void);
+    getVfsRevisionSnapshot: () => number;
+    initBridge(): void;
+    connectBridge(): void;
+    disconnectBridge(): void;
+    private teardownBridge;
+    updateBridgeUrl(bridgeUrl: string): void;
+    subscribeToBridgeStatus: (listener: () => void) => (() => void);
+    getBridgeStatusSnapshot: () => AppBridgeState;
+    subscribeToBridgeJoinCode: (listener: () => void) => (() => void);
+    getBridgeJoinCodeSnapshot: () => string | undefined;
+    /**
+     * Apply a project file change observed outside the app (a folder-session
+     * external edit): applies it to the project file system and the workspace
+     * compiler, recompiles, and absorbs any `wendoo.json` manifest change.
+     */
+    applyExternalProjectFileChange(change: ProjectFileChange): void;
+    /**
+     * Absorb a project file change made by a remote peer: bumps the VFS
+     * revision, and a `wendoo.json` write is diffed against the active
+     * manifest -- an extensions change runs through the install transaction and
+     * the remaining synced fields patch the manifest. The change itself must
+     * already be applied to the project file system.
+     */
+    handleRemoteProjectFileChange(change: ProjectFileChange): void;
+    private wireBridgeState;
+    private applyBridgeSnapshot;
+}
+//# sourceMappingURL=app-environment-host.d.ts.map

package/dist/app-environment-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-environment-host.d.ts","sourceRoot":"","sources":["../src/app-environment-host.ts"],"names":[],"mappings":"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"}