@dxos/protobuf-compiler 2.33.9-dev.b6f4ca19 → 2.33.9-dev.bba8fc00

package/dist/src/generator/context.d.ts

@@ -0,0 +1,6 @@
+import { SubstitutionsMap } from '../parser';
+export interface GeneratorContext {
+    outputFilename: string;
+    subs: SubstitutionsMap;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/src/generator/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/generator/context.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,gBAAgB,CAAA;CACvB"}

package/dist/src/generator/context.js

@@ -0,0 +1,6 @@
+"use strict";
+//
+// Copyright 2022 DXOS.org
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=context.js.map

package/dist/src/generator/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/generator/context.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE"}

package/dist/src/generator/declaration-generator.d.ts

@@ -1,6 +1,6 @@
 import * as protobufjs from 'protobufjs';
 import * as ts from 'typescript';
-import { SubstitutionsMap } from '../parser';
-export declare function createDeclarations(types: protobufjs.ReflectionObject[], subs: SubstitutionsMap): Generator<ts.Statement>;
+import { GeneratorContext } from './context';
+export declare function createDeclarations(types: protobufjs.ReflectionObject[], ctx: GeneratorContext): Generator<ts.Statement>;
 export declare const createTypeDictionary: (root: protobufjs.NamespaceBase) => ts.InterfaceDeclaration;
 //# sourceMappingURL=declaration-generator.d.ts.map

package/dist/src/generator/declaration-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"declaration-generator.d.ts","sourceRoot":"","sources":["../../../src/generator/declaration-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAQ7C,wBAAkB,kBAAkB,CAAE,KAAK,EAAE,UAAU,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAuB3H;AAeD,eAAO,MAAM,oBAAoB,SAAU,WAAW,aAAa,4BAclE,CAAC"}
+{"version":3,"file":"declaration-generator.d.ts","sourceRoot":"","sources":["../../../src/generator/declaration-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAQ7C,wBAAkB,kBAAkB,CAAE,KAAK,EAAE,UAAU,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAuB1H;AAeD,eAAO,MAAM,oBAAoB,SAAU,WAAW,aAAa,4BAclE,CAAC"}

package/dist/src/generator/declaration-generator.js

@@ -35,23 +35,23 @@ const message_1 = require("./message");
 const service_1 = require("./service");
 const types_1 = require("./types");
 const f = ts.factory;
-function* createDeclarations(types, subs) {
+function* createDeclarations(types, ctx) {
     for (const obj of types) {
         if (obj instanceof protobufjs.Enum) {
-            yield (0, enum_1.createEnumDeclaration)(obj);
+            yield (0, enum_1.createEnumDeclaration)(obj, ctx);
         }
         else if (obj instanceof protobufjs.Service) {
-            yield (0, service_1.createServiceDeclaration)(obj, subs);
+            yield (0, service_1.createServiceDeclaration)(obj, ctx);
         }
         else if (obj instanceof protobufjs.Type) {
-            yield (0, message_1.createMessageDeclaration)(obj, subs);
-            const nested = Array.from(createDeclarations(obj.nestedArray, subs));
+            yield (0, message_1.createMessageDeclaration)(obj, ctx);
+            const nested = Array.from(createDeclarations(obj.nestedArray, ctx));
             if (nested.length > 0) {
                 yield f.createModuleDeclaration(undefined, [f.createToken(ts.SyntaxKind.ExportKeyword)], f.createIdentifier(obj.name), f.createModuleBlock(nested), ts.NodeFlags.Namespace);
             }
         }
         else if (obj instanceof protobufjs.Namespace) {
-            yield* createDeclarations(obj.nestedArray, subs);
+            yield* createDeclarations(obj.nestedArray, ctx);
         }
     }
 }

package/dist/src/generator/declaration-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"declaration-generator.js","sourceRoot":"","sources":["../../../src/generator/declaration-generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"declaration-generator.js","sourceRoot":"","sources":["../../../src/generator/declaration-generator.ts"],"names":[],"mappings":"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"}

package/dist/src/generator/enum.d.ts

@@ -1,4 +1,5 @@
 import * as protobufjs from 'protobufjs';
 import * as ts from 'typescript';
-export declare const createEnumDeclaration: (type: protobufjs.Enum) => ts.EnumDeclaration;
+import { GeneratorContext } from './context';
+export declare const createEnumDeclaration: (type: protobufjs.Enum, ctx: GeneratorContext) => ts.EnumDeclaration;
 //# sourceMappingURL=enum.d.ts.map

package/dist/src/generator/enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../../src/generator/enum.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAIjC,eAAO,MAAM,qBAAqB,SAAU,WAAW,IAAI,uBAQ1D,CAAC"}
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../../src/generator/enum.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAK7C,eAAO,MAAM,qBAAqB,SAAU,WAAW,IAAI,OAAO,gBAAgB,uBAqBjF,CAAC"}

package/dist/src/generator/enum.js

@@ -27,8 +27,20 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createEnumDeclaration = void 0;
+const path_1 = require("path");
 const ts = __importStar(require("typescript"));
+const doc_comment_1 = require("./doc-comment");
 const f = ts.factory;
-const createEnumDeclaration = (type) => f.createEnumDeclaration(undefined, [f.createToken(ts.SyntaxKind.ExportKeyword)], type.name, Object.entries(type.values).map(([name, id]) => f.createEnumMember(name, f.createNumericLiteral(id))));
+const createEnumDeclaration = (type, ctx) => {
+    const declaration = f.createEnumDeclaration(undefined, [f.createToken(ts.SyntaxKind.ExportKeyword)], type.name, Object.entries(type.values).map(([name, id]) => f.createEnumMember(name, f.createNumericLiteral(id))));
+    const commentSections = type.comment ? [type.comment] : [];
+    if (type.filename) {
+        commentSections.push(`Defined in:\n  {@link file://./${(0, path_1.relative)((0, path_1.dirname)(ctx.outputFilename), type.filename)}}`);
+    }
+    if (commentSections.length === 0) {
+        return declaration;
+    }
+    return (0, doc_comment_1.attachDocComment)(declaration, commentSections.join('\n\n'));
+};
 exports.createEnumDeclaration = createEnumDeclaration;
 //# sourceMappingURL=enum.js.map

package/dist/src/generator/enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../../src/generator/enum.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;AAGF,+CAAiC;AAEjC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;AAEd,MAAM,qBAAqB,GAAG,CAAC,IAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,qBAAqB,CACrF,SAAS,EACT,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAC5C,IAAI,CAAC,IAAI,EACT,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAChE,IAAI,EACJ,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAC3B,CAAC,CACH,CAAC;AARW,QAAA,qBAAqB,yBAQhC"}
+{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../../src/generator/enum.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;AAEF,+BAAyC;AAEzC,+CAAiC;AAGjC,+CAAiD;AAEjD,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;AAEd,MAAM,qBAAqB,GAAG,CAAC,IAAqB,EAAE,GAAqB,EAAE,EAAE;IACpF,MAAM,WAAW,GAAG,CAAC,CAAC,qBAAqB,CACzC,SAAS,EACT,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAC5C,IAAI,CAAC,IAAI,EACT,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAChE,IAAI,EACJ,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAC3B,CAAC,CACH,CAAC;IAEF,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,IAAI,IAAI,CAAC,QAAQ,EAAE;QACjB,eAAe,CAAC,IAAI,CAAC,kCAAkC,IAAA,eAAQ,EAAC,IAAA,cAAO,EAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;KACjH;IAED,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE;QAChC,OAAO,WAAW,CAAC;KACpB;IAED,OAAO,IAAA,8BAAgB,EAAC,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC;AArBW,QAAA,qBAAqB,yBAqBhC"}

package/dist/src/generator/file-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-generator.d.ts","sourceRoot":"","sources":["../../../src/generator/file-generator.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAgB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAc7C,eAAO,MAAM,yBAAyB,UAAW,GAAG,gBAAgB,EAAE,iBAAiB,gBAAgB,UAAU,MAAM,aAAa,MAAM,uBAAuB,eAAe,GAAG,SAAS,mBAAmB,MAAM,EAAE,kBAkBtN,CAAC;AAEF,eAAO,MAAM,qBAAqB,wBAAyB,eAAe,GAAG,SAAS,QAAQ,GAAG,IAAI,cAAc,MAAM,cAAc,MAAM,EAAE,kBAqB9I,CAAC;AAWF,eAAO,MAAM,uBAAuB,cAAe,MAAM,WAGxD,CAAC"}
+{"version":3,"file":"file-generator.d.ts","sourceRoot":"","sources":["../../../src/generator/file-generator.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAgB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAe7C,eAAO,MAAM,yBAAyB,UAAW,GAAG,gBAAgB,EAAE,iBAAiB,gBAAgB,UAAU,MAAM,aAAa,MAAM,uBAAuB,eAAe,GAAG,SAAS,mBAAmB,MAAM,EAAE,kBAuBtN,CAAC;AAEF,eAAO,MAAM,qBAAqB,wBAAyB,eAAe,GAAG,SAAS,QAAQ,GAAG,IAAI,cAAc,MAAM,cAAc,MAAM,EAAE,kBAqB9I,CAAC;AAWF,eAAO,MAAM,uBAAuB,cAAe,MAAM,WAGxD,CAAC"}

package/dist/src/generator/file-generator.js

@@ -38,7 +38,11 @@ const f = ts.factory;
 const createSubstitutionsImport = (substitutionsModule, context) => substitutionsModule && ts.factory.createImportDeclaration([], [], ts.factory.createImportClause(false, ts.factory.createIdentifier('substitutions'), undefined), ts.factory.createStringLiteral(substitutionsModule.importSpecifier(context)));
 const createNamespaceSourceFile = (types, substitutions, outDir, namespace, substitutionsModule, otherNamespaces) => {
     const outFile = (0, path_1.join)(outDir, (0, exports.getFileNameForNamespace)(namespace));
-    const declarations = Array.from((0, declaration_generator_1.createDeclarations)(types, substitutions));
+    const ctx = {
+        outputFilename: outFile,
+        subs: substitutions
+    };
+    const declarations = Array.from((0, declaration_generator_1.createDeclarations)(types, ctx));
     const substitutionsImport = substitutionsModule && createSubstitutionsImport(substitutionsModule, (0, path_1.dirname)(outFile));
     const otherNamespaceImports = createNamespaceImports(otherNamespaces.filter(ns => ns !== namespace), outDir, (0, path_1.dirname)(outFile));
     return ts.factory.createSourceFile([

package/dist/src/generator/file-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-generator.js","sourceRoot":"","sources":["../../../src/generator/file-generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"file-generator.js","sourceRoot":"","sources":["../../../src/generator/file-generator.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;AAEF,+BAAqC;AAErC,+CAAiC;AAEjC,0DAAoE;AACpE,8CAAoF;AAGpF,mEAAmF;AACnF,uFAA+E;AAC/E,uCAAqD;AAErD,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;AAErB,MAAM,yBAAyB,GAAG,CAAC,mBAAoC,EAAE,OAAe,EAAE,EAAE,CAAC,mBAAmB,IAAI,EAAE,CAAC,OAAO,CAAC,uBAAuB,CACpJ,EAAE,EACF,EAAE,EACF,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC,EAC7F,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAC7E,CAAC;AAEK,MAAM,yBAAyB,GAAG,CAAC,KAA4B,EAAE,aAA+B,EAAE,MAAc,EAAE,SAAiB,EAAE,mBAAgD,EAAE,eAAyB,EAAE,EAAE;IACzN,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,MAAM,EAAE,IAAA,+BAAuB,EAAC,SAAS,CAAC,CAAC,CAAC;IACjE,MAAM,GAAG,GAAqB;QAC5B,cAAc,EAAE,OAAO;QACvB,IAAI,EAAE,aAAa;KACpB,CAAC;IAEF,MAAM,YAAY,GAAmB,KAAK,CAAC,IAAI,CAAC,IAAA,0CAAkB,EAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAEhF,MAAM,mBAAmB,GAAG,mBAAmB,IAAI,yBAAyB,CAAC,mBAAmB,EAAE,IAAA,cAAO,EAAC,OAAO,CAAC,CAAC,CAAC;IAEpH,MAAM,qBAAqB,GAAG,sBAAsB,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,MAAM,EAAE,IAAA,cAAO,EAAC,OAAO,CAAC,CAAC,CAAC;IAE/H,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAChC;QACE,kBAAkB,EAAE;QACpB,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,qBAAqB;QACxB,GAAG,YAAY;KAChB,EACD,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EACpD,EAAE,CAAC,SAAS,CAAC,IAAI,CAClB,CAAC;AACJ,CAAC,CAAC;AAvBW,QAAA,yBAAyB,6BAuBpC;AAEK,MAAM,qBAAqB,GAAG,CAAC,mBAAgD,EAAE,IAAa,EAAE,UAAkB,EAAE,UAAoB,EAAE,EAAE;IACjJ,MAAM,EACJ,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,aAAa,EACvB,GAAG,IAAA,4DAA0B,EAAC,mBAAmB,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAEtE,MAAM,mBAAmB,GAAG,mBAAmB,IAAI,yBAAyB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;IAC9G,MAAM,qBAAqB,GAAG,sBAAsB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAEzF,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAChC;QACE,GAAG,aAAa;QAChB,GAAG,qBAAqB;QACxB,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,IAAA,4CAAoB,EAAC,IAAI,CAAC;QAC1B,IAAA,kCAAwB,EAAC,IAAI,CAAC;QAC9B,GAAG,aAAa;KACjB,EACD,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EACpD,EAAE,CAAC,SAAS,CAAC,IAAI,CAClB,CAAC;AACJ,CAAC,CAAC;AArBW,QAAA,qBAAqB,yBAqBhC;AAEF,MAAM,sBAAsB,GAAG,CAAC,UAAoB,EAAE,UAAkB,EAAE,OAAe,EAAE,EAAE,CAAC,UAAU;KACrG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;KAClC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAClC,EAAE,EACF,EAAE,EACF,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAA,uCAA0B,EAAC,IAAA,oCAAuB,EAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAC5I,CAAC,CAAC,mBAAmB,CAAC,kCAAe,CAAC,mBAAmB,CAAC,IAAA,+BAAuB,EAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAC7H,CAAC,CAAC;AAEE,MAAM,uBAAuB,GAAG,CAAC,SAAiB,EAAE,EAAE;IAC3D,MAAM,IAAI,GAAG,IAAA,oCAAuB,EAAC,SAAS,CAAC,CAAC;IAChD,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;AAChC,CAAC,CAAC;AAHW,QAAA,uBAAuB,2BAGlC;AAEF,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,uBAAuB,CACxD,EAAE,EACF,EAAE,EACF,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,kBAAkB,CAAC;IACzD,CAAC,CAAC,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;CACxE,CAAC,CAAC,EACH,CAAC,CAAC,mBAAmB,CAAC,+BAAY,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CACxD,CAAC"}

package/dist/src/generator/message.d.ts

@@ -1,5 +1,8 @@
 import * as protobufjs from 'protobufjs';
 import * as ts from 'typescript';
-import { SubstitutionsMap } from '../parser';
-export declare const createMessageDeclaration: (type: protobufjs.Type, subs: SubstitutionsMap) => ts.InterfaceDeclaration;
+import { GeneratorContext } from './context';
+/**
+ * {@link file://./../configure.ts#l5}
+ */
+export declare const createMessageDeclaration: (type: protobufjs.Type, ctx: GeneratorContext) => ts.InterfaceDeclaration;
 //# sourceMappingURL=message.d.ts.map

package/dist/src/generator/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/generator/message.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAM7C,eAAO,MAAM,wBAAwB,SAAU,WAAW,IAAI,QAAQ,gBAAgB,4BAyBrF,CAAC"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/generator/message.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAM7C;;GAEG;AACH,eAAO,MAAM,wBAAwB,SAAU,WAAW,IAAI,OAAO,gBAAgB,4BAgCpF,CAAC"}

package/dist/src/generator/message.js

@@ -27,20 +27,29 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMessageDeclaration = void 0;
+const path_1 = require("path");
 const ts = __importStar(require("typescript"));
 const doc_comment_1 = require("./doc-comment");
 const field_1 = require("./field");
 const f = ts.factory;
-const createMessageDeclaration = (type, subs) => {
+/**
+ * {@link file://./../configure.ts#l5}
+ */
+const createMessageDeclaration = (type, ctx) => {
     const declaration = f.createInterfaceDeclaration(undefined, [f.createToken(ts.SyntaxKind.ExportKeyword)], type.name, undefined, undefined, type.fieldsArray.map(field => {
-        const signature = f.createPropertySignature(undefined, field.name.includes('.') ? f.createStringLiteral(field.name) : field.name, field.required ? undefined : f.createToken(ts.SyntaxKind.QuestionToken), (0, field_1.getFieldType)(field, subs));
+        const isRequired = field.required || (!field.getOption('proto3_optional') && !field.repeated && !field.map && !field.partOf);
+        const signature = f.createPropertySignature(undefined, field.name.includes('.') ? f.createStringLiteral(field.name) : field.name, isRequired ? undefined : f.createToken(ts.SyntaxKind.QuestionToken), (0, field_1.getFieldType)(field, ctx.subs));
         const docComment = getFieldDocComment(field);
         return docComment ? (0, doc_comment_1.attachDocComment)(signature, docComment) : signature;
     }));
-    if (!type.comment) {
+    const commentSections = type.comment ? [type.comment] : [];
+    if (type.filename) {
+        commentSections.push(`Defined in:\n  {@link file://./${(0, path_1.relative)((0, path_1.dirname)(ctx.outputFilename), type.filename)}}`);
+    }
+    if (commentSections.length === 0) {
         return declaration;
     }
-    return (0, doc_comment_1.attachDocComment)(declaration, type.comment);
+    return (0, doc_comment_1.attachDocComment)(declaration, commentSections.join('\n\n'));
 };
 exports.createMessageDeclaration = createMessageDeclaration;
 const getFieldDocComment = (field) => {

package/dist/src/generator/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/generator/message.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;AAGF,+CAAiC;AAGjC,+CAAiD;AACjD,mCAAuC;AAEvC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;AAEd,MAAM,wBAAwB,GAAG,CAAC,IAAqB,EAAE,IAAsB,EAAE,EAAE;IACxF,MAAM,WAAW,GAAG,CAAC,CAAC,0BAA0B,CAC9C,SAAS,EACT,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAC5C,IAAI,CAAC,IAAI,EACT,SAAS,EACT,SAAS,EACT,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QAC3B,MAAM,SAAS,GAAG,CAAC,CAAC,uBAAuB,CACzC,SAAS,EACT,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EACzE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EACvE,IAAA,oBAAY,EAAC,KAAK,EAAE,IAAI,CAAC,CAC1B,CAAC;QAEF,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC7C,OAAO,UAAU,CAAC,CAAC,CAAC,IAAA,8BAAgB,EAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,CAAC,CAAC,CACH,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;QACjB,OAAO,WAAW,CAAC;KACpB;IAED,OAAO,IAAA,8BAAgB,EAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;AACrD,CAAC,CAAC;AAzBW,QAAA,wBAAwB,4BAyBnC;AAEF,MAAM,kBAAkB,GAAG,CAAC,KAAuB,EAAE,EAAE;IACrD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,KAAK,CAAC,OAAO,EAAE;QACjB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;KAC9B;IAED,IAAI,KAAK,CAAC,OAAO,EAAE;QACjB,QAAQ,CAAC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;KACvI;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;QACzB,OAAO,SAAS,CAAC;KAClB;SAAM;QACL,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;KAC9B;AACH,CAAC,CAAC"}
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/generator/message.ts"],"names":[],"mappings":"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"}

package/dist/src/generator/serializer-definition-generator.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import protobufjs from 'protobufjs';
 import * as ts from 'typescript';
 import { ModuleSpecifier } from '../module-specifier';

package/dist/src/generator/serializer-definition-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serializer-definition-generator.d.ts","sourceRoot":"","sources":["../../../src/generator/serializer-definition-generator.ts"],"names":[],"mappings":";AAIA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAgB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAKpE,eAAO,MAAM,0BAA0B,wBAAyB,eAAe,GAAG,SAAS,QAAQ,WAAW,IAAI,cAAc,MAAM,KAAG;IAAE,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC;IAAC,SAAS,GAAG,SAAS,EAAE,CAAA;CAmD1L,CAAC"}
+{"version":3,"file":"serializer-definition-generator.d.ts","sourceRoot":"","sources":["../../../src/generator/serializer-definition-generator.ts"],"names":[],"mappings":"AAIA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAgB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAKpE,eAAO,MAAM,0BAA0B,wBAAyB,eAAe,GAAG,SAAS,QAAQ,WAAW,IAAI,cAAc,MAAM,KAAG;IAAE,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC;IAAC,SAAS,GAAG,SAAS,EAAE,CAAA;CAmD1L,CAAC"}

package/dist/src/generator/service.d.ts

@@ -1,6 +1,6 @@
 import * as protobufjs from 'protobufjs';
 import * as ts from 'typescript';
-import { SubstitutionsMap } from '../parser';
-export declare const createServiceDeclaration: (type: protobufjs.Service, subs: SubstitutionsMap) => ts.InterfaceDeclaration;
+import { GeneratorContext } from './context';
+export declare const createServiceDeclaration: (type: protobufjs.Service, ctx: GeneratorContext) => ts.InterfaceDeclaration;
 export declare const createServicesDictionary: (root: protobufjs.NamespaceBase) => ts.InterfaceDeclaration;
 //# sourceMappingURL=service.d.ts.map

package/dist/src/generator/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/generator/service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAsC7C,eAAO,MAAM,wBAAwB,SAAU,WAAW,OAAO,QAAQ,gBAAgB,KAAG,GAAG,oBAsB9F,CAAC;AAaF,eAAO,MAAM,wBAAwB,SAAU,WAAW,aAAa,4BActE,CAAC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/generator/service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAIjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAsC7C,eAAO,MAAM,wBAAwB,SAAU,WAAW,OAAO,OAAO,gBAAgB,KAAG,GAAG,oBA+B7F,CAAC;AAaF,eAAO,MAAM,wBAAwB,SAAU,WAAW,aAAa,4BActE,CAAC"}

package/dist/src/generator/service.js

@@ -31,6 +31,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createServicesDictionary = exports.createServiceDeclaration = void 0;
 const node_assert_1 = __importDefault(require("node:assert"));
+const path_1 = require("path");
 const protobufjs = __importStar(require("protobufjs"));
 const ts = __importStar(require("typescript"));
 const namespaces_1 = require("../namespaces");
@@ -51,14 +52,21 @@ const createRpcMethodType = (method, service, subs) => {
     const outputTypeMonad = method.responseStream ? f.createIdentifier('Stream') : f.createIdentifier('Promise');
     return f.createFunctionTypeNode(undefined, [f.createParameterDeclaration(undefined, undefined, undefined, 'request', undefined, requestType)], f.createTypeReferenceNode(outputTypeMonad, [responseType]));
 };
-const createServiceDeclaration = (type, subs) => {
+const createServiceDeclaration = (type, ctx) => {
     const declaration = f.createInterfaceDeclaration(undefined, [f.createToken(ts.SyntaxKind.ExportKeyword)], type.name, undefined, undefined, type.methodsArray
         .filter(m => !m.requestStream)
         .map(method => {
-        const sig = f.createPropertySignature(undefined, mapRpcMethodName(method.name), undefined, createRpcMethodType(method, type, subs));
+        const sig = f.createPropertySignature(undefined, mapRpcMethodName(method.name), undefined, createRpcMethodType(method, type, ctx.subs));
         return method.comment ? (0, doc_comment_1.attachDocComment)(sig, method.comment) : sig;
     }));
-    return type.comment ? (0, doc_comment_1.attachDocComment)(declaration, type.comment) : declaration;
+    const commentSections = type.comment ? [type.comment] : [];
+    if (type.filename) {
+        commentSections.push(`Defined in:\n  {@link file://./${(0, path_1.relative)((0, path_1.dirname)(ctx.outputFilename), type.filename)}}`);
+    }
+    if (commentSections.length === 0) {
+        return declaration;
+    }
+    return (0, doc_comment_1.attachDocComment)(declaration, commentSections.join('\n\n'));
 };
 exports.createServiceDeclaration = createServiceDeclaration;
 function* getServices(root) {

package/dist/src/generator/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/generator/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/generator/service.ts"],"names":[],"mappings":"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"}

package/dist/test/proto/gen/dxos/test/another.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Defined in:
+ *   {@link file://./../../../another.proto}
+ */
 export interface AnotherMessage {
 }
 //# sourceMappingURL=another.d.ts.map

package/dist/test/proto/gen/dxos/test/another.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"another.d.ts","sourceRoot":"","sources":["../../../../../../test/proto/gen/dxos/test/another.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;CAC9B"}
+{"version":3,"file":"another.d.ts","sourceRoot":"","sources":["../../../../../../test/proto/gen/dxos/test/another.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,WAAW,cAAc;CAC9B"}

package/dist/test/proto/gen/dxos/test/any.d.ts

@@ -1,4 +1,8 @@
+/**
+ * Defined in:
+ *   {@link file://./../../../any.proto}
+ */
 export interface Any {
-    bar?: number;
+    bar: number;
 }
 //# sourceMappingURL=any.d.ts.map

package/dist/test/proto/gen/dxos/test/any.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"any.d.ts","sourceRoot":"","sources":["../../../../../../test/proto/gen/dxos/test/any.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,GAAG;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"any.d.ts","sourceRoot":"","sources":["../../../../../../test/proto/gen/dxos/test/any.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,WAAW,GAAG;IAChB,GAAG,EAAE,MAAM,CAAC;CACf"}

package/dist/test/proto/gen/dxos/test/extensions.d.ts

@@ -1,6 +1,14 @@
+/**
+ * Defined in:
+ *   {@link file://./../../../extensions.proto}
+ */
 export interface OptionsObject {
-    field?: number;
+    field: number;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../extensions.proto}
+ */
 export interface WithDefaultField {
     /**
      * Tag
@@ -9,8 +17,12 @@ export interface WithDefaultField {
      *   - (defaultValue) = "latest"
      *   - (optionsObj).field = 3
      */
-    tag?: string;
+    tag: string;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../extensions.proto}
+ */
 export interface ContainingMessageWithExtensions {
     str?: string;
     msg?: WithDefaultField;

package/dist/test/proto/gen/dxos/test/extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../../../../test/proto/gen/dxos/test/extensions.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,gBAAgB;IAC7B;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,+BAA+B;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,gBAAgB,CAAC;CAC1B"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../../../../test/proto/gen/dxos/test/extensions.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;CACjB;AACD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAC;CACf;AACD;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,gBAAgB,CAAC;CAC1B"}

package/dist/test/proto/gen/dxos/test/testfoo.d.ts

@@ -1,5 +1,9 @@
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../protobuf-test/src/foo.proto}
+ */
 export interface TestFoo {
-    fizz?: number;
-    bazz?: string;
+    fizz: number;
+    bazz: string;
 }
 //# sourceMappingURL=testfoo.d.ts.map

package/dist/test/proto/gen/dxos/test/testfoo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testfoo.d.ts","sourceRoot":"","sources":["../../../../../../test/proto/gen/dxos/test/testfoo.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,OAAO;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"testfoo.d.ts","sourceRoot":"","sources":["../../../../../../test/proto/gen/dxos/test/testfoo.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB"}

package/dist/test/proto/gen/dxos/test.d.ts

@@ -2,60 +2,104 @@ import type { Stream } from "@dxos/codec-protobuf";
 import substitutions from "../../substitutions";
 import * as dxos_test_any from "./test/any";
 import * as dxos_test_testfoo from "./test/testfoo";
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export interface Key {
     data: Uint8Array;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export interface Any {
-    foo?: string;
+    foo: string;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export interface Scalars {
-    doubleField?: number;
-    floatField?: number;
-    int32Field?: number;
-    int64Field?: string;
-    uint32Field?: number;
-    uint64Field?: string;
-    sint32Field?: number;
-    sint64Field?: string;
-    fixed32Field?: number;
-    fixed64Field?: string;
-    sfixed32Field?: number;
-    sfixed64Field?: string;
-    boolField?: boolean;
-    stringField?: string;
-    bytesField?: Uint8Array;
+    doubleField: number;
+    floatField: number;
+    int32Field: number;
+    int64Field: string;
+    uint32Field: number;
+    uint64Field: string;
+    sint32Field: number;
+    sint64Field: string;
+    fixed32Field: number;
+    fixed64Field: string;
+    sfixed32Field: number;
+    sfixed64Field: string;
+    boolField: boolean;
+    stringField: string;
+    bytesField: Uint8Array;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export interface ComplexFields {
     repeatedField?: ReturnType<(typeof substitutions)["dxos.test.Key"]["decode"]>[];
     requiredField: ReturnType<(typeof substitutions)["dxos.test.Key"]["decode"]>;
     mappedField?: Partial<Record<string, ReturnType<(typeof substitutions)["dxos.test.Key"]["decode"]>>>;
-    inner?: ComplexFields.Inner;
-    myAny?: Any;
-    googleAny?: ReturnType<(typeof substitutions)["google.protobuf.Any"]["decode"]>;
-    importedAny?: dxos_test_any.Any;
+    inner: ComplexFields.Inner;
+    myAny: Any;
+    googleAny: ReturnType<(typeof substitutions)["google.protobuf.Any"]["decode"]>;
+    importedAny: dxos_test_any.Any;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     fooTest?: dxos_test_testfoo.TestFoo;
 }
 export declare namespace ComplexFields {
+    /**
+     * Defined in:
+     *   {@link file://./../../schema.proto}
+     */
     interface Inner {
-        foo?: string;
-        bar?: ComplexFields.InnerEnum;
+        foo: string;
+        bar: ComplexFields.InnerEnum;
     }
+    /**
+     * Defined in:
+     *   {@link file://./../../schema.proto}
+     */
     enum InnerEnum {
         FOO = 1,
         BAR = 2
     }
 }
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export interface WithTimestamp {
-    timestamp?: ReturnType<(typeof substitutions)["google.protobuf.Timestamp"]["decode"]>;
+    timestamp: ReturnType<(typeof substitutions)["google.protobuf.Timestamp"]["decode"]>;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export interface Outer {
-    inner?: ComplexFields.Inner;
+    inner: ComplexFields.Inner;
 }
 export declare namespace Outer {
+    /**
+     * Defined in:
+     *   {@link file://./../../schema.proto}
+     */
     interface Inner {
-        inner?: ComplexFields.InnerEnum;
+        inner: ComplexFields.InnerEnum;
     }
 }
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export declare enum TaskType {
     IN_PROGRESS = 1,
     COMPLETED = 2
@@ -63,14 +107,20 @@ export declare enum TaskType {
 /**
  * Task.
  * Comments can be multiline.
+ *
+ * Defined in:
+ *   {@link file://./../../schema.proto}
  */
 export interface Task {
     /**
      * Task id
      */
-    id?: string;
+    id: string;
     /**
      * Task title
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     title?: string;
     /**
@@ -79,19 +129,38 @@ export interface Task {
      */
     key: ReturnType<(typeof substitutions)["dxos.test.Key"]["decode"]>;
     type: TaskType;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     googleAny?: ReturnType<(typeof substitutions)["google.protobuf.Any"]["decode"]>;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export interface TaskList {
     tasks?: Task[];
 }
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export interface SubstitutedByInterface {
-    foo?: string;
+    foo: string;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export interface TaskCount {
-    count?: number;
+    count: number;
 }
 /**
  * Test service definition.
+ *
+ * Defined in:
+ *   {@link file://./../../schema.proto}
  */
 export interface TestService {
     /**
@@ -103,9 +172,17 @@ export interface TestService {
      */
     subscribeTasks: (request: ReturnType<(typeof substitutions)["dxos.test.Key"]["decode"]>) => Stream<Task>;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export interface WithEmptyField {
-    emptyField?: void;
+    emptyField: void;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../schema.proto}
+ */
 export interface ServiceWithEmpty {
     emptyRpc: (request: void) => Promise<void>;
     emptyStreamRpc: (request: void) => Stream<void>;