@oscharko-dev/keiko-contracts 0.2.0

package/dist/editor-dirty-close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-dirty-close.d.ts","sourceRoot":"","sources":["../src/editor-dirty-close.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,YAAY,GACZ,aAAa,GACb,cAAc,GACd,aAAa,CAAC;AAElB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC,GAAG,sBAAsB,CAMzB"}

package/dist/editor-dirty-close.js

@@ -0,0 +1,8 @@
+export function createEditorDirtyCloseIntent(input) {
+    const files = [];
+    for (const file of input.files) {
+        if (file.length > 0 && !files.includes(file))
+            files.push(file);
+    }
+    return { paneId: input.paneId, files, reason: input.reason };
+}

package/dist/editor-hot-exit.d.ts

@@ -0,0 +1,18 @@
+import type { EditorDocumentVersion } from "./editor-session.js";
+export declare const EDITOR_HOT_EXIT_SCHEMA_VERSION: 1;
+export declare const EDITOR_HOT_EXIT_TTL_MS: number;
+export interface EditorHotExitSnapshotV1 {
+    readonly schemaVersion: typeof EDITOR_HOT_EXIT_SCHEMA_VERSION;
+    readonly workspaceRoot: string;
+    readonly relativePath: string;
+    readonly content: string;
+    readonly baseVersion: EditorDocumentVersion | null;
+    readonly contentHash: string;
+    readonly savedContentHash: string | null;
+    readonly updatedAt: number;
+    readonly paneId: string;
+    readonly windowId: string;
+}
+export declare function isEditorHotExitSnapshotV1(value: unknown): value is EditorHotExitSnapshotV1;
+export declare function editorHotExitSnapshotExpired(snapshot: EditorHotExitSnapshotV1, now: number, ttlMs?: number): boolean;
+//# sourceMappingURL=editor-hot-exit.d.ts.map

package/dist/editor-hot-exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-hot-exit.d.ts","sourceRoot":"","sources":["../src/editor-hot-exit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,eAAO,MAAM,8BAA8B,EAAG,CAAU,CAAC;AACzD,eAAO,MAAM,sBAAsB,QAA2B,CAAC;AAE/D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,OAAO,8BAA8B,CAAC;IAC9D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AA+BD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAc1F;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,uBAAuB,EACjC,GAAG,EAAE,MAAM,EACX,KAAK,SAAyB,GAC7B,OAAO,CAET"}

package/dist/editor-hot-exit.js

@@ -0,0 +1,42 @@
+export const EDITOR_HOT_EXIT_SCHEMA_VERSION = 1;
+export const EDITOR_HOT_EXIT_TTL_MS = 7 * 24 * 60 * 60 * 1_000;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+function isSha256Hex(value) {
+    return typeof value === "string" && /^[a-f0-9]{64}$/u.test(value);
+}
+function isNonNegativeFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function isNullOr(value, guard) {
+    return value === null || guard(value);
+}
+function isDocumentVersion(value) {
+    return (isRecord(value) &&
+        isNonNegativeFiniteNumber(value.sizeBytes) &&
+        isNonNegativeFiniteNumber(value.modifiedAt) &&
+        isSha256Hex(value.contentHash));
+}
+export function isEditorHotExitSnapshotV1(value) {
+    if (!isRecord(value))
+        return false;
+    return [
+        value.schemaVersion === EDITOR_HOT_EXIT_SCHEMA_VERSION,
+        isNonEmptyString(value.workspaceRoot),
+        isNonEmptyString(value.relativePath),
+        typeof value.content === "string",
+        isNullOr(value.baseVersion, isDocumentVersion),
+        isSha256Hex(value.contentHash),
+        isNullOr(value.savedContentHash, isSha256Hex),
+        isNonNegativeFiniteNumber(value.updatedAt),
+        isNonEmptyString(value.paneId),
+        isNonEmptyString(value.windowId),
+    ].every(Boolean);
+}
+export function editorHotExitSnapshotExpired(snapshot, now, ttlMs = EDITOR_HOT_EXIT_TTL_MS) {
+    return snapshot.updatedAt + ttlMs < now;
+}

package/dist/editor-inline-completion.d.ts

@@ -0,0 +1,70 @@
+import { type LanguageDocumentOverlay, type LanguagePosition, type LanguageRange } from "./language-service.js";
+import type { EditorCompletionContextSelectors, EditorCompletionSource } from "./editor-completion.js";
+import type { CompletionDegradeReason, CompletionInteractionMode, CostClass } from "./gateway.js";
+export declare const EDITOR_INLINE_COMPLETION_SCHEMA_VERSION: "1";
+export type EditorInlineCompletionWireTriggerKind = "automatic" | "explicit";
+export declare const EDITOR_INLINE_COMPLETION_WIRE_TRIGGER_KINDS: readonly EditorInlineCompletionWireTriggerKind[];
+export interface EditorInlineCompletionWireItem {
+    readonly insertText: string;
+    readonly range?: LanguageRange;
+}
+export interface EditorInlineCompletionWireProvenance {
+    readonly sources: readonly EditorCompletionSource[];
+    readonly modelMode: CompletionInteractionMode;
+    readonly modelId?: string;
+    readonly latencyClass?: string;
+    readonly degradeReason?: CompletionDegradeReason;
+    readonly gatewayPolicyVersion?: string;
+    readonly promptHash?: string;
+}
+export interface EditorInlineCompletionWireResponse {
+    readonly schemaVersion: typeof EDITOR_INLINE_COMPLETION_SCHEMA_VERSION;
+    readonly items: readonly EditorInlineCompletionWireItem[];
+    readonly provenance: EditorInlineCompletionWireProvenance;
+}
+export interface EditorInlineCompletionWireRequest {
+    readonly schemaVersion: typeof EDITOR_INLINE_COMPLETION_SCHEMA_VERSION;
+    readonly root: string;
+    readonly document: LanguageDocumentOverlay;
+    readonly position: LanguagePosition;
+    readonly triggerKind: EditorInlineCompletionWireTriggerKind;
+    readonly contextBudgetBytes: number;
+    readonly context?: EditorCompletionContextSelectors;
+    readonly maxCostClass?: CostClass;
+    readonly maxOutputTokens?: number;
+}
+export declare const EDITOR_INLINE_COMPLETION_TELEMETRY_SCHEMA_VERSION: "1";
+export interface EditorInlineCompletionTelemetryReport {
+    readonly schemaVersion: typeof EDITOR_INLINE_COMPLETION_TELEMETRY_SCHEMA_VERSION;
+    readonly root: string;
+    readonly offered: number;
+    readonly shown: number;
+    readonly accepted: number;
+    readonly rejected: number;
+    readonly ignored: number;
+    readonly partiallyAccepted: number;
+    readonly requestCount: number;
+    readonly requestLatencyMsP50: number;
+    readonly requestLatencyMsP95: number;
+}
+export interface EditorInlineCompletionParseOk {
+    readonly ok: true;
+    readonly value: EditorInlineCompletionWireRequest;
+}
+export interface EditorInlineCompletionParseFail {
+    readonly ok: false;
+    readonly errors: readonly string[];
+}
+export type EditorInlineCompletionParse = EditorInlineCompletionParseOk | EditorInlineCompletionParseFail;
+export declare function parseEditorInlineCompletionRequest(value: unknown): EditorInlineCompletionParse;
+export interface EditorInlineCompletionTelemetryParseOk {
+    readonly ok: true;
+    readonly value: EditorInlineCompletionTelemetryReport;
+}
+export interface EditorInlineCompletionTelemetryParseFail {
+    readonly ok: false;
+    readonly errors: readonly string[];
+}
+export type EditorInlineCompletionTelemetryParse = EditorInlineCompletionTelemetryParseOk | EditorInlineCompletionTelemetryParseFail;
+export declare function parseEditorInlineCompletionTelemetry(value: unknown): EditorInlineCompletionTelemetryParse;
+//# sourceMappingURL=editor-inline-completion.d.ts.map

package/dist/editor-inline-completion.d.ts.map

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

package/dist/editor-inline-completion.js

@@ -0,0 +1,215 @@
+// Editor inline-completion (ghost-text) WIRE contract (Issue #1200, Epic #1189, ADR-0042 D5/D6).
+// These are the request/response shapes the `POST /api/editor/inline-completion` BFF route consumes
+// and emits. The route is the governed seam between the browser-tier `@oscharko-dev/keiko-editor`
+// Monaco inline-completion provider (which renders ghost text only) and the server-owned, gated
+// model-assisted infilling source: an aligned ("instruct"/"edit-tuned") suffix-aware (FIM) model
+// elected by the completion-model selection (#1210) and enriched with governed coding context
+// (#1211, `purpose: "inline"`). Inline completion is model-only: unlike the #1199 completion gateway
+// there is no deterministic ghost-text tier — when no governed FIM model is usable (or policy
+// disables the feature) the route returns zero items and the editor falls back to the deterministic
+// language-service completion gateway (#1199), never a silent ungoverned model (ADR-0042 D5).
+//
+// Content boundary: the REQUEST necessarily carries the in-editor buffer text (the overlay the model
+// infills, prefix + suffix around the cursor), exactly like the language-service (#1198) and
+// completion (#1199) requests — it is the user's own buffer travelling over the loopback BFF, never
+// logged. The RESPONSE is content-free apart from `insertText`, which is the reviewable ghost-text
+// continuation the user explicitly accepts into their own buffer: no raw prompt, no raw model
+// reasoning, no retrieved excerpt, no secret. Provenance carries only ids, hashes, enum literals, and
+// counts (EU AI Act Reg. (EU) 2024/1689 Art. 12 record-keeping). The acceptance/rejection telemetry
+// report is purely counts — no buffer text, no insert text, no prompt.
+//
+// Leaf-package rules (ADR-0019): pure types and frozen const tables plus throw-free validators only.
+// No filesystem, no clock, no crypto, no randomness, and no imports of other `@oscharko-dev/keiko-*`
+// packages. Geometry, the document-overlay shape, the coding-context selectors, and the completion
+// source/mode/degrade vocabularies are reused from the sibling editor contracts so the inline tier
+// shares one stable, content-free provenance model with the completion gateway.
+import { isLanguageDocumentOverlay, isLanguagePosition, } from "./language-service.js";
+// Schema version for the inline-completion envelope. Bump as a new string member when the shape
+// changes incompatibly; consumers pin against the literal to detect skew.
+export const EDITOR_INLINE_COMPLETION_SCHEMA_VERSION = "1";
+export const EDITOR_INLINE_COMPLETION_WIRE_TRIGGER_KINDS = ["automatic", "explicit"];
+// ─── Content-free acceptance/rejection telemetry (Acceptance Criterion 6) ──────────────────────────
+// The browser-tier inline-completion bridge accumulates these counts from Monaco's content-free
+// lifecycle callbacks (shown / partial-accept / end-of-lifetime accepted|rejected|ignored) plus
+// request latency aggregates, and the host posts a cumulative snapshot to
+// `POST /api/editor/inline-completion/telemetry`, which records it as content-free evidence. There is
+// NO code content here — only counts, latency numbers, and the workspace root.
+export const EDITOR_INLINE_COMPLETION_TELEMETRY_SCHEMA_VERSION = "1";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+function isNonNegativeInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function isPositiveInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0;
+}
+function isWireTriggerKind(value) {
+    return (typeof value === "string" &&
+        EDITOR_INLINE_COMPLETION_WIRE_TRIGGER_KINDS.includes(value));
+}
+function isCostClass(value) {
+    return value === "low" || value === "medium" || value === "high";
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((entry) => typeof entry === "string");
+}
+// Collects the optional, content-bearing context selectors (identical invariants to the completion
+// gateway). Unknown-typed fields are rejected so a malformed selector cannot silently widen
+// retrieval; an absent `context` is valid (repository search only for the `inline` purpose).
+function collectContextErrors(context, errors) {
+    if (context === undefined) {
+        return;
+    }
+    if (!isRecord(context)) {
+        errors.push("context must be an object when provided");
+        return;
+    }
+    for (const field of ["queryText", "symbol", "capsuleId", "capsuleSetId"]) {
+        if (context[field] !== undefined && typeof context[field] !== "string") {
+            errors.push(`context.${field} must be a string when provided`);
+        }
+    }
+    if (context.changedFiles !== undefined && !isStringArray(context.changedFiles)) {
+        errors.push("context.changedFiles must be an array of strings when provided");
+    }
+    if (context.capsuleId !== undefined && context.capsuleSetId !== undefined) {
+        errors.push("context must not set both capsuleId and capsuleSetId");
+    }
+}
+function buildContextSelectors(context) {
+    return {
+        ...(typeof context.queryText === "string" ? { queryText: context.queryText } : {}),
+        ...(typeof context.symbol === "string" ? { symbol: context.symbol } : {}),
+        ...(isStringArray(context.changedFiles) ? { changedFiles: context.changedFiles } : {}),
+        ...(typeof context.capsuleId === "string" ? { capsuleId: context.capsuleId } : {}),
+        ...(typeof context.capsuleSetId === "string" ? { capsuleSetId: context.capsuleSetId } : {}),
+    };
+}
+// Collects every field-level invariant error in fixed order (kept separate from the assembly step so
+// the parser entry point stays low-complexity).
+function collectRequestErrors(value) {
+    const errors = [];
+    if (!isNonEmptyString(value.root)) {
+        errors.push("root must be a non-empty string");
+    }
+    if (!isLanguageDocumentOverlay(value.document)) {
+        errors.push("document must be { path, languageId, text }");
+    }
+    if (!isLanguagePosition(value.position)) {
+        errors.push("position must be { line, character }");
+    }
+    if (!isWireTriggerKind(value.triggerKind)) {
+        errors.push(`triggerKind must be one of: ${EDITOR_INLINE_COMPLETION_WIRE_TRIGGER_KINDS.join(", ")}`);
+    }
+    if (!isNonNegativeInteger(value.contextBudgetBytes)) {
+        errors.push("contextBudgetBytes must be a non-negative integer");
+    }
+    if (value.maxCostClass !== undefined && !isCostClass(value.maxCostClass)) {
+        errors.push("maxCostClass must be one of: low, medium, high");
+    }
+    if (value.maxOutputTokens !== undefined && !isPositiveInteger(value.maxOutputTokens)) {
+        errors.push("maxOutputTokens must be a positive integer when provided");
+    }
+    collectContextErrors(value.context, errors);
+    return errors;
+}
+// Validates an `unknown` payload into an EditorInlineCompletionWireRequest, reporting one error per
+// failed invariant. The BFF uses this to reject a malformed request with 400 INVALID_REQUEST.
+export function parseEditorInlineCompletionRequest(value) {
+    if (!isRecord(value)) {
+        return { ok: false, errors: ["request must be an object"] };
+    }
+    const errors = collectRequestErrors(value);
+    if (errors.length > 0) {
+        return { ok: false, errors };
+    }
+    const context = isRecord(value.context) ? buildContextSelectors(value.context) : undefined;
+    return {
+        ok: true,
+        value: {
+            schemaVersion: EDITOR_INLINE_COMPLETION_SCHEMA_VERSION,
+            root: value.root,
+            document: value.document,
+            position: value.position,
+            triggerKind: value.triggerKind,
+            contextBudgetBytes: value.contextBudgetBytes,
+            ...(context !== undefined && Object.keys(context).length > 0 ? { context } : {}),
+            ...(isCostClass(value.maxCostClass) ? { maxCostClass: value.maxCostClass } : {}),
+            ...(isPositiveInteger(value.maxOutputTokens)
+                ? { maxOutputTokens: value.maxOutputTokens }
+                : {}),
+        },
+    };
+}
+const TELEMETRY_COUNT_FIELDS = [
+    "offered",
+    "shown",
+    "accepted",
+    "rejected",
+    "ignored",
+    "partiallyAccepted",
+];
+const TELEMETRY_LATENCY_FIELDS = [
+    "requestCount",
+    "requestLatencyMsP50",
+    "requestLatencyMsP95",
+];
+function collectTelemetryErrors(value) {
+    const errors = [];
+    if (!isNonEmptyString(value.root)) {
+        errors.push("root must be a non-empty string");
+    }
+    for (const field of TELEMETRY_COUNT_FIELDS) {
+        if (!isNonNegativeInteger(value[field])) {
+            errors.push(`${field} must be a non-negative integer`);
+        }
+    }
+    for (const field of TELEMETRY_LATENCY_FIELDS) {
+        if (value[field] !== undefined && !isNonNegativeInteger(value[field])) {
+            errors.push(`${field} must be a non-negative integer when provided`);
+        }
+    }
+    if (isNonNegativeInteger(value.requestLatencyMsP50) &&
+        isNonNegativeInteger(value.requestLatencyMsP95) &&
+        value.requestLatencyMsP95 < value.requestLatencyMsP50) {
+        errors.push("requestLatencyMsP95 must be greater than or equal to requestLatencyMsP50");
+    }
+    return errors;
+}
+function telemetryMetric(value, field) {
+    const metric = value[field];
+    return isNonNegativeInteger(metric) ? metric : 0;
+}
+function buildTelemetryReport(value) {
+    return {
+        schemaVersion: EDITOR_INLINE_COMPLETION_TELEMETRY_SCHEMA_VERSION,
+        root: value.root,
+        offered: value.offered,
+        shown: value.shown,
+        accepted: value.accepted,
+        rejected: value.rejected,
+        ignored: value.ignored,
+        partiallyAccepted: value.partiallyAccepted,
+        requestCount: telemetryMetric(value, "requestCount"),
+        requestLatencyMsP50: telemetryMetric(value, "requestLatencyMsP50"),
+        requestLatencyMsP95: telemetryMetric(value, "requestLatencyMsP95"),
+    };
+}
+// Validates an `unknown` payload into a content-free EditorInlineCompletionTelemetryReport. Every
+// metric must be a non-negative integer; the report carries only counts, latency aggregates, and the
+// workspace root. Latency fields default to 0 so older cumulative telemetry snapshots do not break
+// during rollout; current clients always emit them.
+export function parseEditorInlineCompletionTelemetry(value) {
+    if (!isRecord(value)) {
+        return { ok: false, errors: ["telemetry report must be an object"] };
+    }
+    const errors = collectTelemetryErrors(value);
+    if (errors.length > 0) {
+        return { ok: false, errors };
+    }
+    return { ok: true, value: buildTelemetryReport(value) };
+}

package/dist/editor-layout.d.ts

@@ -0,0 +1,105 @@
+export declare const EDITOR_LAYOUT_SCHEMA_VERSION: 2;
+export type EditorSplitDirection = "row" | "column";
+export type EditorSplitDropZone = "left" | "right" | "top" | "bottom" | "center";
+export interface EditorLayoutPaneNode {
+    readonly type: "pane";
+    readonly paneId: string;
+}
+export interface EditorLayoutSplitNode {
+    readonly type: "split";
+    readonly id: string;
+    readonly direction: EditorSplitDirection;
+    readonly ratio: number;
+    readonly first: EditorLayoutNode;
+    readonly second: EditorLayoutNode;
+}
+export type EditorLayoutNode = EditorLayoutPaneNode | EditorLayoutSplitNode;
+export interface EditorPaneStateV2 {
+    readonly id: string;
+    readonly openFiles: readonly string[];
+    readonly activeFile: string;
+    readonly tabOrder: readonly string[];
+}
+export interface EditorLayoutStateV2 {
+    readonly schemaVersion: typeof EDITOR_LAYOUT_SCHEMA_VERSION;
+    readonly root: string;
+    readonly activePaneId: string;
+    readonly tree: EditorLayoutNode;
+    readonly panes: Readonly<Record<string, EditorPaneStateV2>>;
+    readonly sidebarWidth: number;
+    readonly sidebarCollapsed: boolean;
+}
+export interface EditorTabDragIntent {
+    readonly file: string;
+    readonly fromPaneId: string;
+    readonly toPaneId: string;
+    readonly zone: EditorSplitDropZone;
+    readonly targetIndex?: number | undefined;
+}
+export type EditorLayoutAction = {
+    readonly type: "open-file";
+    readonly paneId: string;
+    readonly file: string;
+} | {
+    readonly type: "select-file";
+    readonly paneId: string;
+    readonly file: string;
+} | {
+    readonly type: "close-tab";
+    readonly paneId: string;
+    readonly file: string;
+} | {
+    readonly type: "close-pane";
+    readonly paneId: string;
+} | {
+    readonly type: "set-active-pane";
+    readonly paneId: string;
+} | {
+    readonly type: "reorder-tab";
+    readonly paneId: string;
+    readonly file: string;
+    readonly targetIndex: number;
+} | {
+    readonly type: "move-tab";
+    readonly fromPaneId: string;
+    readonly toPaneId: string;
+    readonly file: string;
+    readonly targetIndex?: number | undefined;
+} | {
+    readonly type: "drop-tab";
+    readonly intent: EditorTabDragIntent;
+} | {
+    readonly type: "split-pane";
+    readonly paneId: string;
+    readonly direction: EditorSplitDirection;
+    readonly file?: string | undefined;
+} | {
+    readonly type: "resize-split";
+    readonly splitId: string;
+    readonly ratio: number;
+} | {
+    readonly type: "set-sidebar";
+    readonly width?: number | undefined;
+    readonly collapsed?: boolean | undefined;
+} | {
+    readonly type: "replace-root";
+    readonly root: string;
+    readonly sidebarWidth?: number | undefined;
+};
+export interface CreateEditorLayoutStateV2Input {
+    readonly root: string;
+    readonly file: string;
+    readonly openFiles: readonly string[];
+    readonly layoutJson?: string | undefined;
+    readonly defaultSidebarWidth: number;
+    readonly minSidebarWidth: number;
+    readonly maxSidebarWidth: number;
+}
+export declare function createEditorLayoutStateV2(input: CreateEditorLayoutStateV2Input): EditorLayoutStateV2;
+export declare function serializeEditorLayoutStateV2(layout: EditorLayoutStateV2): string;
+export declare function editorLayoutPaneIds(layout: EditorLayoutStateV2): readonly string[];
+export declare function editorLayoutPanes(layout: EditorLayoutStateV2): readonly EditorPaneStateV2[];
+export declare function activeEditorPane(layout: EditorLayoutStateV2): EditorPaneStateV2;
+export declare function editorLayoutReducer(layout: EditorLayoutStateV2, action: EditorLayoutAction): EditorLayoutStateV2;
+export declare function editorLayoutOpenFiles(layout: EditorLayoutStateV2): readonly string[];
+//# sourceMappingURL=editor-layout.d.ts.map

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

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