@azure-tools/typespec-ts 0.11.0

package/src/lib.ts

@@ -0,0 +1,207 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+import {
+  paramMessage,
+  createCadlLibrary,
+  JSONSchemaType
+} from "@typespec/compiler";
+import { RLCOptions } from "@azure-tools/rlc-common";
+import { Options } from "prettier";
+
+export const RLCOptionsSchema: JSONSchemaType<RLCOptions> = {
+  type: "object",
+  additionalProperties: true,
+  properties: {
+    includeShortcuts: { type: "boolean", nullable: true },
+    multiClient: { type: "boolean", nullable: true },
+    batch: {
+      type: "array",
+      nullable: true,
+      items: {
+        type: "string"
+      }
+    },
+    packageDetails: {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        name: { type: "string", nullable: false },
+        scopeName: { type: "string", nullable: true },
+        nameWithoutScope: { type: "string", nullable: true },
+        description: { type: "string", nullable: true },
+        version: { type: "string", nullable: false }
+      },
+      required: ["name", "version"],
+      nullable: true
+    },
+    addCredentials: { type: "boolean", nullable: true },
+    credentialScopes: {
+      type: "array",
+      nullable: true,
+      items: { type: "string" }
+    },
+    credentialKeyHeaderName: { type: "string", nullable: true },
+    generateMetadata: { type: "boolean", nullable: true },
+    generateTest: { type: "boolean", nullable: true },
+    generateSample: { type: "boolean", nullable: true },
+    azureSdkForJs: { type: "boolean", nullable: true },
+    azureOutputDirectory: { type: "string", nullable: true },
+    isCadlTest: { type: "boolean", nullable: true },
+    title: { type: "string", nullable: true },
+    dependencyInfo: {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        link: { type: "string", nullable: false },
+        description: { type: "string", nullable: false }
+      },
+      required: [],
+      nullable: true
+    },
+    productDocLink: { type: "string", nullable: true },
+    serviceInfo: {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        title: { type: "string", nullable: true },
+        description: { type: "string", nullable: true }
+      },
+      nullable: true
+    },
+    azureArm: { type: "boolean", nullable: true },
+    sourceFrom: { type: "string", nullable: true }
+  },
+  required: []
+};
+
+const libDef = {
+  name: "@azure-tools/typespec-ts",
+  diagnostics: {
+    "security-service-namespace": {
+      severity: "error",
+      messages: {
+        default:
+          "Cannot add security details to a namespace other than the service namespace."
+      }
+    },
+    "more-than-one-service": {
+      severity: "error",
+      messages: {
+        default:
+          "Only support one service and more than one services are not allowed."
+      }
+    },
+    "no-service-defined": {
+      severity: "error",
+      messages: {
+        default:
+          "No service defined and must have one and only one service defined."
+      }
+    },
+    "resource-namespace": {
+      severity: "error",
+      messages: {
+        default: "Resource goes on namespace"
+      }
+    },
+    "missing-path-param": {
+      severity: "error",
+      messages: {
+        default: paramMessage`Path contains parameter ${"param"} but wasn't found in given parameters`
+      }
+    },
+    "duplicate-body-types": {
+      severity: "error",
+      messages: {
+        default: "Request has multiple body types"
+      }
+    },
+    "duplicate-header": {
+      severity: "error",
+      messages: {
+        default: paramMessage`The header ${"header"} is defined across multiple content types`
+      }
+    },
+    "duplicate-example": {
+      severity: "error",
+      messages: {
+        default: "Duplicate @example declarations on operation"
+      }
+    },
+    "invalid-schema": {
+      severity: "error",
+      messages: {
+        default: paramMessage`Couldn't get schema for type ${"type"}`
+      }
+    },
+    "union-null": {
+      severity: "error",
+      messages: {
+        default: "Cannot have a union containing only null types."
+      }
+    },
+    "union-unsupported": {
+      severity: "error",
+      messages: {
+        default:
+          "Unions cannot be emitted to OpenAPI v2 unless all options are literals of the same type.",
+        null: "Unions containing multiple model types cannot be emitted to OpenAPI v2 unless the union is between one model type and 'null'."
+      }
+    },
+    discriminator: {
+      severity: "error",
+      messages: {
+        duplicate: paramMessage`Discriminator value "${"val"}" defined in two different variants: ${"model1"} and ${"model2"}`,
+        missing:
+          "The discriminator property is not defined in a variant of a discriminated union.",
+        required: "the discriminator property must be a required property.",
+        type: "the discriminator property must be type 'string'."
+      }
+    },
+    "discriminator-value": {
+      severity: "warning",
+      messages: {
+        literal:
+          "Each variant of a discriminated union should define the discriminator property with a string literal value."
+      }
+    },
+    "invalid-default": {
+      severity: "error",
+      messages: {
+        default: paramMessage`Invalid type '${"type"}' for a default value`
+      }
+    },
+    "no-credential-scopes": {
+      severity: "warning",
+      messages: {
+        default:
+          "Please provide credential scopes to ensure the token credential signature can be generated."
+      }
+    }
+  },
+  emitter: {
+    options: RLCOptionsSchema
+  }
+} as const;
+
+export const $lib = createCadlLibrary(libDef);
+export const { reportDiagnostic } = $lib;
+
+export const prettierTypeScriptOptions: Options = {
+  parser: "typescript",
+  arrowParens: "always",
+  bracketSpacing: true,
+  endOfLine: "lf",
+  printWidth: 80,
+  semi: true,
+  singleQuote: false,
+  tabWidth: 2
+};
+
+export const prettierJSONOptions: Options = {
+  parser: "json",
+  tabWidth: 2,
+  semi: false,
+  singleQuote: false
+};