@alloy-js/csharp 0.17.0 → 0.18.0-dev.11

package/dist/src/components/class/property.test.js

@@ -0,0 +1,201 @@
+import { memo as _$memo, createComponent as _$createComponent, mergeProps as _$mergeProps } from "@alloy-js/core/jsx-runtime";
+import { describe, expect, it } from "vitest";
+import { TestNamespace } from "../../../test/utils.js";
+import { ClassDeclaration } from "../ClassDeclaration.js";
+import { ClassProperty } from "./property.js";
+const Wrapper = props => _$createComponent(TestNamespace, {
+  get children() {
+    return _$createComponent(ClassDeclaration, {
+      "public": true,
+      name: "TestClass",
+      get children() {
+        return props.children;
+      }
+    });
+  }
+});
+describe("modifiers", () => {
+  describe("access modifiers", () => {
+    it.each(["public", "private", "protected", "internal"])("%s", accessModifier => {
+      expect(_$createComponent(Wrapper, {
+        get children() {
+          return _$createComponent(ClassProperty, _$mergeProps({
+            [accessModifier]: true
+          }, {
+            name: "TestProp",
+            type: "string",
+            get: true
+          }));
+        }
+      })).toRenderTo(`
+        public class TestClass
+        {
+          ${accessModifier} string TestProp { get; }
+        }
+      `);
+    });
+  });
+  describe("property modifiers", () => {
+    it.each(["new", "static", "virtual", "sealed", "override", "abstract", "extern", "readonly"])("%s", methodModifier => {
+      expect(_$createComponent(Wrapper, {
+        get children() {
+          return _$createComponent(ClassProperty, _$mergeProps({
+            [methodModifier]: true
+          }, {
+            name: "TestProp",
+            type: "string",
+            get: true
+          }));
+        }
+      })).toRenderTo(`
+        public class TestClass
+        {
+          ${methodModifier} string TestProp { get; }
+        }
+      `);
+    });
+  });
+  it("combine modifiers", () => {
+    expect(_$createComponent(Wrapper, {
+      get children() {
+        return _$createComponent(ClassProperty, {
+          "public": true,
+          "new": true,
+          name: "TestProp",
+          type: "string",
+          get: true
+        });
+      }
+    })).toRenderTo(`
+        public class TestClass
+        {
+          public new string TestProp { get; }
+        }
+      `);
+  });
+});
+it("applies PascalCase naming policy", () => {
+  expect(_$createComponent(Wrapper, {
+    get children() {
+      return _$createComponent(ClassProperty, {
+        name: "test_prop",
+        type: "string",
+        get: true
+      });
+    }
+  })).toRenderTo(`
+    public class TestClass
+    {
+      string TestProp { get; }
+    }
+`);
+});
+it("has getter only", () => {
+  expect(_$createComponent(Wrapper, {
+    get children() {
+      return _$createComponent(ClassProperty, {
+        name: "TestProp",
+        type: "string",
+        get: true
+      });
+    }
+  })).toRenderTo(`
+    public class TestClass
+    {
+      string TestProp { get; }
+    }
+  `);
+});
+it("has setter only", () => {
+  expect(_$createComponent(Wrapper, {
+    get children() {
+      return _$createComponent(ClassProperty, {
+        name: "TestProp",
+        type: "string",
+        set: true
+      });
+    }
+  })).toRenderTo(`
+    public class TestClass
+    {
+      string TestProp { set; }
+    }
+  `);
+});
+it("has getter and setter", () => {
+  expect(_$createComponent(Wrapper, {
+    get children() {
+      return _$createComponent(ClassProperty, {
+        name: "TestProp",
+        type: "string",
+        get: true,
+        set: true
+      });
+    }
+  })).toRenderTo(`
+    public class TestClass
+    {
+      string TestProp { get; set; }
+    }
+  `);
+});
+it("specify doc comment", () => {
+  expect(_$createComponent(TestNamespace, {
+    get children() {
+      return _$createComponent(ClassDeclaration, {
+        name: "Test",
+        get children() {
+          return _$createComponent(ClassProperty, {
+            name: "Method",
+            type: "string",
+            get: true,
+            set: true,
+            doc: "This is a test"
+          });
+        }
+      });
+    }
+  })).toRenderTo(`
+    class Test
+    {
+      /// This is a test
+      string Method { get; set; }
+    }
+  `);
+});
+it("specify nullable property", () => {
+  expect(_$createComponent(Wrapper, {
+    get children() {
+      return _$createComponent(ClassProperty, {
+        name: "TestProp",
+        type: "string",
+        nullable: true,
+        get: true,
+        set: true
+      });
+    }
+  })).toRenderTo(`
+    public class TestClass
+    {
+      string? TestProp { get; set; }
+    }
+  `);
+});
+it("specify initializer", () => {
+  expect(_$createComponent(Wrapper, {
+    get children() {
+      return _$createComponent(ClassProperty, {
+        name: "TestProp",
+        type: "string",
+        get: true,
+        set: true,
+        init: `"abc"`
+      });
+    }
+  })).toRenderTo(`
+    public class TestClass
+    {
+      string TestProp { get; set; } = "abc";
+    }
+  `);
+});

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

@@ -0,0 +1,70 @@
+import { Children } from "@alloy-js/core";
+export interface DocCommentProps {
+    children: Children;
+}
+export declare function DocComment(props: DocCommentProps): Children;
+export interface DocWhenProps {
+    doc: Children | undefined;
+}
+/** Conditionally render the given doc in a <DocComment /> component and tail with a line */
+export declare function DocWhen(props: DocWhenProps): Children;
+export interface DocCommentTagProps {
+    children: Children;
+}
+export declare function makeDocCommentTag(name: string): (props: DocCommentProps) => Children;
+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) => string;
+export declare const DocExample: (props: DocCommentProps) => Children;
+export declare const DocException: (props: DocCommentProps) => Children;
+export interface DocIncludeProps {
+    /**  is the file name of an external XML file. The file name is interpreted relative to the file that contains the include tag. */
+    file: string;
+    /** is an XPath expression that selects some of the XML in the external XML file. */
+    path?: string;
+}
+export declare const DocInclude: (props: DocIncludeProps) => string;
+export interface DocParamProps {
+    name: string;
+    children: Children;
+}
+export declare const DocParam: (props: DocParamProps) => Children;
+export interface DocTypeParamProps {
+    name: string;
+    children: Children;
+}
+export declare const DocTypeParam: (props: DocTypeParamProps) => Children;
+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 DocDescription: (props: DocCommentProps) => Children;
+export declare const DocPara: (props: DocCommentProps) => Children;
+export interface DocSeeProps {
+    cref?: string;
+    href?: string;
+    langword?: string;
+    children?: Children;
+}
+export declare const DocSee: (props: DocSeeProps) => Children;
+export interface DocSeeAlsoProps {
+    cref?: string;
+    href?: string;
+    children?: Children;
+}
+export declare const DocSeeAlso: (props: DocSeeAlsoProps) => Children;
+export interface DocParamRefProps {
+    name: string;
+}
+export declare const DocParamRef: (props: DocParamRefProps) => string;
+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

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

@@ -0,0 +1,88 @@
+import { createComponent as _$createComponent, createIntrinsic as _$createIntrinsic, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import { code, For, Indent, List, Prose, Show } from "@alloy-js/core";
+export function DocComment(props) {
+  return ["/// ", _$createIntrinsic("align", {
+    string: "/// ",
+    get children() {
+      return _$createComponent(List, {
+        get children() {
+          return props.children;
+        }
+      });
+    }
+  })];
+}
+/** Conditionally render the given doc in a <DocComment /> component and tail with a line */
+export function DocWhen(props) {
+  return _$createComponent(Show, {
+    get when() {
+      return Boolean(props.doc);
+    },
+    get children() {
+      return [_$createComponent(DocComment, {
+        get children() {
+          return props.doc;
+        }
+      }), _$createIntrinsic("hbr", {})];
+    }
+  });
+}
+export function makeDocCommentTag(name) {
+  return function DocCommentTag(props) {
+    return _$createComponent(Prose, {
+      get children() {
+        return code`
+        <${name}>
+        ${props.children}
+        </${name}>`;
+      }
+    });
+  };
+}
+export function makeInlineDocCommentTag(name) {
+  return function DocCommentTag(props) {
+    return `<${name}>${props.children}</${name}>`;
+  };
+}
+export const DocSummary = makeDocCommentTag("summary");
+export const DocCode = makeDocCommentTag("code");
+export const DocC = makeInlineDocCommentTag("c");
+export const DocExample = makeDocCommentTag("example");
+export const DocException = makeDocCommentTag("exception");
+export const DocInclude = props => {
+  return `<include file="${props.file}" path="${props.path}" />`;
+};
+export const DocParam = props => code`<param name="${props.name}">${props.children}</param>`;
+export const DocTypeParam = props => code`<typeparam name="${props.name}">${props.children}</typeparam>`;
+export const DocReturns = makeDocCommentTag("returns");
+export const DocRemarks = makeDocCommentTag("remarks");
+export const DocValue = makeDocCommentTag("value");
+export const DocPermission = makeDocCommentTag("permission");
+export const DocDescription = makeDocCommentTag("description");
+export const DocPara = makeDocCommentTag("para");
+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 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.d.ts

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

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

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