@alloy-js/csharp 0.18.0-dev.24 → 0.18.0-dev.3

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

@@ -1,348 +0,0 @@
-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() {
-      return _$createComponent(DocSummary, {
-        children: "This is a sample doc comment"
-      });
-    }
-  })).toRenderTo(`
-    /// <summary>
-    /// This is a sample doc comment
-    /// </summary>
-  `);
-});
-it("define code", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocCode, {
-        children: "code sample"
-      });
-    }
-  })).toRenderTo(`
-    /// <code>
-    /// code sample
-    /// </code>
-  `);
-});
-it("define c", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocC, {
-        children: "inline code"
-      });
-    }
-  })).toRenderTo(`
-    /// <c>inline code</c>
-  `);
-});
-it("define example", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocExample, {
-        children: "example usage"
-      });
-    }
-  })).toRenderTo(`
-    /// <example>
-    /// example usage
-    /// </example>
-  `);
-});
-it("define exception", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocException, {
-        children: "exception info"
-      });
-    }
-  })).toRenderTo(`
-    /// <exception>
-    /// exception info
-    /// </exception>
-  `);
-});
-it("define include", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocInclude, {
-        file: "external.xml",
-        path: "/doc/summary"
-      });
-    }
-  })).toRenderTo(`
-    /// <include file="external.xml" path="/doc/summary" />
-  `);
-});
-it("define param", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocParam, {
-        name: "x",
-        children: "parameter x"
-      });
-    }
-  })).toRenderTo(`
-    /// <param name="x">parameter x</param>
-  `);
-});
-it("define typeparam", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocTypeParam, {
-        name: "T",
-        children: "type parameter T"
-      });
-    }
-  })).toRenderTo(`
-    /// <typeparam name="T">type parameter T</typeparam>
-  `);
-});
-it("define returns", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocReturns, {
-        children: "return value"
-      });
-    }
-  })).toRenderTo(`
-    /// <returns>
-    /// return value
-    /// </returns>
-  `);
-});
-it("define remarks", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocRemarks, {
-        children: "remarks here"
-      });
-    }
-  })).toRenderTo(`
-    /// <remarks>
-    /// remarks here
-    /// </remarks>
-  `);
-});
-it("define value", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocValue, {
-        children: "property value"
-      });
-    }
-  })).toRenderTo(`
-    /// <value>
-    /// property value
-    /// </value>
-  `);
-});
-it("define permission", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocPermission, {
-        children: "permission info"
-      });
-    }
-  })).toRenderTo(`
-    /// <permission>
-    /// permission info
-    /// </permission>
-  `);
-});
-it("define list", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocList, {
-        type: "bullet",
-        items: ["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("define description", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocDescription, {
-        children: "description content"
-      });
-    }
-  })).toRenderTo(`
-    /// <description>
-    /// description content
-    /// </description>
-  `);
-});
-it("define para", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocPara, {
-        children: "paragraph content"
-      });
-    }
-  })).toRenderTo(`
-    /// <para>
-    /// paragraph content
-    /// </para>
-  `);
-});
-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" />
-    `);
-  });
-});
-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 _$createComponent(DocParamRef, {
-        name: "x"
-      });
-    }
-  })).toRenderTo(`
-    /// <paramref name="${"x"}" />
-  `);
-});
-it("define typeparamref", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocTypeParamRef, {
-        name: "T"
-      });
-    }
-  })).toRenderTo(`
-    /// <typeparamref name="T" />
-  `);
-});
-it("wrap long summary", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return _$createComponent(DocSummary, {
-        children: "This is a very long sample doc comment that exceeds the typical line length limit and should be wrapped appropriately in the generated documentation."
-      });
-    }
-  })).toRenderTo(`
-    /// <summary>
-    /// This is a very long sample doc comment that exceeds the typical line length limit
-    /// and should be wrapped appropriately in the generated documentation.
-    /// </summary>
-  `);
-});
-it("combine multiple tags", () => {
-  expect(_$createComponent(DocComment, {
-    get children() {
-      return [_$createComponent(DocSummary, {
-        children: "This operator determines whether two Points have the same location."
-      }), _$createComponent(DocParam, {
-        name: "p1",
-        children: "The first Point to be compared."
-      }), _$createComponent(DocParam, {
-        name: "p2",
-        children: "The second Point to be compared."
-      }), _$createComponent(DocReturns, {
-        children: "True if the Points do not have the same location and the exact same type; otherwise, false."
-      }), _$createComponent(DocSeeAlso, {
-        cref: "Equals"
-      }), _$createComponent(DocSeeAlso, {
-        cref: "operator=="
-      })];
-    }
-  })).toRenderTo(`
-    /// <summary>
-    /// This operator determines whether two Points have the same location.
-    /// </summary>
-    /// <param name="p1">The first Point to be compared.</param>
-    /// <param name="p2">The second Point to be compared.</param>
-    /// <returns>
-    /// True if the Points do not have the same location and the exact same type; otherwise,
-    /// false.
-    /// </returns>
-    /// <seealso cref="Equals" />
-    /// <seealso cref="operator==" />
-  `);
-});

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

@@ -1,6 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,58 +0,0 @@
-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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,83 +0,0 @@
-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/interface/declaration.d.ts

@@ -1,65 +0,0 @@
-import * as core from "@alloy-js/core";
-import { AccessModifiers } from "../../modifiers.js";
-import { AttributesProp } from "../attributes/attributes.jsx";
-import { TypeParameterProps } from "../type-parameters/type-parameter.jsx";
-export interface InterfaceModifiers {
-    readonly partial?: boolean;
-}
-export interface InterfaceDeclarationProps extends Omit<core.DeclarationProps, "nameKind">, AccessModifiers, InterfaceModifiers {
-    name: string;
-    /** Doc comment */
-    doc?: core.Children;
-    refkey?: core.Refkey;
-    /**
-     * Type parameters for the interface
-     *
-     * @example
-     * ```tsx
-     * <InterfaceDeclaration name="IList" typeParameters={["T"]} />
-     * ```
-     * This will produce:
-     * ```csharp
-     * public interface IList<T>
-     * ```
-     */
-    typeParameters?: (TypeParameterProps | string)[];
-    /**
-     * Define attributes to attach
-     * @example
-     * ```tsx
-     * <InterfaceDeclaration name="MyInterface" attributes={[
-     *  <Attribute name="Test" />
-     *  <Attribute name="Test2" args={["arg1", "arg2"]} />
-     * ]} />
-     * ```
-     * This will produce:
-     * ```csharp
-     * [Test]
-     * [Test2("arg1", "arg2")]
-     * public interface MyInterface
-     * ```
-     */
-    attributes?: AttributesProp;
-}
-/**
- * CSharp interface declaration.
- * @example
- * ```tsx
- * <InterfaceDeclaration public name="IMyInterface">
- *   <InterfaceMember public name="MyProperty" type="int" />
- *   <InterfaceMethod public name="MyMethod" returnType="void">
- *     <Parameter name="value" type="int" />
- *   </InterfaceMethod>
- * </InterfaceDeclaration>
- * ```
- * This will produce:
- * ```csharp
- * public interface MyIface
- * {
- *   public int MyProperty { get; set; }
- *   public void MyMethod(int value);
- * }
- * ```
- */
-export declare function InterfaceDeclaration(props: InterfaceDeclarationProps): core.Children;
-//# sourceMappingURL=declaration.d.ts.map

package/dist/src/components/interface/declaration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../../../src/components/interface/declaration.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,EACL,eAAe,EAIhB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAiB,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAI7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAG3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAKD,MAAM,WAAW,yBACf,SAAQ,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,EAC7C,eAAe,EACf,kBAAkB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,kBAAkB;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC;IAErB;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,CAAC,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC;IAEjD;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,iBAqCpE"}

package/dist/src/components/interface/declaration.js

@@ -1,83 +0,0 @@
-import { createComponent as _$createComponent, memo as _$memo } from "@alloy-js/core/jsx-runtime";
-import * as core from "@alloy-js/core";
-import { computeModifiersPrefix, getAccessModifier, makeModifiers } from "../../modifiers.js";
-import { useCSharpNamePolicy } from "../../name-policy.js";
-import { CSharpOutputSymbol } from "../../symbols/csharp-output-symbol.js";
-import { CSharpMemberScope } from "../../symbols/scopes.js";
-import { AttributeList } from "../attributes/attributes.js";
-import { DocWhen } from "../doc/comment.js";
-import { Name } from "../Name.js";
-import { TypeParameterConstraints } from "../type-parameters/type-parameter-constraints.js";
-import { TypeParameters } from "../type-parameters/type-parameters.js";
-const getInterfaceModifiers = makeModifiers(["partial"]);
-
-// properties for creating a class
-
-/**
- * CSharp interface declaration.
- * @example
- * ```tsx
- * <InterfaceDeclaration public name="IMyInterface">
- *   <InterfaceMember public name="MyProperty" type="int" />
- *   <InterfaceMethod public name="MyMethod" returnType="void">
- *     <Parameter name="value" type="int" />
- *   </InterfaceMethod>
- * </InterfaceDeclaration>
- * ```
- * This will produce:
- * ```csharp
- * public interface MyIface
- * {
- *   public int MyProperty { get; set; }
- *   public void MyMethod(int value);
- * }
- * ```
- */
-export function InterfaceDeclaration(props) {
-  const name = useCSharpNamePolicy().getName(props.name, "interface");
-  const thisInterfaceSymbol = new CSharpOutputSymbol(name, {
-    refkeys: props.refkey
-  });
-
-  // this creates a new scope for the interface definition.
-  // members will automatically "inherit" this scope so
-  // that refkeys to them will produce the fully-qualified
-  // name e.g. Foo.Bar.
-  const thisInterfaceScope = new CSharpMemberScope("interface-decl", {
-    owner: thisInterfaceSymbol
-  });
-  const modifiers = computeModifiersPrefix([getAccessModifier(props), getInterfaceModifiers(props)]);
-  return _$createComponent(core.Declaration, {
-    symbol: thisInterfaceSymbol,
-    get children() {
-      return [_$createComponent(DocWhen, {
-        get doc() {
-          return props.doc;
-        }
-      }), _$createComponent(AttributeList, {
-        get attributes() {
-          return props.attributes;
-        },
-        endline: true
-      }), modifiers, "interface ", _$createComponent(Name, {}), _$memo(() => _$memo(() => !!props.typeParameters)() && _$createComponent(TypeParameters, {
-        get parameters() {
-          return props.typeParameters;
-        }
-      })), _$memo(() => _$memo(() => !!props.typeParameters)() && _$createComponent(TypeParameterConstraints, {
-        get parameters() {
-          return props.typeParameters;
-        }
-      })), _$memo(() => _$memo(() => !!props.children)() ? _$createComponent(core.Block, {
-        newline: true,
-        get children() {
-          return _$createComponent(core.Scope, {
-            value: thisInterfaceScope,
-            get children() {
-              return props.children;
-            }
-          });
-        }
-      }) : ";")];
-    }
-  });
-}

package/dist/src/components/interface/declaration.test.d.ts

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

package/dist/src/components/interface/declaration.test.d.ts.map

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