@xyd-js/sources 0.0.0-build

package/__fixtures__/-2.react.basic/5b.inline-props+interfaces.output.json

@@ -0,0 +1,92 @@
+[
+  {
+    "title": "Text",
+    "canonical": "@xyd-js/sources/components/Text",
+    "description": "A flexible text component that supports different sizes, styles, and weights.\n",
+    "context": {
+      "symbolId": "107",
+      "symbolName": "Text",
+      "symbolKind": 64,
+      "packageName": "5b.inline-props+interfaces",
+      "fileName": "5b.inline-props+interfaces.tsx",
+      "fileFullPath": "__fixtures__/-2.react.basic/src/5b.inline-props+interfaces.tsx",
+      "line": 47,
+      "col": 16,
+      "signatureText": {
+        "code": "",
+        "lang": "ts"
+      },
+      "sourcecode": {
+        "code": "",
+        "lang": "ts"
+      },
+      "category": "Component",
+      "group": [
+        "@xyd-js",
+        "sources",
+        "Component"
+      ]
+    },
+    "examples": {
+      "groups": []
+    },
+    "definitions": [
+      {
+        "title": "Props",
+        "properties": [
+          {
+            "name": "size",
+            "type": "\"xsmall\" | \"small\" | \"medium\" | \"large\" | \"xlarge\" | \"xxlarge\"",
+            "description": "Font size of the text\n",
+            "symbolDef": {
+              "id": "110"
+            }
+          },
+          {
+            "name": "kind",
+            "type": "\"default\" | \"ghost\" | \"success\" | \"warn\" | \"error\" | \"primary\" | \"secondary\"",
+            "description": "Visual style/kind of the text\n",
+            "symbolDef": {
+              "id": "111"
+            }
+          },
+          {
+            "name": "weight",
+            "type": "\"normal\" | \"bold\" | \"extra-bold\"",
+            "description": "Font weight of the text\n",
+            "symbolDef": {
+              "id": "112"
+            }
+          },
+          {
+            "name": "children",
+            "type": "React.ReactNode",
+            "description": "Content to be rendered inside the text component\n"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "description": "Additional CSS class name\n"
+          },
+          {
+            "name": "id",
+            "type": "string",
+            "description": "HTML id attribute\n"
+          },
+          {
+            "name": "onClick",
+            "type": "",
+            "description": "Click event handler\n",
+            "properties": []
+          }
+        ],
+        "meta": [
+          {
+            "name": "type",
+            "value": "parameters"
+          }
+        ]
+      }
+    ]
+  }
+]

package/__fixtures__/-2.react.basic/package.json

@@ -0,0 +1,4 @@
+{
+  "main": "dist/index.js"
+}
+

package/__fixtures__/-2.react.basic/src/1.flat-interface.tsx

@@ -0,0 +1,41 @@
+/**
+ * Props for the GuideCard component
+ */
+export interface GuideCardProps {
+    /** Content to be displayed in the card body */
+    children: React.ReactNode;
+
+    /** URL the card links to */
+    href: string
+
+    /** Title displayed at the top of the card */
+    title: string;
+
+    /** Optional icon displayed to the left of the content */
+    icon?: React.ReactNode;
+
+    /** Visual style variant of the card */
+    kind?: "secondary"
+
+    /** Size variant of the card */
+    size?: "sm" | "md"
+
+    /** Additional CSS class names to apply to the card */
+    className?: string
+
+    /** Additional props to pass to the link element */
+    as?: React.ElementType
+}
+
+/**
+ * A card component that displays content with a title and optional icon.
+ * The entire card is clickable and links to the specified URL.
+ *
+ * @category Component
+ */
+export function GuideCard(props: GuideCardProps) {
+    return <div>
+        {props.children}
+    </div>
+}
+

package/__fixtures__/-2.react.basic/src/2.file-connect-interface.tsx

@@ -0,0 +1,28 @@
+/**
+ * Kind of card style to apply.
+ */
+export type Kind = "primary" | "secondary"
+
+/**
+ * Props for the GuideCard component
+ */
+export interface GuideCardProps {
+    /** Content to be displayed in the card body */
+    children: React.ReactNode;
+
+    /** Visual style variant of the card */
+    kind?: Kind
+}
+
+/**
+ * A card component that displays content with a title and optional icon.
+ * The entire card is clickable and links to the specified URL.
+ *
+ * @category Component
+ */
+export function GuideCard(props: GuideCardProps) {
+    return <div>
+        {props.children}
+    </div>
+}
+

package/__fixtures__/-2.react.basic/src/2a.file-connect-interace+advanced.tsx

@@ -0,0 +1,54 @@
+/**
+ * Available font sizes for the Text component
+ */
+export type TextFontSizes = "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+
+/**
+ * Available text styles/kinds for the Text component
+ */
+export type TextKindTypes = "default" | "ghost" | "success" | "warn" | "error" | "primary" | "secondary";
+
+/**
+ * Available font weights for the Text component
+ */
+export type TextFontWeights = "normal" | "bold" | "extra-bold";
+
+/**
+ * Props for the Text component
+ */
+export interface TextProps {
+    /** Font size of the text */
+    size?: TextFontSizes
+
+    /** Visual style/kind of the text */
+    kind?: TextKindTypes
+
+    /** Font weight of the text */
+    weight?: TextFontWeights
+
+    /** Content to be rendered inside the text component */
+    children?: React.ReactNode
+
+    /** Additional CSS class name */
+    className?: string
+
+    /** HTML id attribute */
+    id?: string
+
+    /** Click event handler */
+    onClick?: () => void
+}
+
+/**
+ * A flexible text component that supports different sizes, styles, and weights.
+ *
+ * @category Component
+ */
+export function Text(props: TextProps) {
+    return (
+        <p>
+            {props.children}
+        </p>
+    )
+}
+

package/__fixtures__/-2.react.basic/src/3.props-as-variants.tsx

@@ -0,0 +1,67 @@
+/**
+ * Base interface for all Details component variants
+ */
+export interface BaseDetailsProps {
+    /** Content to be displayed inside the details element */
+    children: React.ReactNode;
+
+    /** Label text displayed in the summary */
+    label: string;
+
+    /** Optional icon element to be displayed in the summary */
+    icon?: React.ReactElement;
+
+    /** Optional CSS class name for custom styling */
+    className?: string;
+}
+
+/**
+ * Props for the tertiary variant of the Details component
+ */
+export interface TertiaryDetailsProps extends BaseDetailsProps {
+    /** Specifies the tertiary variant */
+    kind: "tertiary";
+
+    /** Title text or element displayed in the summary */
+    title: string | React.ReactNode;
+}
+
+/**
+ * Props for the secondary variant of the Details component
+ */
+export interface SecondaryDetailsProps extends BaseDetailsProps {
+    /** Specifies the secondary variant */
+    kind: "secondary";
+
+    /** Title text or element displayed in the summary */
+    title: string | React.ReactNode;
+}
+
+/**
+ * Props for the primary variant of the Details component
+ */
+export interface PrimaryDetailsProps extends BaseDetailsProps {
+    /** Specifies the primary variant (default) */
+    kind?: "primary";
+}
+
+/** Union type of all possible Details component variants */
+export type DetailsProps = PrimaryDetailsProps | SecondaryDetailsProps | TertiaryDetailsProps
+
+/**
+ * A collapsible details component that supports three variants: primary, secondary, and tertiary.
+ * Each variant has a different visual style and structure.
+ *
+ * @param props - The component props
+ * @returns A details element with collapsible content
+ *
+ * @category Component
+ */
+export function Details(props: DetailsProps): React.ReactElement {
+    return <div>
+        {props.children}
+    </div>
+}
+
+
+

package/__fixtures__/-2.react.basic/src/4.outside-interface.tsx

@@ -0,0 +1,13 @@
+import type {GuideCardProps} from "./4.outside-interface2";
+
+/**
+ * A card component that displays content with a title and optional icon.
+ * The entire card is clickable and links to the specified URL.
+ *
+ * @category Component
+ */
+export function GuideCard(props: GuideCardProps) {
+    return <div>
+        {props.children}
+    </div>
+}

package/__fixtures__/-2.react.basic/src/4.outside-interface2.ts

@@ -0,0 +1,15 @@
+/**
+ * Kind of card style to apply.
+ */
+export type Kind = "primary" | "secondary"
+
+/**
+ * Props for the GuideCard component
+ */
+export interface GuideCardProps {
+    /** Content to be displayed in the card body */
+    children: React.ReactNode;
+
+    /** Visual style variant of the card */
+    kind?: Kind
+}

package/__fixtures__/-2.react.basic/src/5.inline-props.tsx

@@ -0,0 +1,19 @@
+export type Kind = "primary" | "secondary";
+
+/**
+ * A card component that displays content with a title and optional icon.
+ * The entire card is clickable and links to the specified URL.
+ *
+ * @category Component
+ */
+export function GuideCard({children, kind = "primary"}: {
+    /** Content to be displayed in the card body */
+    children: React.ReactNode;
+
+    /** Visual style variant of the card */
+    kind?: Kind
+}) {
+    return <div>
+        {children}
+    </div>
+}

package/__fixtures__/-2.react.basic/src/5a.inline-props+outside.tsx

@@ -0,0 +1,19 @@
+import {Kind} from "./4.outside-interface2";
+
+/**
+ * A card component that displays content with a title and optional icon.
+ * The entire card is clickable and links to the specified URL.
+ *
+ * @category Component
+ */
+export function GuideCard({children, kind = "primary"}: {
+    /** Content to be displayed in the card body */
+    children: React.ReactNode;
+
+    /** Visual style variant of the card */
+    kind?: Kind
+}) {
+    return <div>
+        {children}
+    </div>
+}

package/__fixtures__/-2.react.basic/src/5b.inline-props+interfaces.tsx

@@ -0,0 +1,62 @@
+/**
+ * Available font sizes for the Text component
+ */
+export type TextFontSizes = "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+
+/**
+ * Available text styles/kinds for the Text component
+ */
+export type TextKindTypes = "default" | "ghost" | "success" | "warn" | "error" | "primary" | "secondary";
+
+/**
+ * Available font weights for the Text component
+ */
+export type TextFontWeights = "normal" | "bold" | "extra-bold";
+
+/**
+ * Props for the Text component
+ */
+export interface TextProps {
+    /** Font size of the text */
+    size?: TextFontSizes
+
+    /** Visual style/kind of the text */
+    kind?: TextKindTypes
+
+    /** Font weight of the text */
+    weight?: TextFontWeights
+
+    /** Content to be rendered inside the text component */
+    children?: React.ReactNode
+
+    /** Additional CSS class name */
+    className?: string
+
+    /** HTML id attribute */
+    id?: string
+
+    /** Click event handler */
+    onClick?: () => void
+}
+
+/**
+ * A flexible text component that supports different sizes, styles, and weights.
+ *
+ * @category Component
+ */
+export function Text({
+                         size = "medium",
+                         kind = "default",
+                         weight = "normal",
+                         children,
+                         className,
+                         id,
+                         onClick
+                     }: TextProps) {
+    return (
+        <div>
+            {children}
+        </div>
+    )
+}
+

package/__fixtures__/-2.react.basic/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "outDir": "./dist",
+    "jsx": "react-jsx",
+    "skipLibCheck": true
+  }
+}
+

package/__tests__/sourcesToUniform.test.ts

@@ -0,0 +1,167 @@
+import {describe, expect, it} from 'vitest'
+
+import type {Test} from "./types";
+import {testSourcesToUniform} from "./utils";
+
+const TEST_DEBUG = true || Boolean(process.env.TEST_DEBUG);
+const FORCE_SAVE = TEST_DEBUG || process.env.FORCE_SAFE === "true";
+const SAVE_UNIFORM = TEST_DEBUG || process.env.SAVE_UNIFORM === "true";
+const SAVE_TYPEDOC = TEST_DEBUG || process.env.SAVE_UNIFORM === "true";
+
+// TODO: tests in the future
+
+const tests: Test[] = [
+    // {
+    //     id: "1.settings",
+    //     file: "-1.typescript",
+    //     description: "TypeScript: example",
+    //     miniUniformRoot: "Settings",
+    //     entryPoints: [
+    //         "src/settings.ts"
+    //     ],
+    //     forceSave: FORCE_SAVE,
+    //     saveUniform: SAVE_UNIFORM,
+    //     saveTypedoc: SAVE_TYPEDOC,
+    //     multiOutput: true
+    // },
+    // {
+    //     id: "1.settings",
+    //     file: "-1.typescript",
+    //     description: "TypeScript: example",
+    //     miniUniformRoot: "Metadata",
+    //     entryPoints: [
+    //         "src/settings2.ts"
+    //     ],
+    //     forceSave: FORCE_SAVE,
+    //     saveUniform: SAVE_UNIFORM,
+    //     saveTypedoc: SAVE_TYPEDOC,
+    //     multiOutput: true
+    // },
+
+    {
+        id: "1.flat-interface",
+        file: "-2.react.basic",
+        description: "React basic: flat interface",
+        react: true,
+        entryPoints: [
+            "src/1.flat-interface.tsx"
+        ],
+        // forceSave: FORCE_SAVE,
+        // saveUniform: SAVE_UNIFORM,
+        // saveTypedoc: SAVE_TYPEDOC,
+        multiOutput: true
+    },
+    //
+    // {
+    //     id: "2.file-connect-interface",
+    //     file: "-2.react.basic",
+    //     description: "React basic: file connect interface",
+    //     react: true,
+    //     entryPoints: [
+    //         "src/2.file-connect-interface.tsx"
+    //     ],
+    //     forceSave: FORCE_SAVE,
+    //     saveUniform: SAVE_UNIFORM,
+    //     saveTypedoc: SAVE_TYPEDOC,
+    //     multiOutput: true
+    // },
+    // {
+    //     id: "2a.file-connect-interface-advanced",
+    //     file: "-2.react.basic",
+    //     description: "React basic: file connect interface advanced",
+    //     react: true,
+    //     entryPoints: [
+    //         "src/2a.file-connect-interace+advanced.tsx"
+    //     ],
+    //     forceSave: FORCE_SAVE,
+    //     saveUniform: SAVE_UNIFORM,
+    //     saveTypedoc: SAVE_TYPEDOC,
+    //     multiOutput: true
+    // },
+    //
+    // {
+    //     id: "3.props-as-variants",
+    //     file: "-2.react.basic",
+    //     description: "React basic: props as variants",
+    //     react: true,
+    //     entryPoints: [
+    //         "src/3.props-as-variants.tsx"
+    //     ],
+    //     forceSave: FORCE_SAVE,
+    //     saveUniform: SAVE_UNIFORM,
+    //     saveTypedoc: SAVE_TYPEDOC,
+    //     multiOutput: true
+    // },
+    //
+    // {
+    //     id: "4.outside-interface",
+    //     file: "-2.react.basic",
+    //     description: "React basic: outside interface",
+    //     react: true,
+    //     entryPoints: [
+    //         "src/4.outside-interface.tsx"
+    //     ],
+    //     forceSave: FORCE_SAVE,
+    //     saveUniform: SAVE_UNIFORM,
+    //     saveTypedoc: SAVE_TYPEDOC,
+    //     multiOutput: true
+    // },
+    //
+    // {
+    //     id: "5.inline-props",
+    //     file: "-2.react.basic",
+    //     description: "React basic: inline props",
+    //     react: true,
+    //     entryPoints: [
+    //         "src/5.inline-props.tsx"
+    //     ],
+    //     forceSave: FORCE_SAVE,
+    //     saveUniform: SAVE_UNIFORM,
+    //     saveTypedoc: SAVE_TYPEDOC,
+    //     multiOutput: true
+    // },
+    // {
+    //     id: "5a.inline-props+outside",
+    //     file: "-2.react.basic",
+    //     description: "React basic: inline props + outside",
+    //     react: true,
+    //     entryPoints: [
+    //         "src/5a.inline-props+outside.tsx"
+    //     ],
+    //     forceSave: FORCE_SAVE,
+    //     saveUniform: SAVE_UNIFORM,
+    //     saveTypedoc: SAVE_TYPEDOC,
+    //     multiOutput: true
+    // },
+    // {
+    //     id: "5b.inline-props+interfaces",
+    //     file: "-2.react.basic",
+    //     description: "React basic: inline prop + interfaces",
+    //     react: true,
+    //     entryPoints: [
+    //         "src/5b.inline-props+interfaces.tsx"
+    //     ],
+    //     forceSave: FORCE_SAVE,
+    //     saveUniform: SAVE_UNIFORM,
+    //     saveTypedoc: SAVE_TYPEDOC,
+    //     multiOutput: true
+    // },
+]
+
+// describe("sourcesToUniform", () => {
+//     tests.forEach((test) => {
+//         it(`[${test.id} (${test.file})]: ${test.description}`, async () => {
+//             await testSourcesToUniform(test);
+//         });
+//     });
+// });
+
+describe("sourcesToUniform TODO", () => {
+    it("TODO", async () => {
+        // for (const test of tests) {
+        //     await testSourcesToUniform(test);
+        // }
+
+        // expect(true).toBe(true)
+    })
+})