@openpkg-ts/sdk 0.49.0 → 0.50.1

package/dist/browser.d.ts

@@ -60,7 +60,7 @@ interface HTMLOptions {
 	/** Exports to render (multi-mode) - overridden by `export` if both provided */
 	exports?: string[];
 }
-import { SpecExportKind } from "@openpkg-ts/spec";
+import { SpecExportKind, SpecInlineTag } from "@openpkg-ts/spec";
 interface JSONOptions {
 	/** Include raw spec data alongside simplified data */
 	includeRaw?: boolean;
@@ -115,6 +115,7 @@ interface SimplifiedExport {
 	tags: Array<{
 		name: string;
 		text: string;
+		inlineTags?: SpecInlineTag[];
 	}>;
 	parameters?: SimplifiedParameter[];
 	returns?: SimplifiedReturn;

package/dist/index.d.ts

@@ -276,7 +276,7 @@ interface HTMLOptions {
 * ```
 */
 declare function toHTML2(spec: OpenPkg3, options?: HTMLOptions): string;
-import { OpenPkg as OpenPkg4, SpecExportKind } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg4, SpecExportKind, SpecInlineTag } from "@openpkg-ts/spec";
 interface JSONOptions {
 	/** Include raw spec data alongside simplified data */
 	includeRaw?: boolean;
@@ -331,6 +331,7 @@ interface SimplifiedExport {
 	tags: Array<{
 		name: string;
 		text: string;
+		inlineTags?: SpecInlineTag[];
 	}>;
 	parameters?: SimplifiedParameter[];
 	returns?: SimplifiedReturn;
@@ -1271,12 +1272,13 @@ declare function resolveExportTarget(symbol: ts3.Symbol, checker: ts3.TypeChecke
 	targetSymbol: ts3.Symbol;
 	isTypeOnly: boolean;
 };
-import { SpecExample, SpecExportKind as SpecExportKind8, SpecSource, SpecTag, SpecTypeParameter as SpecTypeParameter2 } from "@openpkg-ts/spec";
+import { SpecExample, SpecExportKind as SpecExportKind8, SpecInlineTag as SpecInlineTag2, SpecSource, SpecTag, SpecTypeParameter as SpecTypeParameter2 } from "@openpkg-ts/spec";
 import ts4 from "typescript";
 declare function getJSDocComment(node: ts4.Node, symbol?: ts4.Symbol, checker?: ts4.TypeChecker): {
 	description?: string;
 	tags: SpecTag[];
 	examples: SpecExample[];
+	inlineTags?: SpecInlineTag2[];
 };
 declare function getSourceLocation(node: ts4.Node, sourceFile: ts4.SourceFile): SpecSource;
 /**

package/dist/index.js

@@ -480,7 +480,11 @@ function simplifyExport(exp) {
     signature: buildSignatureString(exp),
     description: exp.description,
     deprecated: exp.deprecated === true,
-    tags: (exp.tags || []).map((t) => ({ name: t.name, text: t.text })),
+    tags: (exp.tags || []).map((t) => ({
+      name: t.name,
+      text: t.text,
+      ...t.inlineTags ? { inlineTags: t.inlineTags } : {}
+    })),
     extends: exp.extends,
     implements: exp.implements,
     sourceFile: exp.source?.file,
@@ -1305,6 +1309,39 @@ import ts12 from "typescript";
 // src/ast/utils.ts
 import * as path2 from "node:path";
 import ts from "typescript";
+var INLINE_TAG_RE = /(^|[^\\])\{@([a-zA-Z][a-zA-Z0-9]*)((?:[^}\\]|\\.)*)\}/g;
+function parseInlineTags(...texts) {
+  const inlineTags = [];
+  for (const text of texts) {
+    if (!text || !text.includes("{@"))
+      continue;
+    INLINE_TAG_RE.lastIndex = 0;
+    let match = INLINE_TAG_RE.exec(text);
+    while (match) {
+      inlineTags.push({ name: match[2], text: match[3].trim() });
+      INLINE_TAG_RE.lastIndex -= 1;
+      match = INLINE_TAG_RE.exec(text);
+    }
+  }
+  return inlineTags.length > 0 ? inlineTags : undefined;
+}
+function withInlineTags(node, ...texts) {
+  const inlineTags = parseInlineTags(...texts);
+  return inlineTags ? { ...node, inlineTags } : node;
+}
+var INLINE_TAGS_ONLY_RE = /^\s*(?:\{@[a-zA-Z][a-zA-Z0-9]*(?:[^}\\]|\\.)*\}\s*)+$/;
+function splitCommentLevelTags(text) {
+  if (!text.includes("{@"))
+    return { retained: text, hoisted: [] };
+  const paragraphs = text.split(/\n\s*\n/);
+  const hoisted = [];
+  while (paragraphs.length > 1 && INLINE_TAGS_ONLY_RE.test(paragraphs[paragraphs.length - 1])) {
+    hoisted.unshift(...parseInlineTags(paragraphs.pop()) ?? []);
+  }
+  return { retained: paragraphs.join(`
+
+`), hoisted };
+}
 function parseExamplesFromTags(tags) {
   const examples = [];
   for (const tag of tags) {
@@ -1319,9 +1356,9 @@ function parseExamplesFromTags(tags) {
       if (lang && ["ts", "js", "tsx", "jsx", "shell", "json"].includes(lang)) {
         example.language = lang;
       }
-      examples.push(example);
+      examples.push(withInlineTags(example, example.code));
     } else if (text) {
-      examples.push({ code: text });
+      examples.push(withInlineTags({ code: text }, text));
     }
   }
   return examples;
@@ -1392,8 +1429,11 @@ function extractSeeTagText(tag) {
 }
 function getJSDocComment(node, symbol, checker) {
   const jsDocTags = ts.getJSDocTags(node);
+  const commentLevelTags = [];
   const tags = jsDocTags.map((tag) => {
     const rawText = typeof tag.comment === "string" ? tag.comment : ts.getTextOfJSDocComment(tag.comment) ?? "";
+    const { retained, hoisted } = tag.tagName.text === "see" ? { retained: rawText, hoisted: [] } : splitCommentLevelTags(rawText);
+    commentLevelTags.push(...hoisted);
     if (tag.tagName.text === "param") {
       const paramTag = tag;
       let paramName = "";
@@ -1416,17 +1456,17 @@ function getJSDocComment(node, symbol, checker) {
         param.description = description2;
       if (paramTag.isBracketed)
         param.optional = true;
-      return { name: tag.tagName.text, text, param };
+      return withInlineTags({ name: tag.tagName.text, text, param }, text);
     }
     if (tag.tagName.text === "typeParam") {
       const text = stripTypeParamSeparator(rawText) ?? "";
-      return { name: tag.tagName.text, text };
+      return withInlineTags({ name: tag.tagName.text, text }, text);
     }
     if (tag.tagName.text === "see") {
       const text = extractSeeTagText(tag);
-      return { name: tag.tagName.text, text };
+      return withInlineTags({ name: tag.tagName.text, text }, text);
     }
-    return { name: tag.tagName.text, text: rawText };
+    return withInlineTags({ name: tag.tagName.text, text: rawText }, retained);
   });
   const jsDocComments = ts.getJSDocCommentsAndTags(node).filter(ts.isJSDoc);
   let description;
@@ -1444,7 +1484,13 @@ function getJSDocComment(node, symbol, checker) {
     }
   }
   const examples = parseExamplesFromTags(tags);
-  return { description, tags, examples };
+  const inlineTags = [...parseInlineTags(description) ?? [], ...commentLevelTags];
+  return {
+    description,
+    tags,
+    examples,
+    inlineTags: inlineTags.length > 0 ? inlineTags : undefined
+  };
 }
 function getSourceLocation(node, sourceFile) {
   const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
@@ -2914,6 +2960,9 @@ function extractParameters(signature, ctx) {
       };
       if (description) {
         paramResult.description = description;
+        const inlineTags = parseInlineTags(description);
+        if (inlineTags)
+          paramResult.inlineTags = inlineTags;
       }
       if (decl.initializer) {
         applyDefault(paramResult, decl.initializer);
@@ -2948,6 +2997,9 @@ function expandBindingPattern(paramDecl, paramType, jsdocTags, ctx) {
     };
     if (description) {
       param.description = description;
+      const inlineTags = parseInlineTags(description);
+      if (inlineTags)
+        param.inlineTags = inlineTags;
     }
     if (element.initializer) {
       applyDefault(param, element.initializer);
@@ -3534,7 +3586,7 @@ function serializeInheritedMember(symbol, inheritedFrom, ctx, isStatic) {
   }
   if (visibility === "private")
     return null;
-  const { description, tags } = getJSDocComment(decl);
+  const { description, tags, inlineTags } = getJSDocComment(decl);
   let kind = "property";
   const callSigs = type.getCallSignatures();
   if (callSigs.length > 0) {
@@ -3567,6 +3619,7 @@ function serializeInheritedMember(symbol, inheritedFrom, ctx, isStatic) {
         },
         ...sigDoc.description ? { description: sigDoc.description } : {},
         ...sigDoc.tags.length > 0 ? { tags: sigDoc.tags } : {},
+        ...sigDoc.inlineTags ? { inlineTags: sigDoc.inlineTags } : {},
         ...callSigs.length > 1 ? { overloadIndex: index } : {}
       };
     });
@@ -3580,16 +3633,17 @@ function serializeInheritedMember(symbol, inheritedFrom, ctx, isStatic) {
     visibility,
     schema: kind !== "method" ? buildSchema(type, checker, ctx) : decoratePropertySchema({ "x-ts-function": true }, symbol, type, checker),
     signatures,
-    flags: Object.keys(flags).length > 0 ? flags : undefined
+    flags: Object.keys(flags).length > 0 ? flags : undefined,
+    ...inlineTags ? { inlineTags } : {}
   };
 }
 
 // src/serializers/shared.ts
 function extractExportMetadata(node, symbol, checker, jsdocNode) {
   const { deprecated, reason: deprecationReason } = isSymbolDeprecated(symbol);
-  const { description, tags, examples } = getJSDocComment(jsdocNode ?? node, symbol, checker);
+  const { description, tags, examples, inlineTags } = getJSDocComment(jsdocNode ?? node, symbol, checker);
   const source = getSourceLocation(node, node.getSourceFile());
-  return { description, tags, examples, source, deprecated, deprecationReason };
+  return { description, tags, examples, source, deprecated, deprecationReason, inlineTags };
 }
 function buildSignatures(callSignatures, checker, ctx) {
   return callSignatures.map((sig, index) => {
@@ -3604,6 +3658,7 @@ function buildSignatures(callSignatures, checker, ctx) {
       ...sigDoc.description ? { description: sigDoc.description } : {},
       ...sigDoc.tags.length > 0 ? { tags: sigDoc.tags } : {},
       ...sigDoc.examples.length > 0 ? { examples: sigDoc.examples } : {},
+      ...sigDoc.inlineTags ? { inlineTags: sigDoc.inlineTags } : {},
       ...sigTypeParams ? { typeParameters: sigTypeParams } : {},
       ...callSignatures.length > 1 ? { overloadIndex: index } : {}
     };
@@ -3617,7 +3672,7 @@ function serializeClass(node, ctx) {
   const name = symbol?.getName() ?? node.name?.getText();
   if (!name)
     return null;
-  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, checker);
+  const { description, tags, examples, source, deprecated, deprecationReason, inlineTags } = extractExportMetadata(node, symbol, checker);
   const typeParameters = extractTypeParameters(node, checker);
   const members = [];
   const signatures = [];
@@ -3693,6 +3748,7 @@ function serializeClass(node, ctx) {
     implements: implementsClause?.length ? implementsClause : undefined,
     ...deprecated ? { deprecated: true, deprecationReason } : {},
     ...examples.length > 0 ? { examples } : {},
+    ...inlineTags ? { inlineTags } : {},
     ...Object.keys(classFlags).length > 0 ? { flags: classFlags } : {}
   };
 }
@@ -3734,7 +3790,7 @@ function serializeProperty(node, ctx) {
   const name = getMemberName(node);
   if (!name)
     return null;
-  const { description, tags } = getJSDocComment(node);
+  const { description, tags, inlineTags } = getJSDocComment(node);
   const visibility = getVisibility(node);
   if (!ctx.includePrivate && (visibility === "private" || visibility === "protected")) {
     return null;
@@ -3763,6 +3819,7 @@ function serializeProperty(node, ctx) {
     visibility,
     schema,
     flags: Object.keys(flags).length > 0 ? flags : undefined,
+    ...inlineTags ? { inlineTags } : {},
     ...deprecated ? { deprecated: true, deprecationReason } : {}
   };
 }
@@ -3771,7 +3828,7 @@ function serializeMethod(node, ctx) {
   const name = getMemberName(node);
   if (!name)
     return null;
-  const { description, tags } = getJSDocComment(node);
+  const { description, tags, inlineTags } = getJSDocComment(node);
   const visibility = getVisibility(node);
   if (!ctx.includePrivate && (visibility === "private" || visibility === "protected")) {
     return null;
@@ -3804,6 +3861,7 @@ function serializeMethod(node, ctx) {
     schema,
     signatures: signatures.length > 0 ? signatures : undefined,
     flags: Object.keys(flags).length > 0 ? flags : undefined,
+    ...inlineTags ? { inlineTags } : {},
     ...deprecated ? { deprecated: true, deprecationReason } : {}
   };
 }
@@ -3815,13 +3873,14 @@ function serializeConstructor(node, ctx) {
   return serializeConstructorSignature(node, sig, ctx);
 }
 function serializeConstructorSignature(node, sig, ctx) {
-  const { description, tags, examples } = getJSDocComment(node);
+  const { description, tags, examples, inlineTags } = getJSDocComment(node);
   const params = extractParameters(sig, ctx);
   return {
     description,
     parameters: params.length > 0 ? params : undefined,
     ...tags.length > 0 ? { tags } : {},
-    ...examples.length > 0 ? { examples } : {}
+    ...examples.length > 0 ? { examples } : {},
+    ...inlineTags ? { inlineTags } : {}
   };
 }
 function serializeInheritedConstructors(node, ctx) {
@@ -3852,7 +3911,7 @@ function serializeAccessor(node, ctx) {
   const name = getMemberName(node);
   if (!name)
     return null;
-  const { description, tags } = getJSDocComment(node);
+  const { description, tags, inlineTags } = getJSDocComment(node);
   const visibility = getVisibility(node);
   if (!ctx.includePrivate && (visibility === "private" || visibility === "protected")) {
     return null;
@@ -3890,7 +3949,8 @@ function serializeAccessor(node, ctx) {
     visibility,
     schema,
     signatures,
-    flags: Object.keys(flags).length > 0 ? flags : undefined
+    flags: Object.keys(flags).length > 0 ? flags : undefined,
+    ...inlineTags ? { inlineTags } : {}
   };
 }
 function getExtendsClause(node, checker) {
@@ -3930,7 +3990,7 @@ function serializeEnum(node, ctx) {
   const name = symbol?.getName() ?? node.name?.getText();
   if (!name)
     return null;
-  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, checker);
+  const { description, tags, examples, source, deprecated, deprecationReason, inlineTags } = extractExportMetadata(node, symbol, checker);
   const members = node.members.map((member) => {
     const memberSymbol = checker.getSymbolAtLocation(member.name);
     const memberName = memberSymbol?.getName() ?? member.name.getText();
@@ -3943,7 +4003,11 @@ function serializeEnum(node, ctx) {
     } else if (member.initializer) {
       schema = { type: member.initializer.getText() };
     }
-    const { description: memberDesc, tags: memberTags } = getJSDocComment(member);
+    const {
+      description: memberDesc,
+      tags: memberTags,
+      inlineTags: memberInlineTags
+    } = getJSDocComment(member);
     const { deprecated: deprecated2, reason: deprecationReason2 } = isSymbolDeprecated(memberSymbol);
     return {
       id: memberName,
@@ -3952,6 +4016,7 @@ function serializeEnum(node, ctx) {
       ...schema ? { schema } : {},
       ...memberDesc ? { description: memberDesc } : {},
       ...memberTags.length > 0 ? { tags: memberTags } : {},
+      ...memberInlineTags ? { inlineTags: memberInlineTags } : {},
       ...deprecated2 ? { deprecated: true, deprecationReason: deprecationReason2 } : {}
     };
   });
@@ -3964,7 +4029,8 @@ function serializeEnum(node, ctx) {
     source,
     members,
     ...deprecated ? { deprecated: true, deprecationReason } : {},
-    ...examples.length > 0 ? { examples } : {}
+    ...examples.length > 0 ? { examples } : {},
+    ...inlineTags ? { inlineTags } : {}
   };
 }
 
@@ -4003,7 +4069,7 @@ function serializeFunctionExport(node, ctx, nameOverride) {
   const name = nameOverride ?? symbol?.getName() ?? node.name?.getText();
   if (!name)
     return null;
-  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, ctx.typeChecker);
+  const { description, tags, examples, source, deprecated, deprecationReason, inlineTags } = extractExportMetadata(node, symbol, ctx.typeChecker);
   const typeParameters = extractTypeParameters(node, ctx.typeChecker);
   const type = ctx.typeChecker.getTypeAtLocation(node);
   const callSignatures = type.getCallSignatures();
@@ -4040,7 +4106,8 @@ function serializeFunctionExport(node, ctx, nameOverride) {
     signatures,
     ...Object.keys(flags).length > 0 ? { flags } : {},
     ...deprecated ? { deprecated: true, deprecationReason } : {},
-    ...examples.length > 0 ? { examples } : {}
+    ...examples.length > 0 ? { examples } : {},
+    ...inlineTags ? { inlineTags } : {}
   };
 }
 
@@ -4052,7 +4119,7 @@ function serializeInterface(node, ctx) {
   const name = symbol?.getName() ?? node.name?.getText();
   if (!name)
     return null;
-  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, checker);
+  const { description, tags, examples, source, deprecated, deprecationReason, inlineTags } = extractExportMetadata(node, symbol, checker);
   const typeParameters = extractTypeParameters(node, checker);
   const members = [];
   const methodsByName = new Map;
@@ -4130,13 +4197,14 @@ function serializeInterface(node, ctx) {
     signatures: exportSignatures,
     extends: extendsClause,
     ...deprecated ? { deprecated: true, deprecationReason } : {},
-    ...examples.length > 0 ? { examples } : {}
+    ...examples.length > 0 ? { examples } : {},
+    ...inlineTags ? { inlineTags } : {}
   };
 }
 function serializePropertySignature(node, ctx) {
   const { typeChecker: checker } = ctx;
   const name = node.name.getText();
-  const { description, tags } = getJSDocComment(node);
+  const { description, tags, inlineTags } = getJSDocComment(node);
   const rawType = checker.getTypeAtLocation(node);
   const type = node.questionToken ? stripUndefinedFromType(rawType, checker) : rawType;
   let schema = buildSchema(type, checker, ctx);
@@ -4159,13 +4227,14 @@ function serializePropertySignature(node, ctx) {
     tags: tags.length > 0 ? tags : undefined,
     schema,
     flags: Object.keys(flags).length > 0 ? flags : undefined,
+    ...inlineTags ? { inlineTags } : {},
     ...deprecated ? { deprecated: true, deprecationReason } : {}
   };
 }
 function serializeMethodSignature(node, ctx) {
   const { typeChecker: checker } = ctx;
   const name = node.name.getText();
-  const { description, tags } = getJSDocComment(node);
+  const { description, tags, inlineTags } = getJSDocComment(node);
   const type = checker.getTypeAtLocation(node);
   const callSignatures = type.getCallSignatures();
   const signatures = buildSignatures(callSignatures, checker, ctx);
@@ -4184,12 +4253,13 @@ function serializeMethodSignature(node, ctx) {
     schema,
     signatures: signatures.length > 0 ? signatures : undefined,
     flags: Object.keys(flags).length > 0 ? flags : undefined,
+    ...inlineTags ? { inlineTags } : {},
     ...deprecated ? { deprecated: true, deprecationReason } : {}
   };
 }
 function serializeCallSignature(node, ctx) {
   const { typeChecker: checker } = ctx;
-  const { description, tags } = getJSDocComment(node);
+  const { description, tags, inlineTags } = getJSDocComment(node);
   const sig = checker.getSignatureFromDeclaration(node);
   if (!sig)
     return null;
@@ -4201,6 +4271,7 @@ function serializeCallSignature(node, ctx) {
     kind: "call-signature",
     description,
     tags: tags.length > 0 ? tags : undefined,
+    ...inlineTags ? { inlineTags } : {},
     signatures: [
       {
         parameters: params.length > 0 ? params : undefined,
@@ -4213,7 +4284,7 @@ function serializeCallSignature(node, ctx) {
 }
 function serializeIndexSignature(node, ctx) {
   const { typeChecker: checker } = ctx;
-  const { description, tags } = getJSDocComment(node);
+  const { description, tags, inlineTags } = getJSDocComment(node);
   const valueType = node.type ? checker.getTypeAtLocation(node.type) : checker.getAnyType();
   const valueSchema = buildSchema(valueType, checker, ctx);
   registerReferencedTypes(valueType, ctx);
@@ -4225,7 +4296,8 @@ function serializeIndexSignature(node, ctx) {
     kind: "index-signature",
     description,
     tags: tags.length > 0 ? tags : undefined,
-    schema: valueSchema
+    schema: valueSchema,
+    ...inlineTags ? { inlineTags } : {}
   };
 }
 function getInterfaceExtends(node, checker) {
@@ -4266,7 +4338,7 @@ function serializeTypeAlias(node, ctx) {
   const name = symbol?.getName() ?? node.name?.getText();
   if (!name)
     return null;
-  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, ctx.typeChecker);
+  const { description, tags, examples, source, deprecated, deprecationReason, inlineTags } = extractExportMetadata(node, symbol, ctx.typeChecker);
   const typeParameters = extractTypeParameters(node, ctx.typeChecker);
   const type = ctx.typeChecker.getTypeAtLocation(node);
   registerReferencedTypes(type, ctx);
@@ -4312,7 +4384,8 @@ function serializeTypeAlias(node, ctx) {
     schema,
     ...members && members.length > 0 ? { members } : {},
     ...deprecated ? { deprecated: true, deprecationReason } : {},
-    ...examples.length > 0 ? { examples } : {}
+    ...examples.length > 0 ? { examples } : {},
+    ...inlineTags ? { inlineTags } : {}
   };
 }
 function isObjectShapedAlias(type, ctx) {
@@ -4411,6 +4484,7 @@ function serializeResolvedMembers(type, node, ctx) {
     if (prop.flags & ts11.SymbolFlags.Method)
       flags.methodSyntax = true;
     const schema = kind === "property" ? decoratePropertySchema(buildSchema(propType, checker, ctx), prop, propType, checker) : decoratePropertySchema({ "x-ts-function": true }, prop, propType, checker);
+    const inlineTags = parseInlineTags(description);
     members.push({
       name: prop.getName(),
       kind,
@@ -4419,6 +4493,7 @@ function serializeResolvedMembers(type, node, ctx) {
       schema,
       signatures: kind === "method" ? buildSignatures(callSigs, checker, ctx) : undefined,
       flags: Object.keys(flags).length > 0 ? flags : undefined,
+      ...inlineTags ? { inlineTags } : {},
       ...deprecated ? { deprecated: true, deprecationReason } : {}
     });
   }
@@ -4594,7 +4669,7 @@ function serializeVariable(node, statement, ctx) {
   const name = symbol?.getName() ?? node.name.getText();
   if (!name)
     return null;
-  const { description, tags, examples, source, deprecated, deprecationReason } = extractExportMetadata(node, symbol, ctx.typeChecker, statement);
+  const { description, tags, examples, source, deprecated, deprecationReason, inlineTags } = extractExportMetadata(node, symbol, ctx.typeChecker, statement);
   const type = ctx.typeChecker.getTypeAtLocation(node);
   const schemaExtraction = extractSchemaType(type, ctx.typeChecker);
   const typeToSerialize = schemaExtraction?.outputType ?? type;
@@ -4614,7 +4689,8 @@ function serializeVariable(node, statement, ctx) {
     schema,
     ...flags ? { flags } : {},
     ...deprecated ? { deprecated: true, deprecationReason } : {},
-    ...examples.length > 0 ? { examples } : {}
+    ...examples.length > 0 ? { examples } : {},
+    ...inlineTags ? { inlineTags } : {}
   };
 }
 
@@ -7177,6 +7253,7 @@ function serializeDeclaration2(declaration, exportSymbol, exportName, ctx, isTyp
 }
 function serializeNamespaceExport(symbol, exportName, ctx) {
   const { description, tags, examples } = getJSDocFromExportSymbol(symbol);
+  const inlineTags = parseInlineTags(description);
   const members = [];
   const checker = ctx.program.getTypeChecker();
   let targetSymbol = symbol;
@@ -7201,7 +7278,8 @@ function serializeNamespaceExport(symbol, exportName, ctx) {
     description,
     tags,
     ...examples.length > 0 ? { examples } : {},
-    ...members.length > 0 ? { members } : {}
+    ...members.length > 0 ? { members } : {},
+    ...inlineTags ? { inlineTags } : {}
   };
 }
 function serializeNamespaceMember(symbol, memberName, ctx) {
@@ -7248,15 +7326,22 @@ function serializeNamespaceMember(symbol, memberName, ctx) {
     registerReferencedTypes(type, ctx);
     schema = buildSchema(type, ctx.typeChecker, ctx);
   }
+  const inlineTags = parseInlineTags(description);
   return {
     name: memberName,
     kind,
     ...description ? { description } : {},
     ...signatures ? { signatures } : {},
     ...schema ? { schema } : {},
+    ...inlineTags ? { inlineTags } : {},
     ...deprecated ? { flags: { deprecated: true } } : {}
   };
 }
+function flattenJSDocComment(comment) {
+  if (comment === undefined)
+    return "";
+  return typeof comment === "string" ? comment : ts18.getTextOfJSDocComment(comment) ?? "";
+}
 function getJSDocFromExportSymbol(symbol) {
   const tags = [];
   const examples = [];
@@ -7267,7 +7352,7 @@ function getJSDocFromExportSymbol(symbol) {
       const jsDocs = ts18.getJSDocCommentsAndTags(exportDecl);
       for (const doc of jsDocs) {
         if (ts18.isJSDoc(doc) && doc.comment) {
-          const commentText = typeof doc.comment === "string" ? doc.comment : doc.comment.map((c) => ("text" in c) ? c.text : "").join("");
+          const commentText = flattenJSDocComment(doc.comment);
           if (commentText) {
             return {
               description: commentText,
@@ -7297,8 +7382,9 @@ function extractJSDocTags(doc) {
   const tags = [];
   for (const tag of doc.tags ?? []) {
     if (tag.tagName.text !== "example") {
-      const text = typeof tag.comment === "string" ? tag.comment : tag.comment?.map((c) => ("text" in c) ? c.text : "").join("") ?? "";
-      tags.push({ name: tag.tagName.text, text });
+      const text = flattenJSDocComment(tag.comment);
+      const inlineTags = parseInlineTags(text);
+      tags.push({ name: tag.tagName.text, text, ...inlineTags ? { inlineTags } : {} });
     }
   }
   return tags;
@@ -7307,7 +7393,7 @@ function extractExamples(doc) {
   const examples = [];
   for (const tag of doc.tags ?? []) {
     if (tag.tagName.text === "example") {
-      const text = typeof tag.comment === "string" ? tag.comment : tag.comment?.map((c) => ("text" in c) ? c.text : "").join("") ?? "";
+      const text = flattenJSDocComment(tag.comment);
       if (text)
         examples.push(text);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/sdk",
-  "version": "0.49.0",
+  "version": "0.50.1",
   "description": "TypeScript API extraction SDK - programmatic primitives for OpenPkg specs",
   "keywords": [
     "openpkg",
@@ -43,7 +43,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@openpkg-ts/spec": "^0.49.0",
+    "@openpkg-ts/spec": "^0.50.0",
     "picomatch": "4.0.3",
     "typescript": "^5.0.0"
   },