@wendoo/bridge-app 0.2.2

package/dist/project-file-bridge.js

@@ -0,0 +1,87 @@
+import { fileContentFromWire, fileContentToWire } from "@wendoo/app-host";
+/** Convert an app-host project file snapshot into a bridge-client snapshot. */
+export function toFileSystemSnapshot(snapshot) {
+    return new Map(snapshot);
+}
+/** Convert an app-host project file mutation into a bridge protocol notification. */
+export function toFileSystemNotification(change) {
+    switch (change.action) {
+        case "write":
+            return {
+                action: "write",
+                path: change.path,
+                ...fileContentToWire(change.content),
+                newEtag: change.newEtag,
+                ...(change.isReadonly !== undefined ? { isReadonly: change.isReadonly } : {}),
+                ...(change.expectedEtag !== undefined ? { expectedEtag: change.expectedEtag } : {}),
+            };
+        case "delete":
+            return {
+                action: "delete",
+                path: change.path,
+                ...(change.expectedEtag !== undefined ? { expectedEtag: change.expectedEtag } : {}),
+            };
+        case "rename":
+            return {
+                action: "rename",
+                oldPath: change.oldPath,
+                newPath: change.newPath,
+                ...(change.expectedEtag !== undefined ? { expectedEtag: change.expectedEtag } : {}),
+            };
+        case "mkdir":
+            return { action: "mkdir", path: change.path };
+        case "rmdir":
+            return { action: "rmdir", path: change.path };
+        case "import":
+            return { action: "import", entries: [...change.entries].map(toWireEntry) };
+    }
+}
+/** Convert a bridge protocol notification into an app-host project file mutation. */
+export function toProjectFileChange(notification) {
+    switch (notification.action) {
+        case "write":
+            return {
+                action: "write",
+                path: notification.path,
+                content: fileContentFromWire(notification),
+                newEtag: notification.newEtag,
+                ...(notification.isReadonly !== undefined ? { isReadonly: notification.isReadonly } : {}),
+                ...(notification.expectedEtag !== undefined ? { expectedEtag: notification.expectedEtag } : {}),
+            };
+        case "delete":
+            return {
+                action: "delete",
+                path: notification.path,
+                ...(notification.expectedEtag !== undefined ? { expectedEtag: notification.expectedEtag } : {}),
+            };
+        case "rename":
+            return {
+                action: "rename",
+                oldPath: notification.oldPath,
+                newPath: notification.newPath,
+                ...(notification.expectedEtag !== undefined ? { expectedEtag: notification.expectedEtag } : {}),
+            };
+        case "mkdir":
+            return { action: "mkdir", path: notification.path };
+        case "rmdir":
+            return { action: "rmdir", path: notification.path };
+        case "import":
+            return { action: "import", entries: [...notification.entries].map(fromWireEntry) };
+    }
+}
+/** Encode a project snapshot entry for the wire. */
+function toWireEntry([path, entry]) {
+    if (entry.kind === "directory") {
+        return [path, entry];
+    }
+    const { content, ...rest } = entry;
+    return [path, { ...rest, ...fileContentToWire(content) }];
+}
+/** Decode a wire entry back into a project snapshot entry. */
+function fromWireEntry([path, entry]) {
+    if (entry.kind === "directory") {
+        return [path, entry];
+    }
+    const { encoding, ...rest } = entry;
+    return [path, { ...rest, content: fileContentFromWire(entry) }];
+}

package/dist/user-tile-registration.d.ts

@@ -0,0 +1,89 @@
+import type { ActionKind, BrainActionCallSpec, WendooEnvironment } from "@wendoo/core/app";
+import type { ActionKey } from "@wendoo/core/runtime";
+import type { CompileDiagnostic, ExtractedArgSpec, ExtractedOutput, WorkspaceCompileResult } from "@wendoo/ts-compiler";
+/** Metadata describing a user-authored sensor or actuator tile. */
+export interface UserTileMetadata {
+    /** Stable key used to identify the tile across compiles. */
+    key: string;
+    /**
+     * Namespace of the project that compiled this tile: a host project's store id
+     * or an installed extension's `<owner>/<repo>` coordinate.
+     */
+    namespace: string;
+    /** Opaque stable id from the source declaration. */
+    id: string;
+    /** The tile-bearing action kind; conversions surface no tile and are excluded. */
+    kind: Exclude<ActionKind, "conversion">;
+    /** Display name of the user's action. */
+    name: string;
+    /** Brain-action call signature derived from the source. */
+    callSpec: BrainActionCallSpec;
+    /** Argument descriptors derived from the source. */
+    args: ExtractedArgSpec[];
+    /** For sensors, the typeId of the value the tile produces. */
+    outputType?: string;
+    /** For sensors, the declared named outputs surfaced as inline output value-tiles. */
+    outputs?: ExtractedOutput[];
+    /** Whether the tile's call returns a `Promise`. */
+    isAsync: boolean;
+    /** Optional human-readable label for the tile. */
+    label?: string;
+    /** Optional icon URL for the tile. */
+    iconUrl?: string;
+    /** Optional Markdown documentation shown in the editor. */
+    docsMarkdown?: string;
+    /** Optional categorization tags. */
+    tags?: string[];
+    /** For sensors, when true the tile is placement-inline; the picker offers it in value-slot positions. */
+    inline?: boolean;
+    /** For sensors, when true the tile carries the PresenceGated capability; a bare WHEN gates on value presence. */
+    presenceGated?: boolean;
+}
+/** Result returned by {@link applyCompiledUserTiles}. */
+export interface UserTileApplyResult {
+    metadata: readonly UserTileMetadata[];
+    /** Action keys whose call definition changed since the previous bundle. */
+    changedActionKeys: readonly string[];
+    /** Number of brains invalidated by the change. */
+    invalidatedBrainCount: number;
+}
+/**
+ * Extract user-tile metadata from a compile result, sorted by key. Includes a
+ * metadata entry for every contributing file of every compilation root -- the
+ * host project and each installed extension, each keyed under its own
+ * namespace -- matching the files whose tiles enter the compiled bundle.
+ */
+export declare function collectMetadataFromCompile(result: WorkspaceCompileResult): UserTileMetadata[];
+/**
+ * A user tile's error compile diagnostics together with the source file path
+ * that produced them. `path` is the compilation-root path keyed by the tile's
+ * {@link ActionKey}; a consumer composes a source location from `path` and each
+ * diagnostic's `line`/`column`.
+ */
+export interface TileCompileDiagnostics {
+    /** Compilation-root path of the source file that contributed the tile. */
+    readonly path: string;
+    /** The file's error compile diagnostics, verbatim and in emit order. */
+    readonly diagnostics: readonly CompileDiagnostic[];
+}
+/**
+ * Map each user tile's {@link ActionKey} to the error compile diagnostics of the
+ * source file that contributed it and that source's path, built from a single
+ * workspace compile. Iterates every compilation root's per-file results, keying
+ * by `(program ?? definition).key` and collecting that file's compile errors:
+ * the TypeScript pre-emit diagnostics (`tsErrors` for the file's path) together
+ * with the result's own descriptor, lowering, and emit diagnostics, filtered to
+ * `severity === "error"`. Conversions surface no tile and are excluded. A file
+ * that compiled cleanly, or produced only warnings and infos, is absent from the
+ * map.
+ *
+ * The stored diagnostics are the compiler's verbatim {@link CompileDiagnostic}
+ * objects, so a consumer reads `message`, `severity`, and `line`/`column` directly.
+ */
+export declare function collectTileSourceCompileErrors(result: WorkspaceCompileResult): Map<ActionKey, TileCompileDiagnostics>;
+/**
+ * Apply the user-tile bundle from a project compile result to the environment.
+ * Returns `undefined` when the compile produced no bundle.
+ */
+export declare function applyCompiledUserTiles(env: WendooEnvironment, result: WorkspaceCompileResult): UserTileApplyResult | undefined;
+//# sourceMappingURL=user-tile-registration.d.ts.map

package/dist/user-tile-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-tile-registration.d.ts","sourceRoot":"","sources":["../src/user-tile-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAGf,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,kFAAkF;IAClF,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACxC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,oDAAoD;IACpD,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,yGAAyG;IACzG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iHAAiH;IACjH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,2EAA2E;IAC3E,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,kDAAkD;IAClD,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AA0BD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB,EAAE,CAe7F;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,sBAAsB,GAAG,GAAG,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAqBrH;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,sBAAsB,GAC7B,mBAAmB,GAAG,SAAS,CAwBjC"}

package/dist/user-tile-registration.js

@@ -0,0 +1,100 @@
+import { logger, mkActionTileId } from "@wendoo/core/app";
+function metadataFromProgram(program) {
+    if (program.kind === "conversion") {
+        throw new Error(`Conversion "${program.key}" has no tile metadata`);
+    }
+    return {
+        key: program.key,
+        namespace: program.projectNamespace,
+        id: program.id,
+        kind: program.kind,
+        name: program.name,
+        callSpec: program.callDef.callSpec,
+        args: program.args,
+        outputType: program.outputType,
+        outputs: program.outputs,
+        isAsync: program.isAsync,
+        label: program.label,
+        iconUrl: program.iconUrl,
+        docsMarkdown: program.docsMarkdown,
+        tags: program.tags,
+        inline: program.inline,
+        presenceGated: program.presenceGated,
+    };
+}
+/**
+ * Extract user-tile metadata from a compile result, sorted by key. Includes a
+ * metadata entry for every contributing file of every compilation root -- the
+ * host project and each installed extension, each keyed under its own
+ * namespace -- matching the files whose tiles enter the compiled bundle.
+ */
+export function collectMetadataFromCompile(result) {
+    const metadata = [];
+    for (const rootResult of result.rootResults) {
+        for (const compileResult of rootResult.results.values()) {
+            const surface = compileResult.program ?? compileResult.definition;
+            // Conversions compile to a program but surface no tiles, so they contribute no tile metadata.
+            if (surface && surface.kind !== "conversion") {
+                metadata.push(metadataFromProgram(surface));
+            }
+        }
+    }
+    metadata.sort((left, right) => left.key.localeCompare(right.key));
+    return metadata;
+}
+/**
+ * Map each user tile's {@link ActionKey} to the error compile diagnostics of the
+ * source file that contributed it and that source's path, built from a single
+ * workspace compile. Iterates every compilation root's per-file results, keying
+ * by `(program ?? definition).key` and collecting that file's compile errors:
+ * the TypeScript pre-emit diagnostics (`tsErrors` for the file's path) together
+ * with the result's own descriptor, lowering, and emit diagnostics, filtered to
+ * `severity === "error"`. Conversions surface no tile and are excluded. A file
+ * that compiled cleanly, or produced only warnings and infos, is absent from the
+ * map.
+ *
+ * The stored diagnostics are the compiler's verbatim {@link CompileDiagnostic}
+ * objects, so a consumer reads `message`, `severity`, and `line`/`column` directly.
+ */
+export function collectTileSourceCompileErrors(result) {
+    const byKey = new Map();
+    for (const rootResult of result.rootResults) {
+        for (const [path, compileResult] of rootResult.results) {
+            const surface = compileResult.program ?? compileResult.definition;
+            // Conversions compile to a program but surface no tile, so they contribute no tile diagnostics.
+            if (!surface || surface.kind === "conversion") {
+                continue;
+            }
+            const tsErrors = rootResult.tsErrors.get(path) ?? [];
+            const diagnostics = [...tsErrors, ...compileResult.diagnostics].filter((diagnostic) => diagnostic.severity === "error");
+            if (diagnostics.length > 0) {
+                byKey.set(surface.key, { path, diagnostics });
+            }
+        }
+    }
+    return byKey;
+}
+/**
+ * Apply the user-tile bundle from a project compile result to the environment.
+ * Returns `undefined` when the compile produced no bundle.
+ */
+export function applyCompiledUserTiles(env, result) {
+    const bundle = result.bundle;
+    if (!bundle) {
+        return undefined;
+    }
+    const metadata = collectMetadataFromCompile(result);
+    const update = env.replaceActionBundle(bundle);
+    if (metadata.length > 0 || update.changedActionKeys.length > 0) {
+        logger.debug(`[user-tile-registration] applied bundle: ${metadata.length} tile(s), ${update.changedActionKeys.length} changed action(s), ${update.invalidatedBrains.length} invalidated brain(s)`);
+        for (const entry of metadata) {
+            const tileId = mkActionTileId(entry.kind, entry.key);
+            logger.debug(`[user-tile-registration]   ${tileId}`);
+        }
+    }
+    return {
+        metadata,
+        changedActionKeys: update.changedActionKeys,
+        invalidatedBrainCount: update.invalidatedBrains.length,
+    };
+}

package/dist/vfs-asset-url-provider.d.ts

@@ -0,0 +1,22 @@
+import type { ProjectFileSystem } from "./app-bridge.js";
+/** Options for {@link createVfsAssetUrlProvider}. */
+export interface VfsAssetUrlProviderOptions {
+    /** Returns the project file system whose snapshot carries the served assets. */
+    getProjectFileSystem: () => ProjectFileSystem;
+    /** Returns the current VFS revision. Advancing it invalidates minted URLs. */
+    getVfsRevision: () => number;
+}
+/** Resolves compiler-minted `/vfs/<path>` asset references to loadable URLs. */
+export interface VfsAssetUrlProvider {
+    /**
+     * Resolve `url` to an object URL for the file at `<path>` in the current
+     * snapshot of the project file system. URLs are cached per (path, revision);
+     * the first resolution after the revision advances re-reads the snapshot and
+     * revokes the superseded generation's URLs. Returns `url` unchanged when it
+     * does not start with `/vfs/` or names no file in the snapshot.
+     */
+    resolveAssetUrl(url: string): string;
+}
+/** Create a {@link VfsAssetUrlProvider} over a project file system and a VFS revision source. */
+export declare function createVfsAssetUrlProvider(options: VfsAssetUrlProviderOptions): VfsAssetUrlProvider;
+//# sourceMappingURL=vfs-asset-url-provider.d.ts.map

package/dist/vfs-asset-url-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs-asset-url-provider.d.ts","sourceRoot":"","sources":["../src/vfs-asset-url-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAmB9E,qDAAqD;AACrD,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;IAC9C,8EAA8E;IAC9E,cAAc,EAAE,MAAM,MAAM,CAAC;CAC9B;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACtC;AAED,iGAAiG;AACjG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,mBAAmB,CAuClG"}

package/dist/vfs-asset-url-provider.js

@@ -0,0 +1,52 @@
+import { fileContentToBytes } from "@wendoo/app-host";
+const VFS_PREFIX = "/vfs/";
+const MIME_TYPES = {
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+};
+function mimeForPath(path) {
+    const dot = path.lastIndexOf(".");
+    if (dot === -1)
+        return "application/octet-stream";
+    return MIME_TYPES[path.slice(dot)] ?? "application/octet-stream";
+}
+/** Create a {@link VfsAssetUrlProvider} over a project file system and a VFS revision source. */
+export function createVfsAssetUrlProvider(options) {
+    let generationRevision;
+    let snapshot;
+    let urlsByPath = new Map();
+    return {
+        resolveAssetUrl(url) {
+            if (!url.startsWith(VFS_PREFIX)) {
+                return url;
+            }
+            const revision = options.getVfsRevision();
+            if (revision !== generationRevision) {
+                for (const minted of urlsByPath.values()) {
+                    URL.revokeObjectURL(minted);
+                }
+                urlsByPath = new Map();
+                snapshot = undefined;
+                generationRevision = revision;
+            }
+            const path = url.slice(VFS_PREFIX.length);
+            const cached = urlsByPath.get(path);
+            if (cached !== undefined) {
+                return cached;
+            }
+            snapshot ??= options.getProjectFileSystem().exportSnapshot();
+            const entry = snapshot.get(path);
+            if (!entry || entry.kind !== "file") {
+                return url;
+            }
+            const bytes = new Uint8Array(fileContentToBytes(entry.content));
+            const minted = URL.createObjectURL(new Blob([bytes], { type: mimeForPath(path) }));
+            urlsByPath.set(path, minted);
+            return minted;
+        },
+    };
+}

package/dist/workspace-folder-project-store.d.ts

@@ -0,0 +1,125 @@
+import type { ProjectCollection, ProjectCollectionTabSession, ProjectFileChange, ProjectFileSnapshot, ProjectManifest, ProjectRef, ProjectStore } from "@wendoo/app-host";
+import type { FileSystemNotification } from "@wendoo/bridge-protocol";
+import type { InstalledExtensionSnapshots } from "./fetched-extension-snapshots.js";
+/** Project collection id of the single collection a workspace-folder store exposes. */
+export declare const WORKSPACE_FOLDER_PROJECT_COLLECTION_ID = "workspace-folder";
+/** Stable identifiers for workspace-folder store errors. */
+export declare const WorkspaceFolderStoreErrorCode: {
+    /** The host-provided `wendoo.json` failed content-manifest validation. */
+    readonly INVALID_MANIFEST: "WORKSPACE_FOLDER_INVALID_MANIFEST";
+    /** A multi-project or collection-management operation was invoked; a workspace folder holds exactly one project. */
+    readonly UNSUPPORTED_OPERATION: "WORKSPACE_FOLDER_UNSUPPORTED_OPERATION";
+};
+/** Union of all {@link WorkspaceFolderStoreErrorCode} values. */
+export type WorkspaceFolderStoreErrorCode = (typeof WorkspaceFolderStoreErrorCode)[keyof typeof WorkspaceFolderStoreErrorCode];
+/** Error thrown by {@link WorkspaceFolderProjectStore}. */
+export declare class WorkspaceFolderStoreError extends Error {
+    /** Stable machine-readable error code. */
+    readonly code: WorkspaceFolderStoreErrorCode;
+    constructor(code: WorkspaceFolderStoreErrorCode, message: string);
+}
+/**
+ * Translates between per-project app-data entries and the owning app's session
+ * chunk stored in the manifest's `app` map.
+ */
+export interface FolderAppDataCodec {
+    /**
+     * Build the app chunk from the current app-data entries. Returns `undefined`
+     * when the entries carry no chunk-worthy state; the chunk is then absent
+     * from the manifest.
+     */
+    chunkFromAppData(appData: ReadonlyMap<string, string>): unknown;
+    /** Translate an app chunk into app-data entries keyed by app-data key. */
+    appDataFromChunk(chunk: unknown): Record<string, string>;
+}
+/** File operations the store issues against the host-owned project folder. */
+export interface WorkspaceFolderRpc {
+    /** Apply one file change to the project folder. Resolves when written. */
+    sendChange(change: FileSystemNotification): Promise<void>;
+    /** Replace the project's `wendoo.json` with `content`. */
+    writeManifest(content: string): Promise<void>;
+    /** Read the project's file snapshot entries, excluding `wendoo.json`. */
+    loadFiles(): Promise<ProjectFileSnapshot>;
+}
+/** Options for {@link WorkspaceFolderProjectStore}. */
+export interface WorkspaceFolderProjectStoreOptions {
+    /** Transport performing the actual folder I/O. */
+    rpc: WorkspaceFolderRpc;
+    /** Stable opaque id of the host-provided project. */
+    projectId: string;
+    /** JSON text of the project's `wendoo.json` as read from disk. */
+    manifestContent: string;
+    /** App name keying this app's chunk in the manifest's `app` map. */
+    appName: string;
+    /** Translator between app-data entries and this app's manifest chunk. */
+    appDataCodec?: FolderAppDataCodec;
+    /**
+     * Installed fetched-extension snapshot records seeding the store's
+     * installed-extensions app data, keyed by `<owner>/<repo>` origin. Loading
+     * the project then regenerates the installed-extensions tree from these
+     * records without reaching the network.
+     */
+    installedExtensionSnapshots?: InstalledExtensionSnapshots;
+}
+/**
+ * A {@link ProjectStore} over a host-owned workspace folder: the folder is the
+ * single project of the store's single collection. File writes are
+ * change-granular; the project manifest and its app data are stored inside the
+ * folder's `wendoo.json` (brains and app chunks in the pass-through
+ * section, unknown fields preserved). Multi-project and collection-management
+ * operations throw {@link WorkspaceFolderStoreError}.
+ */
+export declare class WorkspaceFolderProjectStore implements ProjectStore {
+    readonly keyPrefix: string;
+    private readonly rpc;
+    private readonly projectId;
+    private readonly appName;
+    private readonly appDataCodec;
+    private readonly collection;
+    private base;
+    private manifest;
+    private readonly appData;
+    private chunkAppDataKeys;
+    private lastManifestContent;
+    private mirror;
+    constructor(options: WorkspaceFolderProjectStoreOptions);
+    /**
+     * Absorb a change observed on disk outside the app: a `wendoo.json`
+     * write replaces the store's manifest and app-data state; any other change
+     * updates the store's view of the folder. Returns the change in project
+     * file form for the caller to apply to the live project file system.
+     */
+    absorbExternalChange(change: FileSystemNotification): ProjectFileChange;
+    listProjectCollections(): Promise<ProjectCollection[]>;
+    getProjectCollection(projectCollectionId: string): Promise<ProjectCollection | undefined>;
+    createProjectCollection(): Promise<ProjectCollection>;
+    updateProjectCollection(): Promise<void>;
+    deleteProjectCollection(): Promise<void>;
+    ensureDefaultProjectCollection(): Promise<ProjectCollection>;
+    listProjects(projectCollectionId: string): Promise<ProjectManifest[]>;
+    countProjectsByCollection(): Promise<Map<string, number>>;
+    getProject(id: string): Promise<ProjectManifest | undefined>;
+    createProject(): Promise<ProjectManifest>;
+    deleteProject(): Promise<void>;
+    updateProject(id: string, updates: Partial<Pick<ProjectManifest, "name" | "version" | "description" | "thumbnailUrl" | "extensions" | "targets">>): Promise<void>;
+    duplicateProject(): Promise<ProjectManifest>;
+    copyProjectToCollection(): Promise<ProjectManifest>;
+    loadProjectFiles(id: string): Promise<ProjectFileSnapshot | undefined>;
+    saveProjectFiles(id: string, snapshot: ProjectFileSnapshot): Promise<void>;
+    applyProjectFileChanges(id: string, changes: readonly ProjectFileChange[]): Promise<void>;
+    loadAppData(id: string, key: string): Promise<string | undefined>;
+    saveAppData(id: string, key: string, data: string): Promise<void>;
+    deleteAppData(id: string, key: string): Promise<void>;
+    getProjectSession(): ProjectCollectionTabSession | undefined;
+    setProjectSession(): void;
+    getLastOpenedProject(): ProjectRef;
+    /** Ignores the write; this store's last opened project is always its folder project. */
+    setLastOpenedProject(): void;
+    private unsupported;
+    private requireProject;
+    private seedAppDataFromBase;
+    private composeManifestContent;
+    private writeManifestIfChanged;
+    private writeSnapshotDiff;
+}
+//# sourceMappingURL=workspace-folder-project-store.d.ts.map

package/dist/workspace-folder-project-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-folder-project-store.d.ts","sourceRoot":"","sources":["../src/workspace-folder-project-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,2BAA2B,EAE3B,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,YAAY,EACb,MAAM,kBAAkB,CAAC;AAW1B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAOpF,uFAAuF;AACvF,eAAO,MAAM,sCAAsC,qBAAqB,CAAC;AAEzE,4DAA4D;AAC5D,eAAO,MAAM,6BAA6B;IACxC,0EAA0E;;IAE1E,oHAAoH;;CAE5G,CAAC;AAEX,iEAAiE;AACjE,MAAM,MAAM,6BAA6B,GACvC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,OAAO,6BAA6B,CAAC,CAAC;AAErF,2DAA2D;AAC3D,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;gBAEjC,IAAI,EAAE,6BAA6B,EAAE,OAAO,EAAE,MAAM;CAKjE;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;IAChE,0EAA0E;IAC1E,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1D;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,UAAU,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,0DAA0D;IAC1D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,yEAAyE;IACzE,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC3C;AAED,uDAAuD;AACvD,MAAM,WAAW,kCAAkC;IACjD,kDAAkD;IAClD,GAAG,EAAE,kBAAkB,CAAC;IACxB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;;;OAKG;IACH,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;CAC3D;AAwBD;;;;;;;GAOG;AACH,qBAAa,2BAA4B,YAAW,YAAY;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,MAAM,CAAkC;gBAEpC,OAAO,EAAE,kCAAkC;IA6CvD;;;;;OAKG;IACH,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,GAAG,iBAAiB;IA4BjE,sBAAsB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAItD,oBAAoB,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAIzF,uBAAuB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAIrD,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC,8BAA8B,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAM5D,YAAY,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIrE,yBAAyB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIzD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAI5D,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAIzC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,aAAa,CACjB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CACd,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,CAAC,CACtG,GACA,OAAO,CAAC,IAAI,CAAC;IAMV,gBAAgB,IAAI,OAAO,CAAC,eAAe,CAAC;IAI5C,uBAAuB,IAAI,OAAO,CAAC,eAAe,CAAC;IAMnD,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAQtE,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1E,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBzF,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKjE,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D,iBAAiB,IAAI,2BAA2B,GAAG,SAAS;IAO5D,iBAAiB,IAAI,IAAI;IAIzB,oBAAoB,IAAI,UAAU;IAOlC,wFAAwF;IACxF,oBAAoB,IAAI,IAAI;IAI5B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,sBAAsB;YAwChB,sBAAsB;YAStB,iBAAiB;CAahC"}