typia 13.1.0 → 13.1.1

package/native/core/factories/internal/metadata/MetadataHelper.go

@@ -407,13 +407,86 @@ func metadata_js_doc_comment_text(list *nativeast.NodeList) string {
   }
   parts := []string{}
   for _, node := range list.Nodes {
-    if node != nil {
+    if node == nil {
+      continue
+    }
+    switch node.Kind {
+    case nativeast.KindJSDocText:
       parts = append(parts, node.Text())
+    case nativeast.KindJSDocLink,
+      nativeast.KindJSDocLinkCode,
+      nativeast.KindJSDocLinkPlain:
+      parts = append(parts, metadata_js_doc_link_text(node))
     }
   }
   return metadata_clean_js_doc_text(strings.Join(parts, ""))
 }
 
+func metadata_js_doc_link_text(node *nativeast.Node) string {
+  if node == nil {
+    return ""
+  }
+  name := node.Name()
+  text := strings.Trim(node.Text(), " ")
+  if name == nil {
+    return text
+  }
+  nameText := metadata_js_doc_entity_name_text(name)
+  if (nameText == "http" || nameText == "https") && strings.HasPrefix(text, "://") {
+    target := nameText + text
+    index := strings.IndexAny(target, " |")
+    if index == -1 {
+      return target
+    }
+    label := metadata_js_doc_link_label(target[index:])
+    if label != "" {
+      return label
+    }
+    return target[:index]
+  }
+
+  suffix := ""
+  if strings.HasPrefix(text, "()") {
+    suffix = "()"
+    text = text[2:]
+  }
+  if label := metadata_js_doc_link_label(text); label != "" {
+    return label
+  }
+  return nameText + suffix
+}
+
+func metadata_js_doc_link_label(text string) string {
+  text = strings.TrimLeft(text, " ")
+  text = strings.TrimPrefix(text, "|")
+  return strings.TrimSpace(text)
+}
+
+func metadata_js_doc_entity_name_text(node *nativeast.Node) string {
+  if node == nil {
+    return ""
+  }
+  switch node.Kind {
+  case nativeast.KindIdentifier:
+    return node.Text()
+  case nativeast.KindQualifiedName:
+    name := node.AsQualifiedName()
+    if name == nil {
+      return ""
+    }
+    return metadata_js_doc_entity_name_text(name.Left) + "." + metadata_js_doc_entity_name_text(name.Right)
+  case nativeast.KindPropertyAccessExpression:
+    return metadata_js_doc_entity_name_text(node.Expression()) + "." + metadata_js_doc_entity_name_text(node.Name())
+  case nativeast.KindParenthesizedExpression,
+    nativeast.KindExpressionWithTypeArguments:
+    return metadata_js_doc_entity_name_text(node.Expression())
+  case nativeast.KindJSDocNameReference:
+    return metadata_js_doc_entity_name_text(node.Name())
+  default:
+    return ""
+  }
+}
+
 func metadata_clean_js_doc_text(text string) string {
   text = strings.ReplaceAll(text, "\r\n", "\n")
   text = strings.ReplaceAll(text, "\r", "\n")

package/native/core/factories/internal/metadata/js_doc_link_text_test.go

@@ -0,0 +1,69 @@
+//go:build typia_native_internal
+// +build typia_native_internal
+
+package metadata
+
+import (
+  "path/filepath"
+  "testing"
+
+  nativeast "github.com/microsoft/typescript-go/shim/ast"
+  nativecore "github.com/microsoft/typescript-go/shim/core"
+  nativeparser "github.com/microsoft/typescript-go/shim/parser"
+)
+
+// TestJsDocLinkText verifies the metadata helper renders visible inline links.
+//
+// JSDoc link nodes split their entity target into Name() and their optional
+// display label into Text(). This test pins the shared renderer directly so all
+// metadata consumers keep qualified targets, normalized labels, call suffixes,
+// URLs, and tag comments without depending only on an application-programmer
+// integration.
+//
+// 1. Parse a property comment containing plain, qualified, labeled, URL, and
+// unresolved and malformed links, empty labels, call suffixes, plus a link
+// inside a JSDoc tag.
+// 2. Reflect the property's description and tags through the metadata helpers.
+// 3. Assert the visible text and punctuation are preserved deterministically.
+func TestJsDocLinkText(t *testing.T) {
+  file := nativeparser.ParseSourceFile(
+    nativeast.SourceFileParseOptions{FileName: filepath.ToSlash(filepath.Join(t.TempDir(), "links.ts"))},
+    `interface ITarget {
+  value: string;
+}
+interface IBox {
+  /**
+   * Plain; {@link ITarget}; {@link ITarget.value};
+   * {@link ITarget | label}; {@linkcode ITarget};
+   * {@linkplain ITarget.value}; {@link MissingTarget};
+   * {@link https://example.com/docs}; {@link https://example.com/docs | docs}.
+   * {@link ITarget | }; {@link makeTarget()}; {@link makeTarget() | maker}.
+   * {@link Missing.};
+   * @title {@link ITarget titled target}
+   */
+  field: string;
+}
+`,
+    nativecore.ScriptKindTS,
+  )
+  member := file.Statements.Nodes[1].AsInterfaceDeclaration().Members.Nodes[0]
+  symbol := &nativeast.Symbol{
+    Name:             "field",
+    ValueDeclaration: member,
+    Declarations:     []*nativeast.Node{member},
+  }
+  description := metadata_node_description(symbol)
+  if description == nil {
+    t.Fatal("description was not reflected")
+  }
+  if *description != "Plain; ITarget; ITarget.value;\nlabel; ITarget;\nITarget.value; MissingTarget;\nhttps://example.com/docs; docs.\nITarget; makeTarget(); maker.\nMissing.;" {
+    t.Fatalf("unexpected description: %q", *description)
+  }
+  tags := metadata_node_js_doc_tags(symbol)
+  if len(tags) != 1 || tags[0].Name != "title" || len(tags[0].Text) != 1 || tags[0].Text[0].Text != "titled target" {
+    t.Fatalf("unexpected tags: %#v", tags)
+  }
+  if metadata_js_doc_link_text(nil) != "" {
+    t.Fatal("nil JSDoc link should render empty text")
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typia",
-  "version": "13.1.0",
+  "version": "13.1.1",
   "description": "Superfast runtime validators with only one line",
   "main": "lib/index.js",
   "exports": {
@@ -50,8 +50,8 @@
     "inquirer": "^8.2.5",
     "randexp": "^0.5.3",
     "tinyglobby": "^0.2.12",
-    "@typia/interface": "^13.1.0",
-    "@typia/utils": "^13.1.0"
+    "@typia/interface": "^13.1.1",
+    "@typia/utils": "^13.1.1"
   },
   "devDependencies": {
     "@types/inquirer": "^8.2.5",