@bufbuild/protoplugin 1.8.0 → 2.0.0-alpha.1

package/dist/cjs/ecmascript/index.js

@@ -13,34 +13,8 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createJsDocBlock = exports.makeJsDoc = exports.findCustomEnumOption = exports.findCustomMessageOption = exports.findCustomScalarOption = exports.literalString = exports.getFieldTyping = exports.getFieldIntrinsicDefaultValue = exports.getFieldExplicitDefaultValue = exports.localName = exports.createImportSymbol = exports.reifyWkt = void 0;
-const protobuf_1 = require("@bufbuild/protobuf");
-const jsdoc_js_1 = require("./jsdoc.js");
-var reify_wkt_js_1 = require("./reify-wkt.js");
-Object.defineProperty(exports, "reifyWkt", { enumerable: true, get: function () { return reify_wkt_js_1.reifyWkt; } });
+exports.safeIdentifier = exports.createImportSymbol = void 0;
 var import_symbol_js_1 = require("./import-symbol.js");
 Object.defineProperty(exports, "createImportSymbol", { enumerable: true, get: function () { return import_symbol_js_1.createImportSymbol; } });
-exports.localName = protobuf_1.codegenInfo.localName;
-var legacy_gencommon_js_1 = require("./legacy-gencommon.js");
-Object.defineProperty(exports, "getFieldExplicitDefaultValue", { enumerable: true, get: function () { return legacy_gencommon_js_1.getFieldExplicitDefaultValue; } });
-Object.defineProperty(exports, "getFieldIntrinsicDefaultValue", { enumerable: true, get: function () { return legacy_gencommon_js_1.getFieldIntrinsicDefaultValue; } });
-Object.defineProperty(exports, "getFieldTyping", { enumerable: true, get: function () { return legacy_gencommon_js_1.getFieldTyping; } });
-Object.defineProperty(exports, "literalString", { enumerable: true, get: function () { return legacy_gencommon_js_1.literalString; } });
-var legacy_custom_options_js_1 = require("./legacy-custom-options.js");
-Object.defineProperty(exports, "findCustomScalarOption", { enumerable: true, get: function () { return legacy_custom_options_js_1.findCustomScalarOption; } });
-Object.defineProperty(exports, "findCustomMessageOption", { enumerable: true, get: function () { return legacy_custom_options_js_1.findCustomMessageOption; } });
-Object.defineProperty(exports, "findCustomEnumOption", { enumerable: true, get: function () { return legacy_custom_options_js_1.findCustomEnumOption; } });
-/**
- * @deprecated Please use GeneratedFile.jsDoc() instead
- */
-function makeJsDoc(desc, indentation = "") {
-    return (0, jsdoc_js_1.createJsDocBlock)(desc, indentation).toString();
-}
-exports.makeJsDoc = makeJsDoc;
-/**
- * @deprecated Please use GeneratedFile.jsDoc() instead
- */
-function createJsDocBlock(text, indentation = "") {
-    return (0, jsdoc_js_1.createJsDocBlock)(text, indentation).toString();
-}
-exports.createJsDocBlock = createJsDocBlock;
+var safe_identifier_js_1 = require("./safe-identifier.js");
+Object.defineProperty(exports, "safeIdentifier", { enumerable: true, get: function () { return safe_identifier_js_1.safeIdentifier; } });

package/dist/cjs/ecmascript/jsdoc.d.ts

@@ -1,14 +1,3 @@
 import type { AnyDesc, DescFile } from "@bufbuild/protobuf";
-export type JSDocBlock = {
-    readonly kind: "es_jsdoc";
-    /**
-     * @deprecated In a future release, we will make this property optional.
-     */
-    text: string;
-    indentation?: string;
-    /**
-     * @deprecated In a future release, we will remove this method.
-     */
-    toString(): string;
-};
-export declare function createJsDocBlock(textOrDesc: string | Exclude<AnyDesc, DescFile>, indentation?: string): JSDocBlock;
+export declare function createJsDocTextFromDesc(desc: Exclude<AnyDesc, DescFile>): string;
+export declare function formatJsDocBlock(text: string, indentation: string | undefined): string;

package/dist/cjs/ecmascript/jsdoc.js

@@ -13,33 +13,10 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createJsDocBlock = void 0;
-// TODO simplify type JSDocBlock to bring it in line with others in opaque-printables.ts
-function createJsDocBlock(textOrDesc, indentation) {
-    const text = typeof textOrDesc == "string" ? textOrDesc : createTextForDesc(textOrDesc);
-    return {
-        kind: "es_jsdoc",
-        text,
-        indentation,
-        toString() {
-            if (text.trim().length == 0) {
-                return "";
-            }
-            let lines = text.split("\n");
-            if (lines.length === 0) {
-                return "";
-            }
-            lines = lines.map((l) => l.split("*/").join("*\\/"));
-            lines = lines.map((l) => (l.length > 0 ? " " + l : l));
-            const i = indentation !== null && indentation !== void 0 ? indentation : "";
-            return [`${i}/**\n`, ...lines.map((l) => `${i} *${l}\n`), `${i} */`].join("");
-        },
-    };
-}
-exports.createJsDocBlock = createJsDocBlock;
-function createTextForDesc(desc) {
-    var _a, _b;
-    const comments = desc.getComments();
+exports.formatJsDocBlock = exports.createJsDocTextFromDesc = void 0;
+const source_code_info_js_1 = require("../source-code-info.js");
+function createJsDocTextFromDesc(desc) {
+    const comments = (0, source_code_info_js_1.getComments)(desc);
     let text = "";
     if (comments.leading !== undefined) {
         text += comments.leading;
@@ -65,13 +42,13 @@ function createTextForDesc(desc) {
         .join("\n");
     switch (desc.kind) {
         case "enum_value":
-            text += `@generated from enum value: ${desc.declarationString()};`;
+            text += `@generated from enum value: ${(0, source_code_info_js_1.getDeclarationString)(desc)};`;
             break;
         case "field":
-            text += `@generated from field: ${desc.declarationString()};`;
+            text += `@generated from field: ${(0, source_code_info_js_1.getDeclarationString)(desc)};`;
             break;
         case "extension":
-            text += `@generated from extension: ${desc.declarationString()};`;
+            text += `@generated from extension: ${(0, source_code_info_js_1.getDeclarationString)(desc)};`;
             break;
         default:
             text += `@generated from ${desc.toString()}`;
@@ -82,7 +59,7 @@ function createTextForDesc(desc) {
         case "enum":
         case "message":
         case "service":
-            deprecated = deprecated || ((_b = (_a = desc.file.proto.options) === null || _a === void 0 ? void 0 : _a.deprecated) !== null && _b !== void 0 ? _b : false);
+            deprecated = deprecated || desc.file.deprecated;
             break;
         default:
             break;
@@ -92,3 +69,18 @@ function createTextForDesc(desc) {
     }
     return text;
 }
+exports.createJsDocTextFromDesc = createJsDocTextFromDesc;
+function formatJsDocBlock(text, indentation) {
+    if (text.trim().length == 0) {
+        return "";
+    }
+    let lines = text.split("\n");
+    if (lines.length === 0) {
+        return "";
+    }
+    lines = lines.map((l) => l.split("*/").join("*\\/"));
+    lines = lines.map((l) => (l.length > 0 ? " " + l : l));
+    const i = indentation !== null && indentation !== void 0 ? indentation : "";
+    return [`${i}/**\n`, ...lines.map((l) => `${i} *${l}\n`), `${i} */`].join("");
+}
+exports.formatJsDocBlock = formatJsDocBlock;

package/dist/cjs/ecmascript/names.d.ts

@@ -0,0 +1,4 @@
+import type { DescEnum, DescExtension, DescFile, DescMessage, DescService } from "@bufbuild/protobuf";
+export declare function generateFilePath(file: DescFile, bootstrapWkt: boolean, filesToGenerate: DescFile[]): string;
+export declare function localDescName(desc: DescFile | DescEnum | DescMessage | DescExtension | DescService): string;
+export declare function localShapeName(desc: DescEnum | DescMessage): string;

package/dist/cjs/ecmascript/names.js

@@ -0,0 +1,119 @@
+"use strict";
+// Copyright 2021-2024 Buf Technologies, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localShapeName = exports.localDescName = exports.generateFilePath = void 0;
+const codegenv1_1 = require("@bufbuild/protobuf/codegenv1");
+const reflect_1 = require("@bufbuild/protobuf/reflect");
+const safe_identifier_js_1 = require("./safe-identifier.js");
+function generateFilePath(file, bootstrapWkt, filesToGenerate) {
+    // Well-known types are published with the runtime package. We usually want
+    // the generated code to import them from the runtime package, with the
+    // following exceptions:
+    // 1. We are bootstrapping the runtime package via the plugin option
+    //    "bootstrap_wkt". In that case, we cannot refer to the runtime package
+    //    itself.
+    // 2. We were explicitly asked to generate the well-known type.
+    const wktFrom = codegenv1_1.wktPublicImportPaths[file.proto.name];
+    if (wktFrom !== undefined &&
+        !bootstrapWkt &&
+        !filesToGenerate.find((f) => f.name === file.name)) {
+        return wktFrom;
+    }
+    return "./" + file.name + "_pb.js";
+}
+exports.generateFilePath = generateFilePath;
+function localDescName(desc) {
+    const file = desc.kind == "file" ? desc : desc.file;
+    const { descNames } = allNames(file);
+    const name = descNames.get(desc);
+    if (name === undefined) {
+        throw new Error(`unable to determine unique identifier for ${desc.toString()}`);
+    }
+    return name;
+}
+exports.localDescName = localDescName;
+function localShapeName(desc) {
+    const { shapeNames } = allNames(desc.file);
+    const name = shapeNames.get(desc);
+    if (name === undefined) {
+        throw new Error(`unable to determine unique identifier for ${desc.toString()}`);
+    }
+    return name;
+}
+exports.localShapeName = localShapeName;
+function idealDescName(desc, i) {
+    const escape = i === 0 ? "" : i === 1 ? "$" : `$${i - 1}`;
+    switch (desc.kind) {
+        case "file":
+            return ((0, safe_identifier_js_1.safeIdentifier)("fileDesc_" + desc.name.replace(/[^a-zA-Z0-9_]+/g, "_")) + escape);
+        case "enum":
+            return baseName(desc) + "Desc" + escape;
+        case "message":
+            return baseName(desc) + "Desc" + escape;
+        case "extension":
+            return baseName(desc) + escape;
+        case "service":
+            return baseName(desc) + escape;
+    }
+}
+function idealShapeName(desc, i) {
+    const escape = i === 0 ? "" : i === 1 ? "$" : `$${i - 1}`;
+    return baseName(desc) + escape;
+}
+function baseName(desc) {
+    const pkg = desc.file.proto.package;
+    const offset = pkg.length > 0 ? pkg.length + 1 : 0;
+    const name = desc.typeName.substring(offset).replace(/\./g, "_");
+    return (0, safe_identifier_js_1.safeIdentifier)(name);
+}
+function allNames(file) {
+    const taken = new Set();
+    const shapeNames = new Map();
+    const descNames = new Map();
+    for (const desc of [file, ...(0, reflect_1.nestedTypes)(file)]) {
+        switch (desc.kind) {
+            case "enum":
+            case "message": {
+                let descName;
+                let shapeName;
+                for (let i = 0;; i++) {
+                    descName = idealDescName(desc, i);
+                    shapeName = idealShapeName(desc, i);
+                    if (!taken.has(descName) && !taken.has(shapeName)) {
+                        break;
+                    }
+                }
+                taken.add(descName);
+                taken.add(shapeName);
+                descNames.set(desc, descName);
+                shapeNames.set(desc, shapeName);
+                break;
+            }
+            default: {
+                let descName;
+                for (let i = 0;; i++) {
+                    descName = idealDescName(desc, i);
+                    if (!taken.has(descName)) {
+                        break;
+                    }
+                }
+                taken.add(descName);
+                descNames.set(desc, descName);
+                break;
+            }
+        }
+    }
+    return { shapeNames, descNames };
+}

package/dist/cjs/ecmascript/parameter.d.ts

@@ -1,5 +1,5 @@
-import { Target } from "./target.js";
-import { RewriteImports } from "./import-path.js";
+import type { Target } from "./target.js";
+import type { RewriteImports } from "./import-path.js";
 export interface ParsedParameter {
     targets: Target[];
     tsNocheck: boolean;
@@ -10,4 +10,4 @@ export interface ParsedParameter {
     jsImportStyle: "module" | "legacy_commonjs";
     sanitizedParameter: string;
 }
-export declare function parseParameter(parameter: string | undefined, parseExtraOption: ((key: string, value: string) => void) | undefined): ParsedParameter;
+export declare function parseParameter(parameter: string, parseExtraOption: ((key: string, value: string) => void) | undefined): ParsedParameter;

package/dist/cjs/ecmascript/parameter.js

@@ -17,7 +17,7 @@ exports.parseParameter = void 0;
 const error_js_1 = require("../error.js");
 function parseParameter(parameter, parseExtraOption) {
     let targets = ["js", "dts"];
-    let tsNocheck = true;
+    let tsNocheck = false;
     let bootstrapWkt = false;
     let keepEmptyFiles = false;
     const rewriteImports = [];
@@ -147,7 +147,7 @@ function parseParameter(parameter, parseExtraOption) {
 }
 exports.parseParameter = parseParameter;
 function splitParameter(parameter) {
-    if (parameter == undefined) {
+    if (parameter.length == 0) {
         return [];
     }
     return parameter.split(",").map((raw) => {

package/dist/cjs/ecmascript/printable.d.ts

@@ -0,0 +1,36 @@
+import type { DescEnum, DescExtension, DescFile, DescMessage, DescService } from "@bufbuild/protobuf";
+import { ScalarType, LongType } from "@bufbuild/protobuf/reflect";
+import type { ImportSymbol } from "./import-symbol.js";
+/**
+ * All types that can be passed to GeneratedFile.print()
+ */
+export type Printable = string | number | boolean | bigint | Uint8Array | ImportSymbol | ExportStatement | JSDocBlock | LiteralString | LiteralProtoInt64 | DescImport | ShapeImport | Printable[];
+export type ExportStatement = {
+    kind: "es_export_stmt";
+    name: string;
+    declaration?: string;
+};
+export type LiteralProtoInt64 = {
+    readonly kind: "es_proto_int64";
+    type: ScalarType.INT64 | ScalarType.SINT64 | ScalarType.SFIXED64 | ScalarType.UINT64 | ScalarType.FIXED64;
+    longType: LongType;
+    value: bigint | string;
+};
+export type LiteralString = {
+    readonly kind: "es_string";
+    value: string;
+};
+export type DescImport = {
+    readonly kind: "es_desc_ref";
+    desc: DescMessage | DescEnum | DescExtension | DescService | DescFile;
+    typeOnly?: boolean;
+};
+export type ShapeImport = {
+    readonly kind: "es_shape_ref";
+    desc: DescMessage | DescEnum;
+};
+export type JSDocBlock = {
+    readonly kind: "es_jsdoc";
+    text: string;
+    indentation?: string;
+};

package/dist/cjs/ecmascript/runtime-imports.d.ts

@@ -1,25 +1,14 @@
 import type { ImportSymbol } from "./import-symbol.js";
-export interface RuntimeImports {
-    proto2: ImportSymbol;
-    proto3: ImportSymbol;
-    Message: ImportSymbol;
-    PartialMessage: ImportSymbol;
-    PlainMessage: ImportSymbol;
-    FieldList: ImportSymbol;
-    MessageType: ImportSymbol;
-    Extension: ImportSymbol;
-    BinaryReadOptions: ImportSymbol;
-    BinaryWriteOptions: ImportSymbol;
-    JsonReadOptions: ImportSymbol;
-    JsonWriteOptions: ImportSymbol;
-    JsonValue: ImportSymbol;
-    JsonObject: ImportSymbol;
-    protoDouble: ImportSymbol;
-    protoInt64: ImportSymbol;
-    ScalarType: ImportSymbol;
-    LongType: ImportSymbol;
-    MethodKind: ImportSymbol;
-    MethodIdempotency: ImportSymbol;
-    IMessageTypeRegistry: ImportSymbol;
-}
+import { symbols } from "@bufbuild/protobuf/codegenv1";
+export type RuntimeImports = mapRecord<typeof symbols>;
 export declare function createRuntimeImports(bootstrapWkt: boolean): RuntimeImports;
+type mapRecord<T extends Record<string, unknown>> = {
+    [P in keyof T]: T[P] extends symbolInfo ? ImportSymbol : T[P] extends Record<string, unknown> ? mapRecord<T[P]> : never;
+};
+declare function mapRecord<T extends Record<string, unknown>>(record: T, bootstrapWkt: boolean): mapRecord<T>;
+type symbolInfo = {
+    readonly typeOnly: boolean;
+    readonly from: string;
+    readonly bootstrapWktFrom: string;
+};
+export {};

package/dist/cjs/ecmascript/runtime-imports.js

@@ -15,36 +15,35 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createRuntimeImports = void 0;
 const import_symbol_js_1 = require("./import-symbol.js");
-const protobuf_1 = require("@bufbuild/protobuf");
+const codegenv1_1 = require("@bufbuild/protobuf/codegenv1");
 function createRuntimeImports(bootstrapWkt) {
-    // prettier-ignore
-    return {
-        proto2: infoToSymbol("proto2", bootstrapWkt),
-        proto3: infoToSymbol("proto3", bootstrapWkt),
-        Message: infoToSymbol("Message", bootstrapWkt),
-        PartialMessage: infoToSymbol("PartialMessage", bootstrapWkt),
-        PlainMessage: infoToSymbol("PlainMessage", bootstrapWkt),
-        FieldList: infoToSymbol("FieldList", bootstrapWkt),
-        MessageType: infoToSymbol("MessageType", bootstrapWkt),
-        Extension: infoToSymbol("Extension", bootstrapWkt),
-        BinaryReadOptions: infoToSymbol("BinaryReadOptions", bootstrapWkt),
-        BinaryWriteOptions: infoToSymbol("BinaryWriteOptions", bootstrapWkt),
-        JsonReadOptions: infoToSymbol("JsonReadOptions", bootstrapWkt),
-        JsonWriteOptions: infoToSymbol("JsonWriteOptions", bootstrapWkt),
-        JsonValue: infoToSymbol("JsonValue", bootstrapWkt),
-        JsonObject: infoToSymbol("JsonObject", bootstrapWkt),
-        protoDouble: infoToSymbol("protoDouble", bootstrapWkt),
-        protoInt64: infoToSymbol("protoInt64", bootstrapWkt),
-        ScalarType: infoToSymbol("ScalarType", bootstrapWkt),
-        LongType: infoToSymbol("LongType", bootstrapWkt),
-        MethodKind: infoToSymbol("MethodKind", bootstrapWkt),
-        MethodIdempotency: infoToSymbol("MethodIdempotency", bootstrapWkt),
-        IMessageTypeRegistry: infoToSymbol("IMessageTypeRegistry", bootstrapWkt),
-    };
+    return mapRecord(codegenv1_1.symbols, bootstrapWkt);
 }
 exports.createRuntimeImports = createRuntimeImports;
-function infoToSymbol(name, bootstrapWkt) {
-    const info = protobuf_1.codegenInfo.symbols[name];
-    const symbol = (0, import_symbol_js_1.createImportSymbol)(name, bootstrapWkt ? info.privateImportPath : info.publicImportPath);
-    return info.typeOnly ? symbol.toTypeOnly() : symbol;
+function mapRecord(record, bootstrapWkt) {
+    const result = Object.create(null);
+    for (const [key, value] of Object.entries(record)) {
+        if (isSymbolInfo(value)) {
+            result[key] = (0, import_symbol_js_1.createImportSymbol)(key, bootstrapWkt ? value.bootstrapWktFrom : value.from, value.typeOnly);
+        }
+        else {
+            result[key] = mapRecord(record[key], bootstrapWkt);
+        }
+    }
+    return result;
+}
+function isSymbolInfo(arg) {
+    if (typeof arg != "object" || arg === null) {
+        return false;
+    }
+    const wantNames = [
+        "typeOnly",
+        "from",
+        "bootstrapWktFrom",
+    ];
+    const gotNames = Object.getOwnPropertyNames(arg);
+    if (gotNames.length !== wantNames.length) {
+        return false;
+    }
+    return wantNames.every((w) => gotNames.includes(w));
 }

package/dist/cjs/ecmascript/safe-identifier.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Escapes names that are reserved identifiers in ECMAScript, TypeScript.
+ *
+ * Also see safeObjectProperty() from @bufbuild/protoplugin/reflect.
+ */
+export declare function safeIdentifier(name: string): string;

package/dist/cjs/ecmascript/safe-identifier.js

@@ -0,0 +1,90 @@
+"use strict";
+// Copyright 2021-2024 Buf Technologies, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeIdentifier = void 0;
+/**
+ * Names that cannot be used for identifiers, such as class names,
+ * but _can_ be used for object properties.
+ */
+const reservedIdentifiers = new Set([
+    // ECMAScript 2015 keywords
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "debugger",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "export",
+    "extends",
+    "false",
+    "finally",
+    "for",
+    "function",
+    "if",
+    "import",
+    "in",
+    "instanceof",
+    "new",
+    "null",
+    "return",
+    "super",
+    "switch",
+    "this",
+    "throw",
+    "true",
+    "try",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+    "yield",
+    // ECMAScript 2015 future reserved keywords
+    "enum",
+    "implements",
+    "interface",
+    "let",
+    "package",
+    "private",
+    "protected",
+    "public",
+    "static",
+    // Class name cannot be 'Object' when targeting ES5 with module CommonJS
+    "Object",
+    // TypeScript keywords that cannot be used for types (as opposed to variables)
+    "bigint",
+    "number",
+    "boolean",
+    "string",
+    "object",
+    // Identifiers reserved for the runtime, so we can generate legible code
+    "globalThis",
+    "Uint8Array",
+    "Partial",
+]);
+/**
+ * Escapes names that are reserved identifiers in ECMAScript, TypeScript.
+ *
+ * Also see safeObjectProperty() from @bufbuild/protoplugin/reflect.
+ */
+function safeIdentifier(name) {
+    return reservedIdentifiers.has(name) ? name + "$" : name;
+}
+exports.safeIdentifier = safeIdentifier;

package/dist/cjs/ecmascript/schema.d.ts

@@ -1,9 +1,9 @@
-import type { CodeGeneratorRequest, DescFile } from "@bufbuild/protobuf";
-import { FeatureSetDefaults } from "@bufbuild/protobuf";
+import type { DescEnum, DescExtension, DescFile, DescMessage, DescService } from "@bufbuild/protobuf";
+import type { CodeGeneratorRequest } from "@bufbuild/protobuf/wkt";
+import { Edition } from "@bufbuild/protobuf/wkt";
 import type { FileInfo, GeneratedFile } from "./generated-file.js";
-import { RuntimeImports } from "./runtime-imports.js";
 import type { Target } from "./target.js";
-import { ParsedParameter } from "./parameter.js";
+import type { ParsedParameter } from "./parameter.js";
 /**
  * Schema describes the files and types that the plugin is requested to
  * generate.
@@ -21,14 +21,15 @@ export interface Schema {
      * The plugin option `target`. A code generator should support all targets.
      */
     readonly targets: readonly Target[];
-    /**
-     * Provides some symbols from the runtime library @bufbuild/protobuf.
-     */
-    readonly runtime: RuntimeImports;
     /**
      * Generate a new file with the given name.
      */
     generateFile(name: string): GeneratedFile;
+    /**
+     * List all types in a file (including messages, enumerations, and extensions
+     * nested in messages).
+     */
+    typesInFile(file: DescFile): Iterable<DescMessage | DescEnum | DescExtension | DescService>;
     /**
      * The original google.protobuf.compiler.CodeGeneratorRequest.
      */
@@ -38,5 +39,5 @@ interface SchemaController extends Schema {
     getFileInfo: () => FileInfo[];
     prepareGenerate(target: Target): void;
 }
-export declare function createSchema(request: CodeGeneratorRequest, parameter: ParsedParameter, pluginName: string, pluginVersion: string, featureSetDefaults: FeatureSetDefaults | undefined): SchemaController;
+export declare function createSchema(request: CodeGeneratorRequest, parameter: ParsedParameter, pluginName: string, pluginVersion: string, minimumEdition: Edition, maximumEdition: Edition): SchemaController;
 export {};