@oscharko-dev/keiko-contracts 0.2.8 → 0.2.9

package/dist/editor-builtin-capabilities.js

@@ -0,0 +1,135 @@
+// Editor built-in capability registry (Issue #1380, Epic #1491, ADR-0068 D1/D6). This is the single,
+// authoritative, frozen const table describing, per known source language, the **browser** built-in
+// editor capabilities: whether Monaco tokenises/colours it locally, whether bracket matching applies,
+// and — crucially — *how* its "Format Document" command is served in the browser.
+//
+// It sits BESIDE the source-language mode map (`editor-language-mode-map.ts`, ADR-0067 D1), not inside
+// it (ADR-0068 D2): the mode map is the SERVER-SHARED source-language universe; browser formatting
+// reachability and Monaco syntax/bracket semantics are an editor-tier concern the server has no
+// business consuming. Folding `documentFormatting` into the mode map would invite a future server
+// consumer to misread it as *server* formatting capability — the exact "server can format yaml, the
+// browser can't" confusion this registry exists to end. The two leaves are kept coherent by test
+// (ADR-0068 D6), not by a runtime import coupling.
+//
+// Leaf-package rules (ADR-0019): pure types and frozen const tables plus pure functions only. No
+// filesystem, no clock, no crypto, no randomness, and no imports of other `@oscharko-dev/keiko-*`
+// packages. `plaintext` is deliberately ABSENT (ADR-0067 D5): it is the editor's render fallback for
+// unknown/unsupported buffers, never a known source language, and has no built-in formatter.
+// The canonical table, covering exactly the 15 `EDITOR_LANGUAGE_MODE_IDS` languages. The
+// `documentFormatting` split (ADR-0068 D1): ts/js → the Keiko language-service bridge; the
+// json/css/scss/less/html set → Monaco's bundled workers ("JSON/CSS/HTML … where safe"); everything
+// else → "none" (no reachable in-browser formatter). `as const` makes every entry deeply readonly at
+// compile time; each entry and the outer array are `Object.freeze`d below so the registry is deeply
+// immutable at runtime too — no consumer holding a reference can mutate it.
+const RAW_EDITOR_BUILTIN_CAPABILITIES = [
+    {
+        languageId: "typescript",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "keiko-language-service",
+    },
+    {
+        languageId: "javascript",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "keiko-language-service",
+    },
+    {
+        languageId: "json",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "monaco-builtin",
+    },
+    {
+        languageId: "css",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "monaco-builtin",
+    },
+    {
+        languageId: "scss",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "monaco-builtin",
+    },
+    {
+        languageId: "less",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "monaco-builtin",
+    },
+    {
+        languageId: "html",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "monaco-builtin",
+    },
+    {
+        languageId: "markdown",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "none",
+    },
+    {
+        languageId: "yaml",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "none",
+    },
+    {
+        languageId: "python",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "none",
+    },
+    {
+        languageId: "java",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "none",
+    },
+    {
+        languageId: "go",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "none",
+    },
+    {
+        languageId: "rust",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "none",
+    },
+    {
+        languageId: "sql",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "none",
+    },
+    {
+        languageId: "shell",
+        syntaxHighlighting: true,
+        bracketMatching: true,
+        documentFormatting: "none",
+    },
+];
+export const EDITOR_BUILTIN_CAPABILITIES = Object.freeze(RAW_EDITOR_BUILTIN_CAPABILITIES.map((capability) => Object.freeze({ ...capability })));
+// languageId -> capability, derived from the table. Frozen. Every registry id appears here.
+export const EDITOR_BUILTIN_CAPABILITY_BY_LANGUAGE = Object.freeze(EDITOR_BUILTIN_CAPABILITIES.reduce((accumulator, capability) => {
+    accumulator[capability.languageId] = capability;
+    return accumulator;
+}, {}));
+// The built-in capability for a language id, or `null` when the id is not a known source language.
+export function editorBuiltinCapability(languageId) {
+    return EDITOR_BUILTIN_CAPABILITY_BY_LANGUAGE[languageId] ?? null;
+}
+// How a language's "Format Document" is served in the browser. Unknown ids are `"none"`: an
+// unsupported buffer has no reachable in-browser formatter, matching the mode map's safe-degrade.
+export function editorBuiltinDocumentFormatting(languageId) {
+    return editorBuiltinCapability(languageId)?.documentFormatting ?? "none";
+}
+// True when *some* in-browser document formatter is reachable for the language (Monaco-builtin or the
+// Keiko language-service bridge); false for unknown ids and for the `"none"` set.
+export function isBuiltinFormattingAvailable(languageId) {
+    return editorBuiltinDocumentFormatting(languageId) !== "none";
+}

package/dist/editor-language-mode-map.d.ts

@@ -0,0 +1,11 @@
+export interface EditorLanguageMode {
+    readonly languageId: string;
+    readonly fileExtensions: readonly string[];
+    readonly syntaxHighlighting: boolean;
+}
+export declare const EDITOR_LANGUAGE_MODE_MAP: readonly EditorLanguageMode[];
+export declare const EDITOR_LANGUAGE_MODE_IDS: readonly string[];
+export declare const EDITOR_LANGUAGE_MODE_BY_EXTENSION: Readonly<Record<string, string>>;
+export declare function inferEditorLanguageModeId(pathOrName: string): string | null;
+export declare function isEditorLanguageModeId(value: string): boolean;
+//# sourceMappingURL=editor-language-mode-map.d.ts.map

package/dist/editor-language-mode-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-language-mode-map.d.ts","sourceRoot":"","sources":["../src/editor-language-mode-map.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AAkCD,eAAO,MAAM,wBAAwB,EAAE,SAAS,kBAAkB,EAIjE,CAAC;AAGF,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAErD,CAAC;AAGF,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO9E,CAAC;AAuBF,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3E;AAMD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7D"}

package/dist/editor-language-mode-map.js

@@ -0,0 +1,89 @@
+// Canonical editor language mode map (Issue #1379, Epic #1491, ADR-0067 D1). This is the single,
+// authoritative, frozen const table describing the known SOURCE-LANGUAGE universe shared by the
+// browser editor tier (`keiko-editor`) and the server language service (`keiko-server`). It answers
+// the issue's "language id", "file-extension matching", and "syntax support" dimensions with data,
+// not with code scattered across packages.
+//
+// It enumerates exactly the source languages the product knows. `plaintext` is deliberately EXCLUDED
+// (ADR-0067 D5): it is the editor's render fallback for unknown/unsupported buffers, not a known
+// source language the registry advertises. "known" (AC2) is exactly this id set; everything else
+// degrades to plain text without governed intelligence (AC3) — the two sets are disjoint by design.
+//
+// Leaf-package rules (ADR-0019): pure types and frozen const tables plus pure functions only. No
+// filesystem, no clock, no crypto, no randomness, and no imports of other `@oscharko-dev/keiko-*`
+// packages. The small basename/extension helper is re-implemented locally rather than imported from
+// `keiko-editor` so this module stays a strict, browser-importable leaf.
+// The canonical table. Extensions match `keiko-editor`'s historic `MONACO_LANGUAGE_BY_EXTENSION`
+// keys exactly (including the TSX -> typescript / JSX -> javascript fold) so the editor's inference
+// behaviour is unchanged when it derives from this table (ADR-0067 D2). `as const` makes every entry
+// and extension list deeply readonly at compile time; the entries, their `fileExtensions` arrays, and
+// the outer array are each `Object.freeze`d so the shared universe is deeply immutable at runtime too
+// — no consumer holding a reference to an entry can mutate it.
+const RAW_EDITOR_LANGUAGE_MODES = [
+    {
+        languageId: "typescript",
+        fileExtensions: ["ts", "mts", "cts", "tsx"],
+        syntaxHighlighting: true,
+    },
+    {
+        languageId: "javascript",
+        fileExtensions: ["js", "mjs", "cjs", "jsx"],
+        syntaxHighlighting: true,
+    },
+    { languageId: "json", fileExtensions: ["json", "jsonc"], syntaxHighlighting: true },
+    { languageId: "css", fileExtensions: ["css"], syntaxHighlighting: true },
+    { languageId: "scss", fileExtensions: ["scss"], syntaxHighlighting: true },
+    { languageId: "less", fileExtensions: ["less"], syntaxHighlighting: true },
+    { languageId: "html", fileExtensions: ["html", "htm"], syntaxHighlighting: true },
+    { languageId: "markdown", fileExtensions: ["md", "markdown"], syntaxHighlighting: true },
+    { languageId: "yaml", fileExtensions: ["yaml", "yml"], syntaxHighlighting: true },
+    { languageId: "python", fileExtensions: ["py", "pyi"], syntaxHighlighting: true },
+    { languageId: "java", fileExtensions: ["java"], syntaxHighlighting: true },
+    { languageId: "go", fileExtensions: ["go"], syntaxHighlighting: true },
+    { languageId: "rust", fileExtensions: ["rs"], syntaxHighlighting: true },
+    { languageId: "sql", fileExtensions: ["sql"], syntaxHighlighting: true },
+    { languageId: "shell", fileExtensions: ["sh", "bash", "zsh"], syntaxHighlighting: true },
+];
+export const EDITOR_LANGUAGE_MODE_MAP = Object.freeze(RAW_EDITOR_LANGUAGE_MODES.map((mode) => Object.freeze({ ...mode, fileExtensions: Object.freeze([...mode.fileExtensions]) })));
+// The canonical language ids, derived from the map. Frozen.
+export const EDITOR_LANGUAGE_MODE_IDS = Object.freeze(EDITOR_LANGUAGE_MODE_MAP.map((mode) => mode.languageId));
+// Extension -> languageId, derived from the map. Frozen. Every extension in the map appears here.
+export const EDITOR_LANGUAGE_MODE_BY_EXTENSION = Object.freeze(EDITOR_LANGUAGE_MODE_MAP.reduce((accumulator, mode) => {
+    for (const extension of mode.fileExtensions) {
+        accumulator[extension] = mode.languageId;
+    }
+    return accumulator;
+}, {}));
+// Final path segment (basename) from a POSIX or Windows path. Pure, allocation-light.
+function modeMapBasename(pathOrName) {
+    const segments = pathOrName.split(/[/\\]/u);
+    return segments[segments.length - 1] ?? pathOrName;
+}
+// Lower-case extension (without the leading dot) of a file name, or "" when there is none. A leading
+// dot is treated as "no extension" (dotfiles such as `.gitignore` have no source language). Mirrors
+// `keiko-editor`'s `fileExtension` rules exactly so the two tiers agree on extension matching.
+function modeMapExtension(pathOrName) {
+    const name = modeMapBasename(pathOrName).trim();
+    const dot = name.lastIndexOf(".");
+    if (dot <= 0 || dot === name.length - 1) {
+        return "";
+    }
+    return name.slice(dot + 1).toLowerCase();
+}
+// Infer the canonical source-language id for a file name or path, or `null` when the buffer is not a
+// known source language (unknown extension, dotfile, extension-less name, or empty input). `null` is
+// the AC3 safe-degrade signal: such buffers render as plain text with no governed intelligence.
+export function inferEditorLanguageModeId(pathOrName) {
+    const extension = modeMapExtension(pathOrName);
+    if (extension === "") {
+        return null;
+    }
+    return EDITOR_LANGUAGE_MODE_BY_EXTENSION[extension] ?? null;
+}
+// Runtime membership check: is `value` one of the canonical mode-map language ids? This is a plain
+// boolean predicate, not a narrowing type guard — the mode ids are `string` (the contract names no
+// concrete language literal type), so a `value is …` annotation would narrow nothing and mislead
+// callers.
+export function isEditorLanguageModeId(value) {
+    return EDITOR_LANGUAGE_MODE_IDS.includes(value);
+}

package/dist/editor-layout.d.ts

@@ -1,3 +1,33 @@
+/**
+ * Editor layout state and reducer for multi-tab, split-pane workspaces (Issue #1375, ADR-0064).
+ *
+ * The reducer is the single authority for layout structure: drag/keyboard intents in the UI are
+ * translated into EditorLayoutActions and applied here, never by mutating pane state directly.
+ * editorLayoutReducer is pure and total — it returns a structurally valid EditorLayoutStateV2 for
+ * every action and returns the input state unchanged for actions that target a missing pane, split,
+ * or file.
+ *
+ * Invariants maintained by every operation:
+ *
+ * 1. Tab order is stable and lossless. Within a pane openFiles and tabOrder are the same
+ *    de-duplicated, non-empty list; reorder/move only permute it. The order survives a
+ *    serialize -> parse round trip, so tabs never shuffle on reload (AC1).
+ * 2. Layout operations never read or write file content or dirty state. Files are identified by
+ *    path only, so reordering or moving a tab cannot alter a buffer or its dirty marker (AC2/AC3);
+ *    the dirty index is re-homed onto the layout by the UI layer.
+ * 3. Empty panes collapse predictably. Closing or moving the last tab out of a pane removes that
+ *    pane (when others remain) and promotes the sibling of its enclosing split, so the tree never
+ *    retains an empty pane alongside populated ones (AC4). The final remaining pane is kept even
+ *    when it holds no file.
+ * 4. Splits always have exactly two children and resize never restructures. resize-split only
+ *    clamps an existing split's ratio into [MIN_SPLIT_RATIO, MAX_SPLIT_RATIO]; it adds or removes
+ *    no pane, so nested splits resize without orphan panes or layout jumps (AC5).
+ * 5. Identifiers are unique. Pane ids (pane-N) and split ids (split-N) are allocated to avoid
+ *    collisions with existing nodes, and every tree pane node resolves to an entry in panes.
+ * 6. Persisted values are clamped on read and write. Split ratios and the sidebar width are
+ *    clamped, and unknown or malformed persisted state falls back to a fresh single-pane layout
+ *    rather than blocking the editor.
+ */
 export declare const EDITOR_LAYOUT_SCHEMA_VERSION: 2;
 export type EditorSplitDirection = "row" | "column";
 export type EditorSplitDropZone = "left" | "right" | "top" | "bottom" | "center";
@@ -85,6 +115,13 @@ export type EditorLayoutAction = {
     readonly type: "replace-root";
     readonly root: string;
     readonly sidebarWidth?: number | undefined;
+} | {
+    readonly type: "rename-file";
+    readonly from: string;
+    readonly to: string;
+} | {
+    readonly type: "remove-file";
+    readonly file: string;
 };
 export interface CreateEditorLayoutStateV2Input {
     readonly root: string;

package/dist/editor-layout.d.ts.map

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

package/dist/editor-layout.js

@@ -1,3 +1,33 @@
+/**
+ * Editor layout state and reducer for multi-tab, split-pane workspaces (Issue #1375, ADR-0064).
+ *
+ * The reducer is the single authority for layout structure: drag/keyboard intents in the UI are
+ * translated into EditorLayoutActions and applied here, never by mutating pane state directly.
+ * editorLayoutReducer is pure and total — it returns a structurally valid EditorLayoutStateV2 for
+ * every action and returns the input state unchanged for actions that target a missing pane, split,
+ * or file.
+ *
+ * Invariants maintained by every operation:
+ *
+ * 1. Tab order is stable and lossless. Within a pane openFiles and tabOrder are the same
+ *    de-duplicated, non-empty list; reorder/move only permute it. The order survives a
+ *    serialize -> parse round trip, so tabs never shuffle on reload (AC1).
+ * 2. Layout operations never read or write file content or dirty state. Files are identified by
+ *    path only, so reordering or moving a tab cannot alter a buffer or its dirty marker (AC2/AC3);
+ *    the dirty index is re-homed onto the layout by the UI layer.
+ * 3. Empty panes collapse predictably. Closing or moving the last tab out of a pane removes that
+ *    pane (when others remain) and promotes the sibling of its enclosing split, so the tree never
+ *    retains an empty pane alongside populated ones (AC4). The final remaining pane is kept even
+ *    when it holds no file.
+ * 4. Splits always have exactly two children and resize never restructures. resize-split only
+ *    clamps an existing split's ratio into [MIN_SPLIT_RATIO, MAX_SPLIT_RATIO]; it adds or removes
+ *    no pane, so nested splits resize without orphan panes or layout jumps (AC5).
+ * 5. Identifiers are unique. Pane ids (pane-N) and split ids (split-N) are allocated to avoid
+ *    collisions with existing nodes, and every tree pane node resolves to an entry in panes.
+ * 6. Persisted values are clamped on read and write. Split ratios and the sidebar width are
+ *    clamped, and unknown or malformed persisted state falls back to a fresh single-pane layout
+ *    rather than blocking the editor.
+ */
 export const EDITOR_LAYOUT_SCHEMA_VERSION = 2;
 const MIN_SPLIT_RATIO = 15;
 const MAX_SPLIT_RATIO = 85;
@@ -70,7 +100,9 @@ function paneIdsFromTree(node, out = []) {
     return out;
 }
 function normalizePaneNode(value, panes) {
-    if (value.type === "pane" && typeof value.paneId === "string" && panes[value.paneId] !== undefined) {
+    if (value.type === "pane" &&
+        typeof value.paneId === "string" &&
+        panes[value.paneId] !== undefined) {
         return { type: "pane", paneId: value.paneId };
     }
     return null;
@@ -245,7 +277,9 @@ export function editorLayoutPanes(layout) {
         .filter((pane) => pane !== undefined);
 }
 export function activeEditorPane(layout) {
-    return layout.panes[layout.activePaneId] ?? editorLayoutPanes(layout)[0] ?? createPane("pane-1", "", []);
+    return (layout.panes[layout.activePaneId] ??
+        editorLayoutPanes(layout)[0] ??
+        createPane("pane-1", "", []));
 }
 function updatePane(layout, paneId, update) {
     const pane = layout.panes[paneId];
@@ -263,7 +297,12 @@ function insertFile(files, file, index) {
 }
 function withPaneFiles(pane, files, activeFile) {
     const tabOrder = orderedFiles(activeFile, files);
-    return { ...pane, openFiles: tabOrder, tabOrder, activeFile: activeFile.length > 0 ? activeFile : (tabOrder[0] ?? "") };
+    return {
+        ...pane,
+        openFiles: tabOrder,
+        tabOrder,
+        activeFile: activeFile.length > 0 ? activeFile : (tabOrder[0] ?? ""),
+    };
 }
 function nextPaneId(layout) {
     let index = Object.keys(layout.panes).length + 1;
@@ -353,7 +392,9 @@ function removePane(layout, paneId) {
         if (id !== paneId)
             panes[id] = pane;
     }
-    const nextActivePaneId = layout.activePaneId === paneId ? (paneIdsFromTree(nextTree)[0] ?? layout.activePaneId) : layout.activePaneId;
+    const nextActivePaneId = layout.activePaneId === paneId
+        ? (paneIdsFromTree(nextTree)[0] ?? layout.activePaneId)
+        : layout.activePaneId;
     return { ...layout, tree: nextTree, panes, activePaneId: nextActivePaneId };
 }
 function closeTab(layout, paneId, file) {
@@ -367,7 +408,9 @@ function closeTab(layout, paneId, file) {
             return removePane(layout, paneId);
         return updatePane(layout, paneId, (current) => withPaneFiles(current, [], ""));
     }
-    const nextActive = pane.activeFile === file ? (nextFiles[closingIndex] ?? nextFiles[closingIndex - 1] ?? nextFiles[0] ?? "") : pane.activeFile;
+    const nextActive = pane.activeFile === file
+        ? (nextFiles[closingIndex] ?? nextFiles[closingIndex - 1] ?? nextFiles[0] ?? "")
+        : pane.activeFile;
     return updatePane(layout, paneId, (current) => withPaneFiles(current, nextFiles, nextActive));
 }
 function moveTab(layout, fromPaneId, toPaneId, file, targetIndex) {
@@ -384,6 +427,70 @@ function moveTab(layout, fromPaneId, toPaneId, file, targetIndex) {
     next = updatePane(next, toPaneId, (pane) => withPaneFiles(pane, insertFile(pane.tabOrder, file, targetIndex), file));
     return { ...next, activePaneId: toPaneId };
 }
+// Re-home one identifier under a prefix rename: an exact match becomes `to`; a descendant of the
+// renamed folder keeps its suffix (`src/app.ts` under `src` -> `lib` becomes `lib/app.ts`). Any
+// other path is unchanged. Folder boundaries use a trailing slash so `src` never matches `srcgen`.
+function renamePathUnderPrefix(file, from, to) {
+    if (file === from)
+        return to;
+    return file.startsWith(`${from}/`) ? `${to}${file.slice(from.length)}` : file;
+}
+function dedupeFiles(files) {
+    const out = [];
+    for (const file of files) {
+        if (file.length > 0 && !out.includes(file))
+            out.push(file);
+    }
+    return out;
+}
+function renameFileInPane(pane, from, to) {
+    const swap = (file) => renamePathUnderPrefix(file, from, to);
+    const openFiles = dedupeFiles(pane.openFiles.map(swap));
+    const tabOrder = dedupeFiles(pane.tabOrder.map(swap));
+    const activeFile = swap(pane.activeFile);
+    // Nothing in this pane referenced the renamed path; leave it byte-identical so React can bail out.
+    if (openFiles.length === pane.openFiles.length &&
+        openFiles.every((file, index) => file === pane.openFiles[index]) &&
+        activeFile === pane.activeFile) {
+        return pane;
+    }
+    return {
+        ...pane,
+        openFiles,
+        tabOrder,
+        activeFile: activeFile.length > 0 ? activeFile : (tabOrder[0] ?? openFiles[0] ?? ""),
+    };
+}
+function renameFileEverywhere(layout, from, to) {
+    if (from.length === 0 || to.length === 0 || from === to)
+        return layout;
+    const panes = {};
+    let changed = false;
+    for (const [id, pane] of Object.entries(layout.panes)) {
+        const next = renameFileInPane(pane, from, to);
+        if (next !== pane)
+            changed = true;
+        panes[id] = next;
+    }
+    // No pane referenced the renamed path: return the original layout so React can bail out of the
+    // re-render, matching the referential no-op contract of the other reducer branches.
+    return changed ? { ...layout, panes } : layout;
+}
+function removeFileEverywhere(layout, file) {
+    if (file.length === 0)
+        return layout;
+    // Collect every (pane, openFile) pair the delete touches up front, then fold `closeTab` over them:
+    // `closeTab` already owns the active-file fallback and the single-tab pane collapse, and tolerates a
+    // pane that an earlier collapse removed, so a file open in several panes is closed in each.
+    const targets = [];
+    for (const pane of editorLayoutPanes(layout)) {
+        for (const open of pane.openFiles) {
+            if (open === file || open.startsWith(`${file}/`))
+                targets.push([pane.id, open]);
+        }
+    }
+    return targets.reduce((acc, [paneId, open]) => closeTab(acc, paneId, open), layout);
+}
 const PANE_FILE_ACTION_TYPES = new Set([
     "open-file",
     "select-file",
@@ -407,7 +514,9 @@ function reducePaneFileAction(layout, action) {
         case "open-file":
             return updatePane(layout, action.paneId, (pane) => withPaneFiles(pane, orderedFiles(action.file, pane.openFiles), action.file));
         case "select-file":
-            return updatePane({ ...layout, activePaneId: action.paneId }, action.paneId, (pane) => pane.openFiles.includes(action.file) ? withPaneFiles(pane, pane.openFiles, action.file) : pane);
+            return updatePane({ ...layout, activePaneId: action.paneId }, action.paneId, (pane) => pane.openFiles.includes(action.file)
+                ? withPaneFiles(pane, pane.openFiles, action.file)
+                : pane);
         case "close-tab":
             return closeTab(layout, action.paneId, action.file);
         case "reorder-tab":
@@ -449,7 +558,9 @@ function replaceRoot(layout, action) {
 function reduceLayoutStateAction(layout, action) {
     switch (action.type) {
         case "set-active-pane":
-            return layout.panes[action.paneId] === undefined ? layout : { ...layout, activePaneId: action.paneId };
+            return layout.panes[action.paneId] === undefined
+                ? layout
+                : { ...layout, activePaneId: action.paneId };
         case "resize-split":
             return { ...layout, tree: resizeSplitNode(layout.tree, action.splitId, action.ratio) };
         case "set-sidebar":
@@ -460,12 +571,18 @@ function reduceLayoutStateAction(layout, action) {
             };
         case "replace-root":
             return replaceRoot(layout, action);
+        case "rename-file":
+            return renameFileEverywhere(layout, action.from, action.to);
+        case "remove-file":
+            return removeFileEverywhere(layout, action.file);
     }
 }
 export function editorLayoutReducer(layout, action) {
     if (isPaneFileAction(action))
         return reducePaneFileAction(layout, action);
-    return isStructureAction(action) ? reduceStructureAction(layout, action) : reduceLayoutStateAction(layout, action);
+    return isStructureAction(action)
+        ? reduceStructureAction(layout, action)
+        : reduceLayoutStateAction(layout, action);
 }
 export function editorLayoutOpenFiles(layout) {
     const out = [];

package/dist/editor-workspace-path.d.ts

@@ -0,0 +1,20 @@
+export type RootRelativeFileIdentifier = string;
+export type WorkspaceFileIdentifierResolution = {
+    readonly kind: "empty";
+} | {
+    readonly kind: "root";
+} | {
+    readonly kind: "relative";
+    readonly path: RootRelativeFileIdentifier;
+} | {
+    readonly kind: "outside-root";
+    readonly candidate: string;
+};
+export interface WorkspaceFileTarget {
+    readonly root: string;
+    readonly file: RootRelativeFileIdentifier;
+}
+export declare function isRootRelativeFileIdentifier(value: string): boolean;
+export declare function resolveWorkspaceFileIdentifier(root: string, candidate: string | undefined): WorkspaceFileIdentifierResolution;
+export declare function selectWorkspaceFileTarget(root: string, candidate: string | undefined): WorkspaceFileTarget | null;
+//# sourceMappingURL=editor-workspace-path.d.ts.map

package/dist/editor-workspace-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-workspace-path.d.ts","sourceRoot":"","sources":["../src/editor-workspace-path.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAGhD,MAAM,MAAM,iCAAiC,GAEzC;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAE1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAEzB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAA;CAAE,GAIxE;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAIlE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;CAC3C;AA+CD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnE;AAeD,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,iCAAiC,CAWnC;AAuBD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,mBAAmB,GAAG,IAAI,CAkB5B"}