@wendoo/bridge-app 0.2.2

package/dist/index.js

@@ -0,0 +1,19 @@
+export { createInMemoryProjectFileSystem, WENDOO_JSON_PATH } from "@wendoo/app-host";
+export { FOLDER_HOST_MODE_FOLDER, FOLDER_HOST_MODE_GLOBAL, FOLDER_HOST_MODE_URL_PARAM, FolderSessionErrorCode, } from "@wendoo/bridge-protocol";
+export { createAppBridge } from "./app-bridge.js";
+export { AppEnvironmentHost } from "./app-environment-host.js";
+export { collectBrainErrorDiagnostics, collectBrainTileCompileDiagnostics } from "./brain-diagnostics.js";
+export { CORE_LIB_COORDINATE, CORE_LIB_REFERENCE } from "./core-extension.js";
+export { findEmbeddedExtensionsMissingStableIds, formatEmbeddedExtensionIdViolations, } from "./embedded-extension-id-gate.js";
+export { CatalogMoveWarningCode, createCatalogMoveVersionLookup, ExtensionResolutionCycleError, resolveProjectExtensions, } from "./embedded-extensions.js";
+export { buildExtensionCatalog, buildExtensionCatalogOffers, buildExtensionCatalogShelf, deriveProjectPlatformStack, ExtensionActionResultCode, installEmbeddedExtension, installExtensionReference, isExtensionCompatible, satisfiesRange, uninstallExtension, } from "./extension-catalog.js";
+export { collectExtensionFetchClosure, diffProjectDiagnostics, floatingPinsFromSnapshots, movedClosureHasMissingContent, typecheckBrainProblems, } from "./extension-install.js";
+export { appendExtensionInstallLog, EXTENSION_INSTALL_LOG_APP_DATA_KEY, parseExtensionInstallLog, } from "./extension-install-log.js";
+export { presentExtensionTransaction } from "./extension-report-presenter.js";
+export { decodeInstalledSnapshotFiles, fetchedContentFromSnapshots, INSTALLED_EXTENSIONS_APP_DATA_KEY, installedExtensionMetadataFromSnapshots, installedSnapshotFromFetched, parseInstalledExtensionMetadata, parseInstalledExtensionSnapshots, reconstructInstalledSnapshotsFromTree, serializeInstalledExtensionSnapshots, } from "./fetched-extension-snapshots.js";
+export { connectFolderHostSession, createFolderCompileDiagnosticsPublisher, FolderSessionError, } from "./folder-host-session.js";
+export { addOfferedLibrary } from "./library-offer.js";
+export { collectLibraryUninstallImpact, runGuardedLibraryUninstall } from "./library-uninstall-guard.js";
+export { applyCompiledUserTiles, collectMetadataFromCompile } from "./user-tile-registration.js";
+export { createVfsAssetUrlProvider } from "./vfs-asset-url-provider.js";
+export { WORKSPACE_FOLDER_PROJECT_COLLECTION_ID, WorkspaceFolderProjectStore, WorkspaceFolderStoreError, WorkspaceFolderStoreErrorCode, } from "./workspace-folder-project-store.js";

package/dist/library-offer.d.ts

@@ -0,0 +1,60 @@
+import type { ExtensionActionResult } from "./extension-catalog.js";
+import type { ExtensionInstallReport } from "./extension-install.js";
+import type { ExtensionTransactionToasts } from "./extension-report-presenter.js";
+/**
+ * What one attempt to install a reference answers: the app's own install
+ * outcome, narrowed to what an offer needs of it. `ok: false` is an input the
+ * app could not turn into an installable reference; `ok: true` carries the
+ * extensions-map result and, when the map changed, the transaction's report.
+ */
+export type LibraryInstallAttempt = {
+    /** False: the reference did not resolve to something installable; nothing changed. */
+    readonly ok: false;
+    /** Stable code of the rejection. */
+    readonly code: string;
+    /** Human-readable failure message. */
+    readonly message: string;
+} | {
+    /** True: the reference resolved and the install action ran. */
+    readonly ok: true;
+    /** The extensions-map mutation result. */
+    readonly action: ExtensionActionResult;
+    /** The install transaction's report; absent when the action changed nothing. */
+    readonly report?: ExtensionInstallReport;
+};
+/**
+ * The toast surface a library offer reports through: the two an extension
+ * transaction always has, plus the note a commit that brought new problems with
+ * it carries.
+ */
+export interface LibraryOfferToasts extends ExtensionTransactionToasts {
+    /** The library was added, and new problems appeared with it. Names the library by display name. */
+    worsened(libraryName: string): void;
+}
+/** The app-side pieces one library offer's install runs through. */
+export interface LibraryOfferInstallSurface {
+    /** The reference the app's approved catalog installs `coordinate` by; absent when it approves none. */
+    readonly approvedReference: (coordinate: string) => string | undefined;
+    /** Run the app's install transaction for `reference`. */
+    readonly install: (reference: string) => Promise<LibraryInstallAttempt>;
+    /** The display name the app reads `coordinate` by. */
+    readonly displayName: (coordinate: string) => string;
+    /** Where the attempt's outcome is presented. */
+    readonly toasts: LibraryOfferToasts;
+}
+/**
+ * Add the library at `coordinate` through the app's own install transaction and
+ * present what happened through `surface.toasts`: a refusal as `failed`, a
+ * commit as `confirmed`, and a commit that brought new problems with it as
+ * `worsened` after the confirmation. A coordinate the app's catalog approves no
+ * reference for is refused without running anything.
+ *
+ * Answers whether this attempt put the library in the project: `false` for a
+ * refusal, for a failure, and for a library the project already held, which runs
+ * no transaction and presents nothing.
+ *
+ * @param surface - The app's approved catalog, install transaction, display names, and toasts.
+ * @param coordinate - The `<owner>/<repo>` coordinate to add.
+ */
+export declare function addOfferedLibrary(surface: LibraryOfferInstallSurface, coordinate: string): Promise<boolean>;
+//# sourceMappingURL=library-offer.d.ts.map

package/dist/library-offer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-offer.d.ts","sourceRoot":"","sources":["../src/library-offer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAGlF;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IACE,sFAAsF;IACtF,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;CAC1C,CAAC;AAEN;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,0BAA0B;IACpE,mGAAmG;IACnG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,oEAAoE;AACpE,MAAM,WAAW,0BAA0B;IACzC,uGAAuG;IACvG,QAAQ,CAAC,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvE,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxE,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BjH"}

package/dist/library-offer.js

@@ -0,0 +1,47 @@
+import { ExtensionActionResultCode } from "./extension-catalog.js";
+import { presentExtensionTransaction } from "./extension-report-presenter.js";
+/**
+ * Add the library at `coordinate` through the app's own install transaction and
+ * present what happened through `surface.toasts`: a refusal as `failed`, a
+ * commit as `confirmed`, and a commit that brought new problems with it as
+ * `worsened` after the confirmation. A coordinate the app's catalog approves no
+ * reference for is refused without running anything.
+ *
+ * Answers whether this attempt put the library in the project: `false` for a
+ * refusal, for a failure, and for a library the project already held, which runs
+ * no transaction and presents nothing.
+ *
+ * @param surface - The app's approved catalog, install transaction, display names, and toasts.
+ * @param coordinate - The `<owner>/<repo>` coordinate to add.
+ */
+export async function addOfferedLibrary(surface, coordinate) {
+    const reference = surface.approvedReference(coordinate);
+    if (reference === undefined) {
+        surface.toasts.failed({
+            code: ExtensionActionResultCode.UNKNOWN_COORDINATE,
+            message: `No approved library is shelved at "${coordinate}".`,
+        });
+        return false;
+    }
+    const attempt = await surface.install(reference);
+    if (!attempt.ok) {
+        surface.toasts.failed({ code: attempt.code, message: attempt.message });
+        return false;
+    }
+    if (!attempt.action.ok) {
+        if (attempt.action.code === ExtensionActionResultCode.ALREADY_INSTALLED) {
+            return false;
+        }
+        surface.toasts.failed({ code: attempt.action.code, message: `Adding "${coordinate}" changed nothing.` });
+        return false;
+    }
+    const libraryName = surface.displayName(coordinate);
+    presentExtensionTransaction({ report: attempt.report, flavor: "install", libraryName, toasts: surface.toasts });
+    if (attempt.report?.committed !== true) {
+        return false;
+    }
+    if (attempt.report.outcome.kind === "worsened") {
+        surface.toasts.worsened(libraryName);
+    }
+    return true;
+}

package/dist/library-uninstall-guard.d.ts

@@ -0,0 +1,66 @@
+import type { FileContent } from "@wendoo/app-host";
+import type { EmbeddedExtension, FetchedExtensionContentMap } from "./embedded-extensions.js";
+/** A saved brain checked by the uninstall guard: its display name and persisted brain JSON. */
+export interface UninstallGuardBrain {
+    /** The brain's display name, as listed to the user. */
+    readonly name: string;
+    /** The brain's persisted JSON (the plain object form of its stored bytes). */
+    readonly json: unknown;
+}
+/**
+ * What uninstalling one library takes away from a project: the namespaces
+ * leaving the resolved closure, the saved brains referencing them, and the
+ * user content files importing them.
+ */
+export interface LibraryUninstallImpact {
+    /**
+     * The `<owner>/<repo>` namespaces that leave the resolved closure when the
+     * coordinate is removed: the coordinate itself plus every transitive
+     * dependency no remaining dependent still pulls in.
+     */
+    readonly leavingNamespaces: ReadonlySet<string>;
+    /** Display names of saved brains referencing a leaving namespace, in input order. */
+    readonly brainNames: readonly string[];
+    /** Paths of user content files importing a leaving namespace through `@lib/`, in input order. */
+    readonly filePaths: readonly string[];
+}
+/**
+ * Compute what uninstalling `coordinate` takes away from a project. The
+ * leaving set is the closure delta: the origins resolved today that are no
+ * longer resolved once the coordinate's manifest entry is removed, so a
+ * transitive dependency kept alive by another dependent does not count. A
+ * brain counts as affected when any of its referenced namespaces is leaving;
+ * a file counts when any of its `@lib/` import coordinates is leaving.
+ *
+ * @param options.extensions - The project's current extensions map, keyed by coordinate.
+ * @param options.coordinate - The `<owner>/<repo>` coordinate being uninstalled.
+ * @param options.embedded - The host application's bundled embedded extensions.
+ * @param options.fetched - Installed fetched-extension content, keyed by reference.
+ * @param options.brains - The project's saved brains, each with its display name and persisted JSON.
+ * @param options.files - User content files by path; omit for a host with no user content files.
+ */
+export declare function collectLibraryUninstallImpact(options: {
+    extensions: Readonly<Record<string, string>> | undefined;
+    coordinate: string;
+    embedded: readonly EmbeddedExtension[];
+    fetched?: FetchedExtensionContentMap;
+    brains: readonly UninstallGuardBrain[];
+    files?: ReadonlyMap<string, FileContent>;
+}): LibraryUninstallImpact;
+/** Outcome of a guarded uninstall run. */
+export type LibraryUninstallGuardOutcome = "removed" | "cancelled";
+/**
+ * Run an uninstall behind the in-use guard. An empty impact uninstalls
+ * immediately; a non-empty impact asks `confirmRemoval` first and uninstalls
+ * only on an affirmative answer.
+ *
+ * @param options.impact - The computed uninstall impact.
+ * @param options.confirmRemoval - Asks the user to confirm removing an in-use library.
+ * @param options.uninstall - Performs the uninstall.
+ */
+export declare function runGuardedLibraryUninstall(options: {
+    impact: Pick<LibraryUninstallImpact, "brainNames" | "filePaths">;
+    confirmRemoval: () => boolean | Promise<boolean>;
+    uninstall: () => void | Promise<void>;
+}): Promise<LibraryUninstallGuardOutcome>;
+//# sourceMappingURL=library-uninstall-guard.d.ts.map

package/dist/library-uninstall-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-uninstall-guard.d.ts","sourceRoot":"","sources":["../src/library-uninstall-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAG9F,+FAA+F;AAC/F,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChD,qFAAqF;IACrF,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,iGAAiG;IACjG,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAmCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvC,KAAK,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC1C,GAAG,sBAAsB,CA2CzB;AAED,0CAA0C;AAC1C,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,WAAW,CAAC;AAEnE;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,MAAM,EAAE,IAAI,CAAC,sBAAsB,EAAE,YAAY,GAAG,WAAW,CAAC,CAAC;IACjE,cAAc,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,SAAS,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAOxC"}

package/dist/library-uninstall-guard.js

@@ -0,0 +1,103 @@
+import { fileContentText } from "@wendoo/app-host";
+import { renameBrainNamespaces } from "@wendoo/core/app";
+import { EXTENSION_IMPORT_PREFIX } from "@wendoo/ts-compiler";
+import { resolveProjectExtensions } from "./embedded-extensions.js";
+/** Collect every library namespace a persisted brain references. */
+function collectBrainNamespaces(json) {
+    const namespaces = new Set();
+    renameBrainNamespaces(json, (namespace) => {
+        namespaces.add(namespace);
+        return namespace;
+    });
+    return namespaces;
+}
+/** The `<owner>/<repo>` coordinates a file's `@lib/` import specifiers name. */
+function collectFileImportCoordinates(content) {
+    const coordinates = new Set();
+    const pattern = new RegExp(`["']${EXTENSION_IMPORT_PREFIX}([^"'\\s]+)["']`, "g");
+    for (const match of content.matchAll(pattern)) {
+        const segments = match[1].split("/");
+        if (segments.length >= 2 && segments[0].length > 0 && segments[1].length > 0) {
+            coordinates.add(`${segments[0]}/${segments[1]}`);
+        }
+    }
+    return coordinates;
+}
+/** The set of origin namespaces in the resolved closure of an extensions map. */
+function resolvedNamespaces(extensions, embedded, fetched) {
+    const resolved = resolveProjectExtensions(extensions, { embedded, fetched });
+    return new Set(resolved.dependencyMounts.map((mount) => mount.namespace));
+}
+/**
+ * Compute what uninstalling `coordinate` takes away from a project. The
+ * leaving set is the closure delta: the origins resolved today that are no
+ * longer resolved once the coordinate's manifest entry is removed, so a
+ * transitive dependency kept alive by another dependent does not count. A
+ * brain counts as affected when any of its referenced namespaces is leaving;
+ * a file counts when any of its `@lib/` import coordinates is leaving.
+ *
+ * @param options.extensions - The project's current extensions map, keyed by coordinate.
+ * @param options.coordinate - The `<owner>/<repo>` coordinate being uninstalled.
+ * @param options.embedded - The host application's bundled embedded extensions.
+ * @param options.fetched - Installed fetched-extension content, keyed by reference.
+ * @param options.brains - The project's saved brains, each with its display name and persisted JSON.
+ * @param options.files - User content files by path; omit for a host with no user content files.
+ */
+export function collectLibraryUninstallImpact(options) {
+    const current = options.extensions ?? {};
+    const next = {};
+    for (const [key, value] of Object.entries(current)) {
+        if (key !== options.coordinate) {
+            next[key] = value;
+        }
+    }
+    const remaining = resolvedNamespaces(next, options.embedded, options.fetched);
+    const leavingNamespaces = new Set();
+    for (const namespace of resolvedNamespaces(current, options.embedded, options.fetched)) {
+        if (!remaining.has(namespace)) {
+            leavingNamespaces.add(namespace);
+        }
+    }
+    const brainNames = [];
+    for (const brain of options.brains) {
+        const referenced = collectBrainNamespaces(brain.json);
+        for (const namespace of leavingNamespaces) {
+            if (referenced.has(namespace)) {
+                brainNames.push(brain.name);
+                break;
+            }
+        }
+    }
+    const filePaths = [];
+    for (const [path, content] of options.files ?? []) {
+        const text = fileContentText(content);
+        if (text === undefined) {
+            continue;
+        }
+        const imported = collectFileImportCoordinates(text);
+        for (const namespace of leavingNamespaces) {
+            if (imported.has(namespace)) {
+                filePaths.push(path);
+                break;
+            }
+        }
+    }
+    return { leavingNamespaces, brainNames, filePaths };
+}
+/**
+ * Run an uninstall behind the in-use guard. An empty impact uninstalls
+ * immediately; a non-empty impact asks `confirmRemoval` first and uninstalls
+ * only on an affirmative answer.
+ *
+ * @param options.impact - The computed uninstall impact.
+ * @param options.confirmRemoval - Asks the user to confirm removing an in-use library.
+ * @param options.uninstall - Performs the uninstall.
+ */
+export async function runGuardedLibraryUninstall(options) {
+    const inUse = options.impact.brainNames.length > 0 || options.impact.filePaths.length > 0;
+    if (inUse && !(await options.confirmRemoval())) {
+        return "cancelled";
+    }
+    await options.uninstall();
+    return "removed";
+}

package/dist/manifest-files.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Queries and edits over a project content manifest's `files` list: the list
+ * names what is in the build, while the project may hold more files than it
+ * lists. Membership tells the two apart; the only error direction is a listed
+ * file that is absent from the project. The edit helpers toggle one entry in
+ * the manifest's JSON text while leaving every other byte of the document
+ * untouched.
+ */
+/**
+ * Normalize a manifest `files` entry or project file path for comparison by
+ * stripping leading `./` and `/` segments. `"./a.ts"`, `"/a.ts"`, and
+ * `"a.ts"` all normalize to `"a.ts"`.
+ */
+export declare function normalizeManifestFilePath(path: string): string;
+/**
+ * True when `path` is named by the manifest `files` list, comparing both
+ * sides with {@link normalizeManifestFilePath}.
+ */
+export declare function isFileInBuild(files: readonly string[], path: string): boolean;
+/**
+ * Return the `files` entries, as written, whose normalized path `exists`
+ * rejects. An empty result means every listed file is present. Paths absent
+ * from `files` are never reported, whatever `exists` answers for them.
+ *
+ * @param files - The manifest `files` list.
+ * @param exists - Presence test invoked with each entry's normalized path.
+ */
+export declare function findMissingListedFiles(files: readonly string[], exists: (path: string) => boolean): readonly string[];
+/**
+ * Read the `files` list from a manifest's JSON text without validating the
+ * rest of the document. Returns the string entries when the document is a
+ * JSON object whose `files` is an array holding at least one string, and
+ * `undefined` otherwise (including unparseable text).
+ */
+export declare function readManifestFilesList(manifestText: string): readonly string[] | undefined;
+/**
+ * Add `path` (normalized) to the manifest text's `files` array, preserving
+ * every byte of the document outside that array and matching the array's
+ * existing one-entry-per-line or single-line formatting. Returns the edited
+ * text, or `undefined` when the document has no well-formed root-level
+ * string-array `files`, the entry is already listed, or the edit would not
+ * produce valid JSON.
+ */
+export declare function addManifestFilesEntry(manifestText: string, path: string): string | undefined;
+/**
+ * Remove every `files` entry matching `path` (compared normalized) from the
+ * manifest text, preserving every byte of the document outside the `files`
+ * array. Returns the edited text, or `undefined` when the document has no
+ * well-formed root-level string-array `files`, no entry matches, or the edit
+ * would not produce valid JSON. Removing the last entry leaves `[]`.
+ */
+export declare function removeManifestFilesEntry(manifestText: string, path: string): string | undefined;
+//# sourceMappingURL=manifest-files.d.ts.map

package/dist/manifest-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-files.d.ts","sourceRoot":"","sources":["../src/manifest-files.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW9D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG7E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,MAAM,EAAE,CAErH;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAgBzF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmB5F;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoB/F"}

package/dist/manifest-files.js

@@ -0,0 +1,242 @@
+/**
+ * Queries and edits over a project content manifest's `files` list: the list
+ * names what is in the build, while the project may hold more files than it
+ * lists. Membership tells the two apart; the only error direction is a listed
+ * file that is absent from the project. The edit helpers toggle one entry in
+ * the manifest's JSON text while leaving every other byte of the document
+ * untouched.
+ */
+/**
+ * Normalize a manifest `files` entry or project file path for comparison by
+ * stripping leading `./` and `/` segments. `"./a.ts"`, `"/a.ts"`, and
+ * `"a.ts"` all normalize to `"a.ts"`.
+ */
+export function normalizeManifestFilePath(path) {
+    let result = path;
+    for (;;) {
+        if (result.startsWith("./")) {
+            result = result.slice(2);
+        }
+        else if (result.startsWith("/")) {
+            result = result.slice(1);
+        }
+        else {
+            return result;
+        }
+    }
+}
+/**
+ * True when `path` is named by the manifest `files` list, comparing both
+ * sides with {@link normalizeManifestFilePath}.
+ */
+export function isFileInBuild(files, path) {
+    const target = normalizeManifestFilePath(path);
+    return files.some((entry) => normalizeManifestFilePath(entry) === target);
+}
+/**
+ * Return the `files` entries, as written, whose normalized path `exists`
+ * rejects. An empty result means every listed file is present. Paths absent
+ * from `files` are never reported, whatever `exists` answers for them.
+ *
+ * @param files - The manifest `files` list.
+ * @param exists - Presence test invoked with each entry's normalized path.
+ */
+export function findMissingListedFiles(files, exists) {
+    return files.filter((entry) => !exists(normalizeManifestFilePath(entry)));
+}
+/**
+ * Read the `files` list from a manifest's JSON text without validating the
+ * rest of the document. Returns the string entries when the document is a
+ * JSON object whose `files` is an array holding at least one string, and
+ * `undefined` otherwise (including unparseable text).
+ */
+export function readManifestFilesList(manifestText) {
+    let parsed;
+    try {
+        parsed = JSON.parse(manifestText);
+    }
+    catch {
+        return undefined;
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return undefined;
+    }
+    const files = parsed.files;
+    if (!Array.isArray(files)) {
+        return undefined;
+    }
+    const entries = files.filter((entry) => typeof entry === "string");
+    return entries.length > 0 ? entries : undefined;
+}
+/**
+ * Add `path` (normalized) to the manifest text's `files` array, preserving
+ * every byte of the document outside that array and matching the array's
+ * existing one-entry-per-line or single-line formatting. Returns the edited
+ * text, or `undefined` when the document has no well-formed root-level
+ * string-array `files`, the entry is already listed, or the edit would not
+ * produce valid JSON.
+ */
+export function addManifestFilesEntry(manifestText, path) {
+    const span = findFilesArray(manifestText);
+    if (span === undefined)
+        return undefined;
+    const target = normalizeManifestFilePath(path);
+    if (span.elements.some((element) => normalizeManifestFilePath(element.value) === target)) {
+        return undefined;
+    }
+    const entryText = JSON.stringify(target);
+    let edited;
+    if (span.elements.length === 0) {
+        edited = manifestText.slice(0, span.start + 1) + entryText + manifestText.slice(span.end);
+    }
+    else {
+        const first = span.elements[0];
+        const last = span.elements[span.elements.length - 1];
+        const leading = manifestText.slice(span.start + 1, first.start);
+        const separator = `,${leading === "" ? " " : leading}`;
+        edited = manifestText.slice(0, last.end) + separator + entryText + manifestText.slice(last.end);
+    }
+    return isValidJson(edited) ? edited : undefined;
+}
+/**
+ * Remove every `files` entry matching `path` (compared normalized) from the
+ * manifest text, preserving every byte of the document outside the `files`
+ * array. Returns the edited text, or `undefined` when the document has no
+ * well-formed root-level string-array `files`, no entry matches, or the edit
+ * would not produce valid JSON. Removing the last entry leaves `[]`.
+ */
+export function removeManifestFilesEntry(manifestText, path) {
+    const span = findFilesArray(manifestText);
+    if (span === undefined)
+        return undefined;
+    const target = normalizeManifestFilePath(path);
+    const kept = span.elements.filter((element) => normalizeManifestFilePath(element.value) !== target);
+    if (kept.length === span.elements.length)
+        return undefined;
+    let content;
+    if (kept.length === 0) {
+        content = "";
+    }
+    else {
+        const first = span.elements[0];
+        const last = span.elements[span.elements.length - 1];
+        const leading = manifestText.slice(span.start + 1, first.start);
+        const trailing = manifestText.slice(last.end, span.end);
+        const separator = span.elements.length >= 2 ? manifestText.slice(span.elements[0].end, span.elements[1].start) : "";
+        content =
+            leading + kept.map((element) => manifestText.slice(element.start, element.end)).join(separator) + trailing;
+    }
+    const edited = manifestText.slice(0, span.start + 1) + content + manifestText.slice(span.end);
+    return isValidJson(edited) ? edited : undefined;
+}
+/**
+ * Locate the root-level `files` array in JSON text. Only a `files` key of the
+ * document's root object counts; the same key nested deeper, or the word
+ * inside a string value, is ignored. Returns `undefined` when the key is
+ * absent, its value is not an array of strings, or the text is malformed.
+ */
+function findFilesArray(text) {
+    const stack = [];
+    let i = 0;
+    while (i < text.length) {
+        const ch = text[i];
+        if (ch === '"') {
+            const token = scanString(text, i);
+            if (token === undefined)
+                return undefined;
+            if (stack.length === 1 && stack[0] === "{" && token.value === "files") {
+                const colon = skipWhitespace(text, token.end);
+                if (text[colon] === ":") {
+                    const open = skipWhitespace(text, colon + 1);
+                    if (text[open] !== "[")
+                        return undefined;
+                    return scanFilesArray(text, open);
+                }
+            }
+            i = token.end;
+            continue;
+        }
+        if (ch === "{" || ch === "[") {
+            stack.push(ch);
+        }
+        else if (ch === "}" || ch === "]") {
+            stack.pop();
+        }
+        i++;
+    }
+    return undefined;
+}
+/** Scan the `files` array starting at its `[`; strings at element depth become elements. */
+function scanFilesArray(text, open) {
+    const elements = [];
+    let depth = 1;
+    let i = open + 1;
+    while (i < text.length) {
+        const ch = text[i];
+        if (ch === '"') {
+            const token = scanString(text, i);
+            if (token === undefined)
+                return undefined;
+            if (depth !== 1)
+                return undefined;
+            elements.push(token);
+            i = token.end;
+            continue;
+        }
+        if (ch === "{" || ch === "[") {
+            depth++;
+        }
+        else if (ch === "}" || ch === "]") {
+            depth--;
+            if (depth === 0) {
+                if (ch !== "]")
+                    return undefined;
+                return { start: open, end: i, elements };
+            }
+        }
+        else if (ch !== "," && ch !== " " && ch !== "\t" && ch !== "\n" && ch !== "\r") {
+            return undefined;
+        }
+        i++;
+    }
+    return undefined;
+}
+/** Scan one JSON string token starting at its opening quote. */
+function scanString(text, start) {
+    let i = start + 1;
+    while (i < text.length) {
+        const ch = text[i];
+        if (ch === "\\") {
+            i += 2;
+            continue;
+        }
+        if (ch === '"') {
+            const end = i + 1;
+            try {
+                return { start, end, value: JSON.parse(text.slice(start, end)) };
+            }
+            catch {
+                return undefined;
+            }
+        }
+        i++;
+    }
+    return undefined;
+}
+/** Index of the first non-whitespace character at or after `from`. */
+function skipWhitespace(text, from) {
+    let i = from;
+    while (i < text.length && (text[i] === " " || text[i] === "\t" || text[i] === "\n" || text[i] === "\r")) {
+        i++;
+    }
+    return i;
+}
+function isValidJson(text) {
+    try {
+        JSON.parse(text);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/node.d.ts

@@ -0,0 +1,4 @@
+export { buildEmbeddedExtensionFromDir, extensionSourceFiles, findMissingExtensionFiles, } from "./embedded-extension-loader.js";
+export type { EmbeddedExtensionRegistration, EmbeddedExtensionsVitePlugin, } from "./embedded-extension-vite-plugin.js";
+export { EMBEDDED_EXTENSIONS_MODULE_ID, embeddedExtensionsVitePlugin } from "./embedded-extension-vite-plugin.js";
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/node.js

@@ -0,0 +1,2 @@
+export { buildEmbeddedExtensionFromDir, extensionSourceFiles, findMissingExtensionFiles, } from "./embedded-extension-loader.js";
+export { EMBEDDED_EXTENSIONS_MODULE_ID, embeddedExtensionsVitePlugin } from "./embedded-extension-vite-plugin.js";

package/dist/project-file-bridge.d.ts

@@ -0,0 +1,10 @@
+import type { ProjectFileChange, ProjectFileSnapshot } from "@wendoo/app-host";
+import type { FileSystemSnapshot } from "@wendoo/bridge-client";
+import type { FileSystemNotification } from "@wendoo/bridge-protocol";
+/** Convert an app-host project file snapshot into a bridge-client snapshot. */
+export declare function toFileSystemSnapshot(snapshot: ProjectFileSnapshot): FileSystemSnapshot;
+/** Convert an app-host project file mutation into a bridge protocol notification. */
+export declare function toFileSystemNotification(change: ProjectFileChange): FileSystemNotification;
+/** Convert a bridge protocol notification into an app-host project file mutation. */
+export declare function toProjectFileChange(notification: FileSystemNotification): ProjectFileChange;
+//# sourceMappingURL=project-file-bridge.d.ts.map

package/dist/project-file-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-file-bridge.d.ts","sourceRoot":"","sources":["../src/project-file-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAA0B,MAAM,kBAAkB,CAAC;AAEvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,kBAAkB,CAEtF;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,sBAAsB,CA+B1F;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,sBAAsB,GAAG,iBAAiB,CA+B3F"}