@alloy-js/csharp 0.18.0-dev.8 → 0.18.0-dev.9

package/dist/src/components/doc/comment.d.ts

@@ -15,7 +15,7 @@ export declare function makeDocCommentTag(name: string): (props: DocCommentProps
 export declare function makeInlineDocCommentTag(name: string): (props: DocCommentProps) => string;
 export declare const DocSummary: (props: DocCommentProps) => Children;
 export declare const DocCode: (props: DocCommentProps) => Children;
-export declare const DocC: (props: DocCommentProps) => Children;
+export declare const DocC: (props: DocCommentProps) => string;
 export declare const DocExample: (props: DocCommentProps) => Children;
 export declare const DocException: (props: DocCommentProps) => Children;
 export interface DocIncludeProps {
@@ -39,25 +39,21 @@ export declare const DocReturns: (props: DocCommentProps) => Children;
 export declare const DocRemarks: (props: DocCommentProps) => Children;
 export declare const DocValue: (props: DocCommentProps) => Children;
 export declare const DocPermission: (props: DocCommentProps) => Children;
-export declare const DocResponse: (props: DocCommentProps) => Children;
-export declare const DocCompletionList: (props: DocCommentProps) => Children;
-export declare const DocList: (props: DocCommentProps) => Children;
-export declare const DocItem: (props: DocCommentProps) => Children;
-export declare const DocTerm: (props: DocCommentProps) => Children;
 export declare const DocDescription: (props: DocCommentProps) => Children;
 export declare const DocPara: (props: DocCommentProps) => Children;
 export interface DocSeeProps {
-    cref: string;
+    cref?: string;
+    href?: string;
     langword?: string;
     children?: Children;
 }
-export declare const DocSee: (props: DocSeeProps) => string;
+export declare const DocSee: (props: DocSeeProps) => Children;
 export interface DocSeeAlsoProps {
-    cref: string;
-    langword?: string;
+    cref?: string;
+    href?: string;
     children?: Children;
 }
-export declare const DocSeeAlso: (props: DocSeeAlsoProps) => string;
+export declare const DocSeeAlso: (props: DocSeeAlsoProps) => Children;
 export interface DocParamRefProps {
     name: string;
 }
@@ -66,4 +62,9 @@ export interface DocTypeParamRefProps {
     name: string;
 }
 export declare const DocTypeParamRef: (props: DocTypeParamRefProps) => string;
+export interface DocListProps {
+    type?: "bullet" | "number";
+    items: Children[];
+}
+export declare function DocList(props: DocListProps): Children;
 //# sourceMappingURL=comment.d.ts.map

package/dist/src/components/doc/comment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../../../src/components/doc/comment.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../../../src/components/doc/comment.tsx"],"names":[],"mappings":"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"}

package/dist/src/components/doc/comment.js

@@ -1,5 +1,5 @@
 import { createComponent as _$createComponent, createIntrinsic as _$createIntrinsic, memo as _$memo } from "@alloy-js/core/jsx-runtime";
-import { code, List, Prose, Show } from "@alloy-js/core";
+import { code, For, Indent, List, Prose, Show } from "@alloy-js/core";
 export function DocComment(props) {
   return ["/// ", _$createIntrinsic("align", {
     string: "/// ",
@@ -46,7 +46,7 @@ export function makeInlineDocCommentTag(name) {
 }
 export const DocSummary = makeDocCommentTag("summary");
 export const DocCode = makeDocCommentTag("code");
-export const DocC = makeDocCommentTag("c");
+export const DocC = makeInlineDocCommentTag("c");
 export const DocExample = makeDocCommentTag("example");
 export const DocException = makeDocCommentTag("exception");
 export const DocInclude = props => {
@@ -58,14 +58,31 @@ export const DocReturns = makeDocCommentTag("returns");
 export const DocRemarks = makeDocCommentTag("remarks");
 export const DocValue = makeDocCommentTag("value");
 export const DocPermission = makeDocCommentTag("permission");
-export const DocResponse = makeDocCommentTag("response");
-export const DocCompletionList = makeDocCommentTag("completionlist");
-export const DocList = makeDocCommentTag("list");
-export const DocItem = makeDocCommentTag("item");
-export const DocTerm = makeDocCommentTag("term");
 export const DocDescription = makeDocCommentTag("description");
 export const DocPara = makeDocCommentTag("para");
-export const DocSee = props => `<see cref="${props.cref}"${props.langword ? ` langword="${props.langword}"` : ""}${props.children ? `>${props.children}</see>` : " />"}`;
-export const DocSeeAlso = props => `<seealso cref="${props.cref}"${props.langword ? ` langword="${props.langword}"` : ""}${props.children ? `>${props.children}</seealso>` : " />"}`;
+export const DocSee = props => {
+  const attributes = [props.cref ? `cref="${props.cref}"` : undefined, props.href ? `href="${props.href}"` : undefined, props.langword ? `langword="${props.langword}"` : undefined].filter(Boolean).join(" ");
+  return code`<see ${attributes}${props.children ? code`>${props.children}</see>` : " />"}`;
+};
+export const DocSeeAlso = props => {
+  const attributes = [props.cref ? `cref="${props.cref}"` : undefined, props.href ? `href="${props.href}"` : undefined].filter(Boolean).join(" ");
+  return code`<seealso ${attributes}${props.children ? code`>${props.children}</seealso>` : " />"}`;
+};
 export const DocParamRef = props => `<paramref name="${props.name}" />`;
-export const DocTypeParamRef = props => `<typeparamref name="${props.name}" />`;
+export const DocTypeParamRef = props => `<typeparamref name="${props.name}" />`;
+export function DocList(props) {
+  return _$createComponent(Prose, {
+    get children() {
+      return [_$memo(() => `<list type="${props.type ?? "bullet"}">`), _$createComponent(Indent, {
+        get children() {
+          return _$createComponent(For, {
+            get each() {
+              return props.items;
+            },
+            children: item => code`<item><description>${item}</description></item>`
+          });
+        }
+      }), _$createIntrinsic("hbr", {}), `</list>`];
+    }
+  });
+}

package/dist/src/components/doc/comment.test.js

@@ -1,6 +1,6 @@
-import { createComponent as _$createComponent, memo as _$memo } from "@alloy-js/core/jsx-runtime";
-import { expect, it } from "vitest";
-import { DocC, DocCode, DocComment, DocCompletionList, DocDescription, DocExample, DocException, DocInclude, DocItem, DocList, DocPara, DocParam, DocParamRef, DocPermission, DocRemarks, DocResponse, DocReturns, DocSee, DocSeeAlso, DocSummary, DocTerm, DocTypeParam, DocTypeParamRef, DocValue } from "./comment.js";
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { describe, expect, it } from "vitest";
+import { DocC, DocCode, DocComment, DocDescription, DocExample, DocException, DocInclude, DocList, DocPara, DocParam, DocParamRef, DocPermission, DocRemarks, DocReturns, DocSee, DocSeeAlso, DocSummary, DocTypeParam, DocTypeParamRef, DocValue } from "./comment.js";
 it("define summary", () => {
   expect(_$createComponent(DocComment, {
     get children() {
@@ -35,9 +35,7 @@ it("define c", () => {
       });
     }
   })).toRenderTo(`
-    /// <c>
-    /// inline code
-    /// </c>
+    /// <c>inline code</c>
   `);
 });
 it("define example", () => {
@@ -69,10 +67,10 @@ it("define exception", () => {
 it("define include", () => {
   expect(_$createComponent(DocComment, {
     get children() {
-      return [_$memo(() => DocInclude({
+      return _$createComponent(DocInclude, {
         file: "external.xml",
         path: "/doc/summary"
-      }))];
+      });
     }
   })).toRenderTo(`
     /// <include file="external.xml" path="/doc/summary" />
@@ -154,71 +152,22 @@ it("define permission", () => {
     /// </permission>
   `);
 });
-it("define response", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocResponse, {
-        children: "response info"
-      });
-    }
-  })).toRenderTo(`
-    /// <response>
-    /// response info
-    /// </response>
-  `);
-});
-it("define completionlist", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocCompletionList, {
-        children: "completion list"
-      });
-    }
-  })).toRenderTo(`
-    /// <completionlist>
-    /// completion list
-    /// </completionlist>
-  `);
-});
 it("define list", () => {
   expect(_$createComponent(DocComment, {
     get children() {
       return _$createComponent(DocList, {
-        children: "list content"
+        type: "bullet",
+        items: ["item 1", "item 2", "item 3"]
       });
     }
   })).toRenderTo(`
-    /// <list>
-    /// list content
+    /// <list type="bullet">
+    ///   <item><description>item 1</description></item>
+    ///   <item><description>item 2</description></item>
+    ///   <item><description>item 3</description></item>
     /// </list>
   `);
 });
-it("define item", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocItem, {
-        children: "item content"
-      });
-    }
-  })).toRenderTo(`
-    /// <item>
-    /// item content
-    /// </item>
-  `);
-});
-it("define term", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocTerm, {
-        children: "term content"
-      });
-    }
-  })).toRenderTo(`
-    /// <term>
-    /// term content
-    /// </term>
-  `);
-});
 it("define description", () => {
   expect(_$createComponent(DocComment, {
     get children() {
@@ -245,45 +194,106 @@ it("define para", () => {
     /// </para>
   `);
 });
-it("define see", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return [_$memo(() => DocSee({
-        cref: "T:MyType"
-      }))];
-    }
-  })).toRenderTo(`
-    /// <see cref="T:MyType" />
-  `);
+describe("define see", () => {
+  it("with cref", () => {
+    expect(_$createComponent(DocComment, {
+      get children() {
+        return _$createComponent(DocSee, {
+          cref: "T:MyType"
+        });
+      }
+    })).toRenderTo(`
+      /// <see cref="T:MyType" />
+    `);
+  });
+  it("with href", () => {
+    expect(_$createComponent(DocComment, {
+      get children() {
+        return _$createComponent(DocSee, {
+          href: "https://github.com"
+        });
+      }
+    })).toRenderTo(`
+      /// <see href="https://github.com" />
+    `);
+  });
+  it("with href and children", () => {
+    expect(_$createComponent(DocComment, {
+      get children() {
+        return _$createComponent(DocSee, {
+          href: "https://github.com",
+          children: "GitHub"
+        });
+      }
+    })).toRenderTo(`
+      /// <see href="https://github.com">GitHub</see>
+    `);
+  });
+  it("with langword", () => {
+    expect(_$createComponent(DocComment, {
+      get children() {
+        return _$createComponent(DocSee, {
+          langword: "keyword"
+        });
+      }
+    })).toRenderTo(`
+      /// <see langword="keyword" />
+    `);
+  });
 });
-it("define seealso", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return [_$memo(() => DocSeeAlso({
-        cref: "T:OtherType"
-      }))];
-    }
-  })).toRenderTo(`
-    /// <seealso cref="T:OtherType" />
-  `);
+describe("define seealso", () => {
+  it("with cref", () => {
+    expect(_$createComponent(DocComment, {
+      get children() {
+        return _$createComponent(DocSeeAlso, {
+          cref: "T:OtherType"
+        });
+      }
+    })).toRenderTo(`
+      /// <seealso cref="T:OtherType" />
+    `);
+  });
+  it("with href", () => {
+    expect(_$createComponent(DocComment, {
+      get children() {
+        return _$createComponent(DocSeeAlso, {
+          href: "https://github.com"
+        });
+      }
+    })).toRenderTo(`
+      /// <seealso href="https://github.com" />
+    `);
+  });
+  it("with children", () => {
+    expect(_$createComponent(DocComment, {
+      get children() {
+        return _$createComponent(DocSeeAlso, {
+          cref: "T:OtherType",
+          children: "OtherType"
+        });
+      }
+    })).toRenderTo(`
+      /// <seealso cref="T:OtherType">OtherType</seealso>
+    `);
+  });
 });
 it("define paramref", () => {
   expect(_$createComponent(DocComment, {
     get children() {
-      return [_$memo(() => DocParamRef({
+      return _$createComponent(DocParamRef, {
         name: "x"
-      }))];
+      });
     }
   })).toRenderTo(`
-    /// <paramref name="x" />
+    /// <paramref name="${"x"}" />
   `);
 });
 it("define typeparamref", () => {
   expect(_$createComponent(DocComment, {
     get children() {
-      return [_$memo(() => DocTypeParamRef({
+      return _$createComponent(DocTypeParamRef, {
         name: "T"
-      }))];
+      });
     }
   })).toRenderTo(`
     /// <typeparamref name="T" />

package/dist/src/components/doc/from-markdown.d.ts

@@ -0,0 +1,6 @@
+export interface DocFromMarkdownProps {
+    markdown: string;
+}
+/** Convert markdown to a Csharp doc comment */
+export declare function DocFromMarkdown(props: DocFromMarkdownProps): import("@alloy-js/core/jsx-runtime").Children;
+//# sourceMappingURL=from-markdown.d.ts.map

package/dist/src/components/doc/from-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-markdown.d.ts","sourceRoot":"","sources":["../../../../src/components/doc/from-markdown.tsx"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,iDAG1D"}

package/dist/src/components/doc/from-markdown.js

@@ -0,0 +1,58 @@
+import { memo as _$memo, createComponent as _$createComponent, createIntrinsic as _$createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { marked } from "marked";
+import { DocC, DocCode, DocList, DocSee } from "./comment.js";
+/** Convert markdown to a Csharp doc comment */
+export function DocFromMarkdown(props) {
+  const tokens = marked.lexer(props.markdown);
+  return renderTokens(tokens);
+}
+function renderTokens(tokens) {
+  return [_$memo(() => tokens.map((token, index) => [_$createComponent(DocFromMarkedToken, {
+    token: token
+  }), _$memo(() => _$memo(() => !!(token.type === "paragraph" && index !== tokens.length - 1))() && _$createIntrinsic("br", {}))]))];
+}
+function DocFromMarkedToken(props) {
+  const {
+    token
+  } = props;
+  switch (token.type) {
+    case "paragraph":
+      return token.tokens ? renderTokens(token.tokens) : null;
+    case "code":
+      return _$createComponent(DocCode, {
+        get children() {
+          return token.text;
+        }
+      });
+    case "codespan":
+      return _$createComponent(DocC, {
+        get children() {
+          return token.text;
+        }
+      });
+    case "list":
+      return _$createComponent(DocList, {
+        get type() {
+          return token.ordered ? "number" : "bullet";
+        },
+        get items() {
+          return token.items.map(x => [_$memo(() => renderTokens(x.tokens))]);
+        }
+      });
+    case "link":
+      return _$createComponent(DocSee, {
+        get href() {
+          return token.href;
+        },
+        get children() {
+          return _$memo(() => !!token.tokens)() && renderTokens(token.tokens);
+        }
+      });
+    case "strong":
+    case "em":
+      return token.text;
+    case "text":
+    default:
+      return token.raw;
+  }
+}

package/dist/src/components/doc/from-markdown.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=from-markdown.test.d.ts.map

package/dist/src/components/doc/from-markdown.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-markdown.test.d.ts","sourceRoot":"","sources":["../../../../src/components/doc/from-markdown.test.tsx"],"names":[],"mappings":""}

package/dist/src/components/doc/from-markdown.test.js

@@ -0,0 +1,83 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { d } from "@alloy-js/core/testing";
+import { describe, expect, it } from "vitest";
+import { DocFromMarkdown } from "./from-markdown.js";
+it("convert code block to <code>", () => {
+  expect(_$createComponent(DocFromMarkdown, {
+    markdown: d`
+        Some markdown with code
+        \`\`\`csharp
+        var foo = "bar";
+        \`\`\`
+    `
+  })).toRenderTo(`
+    Some markdown with code
+    <code>
+    var foo = "bar";
+    </code>
+  `);
+});
+it("convert inline code block to <c>", () => {
+  expect(_$createComponent(DocFromMarkdown, {
+    markdown: d`
+        Some markdown with \`inline\` code
+    `
+  })).toRenderTo(`
+    Some markdown with <c>inline</c> code
+  `);
+});
+it("convert link to <see>", () => {
+  expect(_$createComponent(DocFromMarkdown, {
+    markdown: d`
+        Some markdown with [link](https://example.com)
+    `
+  })).toRenderTo(`
+    Some markdown with <see href="https://example.com">link</see>
+  `);
+});
+it("convert bullet list to <list>", () => {
+  expect(_$createComponent(DocFromMarkdown, {
+    markdown: d`
+        - Item 1
+        - Item 2
+        - Item 3
+    `
+  })).toRenderTo(`
+    <list type="bullet">
+      <item><description>Item 1</description></item>
+      <item><description>Item 2</description></item>
+      <item><description>Item 3</description></item>
+    </list>
+  `);
+});
+it("convert numbered list to <list>", () => {
+  expect(_$createComponent(DocFromMarkdown, {
+    markdown: d`
+        1. Item 1
+        2. Item 2
+        3. Item 3
+    `
+  })).toRenderTo(`
+    <list type="number">
+      <item><description>Item 1</description></item>
+      <item><description>Item 2</description></item>
+      <item><description>Item 3</description></item>
+    </list>
+  `);
+});
+describe("strip unsupported elements", () => {
+  it("bold", () => {
+    expect(_$createComponent(DocFromMarkdown, {
+      markdown: d`
+        Some markdown with **bold** text
+    `
+    })).toRenderTo(`Some markdown with bold text`);
+  });
+  it("italic", () => {
+    expect(_$createComponent(DocFromMarkdown, {
+      markdown: d`
+        Some markdown with *italic* text
+    `
+    })).toRenderTo(`Some markdown with italic text`);
+  });
+});

package/dist/src/components/index.d.ts

@@ -1,6 +1,8 @@
 export * from "./ClassDeclaration.jsx";
 export * from "./ClassMethod.jsx";
 export * from "./Declaration.js";
+export * from "./doc/comment.jsx";
+export * from "./doc/from-markdown.jsx";
 export * from "./EnumDeclaration.jsx";
 export * from "./interface/declaration.js";
 export * from "./interface/method.js";

package/dist/src/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/src/components/index.js

@@ -1,6 +1,8 @@
 export * from "./ClassDeclaration.js";
 export * from "./ClassMethod.js";
 export * from "./Declaration.js";
+export * from "./doc/comment.js";
+export * from "./doc/from-markdown.js";
 export * from "./EnumDeclaration.js";
 export * from "./interface/declaration.js";
 export * from "./interface/method.js";