@liyuera/dsh-dev-dock 0.0.0-stage → 1.0.4

package/lib/invariant.js

@@ -0,0 +1,24 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@liyuera/dsh-dev-dock`.
+* @module @liyuera/dsh-dev-dock/invariant
+*/
+const PACKAGE_NAME = "@liyuera/dsh-dev-dock";
+/** Cordis companion plugin name. */
+const name = "dev-dock-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the plugin owns no cross-plugin event stream. The
+* HMR-safety specs prove tool/slot registration disposal, and the settings
+* namespace relation is asserted by the schema specs.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/actions.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Host desktop actions: resolve the workspace IDE, open it, open a system
+ * terminal at the workspace directory, and run the batch start-work flow.
+ * All actions are deterministic (no agent, no approval prompt — the button
+ * click is the user's authorization); the only guard is the sandbox mode:
+ * `read-only` denies desktop side effects.
+ * @module @liyuera/dsh-dev-dock/actions
+ */
+import type { DevDockSettings } from './schema.ts';
+import type { PlatformFacts } from './platform/runner.ts';
+/** Settings scope facade the desktop actions read and mutate. */
+export interface DesktopScope {
+    /** Read the current settings document. */
+    get(): DevDockSettings;
+    /** Merge a partial patch into the document. */
+    update(patch: Partial<DevDockSettings>): void;
+}
+/** Minimal workspace record the actions need (live registry face). */
+export interface DesktopWorkspace {
+    /** Stable workspace registry id. */
+    id: string;
+    /** Canonical directory path. */
+    path: string;
+    /** Display title. */
+    title: string;
+}
+/** Unary result of one desktop action. */
+export type DesktopActionResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Whether a directory shows uni-app/miniapp traits (manifest.json markers).
+ * @param workspacePath - canonical workspace directory.
+ * @returns true when the traits are present.
+ */
+export declare function hasUniAppTraits(workspacePath: string): boolean;
+/**
+ * Default editor for one workspace: uni-app traits prefer HBuilderX, other
+ * projects prefer WebStorm, then the remaining installed editors in order.
+ * @param workspacePath - canonical workspace directory.
+ * @param installed - detected editor names.
+ * @returns the default editor name, or undefined when nothing is installed.
+ */
+export declare function defaultEditorFor(workspacePath: string, installed: readonly string[]): string | undefined;
+/**
+ * Resolve the executable path for one editor: manual path wins, then the
+ * cached detected path, then a live detection pass.
+ * @param scope - settings scope.
+ * @param facts - platform facts.
+ * @param editorName - canonical editor name.
+ * @returns the resolved path or an error message.
+ */
+export declare function editorExecutablePath(scope: DesktopScope, facts: PlatformFacts, editorName: string): Promise<{
+    ok: true;
+    path: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+/**
+ * Resolve which editor opens one workspace: the stored preference wins;
+ * otherwise a default is derived from the content traits and installed
+ * editors. The executable path is resolved from the same entry.
+ * @param scope - settings scope.
+ * @param facts - platform facts.
+ * @param workspace - target workspace.
+ * @returns editor name and executable path, or an error message.
+ */
+export declare function resolveWorkspaceEditor(scope: DesktopScope, facts: PlatformFacts, workspace: DesktopWorkspace): Promise<{
+    ok: true;
+    editor: string;
+    path: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+/**
+ * Open one workspace in its default editor.
+ * @param scope - settings scope.
+ * @param facts - platform facts.
+ * @param workspace - target workspace.
+ * @returns ok, or an error message.
+ */
+export declare function openIdeFor(scope: DesktopScope, facts: PlatformFacts, workspace: DesktopWorkspace): Promise<DesktopActionResult>;
+/**
+ * Open one workspace directory in a system terminal window.
+ * @param scope - settings scope.
+ * @param facts - platform facts.
+ * @param workspace - target workspace.
+ * @returns ok, or an error message.
+ */
+export declare function openTerminalFor(scope: DesktopScope, facts: PlatformFacts, workspace: DesktopWorkspace): Promise<DesktopActionResult>;
+/**
+ * Run the full start action for one workspace: editor first, then terminal.
+ * @param scope - settings scope.
+ * @param facts - platform facts.
+ * @param workspace - target workspace.
+ * @returns ok, or the first error (the other half is still attempted).
+ */
+export declare function startFor(scope: DesktopScope, facts: PlatformFacts, workspace: DesktopWorkspace): Promise<DesktopActionResult>;
+/**
+ * Run the start-work batch: for each selected workspace, open its editor and
+ * a system terminal, with a gap between consecutive editor launches.
+ * @param scope - settings scope.
+ * @param facts - platform facts.
+ * @param workspaces - selected workspaces in selection order.
+ * @returns per-workspace results plus totals.
+ */
+export declare function startWorkFor(scope: DesktopScope, facts: PlatformFacts, workspaces: readonly DesktopWorkspace[]): Promise<{
+    ok: boolean;
+    opened: number;
+    started: number;
+    items: Array<{
+        workspaceId: string;
+        ok: boolean;
+        error?: string;
+    }>;
+}>;
+/** Whether an editor name is one of the known canonical names. */
+export declare function isKnownEditor(name: string): boolean;
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1,25 @@
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { DevDockActions, DevDockData } from './data.ts';
+import { NS } from './locales.ts';
+/** Registration-side inject face for the composer action group. */
+export interface ComposerActionsInjected {
+    /** Data mutation and desktop actions. */
+    dataActions: DevDockActions;
+    hooks: {
+        /** Settings snapshot bound by the renderer as useDevDockData. */
+        devDockData: {
+            getSnapshot(): DevDockData;
+            subscribe(fn: () => void): () => void;
+        };
+    };
+}
+/** Full component props for the composer action group (left/right seats
+ * carry the same InputZone standard props, so both registrations accept it). */
+export type ComposerActionsProps = PropsRuntime<'conversation.input.left'> & PropsRuntime<'conversation.input.right'> & PropsLocale<typeof NS> & InjectFace<ComposerActionsInjected>;
+/**
+ * The composer tool-row action group.
+ * @param props - input-zone runtime, settings mirror, actions, translator.
+ * @returns the three buttons, or null when the session has no workspace.
+ */
+export declare function ComposerActions({ sessionId, useWorkspaces, useDevDockData, dataActions, t }: ComposerActionsProps): import("react").JSX.Element | null;
+//# sourceMappingURL=ComposerActions.d.ts.map

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

@@ -0,0 +1,29 @@
+import type { InjectFace, PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { DevDockActions, DevDockData } from './api.ts';
+import { NS } from './locales.ts';
+import type { createDevDockStore } from './stores.ts';
+/** Registration-side inject face for the drawer. */
+export interface DevDockDrawerInjected {
+    hooks: {
+        /** Settings snapshot bound by the renderer as useDevDockData. */
+        devDockData: {
+            getSnapshot(): DevDockData;
+            subscribe(fn: () => void): () => void;
+        };
+    };
+    /** Data mutation actions (named distinctly from the store actions prop). */
+    dataActions: DevDockActions;
+    /** Prompt the current session to run a dev-dock action tool. */
+    promptAgent: (text: string) => Promise<boolean>;
+    /** Open the host's native single-directory chooser; null when cancelled. */
+    pickDirectory: () => Promise<string | null>;
+}
+/** Full component props for the drawer. */
+export type DevDockDrawerProps = PropsRuntime<'shell.overlay'> & PropsStore<ReturnType<typeof createDevDockStore>> & PropsLocale<typeof NS> & InjectFace<DevDockDrawerInjected>;
+/**
+ * The devDock overlay drawer.
+ * @param props - overlay runtime, view store, data hook, actions, translator.
+ * @returns the drawer panel, or null when closed.
+ */
+export declare function DevDockDrawer({ useStore, actions: view, useDevDockData, dataActions, promptAgent, pickDirectory, t }: DevDockDrawerProps): import("react").JSX.Element | null;
+//# sourceMappingURL=DevDockDrawer.d.ts.map

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

@@ -0,0 +1,28 @@
+/**
+ * Sidebar footer entry: a full-width row above Settings showing the devDock
+ * title and the workspace-project count; clicking opens the start-work
+ * dialog. Renders a compact icon on the 56px rail.
+ */
+import type { InjectFace, PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { DevDockData } from './data.ts';
+import { NS } from './locales.ts';
+import type { createDevDockStore } from './stores.ts';
+/** Registration-side inject face: the settings mirror bound as useDevDockData. */
+export interface DevDockEntryInjected {
+    hooks: {
+        /** Settings snapshot bound by the renderer as useDevDockData. */
+        devDockData: {
+            getSnapshot(): DevDockData;
+            subscribe(fn: () => void): () => void;
+        };
+    };
+}
+/** Full component props for the footer entry. */
+export type DevDockEntryProps = PropsRuntime<'sidebar.footer.action'> & PropsStore<ReturnType<typeof createDevDockStore>> & PropsLocale<typeof NS> & InjectFace<DevDockEntryInjected>;
+/**
+ * The sidebar footer entry row.
+ * @param props - footer owner state, view store, workspace list, translator.
+ * @returns the entry button.
+ */
+export declare function DevDockEntry({ wide, useWorkspaces, actions, t }: DevDockEntryProps): import("react").JSX.Element;
+//# sourceMappingURL=DevDockEntry.d.ts.map

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

@@ -0,0 +1,24 @@
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type DevDockActions, type DevDockData } from './data.ts';
+import { NS } from './locales.ts';
+/** Registration-side inject face for the settings page. */
+export interface DevDockSettingsInjected {
+    hooks: {
+        /** Settings snapshot bound by the renderer as useDevDockData. */
+        devDockData: {
+            getSnapshot(): DevDockData;
+            subscribe(fn: () => void): () => void;
+        };
+    };
+    /** Data mutation and desktop actions. */
+    dataActions: DevDockActions;
+}
+/** Full component props for the settings page. */
+export type DevDockSettingsPageProps = PropsRuntime<'settings.section'> & PropsLocale<typeof NS> & InjectFace<DevDockSettingsInjected>;
+/**
+ * Render the devDock settings page.
+ * @param props - settings runtime, data hook, actions, translator.
+ * @returns the settings sections.
+ */
+export declare function DevDockSettingsPage({ useWorkspaces, useDevDockData, dataActions, t }: DevDockSettingsPageProps): import("react").JSX.Element;
+//# sourceMappingURL=DevDockSettingsPage.d.ts.map

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

@@ -0,0 +1,25 @@
+/**
+ * Start-work tile: a 16px rounded square split from top-right to
+ * bottom-left — the terminal icon in the upper-left half, the editor icon in
+ * the lower-right half, no border or padding, with a soft diagonal seam
+ * blending the two halves. Used by the session-header start button and the
+ * sidebar start-work button, with app icons when resolvable and
+ * app-icon-style fallbacks otherwise.
+ * @module @liyuera/dsh-dev-dock/client/StartTile
+ */
+/** Tile props: one app-icon URL per half; missing URLs fall back to art. */
+export interface StartTileProps {
+    /** Editor app icon URL (the IDE half). */
+    ideSrc?: string | undefined;
+    /** Terminal app icon URL (the terminal half). */
+    termSrc?: string | undefined;
+    /** Tile edge in pixels (default 16). */
+    size?: number;
+}
+/**
+ * Render the combined start-work tile.
+ * @param props - optional app-icon URLs per half and the tile edge.
+ * @returns the split tile.
+ */
+export declare function StartTile({ ideSrc, termSrc, size }: StartTileProps): import("react").JSX.Element;
+//# sourceMappingURL=StartTile.d.ts.map

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

@@ -0,0 +1,28 @@
+/**
+ * Sidebar footer start-work button: the "开始上班" row that opens the
+ * workspace-selection dialog. Follows the sidebar footer action style —
+ * ghost row, icon + label on the wide sidebar, icon-only on the 56px rail.
+ */
+import type { InjectFace, PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { DevDockData } from './data.ts';
+import { NS } from './locales.ts';
+import type { createDevDockStore } from './stores.ts';
+/** Registration-side inject face: the settings mirror bound as useDevDockData. */
+export interface StartWorkButtonInjected {
+    hooks: {
+        /** Settings snapshot bound by the renderer as useDevDockData. */
+        devDockData: {
+            getSnapshot(): DevDockData;
+            subscribe(fn: () => void): () => void;
+        };
+    };
+}
+/** Full component props for the start-work footer button. */
+export type StartWorkButtonProps = PropsRuntime<'sidebar.footer.action'> & PropsStore<ReturnType<typeof createDevDockStore>> & PropsLocale<typeof NS> & InjectFace<StartWorkButtonInjected>;
+/**
+ * The sidebar footer start-work button.
+ * @param props - footer owner state, view store, settings mirror, translator.
+ * @returns the button row.
+ */
+export declare function StartWorkButton({ wide, useWorkspaces, useDevDockData, actions, t }: StartWorkButtonProps): import("react").JSX.Element;
+//# sourceMappingURL=StartWorkButton.d.ts.map

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

@@ -0,0 +1,25 @@
+import type { InjectFace, PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { DevDockActions, DevDockData } from './data.ts';
+import { NS } from './locales.ts';
+import type { createDevDockStore } from './stores.ts';
+/** Registration-side inject face for the dialog. */
+export interface StartWorkModalInjected {
+    hooks: {
+        /** Settings snapshot bound by the renderer as useDevDockData. */
+        devDockData: {
+            getSnapshot(): DevDockData;
+            subscribe(fn: () => void): () => void;
+        };
+    };
+    /** Data mutation and desktop actions. */
+    dataActions: DevDockActions;
+}
+/** Full component props for the start-work dialog. */
+export type StartWorkModalProps = PropsRuntime<'shell.overlay'> & PropsStore<ReturnType<typeof createDevDockStore>> & PropsLocale<typeof NS> & InjectFace<StartWorkModalInjected>;
+/**
+ * The start-work dialog.
+ * @param props - overlay runtime, view store, data hook, actions, translator.
+ * @returns the modal, or null when closed.
+ */
+export declare function StartWorkModal({ useStore, actions, useWorkspaces, useDevDockData, dataActions, t }: StartWorkModalProps): import("react").JSX.Element | null;
+//# sourceMappingURL=StartWorkModal.d.ts.map

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

@@ -0,0 +1,56 @@
+/**
+ * devDock browser data layer: binds the plugin's settings namespace through
+ * the settingsScope service and exposes a snapshot store plus mutation
+ * actions to the UI. Agent-facing actions (open IDE / terminal / quick-start)
+ * are routed through the current session's prompt so the approval pipeline
+ * and tool cards apply.
+ * @module @liyuera/dsh-dev-dock/client/api
+ */
+import { type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-runtime/client';
+import type { DevDockSettings, EditorRecord, ProjectRecord, QuickStartPlan } from '../schema.ts';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** The ui-settings settingsScope service (declared locally: the package
+         *  root's own augmentation is not pulled by type-only imports). */
+        settingsScope: {
+            bind<T>(spec: {
+                namespace: string;
+                decode?: (section: unknown) => T | undefined;
+            }): SettingsScope<T>;
+        };
+    }
+}
+/** Client-visible data snapshot: settings document plus readiness. */
+export interface DevDockData {
+    /** Loading until the first accepted settings section. */
+    ready: boolean;
+    /** The settings document; undefined before readiness. */
+    settings: DevDockSettings | undefined;
+}
+/** Actions the UI may invoke on the data layer. */
+export interface DevDockActions {
+    /** Upsert one project record (id minted host-side on insert). */
+    saveProject(project: Omit<ProjectRecord, 'id' | 'createdAt'>): Promise<void>;
+    /** Remove one project; cascades quick-start references host-side. */
+    removeProject(projectId: string): Promise<void>;
+    /** Replace the editor records. */
+    setEditors(editors: EditorRecord[]): Promise<void>;
+    /** Replace the quick-start plans. */
+    setQuickStarts(plans: QuickStartPlan[]): Promise<void>;
+    /** Replace one quick-start plan. */
+    setQuickStartPlan(plan: QuickStartPlan): Promise<void>;
+    /** Prompt the current session to run a devDock action tool. */
+    promptAgent(text: string): Promise<boolean>;
+}
+/**
+ * Create the devDock data layer for one client plugin fiber.
+ * @param ctx - client root context (needs settingsScope, remote, connection).
+ * @returns the data store and action facade.
+ */
+export declare function createDevDockData(ctx: ClientContext): {
+    store: SnapshotStore<DevDockData>;
+    actions: DevDockActions;
+};
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1,75 @@
+/**
+ * devDock browser data layer v2: mirrors the plugin's document from the host
+ * through the same-origin `/dev-dock/state` route and exposes the
+ * desktop-action bridge. Both are plain HTTP because static client bundles
+ * have no package-private RPC channel (host.call is a dynamic-plugin
+ * builtin); the host half owns the storage domain behind that route and runs
+ * the deterministic desktop actions.
+ * @module @liyuera/dsh-dev-dock/client/data
+ */
+import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import type { DevDockSettings } from '../schema.ts';
+/** Client-visible data snapshot: document plus readiness. */
+export interface DevDockData {
+    /** Loading until the first accepted state read. */
+    ready: boolean;
+    /** The document; undefined before readiness. */
+    settings: DevDockSettings | undefined;
+}
+/** One desktop-action request the browser half sends to the host route. */
+export interface ActionRequest {
+    action: 'list-editors' | 'open-ide' | 'open-terminal' | 'start' | 'start-work';
+    workspaceId?: string;
+    workspaceIds?: string[];
+}
+/** Unary host answer (list-editors rides editors on ok). */
+export interface ActionResult {
+    ok: boolean;
+    error?: string;
+}
+/** Start-work answer shape from the host. */
+export interface StartWorkResult {
+    ok: boolean;
+    opened: number;
+    started: number;
+    error?: string;
+    items: Array<{
+        workspaceId: string;
+        ok: boolean;
+        error?: string;
+    }>;
+}
+/** Actions the UI may invoke on the data layer. */
+export interface DevDockActions {
+    /** Record one workspace's IDE preference (upsert by workspaceId). */
+    setWorkspacePref(workspaceId: string, editor: string): Promise<void>;
+    /** Record one editor's manual path (upsert by name). */
+    setEditorManualPath(name: string, manualPath: string): Promise<void>;
+    /** Record the terminal preference. */
+    setTerminalApp(app: 'default' | 'iterm'): Promise<void>;
+    /** Record the start-work selection memory. */
+    setStartWork(workspaceIds: string[]): Promise<void>;
+    /** Detect installed editors host-side and refresh the cache. */
+    listEditors(): Promise<ActionResult>;
+    /** Open the workspace in its default editor. */
+    openIde(workspaceId: string): Promise<ActionResult>;
+    /** Open a system terminal at the workspace. */
+    openTerminal(workspaceId: string): Promise<ActionResult>;
+    /** Open editor + terminal for one workspace. */
+    start(workspaceId: string): Promise<ActionResult>;
+    /** Open editor + terminal for the selected workspaces. */
+    startWork(workspaceIds: string[]): Promise<StartWorkResult>;
+}
+/** Canonical editor names across platforms (union for stable UI display). */
+export declare const EDITOR_NAMES: readonly ["WebStorm", "VS Code", "IntelliJ IDEA", "Cursor", "Sublime Text", "HBuilderX"];
+/**
+ * Create the devDock data layer for one client plugin fiber.
+ * @param ctx - client root context, used to own the mirror's effects.
+ * @returns the document mirror and the action facade.
+ */
+export declare function createDevDockData(ctx: ClientContext): {
+    store: SnapshotStore<DevDockData>;
+    actions: DevDockActions;
+};
+//# sourceMappingURL=data.d.ts.map

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

@@ -0,0 +1,40 @@
+/**
+ * devDock proprietary action glyphs. The product icon set has no
+ * IDE/terminal glyphs (IconCodeOutline16 is a hash), so these three are
+ * drawn locally in the set's own vocabulary: single color (`currentColor`),
+ * 16px viewBox, ~1.4px stroke, the same density as IconPlayOutline16.
+ * @module @liyuera/dsh-dev-dock/client/icons
+ */
+/** Marker props shared by every action glyph. */
+export interface ActionIconProps {
+    size?: number;
+    className?: string | undefined;
+}
+/**
+ * IDE glyph: `</>` code brackets.
+ * @param props - icon size and optional class.
+ * @returns the 16px editor svg.
+ */
+export declare function DevIdeIcon({ size, className }: ActionIconProps): import("react").JSX.Element;
+/**
+ * Terminal glyph: `>_` prompt.
+ * @param props - icon size and optional class.
+ * @returns the 16px terminal svg.
+ */
+export declare function DevTerminalIcon({ size, className }: ActionIconProps): import("react").JSX.Element;
+/**
+ * App-icon-style terminal fallback: a dark rounded square with a light `>_`
+ * prompt, used where the real app icon is unavailable (Assets.car-only
+ * bundles, other platforms).
+ * @param props - icon size and optional class.
+ * @returns the 16px filled terminal svg.
+ */
+export declare function DevTerminalAppIcon({ size, className }: ActionIconProps): import("react").JSX.Element;
+/**
+ * App-icon-style editor fallback: a blue rounded square with a white `</>`
+ * mark, used where the real app icon is unavailable.
+ * @param props - icon size and optional class.
+ * @returns the 16px filled editor svg.
+ */
+export declare function DevIdeAppIcon({ size, className }: ActionIconProps): import("react").JSX.Element;
+//# sourceMappingURL=icons.d.ts.map

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

@@ -0,0 +1,27 @@
+/**
+ * devDock plugin v2, browser half: registers the locale dictionary, the
+ * sidebar footer start-work button, the three session-header action buttons
+ * (IDE / terminal / start), the start-work dialog, and the devDock settings
+ * page. All entries share one viewing store and the settings data mirror.
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import { type DevDockKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** devDock panel copy. */
+        devDock: DevDockKey;
+    }
+}
+export type { StartWorkButtonProps, StartWorkButtonInjected } from './StartWorkButton.tsx';
+export type { StartWorkModalProps, StartWorkModalInjected } from './StartWorkModal.tsx';
+export type { ComposerActionsProps, ComposerActionsInjected } from './ComposerActions.tsx';
+export type { DevDockSettingsPageProps, DevDockSettingsInjected } from './DevDockSettingsPage.tsx';
+export type { DevDockData, DevDockActions } from './data.ts';
+/** Required services for data binding and slot contributions. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register dictionaries and every surface entry.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,65 @@
+/**
+ * devDock v2 browser copy: entry row, start-work dialog, per-session header
+ * actions (IDE / terminal / start), and the settings page. Simplified from
+ * v1: projects are dsh workspaces; desktop actions are deterministic.
+ * @module @liyuera/dsh-dev-dock/client/locales
+ */
+/** devDock dictionary keys. */
+export declare const NS: "devDock";
+/** zh dict. */
+export declare const zh: {
+    readonly 'start.button': "开始上班";
+    readonly 'start.notice': "选择要启动的工作区项目（记住上次选择）";
+    readonly 'start.confirm': "启动";
+    readonly 'start.cancel': "取消";
+    readonly 'start.running': "正在启动…";
+    readonly 'start.done': "已打开 {opened} 个编辑器、{started} 个终端窗口";
+    readonly 'start.empty': "没有可用的工作区项目";
+    readonly 'start.noWorkspace': "请先在工作区添加项目";
+    readonly 'header.ide': "用 IDE 打开";
+    readonly 'header.terminal': "打开系统终端";
+    readonly 'header.start': "启动（IDE + 终端）";
+    readonly 'header.noWorkspace': "当前会话没有关联工作区";
+    readonly 'header.error': "操作失败：{error}";
+    readonly 'settings.title': "devDock";
+    readonly 'settings.workspacePref.title': "工作区编辑器偏好";
+    readonly 'settings.workspacePref.hint': "给每个工作区选择打开用的 IDE；不选则按内容自动检测（uni-app → HBuilderX，其它 → WebStorm）。";
+    readonly 'settings.editors.title': "编辑器";
+    readonly 'settings.editors.refresh': "重新检测";
+    readonly 'settings.editors.manual': "手动路径";
+    readonly 'settings.editors.save': "保存";
+    readonly 'settings.editors.hint': "检测不到或需要指定时，可手动填写（如 HBuilderX）。";
+    readonly 'settings.terminal.title': "终端";
+    readonly 'settings.terminal.default': "Terminal.app（默认）";
+    readonly 'settings.terminal.iterm': "iTerm2";
+};
+/** en dict. */
+export declare const en: {
+    readonly 'start.button': "Start Work";
+    readonly 'start.notice': "Select workspace projects to start (last selection remembered)";
+    readonly 'start.confirm': "Start";
+    readonly 'start.cancel': "Cancel";
+    readonly 'start.running': "Starting…";
+    readonly 'start.done': "Opened {opened} editor(s) and {started} terminal(s)";
+    readonly 'start.empty': "No workspace projects available";
+    readonly 'start.noWorkspace': "Add projects in the workspace area first";
+    readonly 'header.ide': "Open in IDE";
+    readonly 'header.terminal': "Open system terminal";
+    readonly 'header.start': "Start (IDE + terminal)";
+    readonly 'header.noWorkspace': "This session has no associated workspace";
+    readonly 'header.error': "Action failed: {error}";
+    readonly 'settings.title': "devDock";
+    readonly 'settings.workspacePref.title': "Workspace editor preference";
+    readonly 'settings.workspacePref.hint': "Pick the IDE each workspace opens with; auto-detected when unset (uni-app → HBuilderX, other → WebStorm).";
+    readonly 'settings.editors.title': "Editors";
+    readonly 'settings.editors.refresh': "Re-detect";
+    readonly 'settings.editors.manual': "Manual path";
+    readonly 'settings.editors.save': "Save";
+    readonly 'settings.editors.hint': "Set a manual path when detection misses (e.g. HBuilderX).";
+    readonly 'settings.terminal.title': "Terminal";
+    readonly 'settings.terminal.default': "Terminal.app (default)";
+    readonly 'settings.terminal.iterm': "iTerm2";
+};
+/** Full key type of the devDock dictionary. */
+export type DevDockKey = keyof typeof zh;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/pages/ImportPage.d.ts

@@ -0,0 +1,26 @@
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { DevDockData } from '../api.ts';
+import { NS } from '../locales.ts';
+/** Registration-side inject face (same shape as the drawer's). */
+export interface ImportInjected {
+    hooks: {
+        /** Settings snapshot bound by the renderer as useDevDockData. */
+        devDockData: {
+            getSnapshot(): DevDockData;
+            subscribe(fn: () => void): () => void;
+        };
+    };
+    /** Prompt the current session to run a dev-dock action tool. */
+    promptAgent: (text: string) => Promise<boolean>;
+    /** Open the host's native single-directory chooser; null when cancelled. */
+    pickDirectory: () => Promise<string | null>;
+}
+/** Full component props. */
+export type ImportPageProps = PropsLocale<typeof NS> & InjectFace<ImportInjected>;
+/**
+ * Render the import page.
+ * @param props - prompt channel, directory picker, data hook, translator.
+ * @returns the import form.
+ */
+export declare function ImportPage({ useDevDockData, promptAgent, pickDirectory, t }: ImportPageProps): import("react").JSX.Element;
+//# sourceMappingURL=ImportPage.d.ts.map