mirror of
https://github.com/microsoft/vscode.git
synced 2026-10-06 05:07:29 +01:00
Giuseppe Cianci
ad360f0511
Use TypeScript comment ranges so the generator satisfies Unicode hygiene without rewriting string literals, template text, or other code. Cover the Codex 0.155.1 user-verification comments and literal-preservation cases.
37 lines
1.7 KiB
TypeScript
37 lines
1.7 KiB
TypeScript
/*---------------------------------------------------------------------------------------------
|
|
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
* Licensed under the MIT License. See License.txt in the project root for license information.
|
|
*--------------------------------------------------------------------------------------------*/
|
|
|
|
// Type declarations for the (plain-JS) codex protocol generator, so the TypeScript freshness
|
|
// check (check-protocol-sync.ts) can import its reusable pieces. The runnable logic lives in
|
|
// generate-protocol.mjs.
|
|
|
|
/** Absolute path to the repository root. */
|
|
export declare const REPO_ROOT: string;
|
|
|
|
/** Absolute path to the generated protocol client directory. */
|
|
export declare const OUT_DIR: string;
|
|
|
|
/** Absolute path to build/codex/codex-version.txt (the pinned codex version). */
|
|
export declare const VERSION_FILE: string;
|
|
|
|
/** Resolves the codex binary ($CODEX_BIN, vendored npm package, or PATH). */
|
|
export declare function resolveCodexBinary(): string;
|
|
|
|
/** Reads the `codex --version` of the given binary. */
|
|
export declare function readBinaryVersion(bin: string): string;
|
|
|
|
/** Reads the pinned version from build/codex/codex-version.txt. */
|
|
export declare function readPinnedVersion(): string;
|
|
|
|
/** Normalize en dashes in comments without changing TypeScript tokens. */
|
|
export declare function normalizeCommentDashes(text: string): string;
|
|
|
|
/**
|
|
* Regenerates the protocol client into `outDir` using `bin`, stamping `codexVersion` into the
|
|
* per-file header. Wipes `outDir` first (except README.md). Output is byte-identical regardless
|
|
* of `outDir`, so a scratch-dir regeneration can be compared against the committed client.
|
|
*/
|
|
export declare function generate(bin: string, outDir: string, codexVersion: string): void;
|