@azure-tools/typespec-ts 0.55.0-dev.6 → 0.55.0-dev.7

package/src/rlc-common/metadata/build-ts-config.ts

@@ -0,0 +1,177 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+import { Project } from "ts-morph";
+import { RLCModel } from "../interfaces.js";
+
+/**
+ * Builds the root tsconfig.json.
+ *
+ * Emits project references pointing into the `config/` subfolder
+ * (following the eng/tsconfigs pattern).
+ */
+export function buildTsConfig(model: RLCModel) {
+  const { generateTest, generateSample, generateReactNativeTarget } = model.options || {};
+  const project = new Project({ useInMemoryFileSystem: true });
+
+  const references: { path: string }[] = [
+    { path: "./config/tsconfig.src.esm.json" },
+    { path: "./config/tsconfig.src.browser.json" },
+  ];
+
+  if (generateReactNativeTarget) {
+    references.push({ path: "./config/tsconfig.src.react-native.json" });
+  }
+
+  references.push({ path: "./config/tsconfig.src.cjs.json" });
+
+  if (generateTest) {
+    references.push(
+      { path: "./config/tsconfig.test.node.json" },
+      { path: "./config/tsconfig.test.browser.json" },
+    );
+  }
+
+  if (generateSample) {
+    references.push({ path: "./config/tsconfig.samples.json" });
+  }
+
+  if (generateTest) {
+    references.push({ path: "./config/tsconfig.snippets.json" });
+  }
+
+  const tsConfig = { references, files: [] };
+
+  const filePath = "tsconfig.json";
+  const configFile = project.createSourceFile(filePath, JSON.stringify(tsConfig, null, 2), {
+    overwrite: true,
+  });
+  return {
+    path: filePath,
+    content: configFile.getFullText(),
+  };
+}
+
+/**
+ * Builds config/tsconfig.src.esm.json — extends eng/tsconfigs/src.esm.json
+ */
+export function buildTsSrcEsmConfig() {
+  return {
+    path: "config/tsconfig.src.esm.json",
+    content: JSON.stringify(
+      {
+        extends: "../../../../eng/tsconfigs/src.esm.json",
+        include: ["../src/index.ts"],
+      },
+      null,
+      2,
+    ),
+  };
+}
+
+/**
+ * Builds config/tsconfig.src.browser.json — extends eng/tsconfigs/src.browser.json
+ */
+export function buildTsSrcBrowserConfig() {
+  return {
+    path: "config/tsconfig.src.browser.json",
+    content: JSON.stringify(
+      {
+        extends: "../../../../eng/tsconfigs/src.browser.json",
+        include: ["../src/index.ts"],
+      },
+      null,
+      2,
+    ),
+  };
+}
+
+/**
+ * Builds config/tsconfig.src.react-native.json — extends eng/tsconfigs/src.react-native.json
+ */
+export function buildTsSrcReactNativeConfig() {
+  return {
+    path: "config/tsconfig.src.react-native.json",
+    content: JSON.stringify(
+      {
+        extends: "../../../../eng/tsconfigs/src.react-native.json",
+        include: ["../src/index.ts"],
+      },
+      null,
+      2,
+    ),
+  };
+}
+
+/**
+ * Builds config/tsconfig.src.cjs.json — extends eng/tsconfigs/src.cjs.json
+ */
+export function buildTsSrcCjsConfig() {
+  return {
+    path: "config/tsconfig.src.cjs.json",
+    content: JSON.stringify(
+      {
+        extends: "../../../../eng/tsconfigs/src.cjs.json",
+        include: ["../src/index.ts"],
+      },
+      null,
+      2,
+    ),
+  };
+}
+
+/**
+ * Builds config/tsconfig.samples.json — extends eng/tsconfigs/samples.json
+ */
+export function buildTsSampleConfig(model: RLCModel) {
+  const { packageDetails } = model.options || {};
+  const clientPackageName = packageDetails?.name ?? "";
+  return {
+    path: "config/tsconfig.samples.json",
+    content: JSON.stringify(
+      {
+        extends: "../../../../eng/tsconfigs/samples.json",
+        compilerOptions: {
+          paths: {
+            [clientPackageName]: ["../dist/esm"],
+          },
+        },
+      },
+      null,
+      2,
+    ),
+  };
+}
+
+/**
+ * Builds config/tsconfig.lint.json — used by eslint.config.mjs for type-aware linting
+ */
+export function buildTsLintConfig() {
+  return {
+    path: "config/tsconfig.lint.json",
+    content: JSON.stringify(
+      {
+        extends: "../../../../tsconfig.json",
+        include: ["../src", "../test"],
+      },
+      null,
+      2,
+    ),
+  };
+}
+
+/**
+ * Builds config/tsconfig.snippets.json — extends eng/tsconfigs/snippets.json
+ */
+export function buildTsSnippetsConfig() {
+  return {
+    path: "config/tsconfig.snippets.json",
+    content: JSON.stringify(
+      {
+        extends: "../../../../eng/tsconfigs/snippets.json",
+      },
+      null,
+      2,
+    ),
+  };
+}

package/src/rlc-common/metadata/build-warp-config.ts

@@ -0,0 +1,87 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+import { RLCModel } from "../interfaces.js";
+
+export interface WarpConfigOptions {
+  /** Source-level exports, e.g. { ".": "./src/index.ts", "./models": "./src/models/index.ts" } */
+  exports?: Record<string, string>;
+}
+
+/** Default exports included in every warp config. */
+const BASE_EXPORTS: Record<string, string> = {
+  "./package.json": "./package.json",
+  ".": "./src/index.ts",
+};
+
+/** Full inline warp config template with react-native target. */
+const WarpConfigTemplateWithReactNative = `# warp.config.yml — build configuration
+
+exports:
+{{exports}}
+
+targets:
+  - name: browser
+    tsconfig: "./config/tsconfig.src.browser.json"
+
+  - name: react-native
+    tsconfig: "./config/tsconfig.src.react-native.json"
+
+  - name: esm
+    condition: import
+    tsconfig: "./config/tsconfig.src.esm.json"
+
+  - name: commonjs
+    condition: require
+    tsconfig: "./config/tsconfig.src.cjs.json"
+    moduleType: commonjs
+`;
+
+/** Warp config template without react-native target (default). */
+const WarpConfigTemplateDefault = `# warp.config.yml — build configuration
+
+exports:
+{{exports}}
+
+targets:
+  - name: browser
+    tsconfig: "./config/tsconfig.src.browser.json"
+
+  - name: esm
+    condition: import
+    tsconfig: "./config/tsconfig.src.esm.json"
+
+  - name: commonjs
+    condition: require
+    tsconfig: "./config/tsconfig.src.cjs.json"
+    moduleType: commonjs
+`;
+
+/**
+ * Builds a self-contained warp.config.yml file.
+ *
+ * Emits a full inline config with all exports and targets.
+ * Polyfill resolution (browser/react-native file substitution) is handled
+ * via package.json `imports` subpath imports (#platform/*).
+ *
+ * By default, react-native target is NOT included. Set `generateReactNativeTarget: true`
+ * in options to include it.
+ */
+export function buildWarpConfig(model: RLCModel, { exports }: WarpConfigOptions = {}) {
+  const allExports: Record<string, string> = {
+    ...BASE_EXPORTS,
+    ...exports,
+  };
+
+  const exportsContent = Object.entries(allExports)
+    .map(([key, value]) => `  ${JSON.stringify(key)}: ${JSON.stringify(value)}`)
+    .join("\n");
+
+  const template = model.options?.generateReactNativeTarget
+    ? WarpConfigTemplateWithReactNative
+    : WarpConfigTemplateDefault;
+
+  const content = template.replace("{{exports}}", exportsContent);
+
+  return { path: "warp.config.yml", content };
+}

package/src/rlc-common/metadata/package-json/azure-package-common.ts

@@ -0,0 +1,20 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+import { PackageCommonInfoConfig } from "./package-common.js";
+
+export interface AzurePackageInfoConfig extends PackageCommonInfoConfig {
+  hasLro: boolean;
+}
+
+/**
+ * Build the common package.json config for an Azure package.
+ */
+export function getAzureCommonPackageInfo(_config: AzurePackageInfoConfig) {
+  return {
+    keywords: ["node", "azure", "cloud", "typescript", "browser", "isomorphic"],
+    author: "Microsoft Corporation",
+    license: "MIT",
+    files: ["dist/", "!dist/**/*.d.*ts.map", "README.md", "LICENSE"],
+  };
+}

package/src/rlc-common/metadata/package-json/build-azure-monorepo-package.ts

@@ -0,0 +1,180 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+import { AzurePackageInfoConfig, getAzureCommonPackageInfo } from "./azure-package-common.js";
+import { getCommonPackageScripts, getPackageCommonInfo } from "./package-common.js";
+
+export interface AzureMonorepoInfoConfig extends AzurePackageInfoConfig {
+  monorepoPackageDirectory?: string;
+  clientFilePaths: string[];
+  clientContextPaths?: string[];
+}
+
+/**
+ * Builds the package.json for an Azure package that will be hosted in the azure-sdk-for-js mono repo.
+ */
+export function buildAzureMonorepoPackage(config: AzureMonorepoInfoConfig) {
+  const packageInfo = {
+    ...getAzureMonorepoPackageInfo(config),
+    ...getAzureMonorepoDependencies(config),
+    scripts: getAzureMonorepoScripts(config),
+    ...getSampleMetadata(config),
+  };
+
+  return packageInfo;
+}
+
+/**
+ * Builds the dependencies for an Azure package that will be hosted in the azure-sdk-for-js mono repo.
+ */
+export function getAzureMonorepoDependencies(config: AzureMonorepoInfoConfig) {
+  const { hasLro, dependencies, withTests } = config;
+
+  // revert this change after sdk repo update.
+  const runtimeDeps = {
+    ...dependencies,
+    "@azure-rest/core-client": "^2.3.1",
+    ...(hasLro && {
+      "@azure/abort-controller": "^2.1.2",
+    }),
+    "@azure/core-auth": "^1.9.0",
+    ...(hasLro && {
+      "@azure/core-lro": "^3.1.0",
+    }),
+    "@azure/core-rest-pipeline": "^1.20.0",
+    "@azure/core-util": "^1.12.0",
+    "@azure/logger": "^1.2.0",
+    tslib: "^2.8.1",
+  };
+
+  const testDeps = withTests
+    ? {
+        "@vitest/browser-playwright": "catalog:testing",
+        "@vitest/coverage-istanbul": "catalog:testing",
+        dotenv: "catalog:testing",
+        playwright: "catalog:testing",
+        typescript: "catalog:",
+        vitest: "catalog:testing",
+      }
+    : {
+        typescript: "catalog:",
+      };
+
+  return {
+    dependencies: runtimeDeps,
+    devDependencies: {
+      "@azure-tools/test-credential": "workspace:^",
+      "@azure-tools/test-recorder": "workspace:^",
+      "@azure-tools/test-utils-vitest": "workspace:^",
+      "@azure/dev-tool": "workspace:^",
+      "@azure/eslint-plugin-azure-sdk": "workspace:^",
+      "@azure/identity": "catalog:internal",
+      "@types/node": "catalog:",
+      "cross-env": "catalog:",
+      eslint: "catalog:",
+      prettier: "catalog:",
+      rimraf: "catalog:",
+      ...testDeps,
+    },
+  };
+}
+
+/**
+ * Build the common package.json config for an Azure package that will be hosted in the azure-sdk-for-js mono repo.
+ */
+export function getAzureMonorepoPackageInfo(config: AzureMonorepoInfoConfig): Record<string, any> {
+  const commonPackageInfo = getPackageCommonInfo(config);
+  const repositoryDirectory = config.monorepoPackageDirectory ?? "sdk/";
+
+  return {
+    ...commonPackageInfo,
+    ...getAzureCommonPackageInfo(config),
+    "sdk-type": `${config.azureArm ? "mgmt" : "client"}`,
+    repository: {
+      type: "git",
+      url: "git+https://github.com/Azure/azure-sdk-for-js",
+      directory: repositoryDirectory,
+    },
+    bugs: {
+      url: "https://github.com/Azure/azure-sdk-for-js/issues",
+    },
+    ...(config.monorepoPackageDirectory && {
+      homepage: `https://github.com/Azure/azure-sdk-for-js/tree/main/${config.monorepoPackageDirectory}/README.md`,
+    }),
+    prettier: "@azure/eslint-plugin-azure-sdk/prettier.json",
+    "//metadata": getMetadataInfo(config),
+  };
+}
+
+function getSampleMetadata({ name, version, withSamples }: AzureMonorepoInfoConfig) {
+  if (!withSamples) {
+    return {};
+  }
+
+  let apiRefUrlQueryParameter: string = "";
+  if (version.includes("beta")) {
+    apiRefUrlQueryParameter = "?view=azure-node-preview";
+  }
+
+  return {
+    "//sampleConfiguration": {
+      productName: name,
+      productSlugs: ["azure"],
+      disableDocsMs: true,
+      apiRefLink: `https://learn.microsoft.com/javascript/api/${name}${apiRefUrlQueryParameter}`,
+    },
+  };
+}
+
+function getAzureMonorepoScripts(config: AzureMonorepoInfoConfig) {
+  const esmScripts = getEsmScripts();
+  const skipLinting = config.azureArm && config.isModularLibrary;
+  const buildSampleScripts = config.azureArm
+    ? "tsc -p config/tsconfig.samples.json && dev-tool samples publish -f"
+    : "tsc -p config/tsconfig.samples.json";
+  return {
+    ...getCommonPackageScripts(),
+    "build:samples": config.withSamples ? buildSampleScripts : "echo skipped",
+    "check-format": `prettier --list-different --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore "src/**/*.{ts,cts,mts}" "test/**/*.{ts,cts,mts}" "*.{js,cjs,mjs,json}" ${
+      config.withSamples ? '"samples-dev/*.ts"' : ""
+    }`,
+    clean: "rimraf --glob dist dist-browser dist-esm test-dist temp types *.tgz *.log",
+    "execute:samples": config.withSamples ? "dev-tool samples run samples-dev" : "echo skipped",
+    "extract-api": "rimraf review && dev-tool run extract-api",
+    format: `prettier --write --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore "src/**/*.{ts,cts,mts}" "test/**/*.{ts,cts,mts}" "*.{js,cjs,mjs,json}" ${
+      config.withSamples ? '"samples-dev/*.ts"' : ""
+    }`,
+    "generate:client": "echo skipped",
+    "test:browser": "dev-tool run test:vitest --browser",
+    "lint:fix": skipLinting
+      ? "echo skipped"
+      : "eslint package.json src test --fix --fix-type [problem,suggestion]",
+    lint: skipLinting ? "echo skipped" : "eslint package.json src test",
+    pack: `pnpm pack 2>&1`,
+    ...esmScripts,
+    "update-snippets": "dev-tool run update-snippets",
+  };
+}
+
+function getEsmScripts() {
+  return {
+    build: "npm run clean && dev-tool run build-package && dev-tool run extract-api",
+    "test:node": "dev-tool run test:vitest",
+    test: "tsc -b --noEmit && npm run test:node && npm run test:browser",
+  };
+}
+
+function getMetadataInfo(config: AzureMonorepoInfoConfig) {
+  const metadata: Record<string, any> = {
+    constantPaths: [],
+  };
+  const paths = config.isModularLibrary ? config.clientContextPaths : config.clientFilePaths;
+  for (const path of paths ?? []) {
+    metadata["constantPaths"].push({
+      path: path,
+      prefix: "userAgentInfo",
+    });
+  }
+
+  return metadata;
+}

package/src/rlc-common/metadata/package-json/package-common.ts

@@ -0,0 +1,138 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+export interface PackageCommonInfoConfig {
+  name: string;
+  nameWithoutScope?: string;
+  version: string;
+  description: string;
+  withTests: boolean;
+  withSamples: boolean;
+  exports?: Record<string, any>;
+  dependencies?: Record<string, string>;
+  azureArm?: boolean;
+  isModularLibrary?: boolean;
+  /**
+   * When true, generates React Native build targets (dist/react-native, exports condition).
+   * Defaults to false.
+   */
+  generateReactNativeTarget?: boolean;
+}
+
+/**
+ * Common package.json config for a package.
+ */
+export function getPackageCommonInfo(config: PackageCommonInfoConfig) {
+  const { name, version, description } = config;
+
+  return {
+    name,
+    version,
+    description,
+    engines: {
+      node: ">=20.0.0",
+    },
+    sideEffects: false,
+    autoPublish: false,
+    ...getEntryPointInformation(config),
+  };
+}
+
+function getEntryPointInformation(config: PackageCommonInfoConfig) {
+  // Azure monorepo packages use warp.
+  const result: Record<string, any> = {
+    type: "module",
+    main: "./dist/commonjs/index.js",
+    module: "./dist/esm/index.js",
+    types: "./dist/commonjs/index.d.ts",
+    browser: "./dist/browser/index.js",
+    imports: {
+      "#platform/*": {
+        browser: "./src/*-browser.mts",
+        default: "./src/*.ts",
+      } as Record<string, string>,
+    },
+    exports: resolveWarpExports(config.exports, config.generateReactNativeTarget),
+  };
+
+  if (config.generateReactNativeTarget) {
+    result["react-native"] = "./dist/react-native/index.js";
+    (result["imports"]["#platform/*"] as Record<string, string>)["react-native"] =
+      "./src/*-react-native.mts";
+    // Reorder so react-native comes before default
+    const importsEntry = result["imports"]["#platform/*"] as Record<string, string>;
+    result["imports"]["#platform/*"] = {
+      browser: importsEntry["browser"],
+      "react-native": importsEntry["react-native"],
+      default: importsEntry["default"],
+    };
+  }
+
+  return result;
+}
+
+/**
+ * Resolve source-level exports to dist-level exports for warp.
+ * Converts { ".": "./src/index.ts" } to the nested condition map with
+ * browser/import/require conditions pointing to dist/ paths.
+ */
+export function resolveWarpExports(
+  sourceExports?: Record<string, any>,
+  includeReactNative?: boolean,
+): Record<string, any> {
+  const exports: Record<string, any> = {};
+  const allExports: Record<string, string> = {
+    "./package.json": "./package.json",
+    ".": "./src/index.ts",
+    ...sourceExports,
+  };
+
+  for (const [subpath, sourcePath] of Object.entries(allExports)) {
+    // Pass-through entries (e.g. "./package.json": "./package.json")
+    if (!/\.ts$/.test(sourcePath)) {
+      exports[subpath] = sourcePath;
+      continue;
+    }
+
+    // Convert source path to dist path: "./src/foo/index.ts" -> "foo/index"
+    const relPath = sourcePath.replace(/^\.\/src\//, "").replace(/\.ts$/, "");
+
+    const exportEntry: Record<string, any> = {
+      browser: {
+        types: `./dist/browser/${relPath}.d.ts`,
+        default: `./dist/browser/${relPath}.js`,
+      },
+    };
+
+    if (includeReactNative) {
+      exportEntry["react-native"] = {
+        types: `./dist/react-native/${relPath}.d.ts`,
+        default: `./dist/react-native/${relPath}.js`,
+      };
+    }
+
+    exportEntry["import"] = {
+      types: `./dist/esm/${relPath}.d.ts`,
+      default: `./dist/esm/${relPath}.js`,
+    };
+
+    exportEntry["require"] = {
+      types: `./dist/commonjs/${relPath}.d.ts`,
+      default: `./dist/commonjs/${relPath}.js`,
+    };
+
+    exports[subpath] = exportEntry;
+  }
+
+  return exports;
+}
+
+export function getCommonPackageScripts() {
+  return {
+    clean: "rimraf --glob dist dist-browser dist-esm test-dist temp types *.tgz *.log",
+    "extract-api": "rimraf review && mkdirp ./review && api-extractor run --local",
+    pack: "npm pack 2>&1",
+    lint: "eslint package.json api-extractor.json src",
+    "lint:fix": "eslint package.json api-extractor.json src --fix --fix-type [problem,suggestion]",
+  };
+}