@bufbuild/protoplugin 1.5.1 → 1.7.0

package/dist/cjs/ecmascript/schema.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2021-2023 Buf Technologies, Inc.
+// 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.
@@ -13,66 +13,53 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toResponse = exports.createSchema = void 0;
+exports.createSchema = void 0;
 const protobuf_1 = require("@bufbuild/protobuf");
 const generated_file_js_1 = require("./generated-file.js");
 const runtime_imports_js_1 = require("./runtime-imports.js");
 const import_symbol_js_1 = require("./import-symbol.js");
 const import_path_js_1 = require("./import-path.js");
-function createSchema(request, targets, tsNocheck, bootstrapWkt, rewriteImports, importExtension, keepEmptyFiles, pluginName, pluginVersion, pluginParameter) {
-    const descriptorSet = (0, protobuf_1.createDescriptorSet)(request.protoFile);
+const gencommon_1 = require("./gencommon");
+function createSchema(request, parameter, pluginName, pluginVersion, featureSetDefaults) {
+    const descriptorSet = (0, protobuf_1.createDescriptorSet)(request.protoFile, {
+        featureSetDefaults,
+    });
     const filesToGenerate = findFilesToGenerate(descriptorSet, request);
-    const runtime = (0, runtime_imports_js_1.createRuntimeImports)(bootstrapWkt);
+    const runtime = (0, runtime_imports_js_1.createRuntimeImports)(parameter.bootstrapWkt);
     const createTypeImport = (desc) => {
         const name = protobuf_1.codegenInfo.localName(desc);
-        const from = (0, import_path_js_1.makeImportPath)(desc.file, bootstrapWkt, filesToGenerate);
+        const from = (0, import_path_js_1.makeImportPath)(desc.file, parameter.bootstrapWkt, filesToGenerate);
         return (0, import_symbol_js_1.createImportSymbol)(name, from);
     };
+    const createPreamble = (descFile) => (0, gencommon_1.makeFilePreamble)(descFile, pluginName, pluginVersion, parameter.sanitizedParameter, parameter.tsNocheck);
+    let target;
     const generatedFiles = [];
-    const schema = {
-        targets,
+    return {
+        targets: parameter.targets,
         runtime,
         proto: request,
         files: filesToGenerate,
         allFiles: descriptorSet.files,
         generateFile(name) {
-            const genFile = (0, generated_file_js_1.createGeneratedFile)(name, (0, import_path_js_1.deriveImportPath)(name), (importPath) => (0, import_path_js_1.rewriteImportPath)(importPath, rewriteImports, importExtension), createTypeImport, runtime, {
-                pluginName,
-                pluginVersion,
-                pluginParameter,
-                tsNocheck,
-            }, keepEmptyFiles);
+            if (target === undefined) {
+                throw new Error("prepareGenerate() must be called before generateFile()");
+            }
+            const genFile = (0, generated_file_js_1.createGeneratedFile)(name, (0, import_path_js_1.deriveImportPath)(name), target === "js" ? parameter.jsImportStyle : "module", // ts and dts always use import/export, only js may use commonjs
+            (importPath) => (0, import_path_js_1.rewriteImportPath)(importPath, parameter.rewriteImports, parameter.importExtension), createTypeImport, runtime, createPreamble);
             generatedFiles.push(genFile);
             return genFile;
         },
-    };
-    return {
-        schema,
         getFileInfo() {
-            return generatedFiles.flatMap((file) => {
-                const fileInfo = file.getFileInfo();
-                // undefined is returned if the file has no content
-                if (!fileInfo) {
-                    return [];
-                }
-                return [fileInfo];
-            });
+            return generatedFiles
+                .map((f) => f.getFileInfo())
+                .filter((fi) => parameter.keepEmptyFiles || fi.content.length > 0);
+        },
+        prepareGenerate(newTarget) {
+            target = newTarget;
         },
     };
 }
 exports.createSchema = createSchema;
-function toResponse(files) {
-    return new protobuf_1.CodeGeneratorResponse({
-        supportedFeatures: protobuf_1.protoInt64.parse(protobuf_1.CodeGeneratorResponse_Feature.PROTO3_OPTIONAL),
-        file: files.map((f) => {
-            if (f.preamble !== undefined) {
-                f.content = f.preamble + "\n" + f.content;
-            }
-            return f;
-        }),
-    });
-}
-exports.toResponse = toResponse;
 function findFilesToGenerate(descriptorSet, request) {
     const missing = request.fileToGenerate.filter((fileToGenerate) => descriptorSet.files.every((file) => fileToGenerate !== file.name + ".proto"));
     if (missing.length) {

package/dist/cjs/ecmascript/target.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2021-2023 Buf Technologies, Inc.
+// 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.

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

@@ -1,2 +1,2 @@
 import type { FileInfo } from "./generated-file.js";
-export declare function transpile(files: FileInfo[], transpileJs: boolean, transpileDts: boolean): FileInfo[];
+export declare function transpile(files: FileInfo[], transpileJs: boolean, transpileDts: boolean, jsImportStyle: "module" | "legacy_commonjs"): FileInfo[];

package/dist/cjs/ecmascript/transpile.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2021-2023 Buf Technologies, Inc.
+// 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.
@@ -82,8 +82,11 @@ function createTranspiler(options, files) {
         host: host.compilerHost,
     });
 }
-function transpile(files, transpileJs, transpileDts) {
+function transpile(files, transpileJs, transpileDts, jsImportStyle) {
     const options = Object.assign(Object.assign({}, defaultOptions), { declaration: transpileDts, emitDeclarationOnly: transpileDts && !transpileJs });
+    if (jsImportStyle == "legacy_commonjs") {
+        options.module = typescript_1.default.ModuleKind.CommonJS;
+    }
     // Create the transpiler (a ts.Program object)
     const program = createTranspiler(options, files);
     const results = [];

package/dist/cjs/error.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2021-2023 Buf Technologies, Inc.
+// 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.

package/dist/cjs/index.d.ts

@@ -1,4 +1,8 @@
+import { Schema as SchemaInternal } from "./ecmascript/schema.js";
 export { Plugin } from "./plugin.js";
-export { Schema } from "./ecmascript/schema.js";
 export { runNodeJs } from "./run-node.js";
 export { createEcmaScriptPlugin } from "./create-es-plugin.js";
+/**
+ * @deprecated Please use Schema from @bufbuild/protoplugin/ecmascript instead
+ */
+export type Schema = SchemaInternal;

package/dist/cjs/index.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2021-2023 Buf Technologies, Inc.
+// 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.

package/dist/cjs/plugin.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2021-2023 Buf Technologies, Inc.
+// 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.

package/dist/cjs/run-node.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2021-2023 Buf Technologies, Inc.
+// 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.

package/dist/esm/create-es-plugin.d.ts

@@ -1,6 +1,7 @@
 import { Schema } from "./ecmascript/schema.js";
 import type { FileInfo } from "./ecmascript/generated-file.js";
 import type { Plugin } from "./plugin.js";
+import type { FeatureSetDefaults } from "@bufbuild/protobuf";
 interface PluginInit {
     /**
      * Name of this code generator plugin.
@@ -15,6 +16,20 @@ interface PluginInit {
      * options.
      */
     parseOption?: (key: string, value: string) => void;
+    /**
+     * Whether the plugin supports editions.
+     */
+    supportsEditions?: boolean;
+    /**
+     * By default, plugins support all editions supported by createDescriptorSet()
+     * from @bufbuild/protobuf, if supportsEditions is enabled.
+     *
+     * This option can be used to limit support for specific editions, by providing
+     * your own google.protobuf.FeatureSetDefaults generated by protoc with the
+     * flags --experimental_edition_defaults_out, --experimental_edition_defaults_minimum,
+     * and --experimental_edition_defaults_maximum.
+     */
+    featureSetDefaults?: FeatureSetDefaults;
     /**
      * A function which will generate TypeScript files based on proto input.
      * This function will be invoked by the plugin framework when the plugin runs.
@@ -45,14 +60,19 @@ interface PluginInit {
      */
     generateDts?: (schema: Schema, target: "dts") => void;
     /**
-     * A optional function which will transpile a given set of files.
+     * An optional function which will transpile a given set of files.
      *
-     * This funcion is meant to be used in place of either generateJs,
+     * This function is meant to be used in place of either generateJs,
      * generateDts, or both.  However, those functions will take precedence.
      * This means that if generateJs, generateDts, and this transpile function
      * are all provided, this transpile function will be ignored.
+     *
+     * If jsImportStyle is "module" (the standard behavior), the function is
+     * expected to use ECMAScript module import and export statements when
+     * transpiling to JS. If jsImportStyle is "legacy_commonjs", the function is
+     * expected to use CommonJs require() and exports when transpiling to JS.
      */
-    transpile?: (files: FileInfo[], transpileJs: boolean, transpileDts: boolean) => FileInfo[];
+    transpile?: (files: FileInfo[], transpileJs: boolean, transpileDts: boolean, jsImportStyle: "module" | "legacy_commonjs") => FileInfo[];
 }
 /**
  * Create a new code generator plugin for ECMAScript.

package/dist/esm/create-es-plugin.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2023 Buf Technologies, Inc.
+// 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.
@@ -11,9 +11,10 @@
 // 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.
-import { createSchema, toResponse } from "./ecmascript/schema.js";
+import { createSchema } from "./ecmascript/schema.js";
 import { transpile } from "./ecmascript/transpile.js";
-import { PluginOptionError } from "./error.js";
+import { parseParameter } from "./ecmascript/parameter.js";
+import { CodeGeneratorResponse, CodeGeneratorResponse_Feature, protoInt64, } from "@bufbuild/protobuf";
 /**
  * Create a new code generator plugin for ECMAScript.
  * The plugin can generate JavaScript, TypeScript, or TypeScript declaration
@@ -26,9 +27,9 @@ export function createEcmaScriptPlugin(init) {
         name: init.name,
         version: init.version,
         run(req) {
-            var _a;
-            const { targets, tsNocheck, bootstrapWkt, rewriteImports, importExtension, keepEmptyFiles, pluginParameter, } = parseParameter(req.parameter, init.parseOption);
-            const { schema, getFileInfo } = createSchema(req, targets, tsNocheck, bootstrapWkt, rewriteImports, importExtension, keepEmptyFiles, init.name, init.version, pluginParameter);
+            var _a, _b;
+            const parameter = parseParameter(req.parameter, init.parseOption);
+            const schema = createSchema(req, parameter, init.name, init.version, init.featureSetDefaults);
             const targetTs = schema.targets.includes("ts");
             const targetJs = schema.targets.includes("js");
             const targetDts = schema.targets.includes("dts");
@@ -42,6 +43,7 @@ export function createEcmaScriptPlugin(init) {
             if (targetTs ||
                 (targetJs && !init.generateJs) ||
                 (targetDts && !init.generateDts)) {
+                schema.prepareGenerate("ts");
                 init.generateTs(schema, "ts");
                 // Save off the generated TypeScript files so that we can pass these
                 // to the transpilation process if necessary.  We do not want to pass
@@ -53,10 +55,11 @@ export function createEcmaScriptPlugin(init) {
                 // a generateJs function and expect to transpile declarations.
                 // 3.  Transpiling is somewhat expensive and situations with an
                 // extremely large amount of files could have performance impacts.
-                tsFiles = getFileInfo();
+                tsFiles = schema.getFileInfo();
             }
             if (targetJs) {
                 if (init.generateJs) {
+                    schema.prepareGenerate("js");
                     init.generateJs(schema, "js");
                 }
                 else {
@@ -65,6 +68,7 @@ export function createEcmaScriptPlugin(init) {
             }
             if (targetDts) {
                 if (init.generateDts) {
+                    schema.prepareGenerate("dts");
                     init.generateDts(schema, "dts");
                 }
                 else {
@@ -76,7 +80,7 @@ export function createEcmaScriptPlugin(init) {
             // generated TypeScript files to assist in transpilation.  If they were
             // generated but not specified in the target out, we shouldn't produce
             // these files in the CodeGeneratorResponse.
-            let files = getFileInfo();
+            let files = schema.getFileInfo();
             if (!targetTs && tsFiles.length > 0) {
                 files = files.filter((file) => !tsFiles.some((tsFile) => tsFile.name === file.name));
             }
@@ -86,139 +90,26 @@ export function createEcmaScriptPlugin(init) {
             if (transpileJs || transpileDts) {
                 const transpileFn = (_a = init.transpile) !== null && _a !== void 0 ? _a : transpile;
                 // Transpile the TypeScript files and add to the master list of files
-                const transpiledFiles = transpileFn(tsFiles, transpileJs, transpileDts);
+                const transpiledFiles = transpileFn(tsFiles, transpileJs, transpileDts, parameter.jsImportStyle);
                 files.push(...transpiledFiles);
             }
-            return toResponse(files);
+            return toResponse(files, (_b = init.supportsEditions) !== null && _b !== void 0 ? _b : false);
         },
     };
 }
-function parseParameter(parameter, parseOption) {
-    let targets = ["js", "dts"];
-    let tsNocheck = true;
-    let bootstrapWkt = false;
-    let keepEmptyFiles = false;
-    const rewriteImports = [];
-    let importExtension = ".js";
-    const rawParameters = [];
-    for (const { key, value, raw } of splitParameter(parameter)) {
-        // Whether this key/value plugin parameter pair should be
-        // printed to the generated file preamble
-        let printToFile = true;
-        switch (key) {
-            case "target":
-                targets = [];
-                for (const rawTarget of value.split("+")) {
-                    switch (rawTarget) {
-                        case "js":
-                        case "ts":
-                        case "dts":
-                            if (targets.indexOf(rawTarget) < 0) {
-                                targets.push(rawTarget);
-                            }
-                            break;
-                        default:
-                            throw new PluginOptionError(raw);
-                    }
-                }
-                value.split("+");
-                break;
-            case "ts_nocheck":
-                switch (value) {
-                    case "true":
-                    case "1":
-                        tsNocheck = true;
-                        break;
-                    case "false":
-                    case "0":
-                        tsNocheck = false;
-                        break;
-                    default:
-                        throw new PluginOptionError(raw);
-                }
-                break;
-            case "bootstrap_wkt":
-                switch (value) {
-                    case "true":
-                    case "1":
-                        bootstrapWkt = true;
-                        break;
-                    case "false":
-                    case "0":
-                        bootstrapWkt = false;
-                        break;
-                    default:
-                        throw new PluginOptionError(raw);
-                }
-                break;
-            case "rewrite_imports": {
-                const parts = value.split(":");
-                if (parts.length !== 2) {
-                    throw new PluginOptionError(raw, "must be in the form of <pattern>:<target>");
-                }
-                const [pattern, target] = parts;
-                rewriteImports.push({ pattern, target });
-                // rewrite_imports can be noisy and is more of an implementation detail
-                // so we strip it out of the preamble
-                printToFile = false;
-                break;
-            }
-            case "import_extension": {
-                importExtension = value === "none" ? "" : value;
-                break;
-            }
-            case "keep_empty_files": {
-                switch (value) {
-                    case "true":
-                    case "1":
-                        keepEmptyFiles = true;
-                        break;
-                    case "false":
-                    case "0":
-                        keepEmptyFiles = false;
-                        break;
-                    default:
-                        throw new PluginOptionError(raw);
-                }
-                break;
-            }
-            default:
-                if (parseOption === undefined) {
-                    throw new PluginOptionError(raw);
-                }
-                try {
-                    parseOption(key, value);
-                }
-                catch (e) {
-                    throw new PluginOptionError(raw, e);
-                }
-                break;
-        }
-        if (printToFile) {
-            rawParameters.push(raw);
-        }
-    }
-    const pluginParameter = rawParameters.join(",");
-    return {
-        targets,
-        tsNocheck,
-        bootstrapWkt,
-        rewriteImports,
-        importExtension,
-        keepEmptyFiles,
-        pluginParameter,
-    };
-}
-function splitParameter(parameter) {
-    if (parameter == undefined) {
-        return [];
+function toResponse(files, supportsEditions) {
+    let supportedFeatures = CodeGeneratorResponse_Feature.PROTO3_OPTIONAL;
+    if (supportsEditions) {
+        supportedFeatures =
+            supportedFeatures | CodeGeneratorResponse_Feature.SUPPORTS_EDITIONS;
     }
-    return parameter.split(",").map((raw) => {
-        const i = raw.indexOf("=");
-        return {
-            key: i === -1 ? raw : raw.substring(0, i),
-            value: i === -1 ? "" : raw.substring(i + 1),
-            raw,
-        };
+    return new CodeGeneratorResponse({
+        supportedFeatures: protoInt64.parse(supportedFeatures),
+        file: files.map((f) => {
+            if (f.preamble !== undefined) {
+                f.content = f.preamble + "\n" + f.content;
+            }
+            return f;
+        }),
     });
 }

package/dist/esm/ecmascript/custom-options.d.ts

@@ -1,12 +1,16 @@
 import type { AnyDesc } from "@bufbuild/protobuf";
 import { Message, MessageType, ScalarType } from "@bufbuild/protobuf";
 /**
+ * @deprecated Please use extensions instead.
+ *
  * Returns the value of a custom option with a scalar type.
  *
  * If no option is found, returns undefined.
  */
 export declare function findCustomScalarOption<T extends ScalarType>(desc: AnyDesc, extensionNumber: number, scalarType: T): ScalarValue<T> | undefined;
 /**
+ * @deprecated Please use extensions instead.
+ *
  * Returns the value of a custom message option for the given descriptor and
  * extension number.
  * The msgType param is then used to deserialize the message for returning to
@@ -19,6 +23,8 @@ export declare function findCustomScalarOption<T extends ScalarType>(desc: AnyDe
  */
 export declare function findCustomMessageOption<T extends Message<T>>(desc: AnyDesc, extensionNumber: number, msgType: MessageType<T>): T | undefined;
 /**
+ * @deprecated Please use extensions instead.
+ *
  * Returns the value of a custom enum option for the given descriptor and
  * extension number.
  *
@@ -26,6 +32,8 @@ export declare function findCustomMessageOption<T extends Message<T>>(desc: AnyD
  */
 export declare function findCustomEnumOption(desc: AnyDesc, extensionNumber: number): number | undefined;
 /**
+ * @deprecated Please use extensions instead.
+ *
  * ScalarValue is a conditional type that pairs a ScalarType value with its concrete type.
  */
 type ScalarValue<T> = T extends ScalarType.STRING ? string : T extends ScalarType.INT32 ? number : T extends ScalarType.UINT32 ? number : T extends ScalarType.UINT32 ? number : T extends ScalarType.SINT32 ? number : T extends ScalarType.FIXED32 ? number : T extends ScalarType.SFIXED32 ? number : T extends ScalarType.FLOAT ? number : T extends ScalarType.DOUBLE ? number : T extends ScalarType.INT64 ? bigint | string : T extends ScalarType.SINT64 ? bigint | string : T extends ScalarType.SFIXED64 ? bigint | string : T extends ScalarType.UINT64 ? bigint | string : T extends ScalarType.FIXED64 ? bigint | string : T extends ScalarType.BOOL ? boolean : T extends ScalarType.BYTES ? Uint8Array : never;

package/dist/esm/ecmascript/custom-options.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2023 Buf Technologies, Inc.
+// 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.
@@ -13,6 +13,8 @@
 // limitations under the License.
 import { proto3, BinaryReader, ScalarType, } from "@bufbuild/protobuf";
 /**
+ * @deprecated Please use extensions instead.
+ *
  * Returns the value of a custom option with a scalar type.
  *
  * If no option is found, returns undefined.
@@ -59,6 +61,8 @@ export function findCustomScalarOption(desc, extensionNumber, scalarType) {
     return undefined;
 }
 /**
+ * @deprecated Please use extensions instead.
+ *
  * Returns the value of a custom message option for the given descriptor and
  * extension number.
  * The msgType param is then used to deserialize the message for returning to
@@ -84,6 +88,8 @@ export function findCustomMessageOption(desc, extensionNumber, msgType) {
     return undefined;
 }
 /**
+ * @deprecated Please use extensions instead.
+ *
  * Returns the value of a custom enum option for the given descriptor and
  * extension number.
  *

package/dist/esm/ecmascript/export-declaration.d.ts

@@ -0,0 +1,7 @@
+import { DescEnum, DescExtension, DescMessage } from "@bufbuild/protobuf";
+export type ExportDeclaration = {
+    readonly kind: "es_export_decl";
+    declaration: string;
+    name: string | DescMessage | DescEnum | DescExtension;
+};
+export declare function createExportDeclaration(declaration: string, name: ExportDeclaration["name"]): ExportDeclaration;

package/dist/esm/ecmascript/export-declaration.js

@@ -0,0 +1,20 @@
+// 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.
+export function createExportDeclaration(declaration, name) {
+    return {
+        kind: "es_export_decl",
+        declaration,
+        name,
+    };
+}

package/dist/esm/ecmascript/gencommon.d.ts

@@ -1,20 +1,19 @@
-import { DescEnum, DescEnumValue, DescField, DescFile, DescMessage, DescMethod, DescOneof, DescService, LongType, ScalarType } from "@bufbuild/protobuf";
+import type { DescExtension } from "@bufbuild/protobuf";
+import { DescField, DescFile, LongType, ScalarType } from "@bufbuild/protobuf";
 import type { GeneratedFile, Printable } from "./generated-file.js";
 import type { ImportSymbol } from "./import-symbol.js";
 export declare function makeFilePreamble(file: DescFile, pluginName: string, pluginVersion: string, parameter: string, tsNoCheck: boolean): string;
-export declare function createJsDocBlock(text: string, indentation?: string): Printable;
-export declare function makeJsDoc(desc: DescEnum | DescEnumValue | DescMessage | DescOneof | DescField | DescService | DescMethod, indentation?: string): Printable;
 /**
  * Returns an expression for the TypeScript typing of a field,
  * and whether the property should be optional.
  */
-export declare function getFieldTyping(field: DescField, file: GeneratedFile): {
+export declare function getFieldTyping(field: DescField | DescExtension, file: GeneratedFile): {
     typing: Printable;
     optional: boolean;
 };
 export declare function scalarTypeScriptType(type: ScalarType, longType: LongType): Printable;
 export declare function literalString(value: string): string;
-export declare function getFieldExplicitDefaultValue(field: DescField, protoInt64Symbol: ImportSymbol): Printable | undefined;
+export declare function getFieldExplicitDefaultValue(field: DescField | DescExtension, protoInt64Symbol: ImportSymbol): Printable | undefined;
 export declare function getFieldIntrinsicDefaultValue(field: DescField): {
     defaultValue: Printable | undefined;
     typingInferrable: boolean;

package/dist/esm/ecmascript/gencommon.js

@@ -1,4 +1,4 @@
-// Copyright 2021-2023 Buf Technologies, Inc.
+// 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.
@@ -69,78 +69,6 @@ export function makeFilePreamble(file, pluginName, pluginVersion, parameter, tsN
     writeLeadingComments(file.getPackageComments());
     return trimSuffix(builder.join(""), "\n");
 }
-export function createJsDocBlock(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));
-    // prettier-ignore
-    return [
-        `${indentation}/**\n`,
-        ...lines.map((l) => `${indentation} *${l}\n`),
-        `${indentation} */`
-    ];
-}
-export function makeJsDoc(desc, indentation = "") {
-    var _a, _b;
-    const comments = desc.getComments();
-    let text = "";
-    if (comments.leading !== undefined) {
-        text += comments.leading;
-        if (text.endsWith("\n")) {
-            text = text.substring(0, text.length - 1);
-        }
-    }
-    if (comments.trailing !== undefined) {
-        if (text.length > 0) {
-            text += "\n\n";
-        }
-        text += comments.trailing;
-        if (text.endsWith("\n")) {
-            text = text.substring(0, text.length - 1);
-        }
-    }
-    if (text.length > 0) {
-        text += "\n\n";
-    }
-    text = text
-        .split("\n")
-        .map((line) => (line.startsWith(" ") ? line.substring(1) : line))
-        .join("\n");
-    switch (desc.kind) {
-        case "enum_value":
-            text += `@generated from enum value: ${desc.declarationString()};`;
-            break;
-        case "field":
-            text += `@generated from field: ${desc.declarationString()};`;
-            break;
-        default:
-            text += `@generated from ${desc.toString()}`;
-            break;
-    }
-    let deprecated = desc.deprecated;
-    switch (desc.kind) {
-        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);
-            break;
-        default:
-            break;
-    }
-    if (deprecated) {
-        text += "\n@deprecated";
-    }
-    if (text.length > 0) {
-        return createJsDocBlock(text, indentation);
-    }
-    return [];
-}
 /**
  * Returns an expression for the TypeScript typing of a field,
  * and whether the property should be optional.