@jingyi0605/codingns4dsh 0.1.0

package/data/build/dist/shared/contracts/feature.d.ts

@@ -0,0 +1,71 @@
+export type FeatureState = 'disabled' | 'enabling' | 'enabled' | 'draining' | 'failed';
+/** 功能模块的承载端：Host 进程、浏览器，或两端都需要。 */
+export type FeatureRuntime = 'host' | 'client' | 'both';
+/** 功能开关的生效时机；未声明时按实时生效处理。 */
+export type FeatureActivation = 'live' | 'restart';
+/**
+ * 功能模块在设置界面中的静态描述。
+ *
+ * 它是设置页渲染卡片的唯一来源：卡片标题、说明文字、排序、初始展开状态和
+ * 开关可见性都从这里读取，因此新增模块不需要修改设置页代码。
+ */
+export interface FeatureUiDescriptor {
+    /** 设置卡片标题。 */
+    label: string;
+    /** 设置卡片说明。 */
+    description: string;
+    /** DSH locale 命名空间中的标题键；未提供时使用 label 原文。 */
+    labelKey?: string;
+    /** DSH locale 命名空间中的说明键；未提供时使用 description 原文。 */
+    descriptionKey?: string;
+    /** 排序权重，升序靠前；缺省按 0 处理。 */
+    order?: number;
+    /** 卡片初始是否展开。 */
+    defaultOpen?: boolean;
+    /** 启动即生效、不提供关闭入口的模块；设置页只展示当前的启用状态。 */
+    alwaysEnabled?: boolean;
+    /** 旧版 DSH 仍可运行但能力降级时显示的提示。 */
+    legacyFallback?: boolean;
+    /** 旧版兼容提示使用的 locale key；未提供时使用通用提示。 */
+    legacyFallbackKey?: string;
+}
+export interface FeatureDescriptor {
+    /** 稳定标识：同时作为依赖引用名与设置中的启用键。 */
+    name: string;
+    version: string;
+    enabledByDefault: boolean;
+    dependencies: string[];
+    runtime: FeatureRuntime;
+    /** `restart` 表示只保存下次启动意图，当前进程不跟随设置变化启停。 */
+    activation?: FeatureActivation;
+    /** 模块要求的最低 DSH 版本；低于该版本时不得启动。 */
+    minimumDshVersion?: string;
+    /** 提供后该模块出现在设置页；缺省表示它没有界面。 */
+    ui?: FeatureUiDescriptor;
+}
+/** 模块启动期间可登记的资源释放函数。 */
+export type FeatureDisposer = () => void | Promise<void>;
+/** 以逆序释放模块所拥有资源的集合。 */
+export interface FeatureResourceScope {
+    add(disposer: FeatureDisposer): void;
+    dispose(): Promise<void>;
+    readonly disposed: boolean;
+}
+/**
+ * 模块的运行上下文。
+ *
+ * @typeParam S - 宿主创建注册表时注入的服务集合。
+ */
+export interface FeatureContext<S = unknown> {
+    readonly descriptor: FeatureDescriptor;
+    readonly resources: FeatureResourceScope;
+    readonly services: S;
+}
+/** 可由模块注册表管理的功能模块。 */
+export interface FeatureModule<S = unknown> {
+    descriptor: FeatureDescriptor;
+    start(context: FeatureContext<S>): void | FeatureDisposer | Promise<void | FeatureDisposer>;
+    drain?(context: FeatureContext<S>): void | Promise<void>;
+    dispose?(context: FeatureContext<S>): void | Promise<void>;
+}
+//# sourceMappingURL=feature.d.ts.map

package/data/build/dist/shared/contracts/feature.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=feature.js.map

package/data/build/dist/shared/contracts/host-status.d.ts

@@ -0,0 +1,14 @@
+/** DSH Host 当前资源与访问链路摘要。 */
+export interface DshHostStatus {
+    /** 当前进程采样得到的主机 CPU 使用率（0-100）。 */
+    cpuPercent: number;
+    /** 当前主机物理内存使用率（0-100）。 */
+    memoryPercent: number;
+    /** 已使用内存字节数。 */
+    memoryUsedBytes: number;
+    /** 总内存字节数。 */
+    memoryTotalBytes: number;
+    /** Host 采样时间戳。 */
+    sampledAt: number;
+}
+//# sourceMappingURL=host-status.d.ts.map

package/data/build/dist/shared/contracts/host-status.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host-status.js.map

package/data/build/dist/shared/contracts/lan-access-dsh.d.ts

@@ -0,0 +1,30 @@
+import type { LoginProtectionScopes } from './config.js';
+/** “局域网访问 DSH”唯一一条监听配置。 */
+export interface LanAccessDshConfig {
+    /** 监听地址：本机网卡地址，或 0.0.0.0 监听所有 IPv4 网卡。 */
+    listenHost: string;
+    /** 局域网访问入口端口，默认 13080；填 0 时由系统分配。 */
+    listenPort: number;
+    /** 当前 DSH Web 的本地端口。 */
+    dshPort: number;
+    /** 可选的 Host 侧登录保护；凭据不会进入此配置快照。 */
+    login?: LanAccessDshLoginConfig;
+}
+export interface LanAccessDshLoginConfig {
+    enabled: boolean;
+    username: string;
+    passwordHash: string;
+    passwordSalt: string;
+    timeoutSeconds: number;
+    scopes: LoginProtectionScopes;
+}
+export type LanAccessDshState = 'stopped' | 'starting' | 'listening' | 'error';
+/** 局域网访问 DSH 的运行快照。 */
+export interface LanAccessDshSnapshot extends Omit<LanAccessDshConfig, 'login'> {
+    state: LanAccessDshState;
+    actualListenPort: number | null;
+    detectedDshPorts: readonly number[];
+    error: string | null;
+    loginEnabled: boolean;
+}
+//# sourceMappingURL=lan-access-dsh.d.ts.map

package/data/build/dist/shared/contracts/lan-access-dsh.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lan-access-dsh.js.map

package/data/build/dist/shared/contracts/peer-host.d.ts

@@ -0,0 +1,37 @@
+export type PeerHostStatus = 'unknown' | 'checking' | 'ready' | 'unreachable' | 'version_mismatch' | 'session_required' | 'disabled';
+export interface PeerHostRecord {
+    peerHostId: string;
+    name: string;
+    baseUrl: string;
+    status: PeerHostStatus;
+    remoteVersion: string | null;
+    remoteApiCompatibility: string | null;
+    remoteHostFingerprint: string | null;
+    lastCheckedAt: string | null;
+    lastErrorCode: string | null;
+}
+export interface ResourceScopeRef {
+    hostId: string;
+    workspaceId: string;
+    targetHostId: string | null;
+    scopeGeneration: number;
+}
+/**
+ * 作用域切换时使用的输入，不允许调用方自行伪造 generation。
+ * generation 只能由 ResourceScopeManager 分配。
+ */
+export interface ResourceScopeInput {
+    hostId: string;
+    workspaceId: string;
+    targetHostId: string | null;
+}
+/** 对外暴露的只读作用域快照。 */
+export type ResourceScopeSnapshot = Readonly<ResourceScopeRef>;
+/** 作用域拥有的清理函数。清理函数必须可重复调用而不会产生副作用。 */
+export type ResourceScopeDisposer = () => void | Promise<void>;
+/** 作用域已经失效时统一抛出的错误。 */
+export declare class ResourceScopeStaleError extends Error {
+    readonly code: "RESOURCE_SCOPE_STALE";
+    constructor(message?: string);
+}
+//# sourceMappingURL=peer-host.d.ts.map

package/data/build/dist/shared/contracts/peer-host.js

@@ -0,0 +1,9 @@
+/** 作用域已经失效时统一抛出的错误。 */
+export class ResourceScopeStaleError extends Error {
+    code = 'RESOURCE_SCOPE_STALE';
+    constructor(message = 'Resource scope is stale') {
+        super(message);
+        this.name = 'ResourceScopeStaleError';
+    }
+}
+//# sourceMappingURL=peer-host.js.map

package/data/build/dist/shared/contracts/signaling.d.ts

@@ -0,0 +1,67 @@
+export interface RelayIceServer {
+    urls: string | string[];
+    username?: string;
+    credential?: string;
+}
+export interface RelaySignalingTicketRequest {
+    tunnelDomain?: string;
+    bindingId?: string;
+    hostDtlsFingerprint?: string;
+    credentialVersion?: number;
+}
+export interface RelaySignalingTicketResponse {
+    ticket: string;
+    expiresAt: string;
+    signalingBaseUrl: string;
+    iceServers: RelayIceServer[];
+    iceTransportPolicy: 'all' | 'relay';
+    hostDtlsFingerprint: string;
+    bindingId: string;
+    tunnelDomain: string;
+    trafficRemainingBytes: string;
+    credentialVersion?: number;
+}
+export type RelaySignalingClientMessage = {
+    type: 'offer';
+    sdp: string;
+} | {
+    type: 'candidate';
+    candidate: string;
+    mid: string | null;
+} | {
+    type: 'ping';
+    at: string;
+};
+export type RelaySignalingServerMessage = {
+    type: 'registered';
+    role: 'client' | 'host';
+    bindingId: string;
+    sessionId: string | null;
+} | {
+    type: 'peer-ready';
+    peerRole: 'client' | 'host';
+    sessionId: string | null;
+} | {
+    type: 'peer-left';
+    peerRole: 'client' | 'host';
+    sessionId: string | null;
+} | {
+    type: 'answer';
+    sdp: string;
+    senderRole: 'host';
+    sessionId: string;
+} | {
+    type: 'candidate';
+    candidate: string;
+    mid: string | null;
+    senderRole: 'host';
+    sessionId: string;
+} | {
+    type: 'pong';
+    at: string;
+} | {
+    type: 'error';
+    errorCode: string;
+    detail: string;
+};
+//# sourceMappingURL=signaling.d.ts.map

package/data/build/dist/shared/contracts/signaling.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signaling.js.map

package/data/build/dist/shared/contracts/subscription.d.ts

@@ -0,0 +1,69 @@
+/** 单个 Provider 订阅窗口的脱敏用量。百分比均为 0 到 100。 */
+export interface CliSubscriptionWindow {
+    readonly usedPercent: number;
+    readonly remainingPercent: number;
+    readonly windowDurationMins: number | null;
+    readonly resetsAt: number | null;
+    readonly remainingCredits?: number;
+    readonly totalCredits?: number;
+}
+/** Host 读取 Provider 订阅后返回给 Client 的安全摘要。 */
+export interface CliSubscriptionUsage {
+    readonly authenticated: boolean;
+    readonly planType: string | null;
+    readonly primary: CliSubscriptionWindow | null;
+    readonly secondary: CliSubscriptionWindow | null;
+    readonly monthly: CliSubscriptionWindow | null;
+    readonly rateLimitReachedType: string | null;
+    readonly resetCredits: null | {
+        readonly availableCount: number;
+        readonly credits: readonly {
+            readonly id: string | null;
+            readonly expiresAt: number | null;
+            readonly title: string | null;
+            readonly description: string | null;
+        }[];
+    };
+    readonly capturedAt: string;
+    /** 第三方上游的账户余额和用量摘要；原始 API key 永不进入此结构。 */
+    readonly sub2api?: Sub2ApiUsage;
+}
+export interface Sub2ApiUsagePoint {
+    readonly requests: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheCreationTokens: number;
+    readonly cacheReadTokens: number;
+    readonly totalTokens: number;
+    readonly cost: number;
+    readonly actualCost: number;
+    readonly cacheHitRate: number;
+}
+export interface Sub2ApiDailyUsage extends Sub2ApiUsagePoint {
+    readonly date: string;
+}
+export interface Sub2ApiModelUsage extends Sub2ApiUsagePoint {
+    readonly model: string;
+    readonly accountCost: number;
+}
+export interface Sub2ApiUsage {
+    readonly upstreamType: 'Sub2API' | 'OneAPI' | '其他';
+    /** 已移除 query、fragment、userinfo 的可公开上游地址。 */
+    readonly upstreamUrl: string;
+    /** Host 侧按需获取并内联的图标；失败时为空字符串。 */
+    readonly logoDataUrl?: string;
+    readonly logoUrl: string;
+    readonly balance: number;
+    readonly remaining: number;
+    readonly unit: string;
+    readonly planName: string | null;
+    readonly mode: string | null;
+    readonly today: Sub2ApiUsagePoint;
+    readonly total: Sub2ApiUsagePoint;
+    readonly daily: readonly Sub2ApiDailyUsage[];
+    readonly models: readonly Sub2ApiModelUsage[];
+    readonly rpm: number | null;
+    readonly tpm: number | null;
+    readonly averageDurationMs: number | null;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/data/build/dist/shared/contracts/subscription.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subscription.js.map

package/data/build/dist/shared/contracts/terminal-process.d.ts

@@ -0,0 +1,65 @@
+import type { CodingNsTerminalRuntimeType, CodingNsTerminalShell, CodingNsWebTerminalInfo } from './terminal.js';
+/** 终端侧可直接启动的配置；完整调试编排仍由 Spec003 负责。 */
+export interface TerminalLaunchProfile {
+    readonly id: string;
+    readonly workspaceId: string;
+    readonly name: string;
+    /** 相对于 Workspace 根目录，禁止保存绝对路径。 */
+    readonly cwdRelative: string;
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly env: Readonly<Record<string, string>>;
+    readonly shell: CodingNsTerminalShell;
+    readonly runtimeType: CodingNsTerminalRuntimeType;
+    readonly runtimeMode: 'pty';
+    readonly revision: number;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface TerminalLaunchProfileInput {
+    readonly id: string;
+    readonly workspaceId: string;
+    readonly name: string;
+    readonly cwdRelative: string;
+    readonly command: string;
+    readonly args?: readonly string[];
+    readonly env?: Readonly<Record<string, string>>;
+    readonly shell: CodingNsTerminalShell;
+    readonly runtimeType: CodingNsTerminalRuntimeType;
+    readonly runtimeMode?: 'pty';
+}
+export type TerminalProcessState = 'starting' | 'running' | 'stopping' | 'exited' | 'failed' | 'lost';
+/** 一次由 Host 创建、并可附着到终端的实际进程记录。 */
+export interface TerminalProcessInstance {
+    readonly id: string;
+    readonly workspaceId: string;
+    readonly profileId: string;
+    readonly terminalId: string;
+    readonly runtimeSessionKey: string | null;
+    readonly state: TerminalProcessState;
+    readonly pid: number | null;
+    readonly resolvedCommand: {
+        readonly command: string;
+        readonly args: readonly string[];
+        readonly cwd: string;
+    };
+    readonly exitCode: number | null;
+    readonly error?: string;
+    readonly startedAt: string | null;
+    readonly stoppedAt: string | null;
+}
+export interface TerminalProcessLaunchRequest {
+    readonly workspaceId: string;
+    readonly profileId: string;
+    readonly dshSessionId?: string;
+    readonly terminalId?: string;
+    readonly cols: number;
+    readonly rows: number;
+    /** 直接启动命令，或先启动 Shell 再把命令写入终端。 */
+    readonly commandMode?: 'direct' | 'shell-input';
+}
+export interface TerminalProcessLaunchResult {
+    readonly instance: TerminalProcessInstance;
+    readonly terminal: CodingNsWebTerminalInfo;
+}
+//# sourceMappingURL=terminal-process.d.ts.map

package/data/build/dist/shared/contracts/terminal-process.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal-process.js.map

package/data/build/dist/shared/contracts/terminal.d.ts

@@ -0,0 +1,127 @@
+/** 插件 Sidebar 终端兼容层使用的终端状态。 */
+export type WebTerminalId = string;
+export type TerminalAttachmentId = string;
+export type CodingNsTerminalState = 'starting' | 'running' | 'exited' | 'closing' | 'lost' | 'closed' | 'error';
+/** 持久终端所使用的本机运行时。 */
+export type CodingNsTerminalRuntimeType = 'local-pty' | 'tmux' | 'conpty-powershell' | 'conpty-cmd' | 'conpty-git-bash';
+/**
+ * 可跨浏览器、插件 generation 和 DSH 重启恢复的记录。
+ *
+ * 这里故意不包含 generation、stream、Socket、订阅回调或本机控制凭据；这些
+ * 都是一次 attach 的短命资源，不能反过来拥有 tmux/ConPTY 进程。
+ */
+export interface PersistentTerminalRecord {
+    readonly hostId: string;
+    readonly workspaceId: string;
+    /** 最近一次 attach 所在的 DSH session；仅兼容旧记录和诊断，不参与归属或主键。 */
+    readonly dshSessionId?: string;
+    readonly terminalId: string;
+    readonly runtimeSessionKey: string;
+    readonly runtimeType: CodingNsTerminalRuntimeType;
+    /** 终端 UI 显示的 shell；启动项 PTY 可以另外指定实际命令。 */
+    readonly shellPath: string;
+    readonly shellProfileId?: CodingNsTerminalShell['profileId'];
+    readonly shellName?: string;
+    readonly shellArgs?: readonly string[];
+    /** 由 Host 直接启动的 PTY 命令；普通交互终端不设置。 */
+    readonly commandPath?: string;
+    readonly commandArgs?: readonly string[];
+    readonly commandEnv?: Readonly<Record<string, string>>;
+    readonly launchProfileId?: string;
+    readonly cwd: string;
+    readonly title: string;
+    readonly cols: number;
+    readonly rows: number;
+    readonly state: CodingNsTerminalState;
+    readonly exitCode: number | null;
+    readonly error?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+/** 当前连接到持久运行时的一次短命 attach，只保存在内存中。 */
+export interface TerminalAttachmentRecord {
+    readonly terminalId: string;
+    readonly generation: string;
+    readonly streamId: string;
+    readonly subscriptionId: string;
+    readonly runtimeAttachmentId: string;
+}
+/** 持久终端按 Host 与工作区归属；dshSessionId 只作为本次请求的 attach 上下文。 */
+export interface TerminalOwnerScope {
+    readonly hostId: string;
+    readonly workspaceId: string;
+    readonly dshSessionId?: string;
+}
+export interface TerminalRecordIdentity extends TerminalOwnerScope {
+    readonly terminalId: string;
+}
+export interface CodingNsTerminalShell {
+    readonly profileId: 'zsh' | 'bash' | 'powershell' | 'cmd' | 'git-bash';
+    readonly path: string;
+    readonly args: readonly string[];
+    readonly name: string;
+}
+/** 与 DSH 0.1.6-alpha.2 `remote.terminal` wire shape 对齐。 */
+export interface CodingNsWebTerminalInfo {
+    readonly id: string;
+    readonly title: string;
+    /** 浏览器 wire 不暴露 Host 内部 profileId。 */
+    readonly shell: CodingNsTerminalShellOption;
+    readonly cwd: string;
+    readonly cols: number;
+    readonly rows: number;
+    readonly state: 'running' | 'exited' | 'failed';
+    readonly exitCode: number | null;
+    readonly error?: string;
+    readonly controllerId?: string;
+}
+export interface CodingNsTerminalCreateRequest {
+    readonly id: string;
+    readonly shellPath?: string;
+    readonly cols: number;
+    readonly rows: number;
+}
+export interface CodingNsTerminalEnvironment {
+    readonly cwd: string;
+    /** DSH Workspace Registry 的稳定身份；缺失时 Client 仅使用会话级兼容键。 */
+    readonly workspaceId?: string;
+    readonly maxInputBytes: number;
+    readonly maxCols: number;
+    readonly maxRows: number;
+    readonly scrollback: number;
+}
+export interface CodingNsTerminalShellOption {
+    readonly path: string;
+    readonly args: readonly string[];
+    readonly name: string;
+}
+/** Host 对设置页公开的终端启动状态；只含平台能力，不含本机控制凭据。 */
+export interface CodingNsTerminalStatus {
+    readonly platform: 'darwin' | 'linux' | 'win32' | 'unsupported';
+    readonly controllerMode: 'baseline' | 'enhanced';
+    readonly effectiveEnabled: boolean;
+    readonly profiles: readonly {
+        readonly profileId: CodingNsTerminalShell['profileId'];
+        readonly name: string;
+        readonly path: string;
+    }[];
+    readonly resolvedProfileId: CodingNsTerminalShell['profileId'] | null;
+    readonly fallbackReason?: string;
+}
+export type CodingNsTerminalFrame = {
+    readonly type: 'snapshot';
+    readonly sequence: number;
+    readonly screen: string;
+    readonly info: CodingNsWebTerminalInfo;
+} | {
+    readonly type: 'output';
+    readonly sequence: number;
+    readonly data: string;
+} | {
+    readonly type: 'state';
+    readonly info: CodingNsWebTerminalInfo;
+};
+export interface CodingNsTerminalRetentionFrame {
+    readonly type: 'retained';
+}
+//# sourceMappingURL=terminal.d.ts.map

package/data/build/dist/shared/contracts/terminal.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal.js.map

package/data/build/dist/shared/contracts/transport.d.ts

@@ -0,0 +1,45 @@
+import type { CodingNsDshErrorCode } from './errors.js';
+/** Codingns4DSH Host RPC 的固定逻辑通道。 */
+export declare const CODINGNS_RPC_CHANNEL = "/codingns";
+export interface CodingNsRpcRequest<TPayload = unknown> {
+    method: string;
+    payload: TPayload;
+    signal?: AbortSignal;
+}
+export interface CodingNsStreamRequest<TPayload = unknown> {
+    method: string;
+    payload: TPayload;
+    signal?: AbortSignal;
+}
+export interface CodingNsTransportGeneration {
+    id: number;
+    host: {
+        home: string;
+    };
+}
+export interface CodingNsTransport {
+    rpc<TResponse = unknown, TPayload = unknown>(request: CodingNsRpcRequest<TPayload>): Promise<TResponse>;
+    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+    openStream<TChunk = unknown, TPayload = unknown>(request: CodingNsStreamRequest<TPayload>): AsyncIterable<TChunk>;
+    loadBundle(url: string): Promise<void>;
+    getGeneration(): CodingNsTransportGeneration | undefined;
+    onGenerationChange(listener: (generation: CodingNsTransportGeneration | undefined) => void): () => void;
+    reconnect(signal?: AbortSignal): Promise<void>;
+    close(): Promise<void>;
+}
+export interface CodingNsTransportHooks {
+    rpc?: CodingNsTransport['rpc'];
+    fetch?: CodingNsTransport['fetch'];
+    openStream?: CodingNsTransport['openStream'];
+    loadBundle?: CodingNsTransport['loadBundle'];
+    generation?: CodingNsTransport['getGeneration'];
+    onGenerationChange?: CodingNsTransport['onGenerationChange'];
+    reconnect?: CodingNsTransport['reconnect'];
+    close?: CodingNsTransport['close'];
+}
+export interface CodingNsTransportErrorShape {
+    code: CodingNsDshErrorCode;
+    message: string;
+    generationId?: number;
+}
+//# sourceMappingURL=transport.d.ts.map

package/data/build/dist/shared/contracts/transport.js

@@ -0,0 +1,3 @@
+/** Codingns4DSH Host RPC 的固定逻辑通道。 */
+export const CODINGNS_RPC_CHANNEL = '/codingns';
+//# sourceMappingURL=transport.js.map

package/data/build/dist/shared/contracts/version.d.ts

@@ -0,0 +1,19 @@
+/** 当前经过完整验证的 DSH 版本；源文件由根目录 version.json 同步。 */
+export declare const DSH_VERSION: "0.1.6-alpha.2";
+/** DSH 测试版本别名，供新代码表达语义，保留 DSH_VERSION 兼容旧调用方。 */
+export declare const DSH_TESTED_VERSION: "0.1.6-alpha.2";
+/** 插件支持的 DSH 版本范围；插件版本与宿主版本独立发布。 */
+export declare const DSH_COMPATIBILITY: ">=0.1.5-rc.3 <0.1.7-0";
+/** DSH Envelope/Tunnel 协议主版本。 */
+export declare const DSH_PROTOCOL_VERSION: 1;
+/** Host 注入到浏览器页面的真实 DSH 版本全局字段。 */
+export declare const CODINGNS_DSH_VERSION_GLOBAL: "__CODINGNS_DSH_VERSION__";
+/** 识别没有 alpha2 Sidebar 扩展 API 的 DSH 旧版运行时。 */
+export declare function isLegacyDshVersion(version: string): boolean;
+/** Codingns4DSH 插件自身的 npm 版本。 */
+export declare const CODINGNS_VERSION: "0.1.0";
+/** 判断宿主版本是否落在当前插件声明的 DSH 兼容范围内。 */
+export declare function isDshVersionCompatible(version: string): boolean;
+/** 判断 DSH 版本是否达到某个功能模块要求的最低版本。 */
+export declare function isDshVersionAtLeast(version: string, minimum: string): boolean;
+//# sourceMappingURL=version.d.ts.map

package/data/build/dist/shared/contracts/version.js

@@ -0,0 +1,74 @@
+/** 当前经过完整验证的 DSH 版本；源文件由根目录 version.json 同步。 */
+export const DSH_VERSION = '0.1.6-alpha.2';
+/** DSH 测试版本别名，供新代码表达语义，保留 DSH_VERSION 兼容旧调用方。 */
+export const DSH_TESTED_VERSION = DSH_VERSION;
+/** 插件支持的 DSH 版本范围；插件版本与宿主版本独立发布。 */
+export const DSH_COMPATIBILITY = '>=0.1.5-rc.3 <0.1.7-0';
+/** DSH Envelope/Tunnel 协议主版本。 */
+export const DSH_PROTOCOL_VERSION = 1;
+/** Host 注入到浏览器页面的真实 DSH 版本全局字段。 */
+export const CODINGNS_DSH_VERSION_GLOBAL = '__CODINGNS_DSH_VERSION__';
+/** 识别没有 alpha2 Sidebar 扩展 API 的 DSH 旧版运行时。 */
+export function isLegacyDshVersion(version) {
+    return /^0\.1\.5(?:-|$)/u.test(version);
+}
+/** Codingns4DSH 插件自身的 npm 版本。 */
+export const CODINGNS_VERSION = '0.1.0';
+/** 判断宿主版本是否落在当前插件声明的 DSH 兼容范围内。 */
+export function isDshVersionCompatible(version) {
+    const match = /^>=([^ ]+) <([^ ]+)$/u.exec(DSH_COMPATIBILITY);
+    const actual = parseVersion(version);
+    const minimum = parseVersion(match?.[1] ?? '');
+    const maximum = parseVersion(match?.[2] ?? '');
+    if (!actual || !minimum || !maximum)
+        return version === DSH_VERSION;
+    if (actual.major === maximum.major && actual.minor === maximum.minor && actual.patch === maximum.patch && actual.prerelease.length > 0)
+        return false;
+    return compareVersions(actual, minimum) >= 0 && compareVersions(actual, maximum) < 0;
+}
+/** 判断 DSH 版本是否达到某个功能模块要求的最低版本。 */
+export function isDshVersionAtLeast(version, minimum) {
+    const actual = parseVersion(version);
+    const required = parseVersion(minimum);
+    if (!actual || !required)
+        return false;
+    return compareVersions(actual, required) >= 0;
+}
+function parseVersion(value) {
+    const match = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/u.exec(value);
+    if (!match)
+        return undefined;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        prerelease: match[4] === undefined ? [] : match[4].split('.').map((part) => /^\d+$/u.test(part) ? Number(part) : part),
+    };
+}
+function compareVersions(left, right) {
+    for (const key of ['major', 'minor', 'patch']) {
+        if (left[key] !== right[key])
+            return left[key] - right[key];
+    }
+    if (left.prerelease.length === 0 && right.prerelease.length > 0)
+        return 1;
+    if (left.prerelease.length > 0 && right.prerelease.length === 0)
+        return -1;
+    for (let index = 0; index < Math.max(left.prerelease.length, right.prerelease.length); index += 1) {
+        const leftPart = left.prerelease[index];
+        const rightPart = right.prerelease[index];
+        if (leftPart === undefined)
+            return -1;
+        if (rightPart === undefined)
+            return 1;
+        if (leftPart === rightPart)
+            continue;
+        if (typeof leftPart === 'number' && typeof rightPart === 'string')
+            return -1;
+        if (typeof leftPart === 'string' && typeof rightPart === 'number')
+            return 1;
+        return leftPart < rightPart ? -1 : 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=version.js.map