@lijian-ui/dsh-file-manager 0.1.20

package/lib/types/client/settings-form.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Staged form model behind the plugin settings card. A card stages what the
+ * user types and writes it only when they save — the settings write is a
+ * durable, revision-fenced document mutation, so staging keeps what is on
+ * screen exactly what a save would store. Family-shared slice inlined into
+ * each plugin's client bundle; mirrors the official ui-plugin-config
+ * card-store pattern.
+ */
+import type { SettingsScope, SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+/** The write one field's staged text performs when the card is saved. */
+export type FieldWrite = {
+    kind: 'set';
+    value: unknown;
+} | {
+    kind: 'clear';
+};
+/** How one field converts between its stored value and its draft text. */
+export interface FieldSpec {
+    /** Field name inside the namespace section. */
+    field: string;
+    /**
+     * Whether the Host treats this field as a secret and redacts its value from
+     * the read-back (role('secret') in the section schema). Redacted secrets are
+     * never compared against the draft on save; the field lands when the scope
+     * reports the write succeeded (its secret-set marker under the bridge), so
+     * a successful secret save is not misreported as failed.
+     */
+    secret?: boolean;
+    /** Render a stored value as draft text; the empty string when the section carries none. */
+    format: (value: unknown) => string;
+    /**
+     * The write this draft text stages, or undefined when the text is not a
+     * value this field accepts — which blocks the save rather than discarding it.
+     */
+    parse: (text: string) => FieldWrite | undefined;
+}
+/** One field as the card renders it. */
+export interface FieldState {
+    /** Draft text the control renders. */
+    text: string;
+    /** Whether saving would leave a user-layer entry for this field. */
+    overridden: boolean;
+    /** Whether the draft is not a value this field accepts, which blocks saving. */
+    invalid: boolean;
+}
+/** Form state every plugin settings card shares. */
+export interface CardShell {
+    /** False while the namespace is still loading; the card renders nothing. */
+    available: boolean;
+    /**
+     * Whether the namespace is actually served to this client. False when the
+     * Host deployment does not expose it (e.g. the official apiproxy settings
+     * allowlist omits third-party namespaces): the card renders an explanation
+     * instead of its form, so a missing namespace never looks like a missing
+     * plugin.
+     */
+    exposed: boolean;
+    /** Whether the Host document accepts writes. */
+    writable: boolean;
+    /** Whether the form holds edits that a save would write. */
+    dirty: boolean;
+    /** Whether any staged draft is invalid, which blocks the save. */
+    invalid: boolean;
+    /** Whether a save is crossing the wire. */
+    saving: boolean;
+    /** Whether the last save did not land as staged; cleared by the next edit or save. */
+    failed: boolean;
+    /**
+     * The rejection code/message the Host returned for the last failed save,
+     * surfaced next to the generic failure text. Undefined while no save has
+     * failed (or the failure carried no server reason).
+     */
+    failedReason?: string;
+}
+/** The write actions the card's slot entry injects. */
+export interface CardActions {
+    /** Stage draft text for one field. */
+    edit: (field: string, text: string) => void;
+    /** Stage a clear, so saving lets the field re-inherit the composition layer. */
+    resetField: (field: string) => void;
+    /** Write every staged edit, then re-seed from what the Host accepted. */
+    save: () => void;
+    /** Drop every staged edit. */
+    discard: () => void;
+}
+/** One durable write a batched settings scope performs. */
+export interface BatchedWrite {
+    /** Field this entry writes. */
+    field: string;
+    /** set stores a value; unset drops the leaf. */
+    op: 'set' | 'unset';
+    /** Value for op set (absent for unset). */
+    value?: unknown;
+}
+/** Per-field outcome of one batched scope write. */
+export interface BatchedFieldResult {
+    /** Field this entry writes. */
+    field: string;
+    /** Whether the Host accepted this field's write (per the read-back view). */
+    landed: boolean;
+}
+/**
+ * Result of a batched scope write. The bridge scope posts every planned write
+ * in one /mutate so the Host validate hook judges baseURL+model together; a
+ * batched refusal fails the whole save rather than per-field.
+ */
+export interface BatchResult {
+    /** Whether the whole mutate was accepted. */
+    ok: boolean;
+    /** Per-field success, in the request order (always present when ok). */
+    fields: BatchedFieldResult[];
+    /** Host rejection code (mutate refused). */
+    code?: string;
+    /** Host rejection message (mutate refused). */
+    message?: string;
+}
+/** Constraints a numeric field's accepted drafts must satisfy, mirroring the host schema. */
+export interface NumberConstraints {
+    /** The accepted value must be a whole number. */
+    integer?: boolean;
+    /** The accepted value must be at least this. */
+    min?: number;
+}
+/** A whole- or decimal-number field. An empty draft clears the field; any other draft that is not a finite number within the constraints blocks the save. */
+export declare function numberField(field: string, constraints?: NumberConstraints): FieldSpec;
+/** A free-text field. An empty draft clears the field. */
+export declare function textField(field: string): FieldSpec;
+/**
+ * A free-text field the Host treats as a secret and redacts from the read-back
+ * (role('secret') in the section schema). The card still edits it like text,
+ * but a save never compares the redacted value back and relies on the scope
+ * reporting the write landed.
+ */
+export declare function secretField(field: string): FieldSpec;
+/** A boolean field, edited through true/false draft text. */
+export declare function booleanField(field: string): FieldSpec;
+/** An enumerated string field; only the listed choices are accepted. An empty draft clears the field. */
+export declare function choiceField(field: string, choices: readonly string[]): FieldSpec;
+/**
+ * Stages one card's edits over one settings namespace and writes them on save.
+ *
+ * The Host is the only authority on whether a value was accepted — its
+ * validators own the constraints no schema can express — so the outcome is
+ * read back from the section rather than predicted here. A save that did not
+ * land keeps its drafts, so the user can correct them instead of retyping.
+ */
+export declare class CardForm<T> {
+    private readonly scope;
+    private readonly specs;
+    private readonly staged;
+    private readonly listeners;
+    /** The scope subscription installed in the constructor; released by dispose(). */
+    private readonly disposeScope;
+    private disposed;
+    private saving;
+    private failed;
+    private failedReason;
+    /** @param scope - the bound settings scope for this card's namespace. */
+    constructor(scope: SettingsScope<T>, specs: FieldSpec[]);
+    /**
+     * Release the scope subscription and every bound store listener. The card
+     * must call this on teardown; later calls are no-ops.
+     */
+    dispose(): void;
+    /** Publish a projection of this form, rebuilt whenever the scope or a draft changes. */
+    bind<S>(project: () => S): SnapshotStore<S>;
+    /** Read the card-level state: what the Host serves, and what a save would do. */
+    shell(): CardShell;
+    /** Read one field's state from the effective section and its staged draft. */
+    field(field: string): FieldState;
+    /** The actions the card's slot registration injects. */
+    actions(): CardActions;
+    /**
+     * Write every staged edit, then re-seed from what the Host accepted.
+     *
+     * When the scope carries the optional batch surface (the dsh-web-ui
+     * bridge scope), every planned write rides one mutation so cross-field
+     * validate hooks (baseURL+model) judge the batch as a unit instead of
+     * deadlocking on per-field writes. Otherwise the per-field loop runs.
+     * A field lands only when the Host reports it held the staged value; a
+     * landed field's draft is dropped, a failed one stays staged for the user.
+     * @returns settlement after every write and the read-back.
+     */
+    save(): Promise<void>;
+    /** The scope's batch surface when it supports one; undefined conservatively otherwise. */
+    private batchedScope;
+    /**
+     * Every staged edit a save would write. An entry whose draft is not a value
+     * its field accepts carries no write: the form is still dirty, and the save
+     * refuses rather than dropping the edit. A staged edit that matches the
+     * effective section is not a write at all.
+     * @returns the planned writes, in the order the fields were staged.
+     */
+    private plan;
+    private clear;
+    private store;
+    private stage;
+    private specOf;
+    private snapshotOf;
+    private sectionValue;
+    private baseValue;
+    private userLayer;
+    private stored;
+    private publish;
+}
+//# sourceMappingURL=settings-form.d.ts.map

package/lib/types/client/settings-form.d.ts.map

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

package/lib/types/client/store.d.ts

@@ -0,0 +1,279 @@
+/**
+ * Framework-free state core of the panel system: four small stores (layout,
+ * explorer, scm, preview) built on a minimal subscribe/getSnapshot primitive
+ * so every decision lives outside React (StrictMode-safe: update reducers are
+ * pure; async work — fetches, persistence — runs in the action layer).
+ *
+ * FileManager's right-panel architecture (Apache-2.0, re-implemented): the width
+ * clamps below are the exact ordered pair that keeps the chat area >= 360px
+ * at all times (see the research report's section 4.2).
+ * @module dsh-filemgr/client/store
+ */
+import type { FsEntry, GitStatusView, PreviewContentType, SearchHit } from '../core/types.ts';
+import type { PanelApi } from './api.ts';
+/** A minimal external store usable with useSyncExternalStore. */
+export interface StateHandle<S> {
+    getSnapshot: () => S;
+    subscribe: (listener: () => void) => () => void;
+    /** Pure update: fn receives the previous state and returns the next. */
+    update: (fn: (prev: S) => S) => void;
+}
+/** Create a state handle with an immutable snapshot (new object per update). */
+export declare function createState<S>(initial: S): StateHandle<S>;
+/** Chat-area floor the two clamps guarantee (never below this). */
+export declare const MIN_CHAT_PANEL_PX = 360;
+/** Preview region width contract. */
+export declare const MIN_PREVIEW_PANEL_PX = 340;
+export declare const DEFAULT_PREVIEW_REGION_PX = 480;
+export declare const MAX_PREVIEW_REGION_PX = 1200;
+/** Explorer (workspace) width contract. */
+export declare const MIN_WORKSPACE_PANEL_PX = 220;
+export declare const MAX_WORKSPACE_PANEL_PX = 500;
+export declare const DEFAULT_WORKSPACE_PANEL_PX = 260;
+/** Preview region horizontal chrome (margins + borders) the clamps subtract. */
+export declare const PREVIEW_REGION_CHROME_PX = 24;
+/** Storage keys (FileManager contract, verbatim). */
+export declare const KEY_EXPLORER_WIDTH = "chat-workspace-width-px";
+export declare const KEY_PREVIEW_WIDTH = "chat-preview-width-px";
+export declare const KEY_COLLAPSE = "project-panel-collapse:";
+export declare const KEY_EXPLORER_UI = "explorer-ui:";
+/** Trailing window for coalescing explorer fs-event refetches (ms). */
+export declare const FS_COALESCE_MS = 200;
+export declare const KEY_SCM_UI = "scm-ui:";
+/**
+ * Explorer clamp (runs first): reserve chat's floor plus the preview region
+ * (min + chrome) when open, so the explorer never grows into the preview's
+ * space; floor at the explorer minimum so a narrow container cannot squeeze
+ * it to nothing.
+ */
+export declare function clampExplorerWidth(requested: number, available: number, previewOpen: boolean): number;
+/**
+ * Preview clamp (runs after the explorer clamp): reserve chat's floor plus
+ * the already-clamped explorer width plus the region chrome. The ordered pair
+ * guarantees chat = available - explorer - preview >= 360.
+ */
+export declare function clampPreviewWidth(requested: number, available: number, explorerWidth: number): number;
+/** Which panel is maximized (null = normal layout). */
+export type MaximizeTarget = 'explorer' | 'preview';
+/** Layout panel state (project-scoped). */
+export interface LayoutState {
+    /** The project root ('' when no project is bound). */
+    root: string;
+    /** Requested explorer width (persisted; clamped on render). */
+    explorerWidth: number;
+    /** Requested preview width (persisted; clamped on render). */
+    previewWidth: number;
+    /** Explorer collapsed (width 0, kept mounted). */
+    explorerCollapsed: boolean;
+    /** Preview region visible. */
+    previewOpen: boolean;
+    /** Measured available width of the [content | panels] row. */
+    availableWidth: number;
+    /** True while a panel drag is in flight (disables transitions). */
+    dragging: boolean;
+    /**
+     * Maximized panel (transient, never persisted): the panel takes over the
+     * whole frame row (or the viewport as an overlay on narrow screens) while
+     * the other panel, the chat area and the shell side columns hide. Restoring
+     * re-applies the stored widths/collapse — nothing else changes.
+     */
+    maximized: MaximizeTarget | null;
+}
+/** The layout store plus its pure width math. */
+export interface LayoutStore extends StateHandle<LayoutState> {
+    /** Effective explorer width after the ordered clamp. */
+    explorerWidthPx: (state: LayoutState) => number;
+    /** Effective preview width after the ordered clamp. */
+    previewWidthPx: (state: LayoutState) => number;
+    /** Persist a clamped shrink when the stored width no longer fits. */
+    shrinkToFit: (state: LayoutState) => void;
+}
+/** Storage key of the collapse preference for one root. */
+export declare const collapseKey: (root: string) => string;
+/** Create the layout store (reads persisted widths on init). */
+export declare function createLayoutStore(): LayoutStore;
+/** Switch the layout to a project root (restores collapse + widths). */
+export declare function layoutSetRoot(store: LayoutStore, root: string, previewOpen: boolean): void;
+/** Explorer panel state. */
+export interface ExplorerState {
+    root: string;
+    /** rel path -> listing cache ('' = root). */
+    dirs: Record<string, FsEntry[]>;
+    /** Expanded dir rel paths (order = display order). */
+    expanded: string[];
+    /** Selected node rel path (null = none). */
+    selected: string | null;
+    /** Dirs currently fetching. */
+    loading: string[];
+    /** Active tab: files | changes. */
+    activeTab: 'files' | 'changes';
+    /** Filename search state. */
+    search: {
+        query: string;
+        status: 'idle' | 'searching' | 'done' | 'error';
+        hits: SearchHit[];
+        truncated: boolean;
+    };
+    /** Bumped on every fs change event (drives refetch + re-render). */
+    version: number;
+}
+/** The explorer store with its async actions. */
+export interface ExplorerStore extends StateHandle<ExplorerState> {
+    setRoot: (root: string) => void;
+    setActiveTab: (tab: 'files' | 'changes') => void;
+    toggleDir: (rel: string) => void;
+    select: (rel: string | null) => void;
+    reveal: (rel: string) => void;
+    setSearchQuery: (query: string) => void;
+    cancelSearch: () => void;
+    /** Refetch every expanded dir + active search after a host change event. */
+    handleFsChange: () => void;
+    /** Reveal a path in the OS file manager (right-click menu). */
+    revealInFileManager: (rel: string) => Promise<boolean>;
+    /** Open a path with the OS default app (files only, right-click menu). */
+    openWithDefaultApp: (rel: string) => Promise<boolean>;
+    /** Rename a path (newName is a bare name). */
+    renameEntry: (rel: string, newName: string) => Promise<boolean>;
+    /** Create a directory at rel (parent dirs untouched). */
+    createDir: (rel: string) => Promise<boolean>;
+    /** Create an empty file at rel. */
+    createFile: (rel: string) => Promise<boolean>;
+    /** Delete a path (recursive for directories). */
+    deleteEntry: (rel: string) => Promise<boolean>;
+}
+/** Read the persisted explorer UI state for a root (range-guarded). */
+export declare function readExplorerUi(root: string): {
+    expanded: string[];
+    selected: string | null;
+};
+/** Create the explorer store (per-root persistence, debounced writes). */
+export declare function createExplorerStore(api: PanelApi): ExplorerStore;
+/** SCM panel state. */
+export interface ScmState {
+    root: string;
+    /** null: not a git repository (or still loading). */
+    status: GitStatusView | null;
+    /** True when the host reported git is not installed (SSE gitUnavailable). */
+    gitMissing: boolean;
+    loading: boolean;
+    /** Paths with an action in flight. */
+    busy: string[];
+    /** Paths the last action reported failed. */
+    failed: string[];
+    /** list | tree. */
+    viewMode: 'list' | 'tree';
+    /** Section collapse map (repositories | changes). */
+    sectionCollapsed: Record<string, boolean>;
+    /** Tree-view expanded dir keys. */
+    treeExpanded: string[];
+    /** Path of the last row opened in the preview panel (null = none). */
+    selected: string | null;
+}
+/** The scm store with its async actions. */
+export interface ScmStore extends StateHandle<ScmState> {
+    setRoot: (root: string) => void;
+    refresh: () => Promise<void>;
+    stage: (paths: string[]) => Promise<void>;
+    unstage: (paths: string[]) => Promise<void>;
+    discard: (paths: string[]) => Promise<void>;
+    discardAll: () => Promise<void>;
+    setViewMode: (mode: 'list' | 'tree') => void;
+    setSectionCollapsed: (id: string, collapsed: boolean) => void;
+    setTreeExpanded: (keys: string[]) => void;
+    setFailed: (paths: string[]) => void;
+    select: (path: string | null) => void;
+}
+/** Read the persisted scm UI state for a root (guarded). */
+export declare function readScmUi(root: string): {
+    viewMode: 'list' | 'tree';
+    sectionCollapsed: Record<string, boolean>;
+    treeExpanded: string[];
+    selected: string | null;
+};
+/** Create the scm store (host status is the only truth — no optimistic rows). */
+export declare function createScmStore(api: PanelApi): ScmStore;
+/** One preview tab. */
+export interface PreviewTabState {
+    id: string;
+    title: string;
+    root: string;
+    path: string;
+    contentType: PreviewContentType;
+    /** Diff tabs (opened from the SCM panel): content is the path's git diff. */
+    diff?: {
+        staged: boolean;
+    };
+    /** URL tabs: bumped by reloadTab to re-navigate the preview frame. */
+    reloadNonce?: number;
+    /** null: content not loaded yet. */
+    content: string | null;
+    /** Image dimensions for image tabs. */
+    image?: {
+        width: number;
+        height: number;
+    };
+    dirty: boolean;
+    /** mtime the loaded/saved content is based on (write-conflict base). */
+    mtime?: number;
+    /** Disk is newer than the loaded content (refresh affordance). */
+    updated: boolean;
+    loading: boolean;
+    truncated: boolean;
+    error: string | null;
+    savedAt: number;
+}
+/** Preview panel state. */
+export interface PreviewState {
+    root: string;
+    open: boolean;
+    tabs: PreviewTabState[];
+    activeTabId: string | null;
+    /** Bumped on every fs change event (drives staleness checks). */
+    version: number;
+}
+/** The preview store with its async actions. */
+export interface PreviewStore extends StateHandle<PreviewState> {
+    setRoot: (root: string) => void;
+    openFile: (root: string, path: string) => void;
+    openDiff: (root: string, path: string, staged: boolean) => void;
+    switchTab: (id: string) => void;
+    closeTabs: (ids: string[]) => void;
+    updateContent: (id: string, content: string) => void;
+    saveTab: (id: string) => Promise<void>;
+    reloadTab: (id: string) => Promise<void>;
+    setOpen: (open: boolean) => void;
+    handleFsChange: () => void;
+    handleGitChange: (root: string) => void;
+}
+/** Persisted tab meta (content is re-fetched on restore). */
+interface PersistedTab {
+    id: string;
+    title: string;
+    root: string;
+    path: string;
+    contentType: PreviewContentType;
+    diff?: {
+        staged: boolean;
+    };
+    savedAt: number;
+}
+/** Read persisted tabs for a root (guarded, content-less). */
+export declare function readPreviewTabs(root: string): PersistedTab[];
+/** Create the preview store (per-root tab persistence with LRU scopes). */
+export declare function createPreviewStore(api: PanelApi): PreviewStore;
+/** Convenience bundle: the four stores wired to one api. */
+export interface PanelStores {
+    layout: LayoutStore;
+    explorer: ExplorerStore;
+    scm: ScmStore;
+    preview: PreviewStore;
+}
+/** PanelStores plus a pagehide flush hook. */
+export interface PanelStoresWithFlush extends PanelStores {
+    /** Flush every pending debounced persist immediately (pagehide/beforeunload). */
+    flushNow: () => void;
+}
+/** Create the full store bundle. */
+export declare function createPanelStores(api: PanelApi): PanelStoresWithFlush;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/lib/types/client/store.d.ts.map

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

package/lib/types/core/types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Wire vocabulary shared by the host data services and the browser client:
+ * the request/response shapes of the /filemgr/* routes and the stable
+ * error codes the client maps onto copy. Pure types — no runtime code.
+ *
+ * The design follows FileManager's right-panel system (Apache-2.0, re-implemented
+ * from measured behavior, not copied code): the explorer column is a lazy
+ * directory tree, the preview column opens files as tabs, and the SCM tab
+ * reads the repository's real working-tree state.
+ * @module dsh-filemgr/core/types
+ */
+/** Envelope every /filemgr JSON response carries. */
+export type PanelEnvelope<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: PanelError;
+};
+/** Stable rejection codes (host-authored; the client prefers its own copy by code). */
+export type PanelErrorCode = 'workspace-unknown' | 'path-outside-root' | 'not-found' | 'is-directory' | 'read-failed' | 'write-conflict' | 'write-failed' | 'search-failed' | 'git-unavailable' | 'git-failed' | 'internal';
+/** One rejection with a human-readable host message. */
+export interface PanelError {
+    code: PanelErrorCode;
+    message: string;
+}
+/** One filesystem entry in a directory listing (path is relative to the root). */
+export interface FsEntry {
+    /** Display name (basename). */
+    name: string;
+    /** Path relative to the project root, '/' separated; '' is the root itself. */
+    path: string;
+    isDir: boolean;
+    /** Size in bytes (0 for directories). */
+    size: number;
+    /** Last-modified epoch millis (0 for directories). */
+    mtime: number;
+}
+/** The listing of one directory. */
+export interface DirListing {
+    /** Canonical root path the listing is relative to. */
+    root: string;
+    /** Sorted entries (directories first, then files, both case-insensitive alpha). */
+    entries: FsEntry[];
+    /** True when the entry count was capped at MAX_ENTRIES (a giant flat dir). */
+    truncated: boolean;
+}
+/** The result of reading one file for preview. */
+export interface FileRead {
+    /** Text content (decoded utf-8), or a data URL for image kinds. */
+    content: string;
+    /** True when the text was truncated at the preview ceiling. */
+    truncated: boolean;
+    /** Total size in bytes. */
+    size: number;
+    /** Last-modified epoch millis (the write-conflict base). */
+    mtime: number;
+    /** Image dimensions when the file is an image (host decodes via probe). */
+    image?: {
+        width: number;
+        height: number;
+    };
+}
+/** One filename-search hit. */
+export interface SearchHit {
+    /** Path relative to the root. */
+    path: string;
+    /** Display name (basename). */
+    name: string;
+    isDir: boolean;
+}
+/** The filename-search result. */
+export interface SearchView {
+    /** The query the hits were ranked for. */
+    query: string;
+    hits: SearchHit[];
+    /** True when the hit cap cut the result stream. */
+    truncated: boolean;
+}
+/** Working-tree state of one change row. */
+export type GitFileState = 'created' | 'modified' | 'deleted' | 'renamed' | 'conflicted' | 'untracked' | 'unknown';
+/** One change row in a git status. */
+export interface GitChangeRow {
+    /** Path relative to the repo root. */
+    path: string;
+    /** Original path for renames (old -> new). */
+    oldPath?: string;
+    state: GitFileState;
+    /** True when the change sits in the index (staged). */
+    staged: boolean;
+}
+/** The git status view of one repo root. */
+export interface GitStatusView {
+    /** Repo root (git rev-parse --show-toplevel). */
+    root: string;
+    /** Current branch name; '' when detached. */
+    branch: string;
+    /** Staged changes (index vs HEAD). */
+    staged: GitChangeRow[];
+    /** Unstaged changes (worktree vs index). */
+    unstaged: GitChangeRow[];
+    /** Untracked files (worktree, not in index). */
+    untracked: GitChangeRow[];
+}
+/** The result of a stage/unstage/discard batch. */
+export interface GitBatchResult {
+    /** Rows the operation actually changed (post-op status snapshot for these paths). */
+    applied: string[];
+    /** Paths the host refused to touch. */
+    failed: string[];
+}
+/** One preview tab identity as persisted. */
+export interface PreviewTabMeta {
+    /** Stable tab id (root + path + type). */
+    id: string;
+    /** Display title (basename). */
+    title: string;
+    /** Project root the file belongs to. */
+    root: string;
+    /** File path relative to the root. */
+    path: string;
+    contentType: PreviewContentType;
+    /** Whether the tab carries unsaved edits. */
+    dirty?: boolean;
+    /** Last write timestamp the tab's content was based on (conflict base). */
+    mtime?: number;
+    /** When the tab was last touched (LRU ordering within a scope). */
+    savedAt: number;
+}
+/** Preview content kinds the panel can render. */
+export type PreviewContentType = 'markdown' | 'html' | 'code' | 'diff' | 'csv' | 'pdf' | 'word' | 'excel' | 'ppt' | 'image' | 'text' | 'url' | 'unsupported';
+//# sourceMappingURL=types.d.ts.map

package/lib/types/core/types.d.ts.map

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