create-react-admin-template 0.0.0-stage → 0.1.0

package/template/tools/component-governance/manifest.json

@@ -0,0 +1,112 @@
+{
+  "schemaVersion": 1,
+  "components": [
+    {
+      "name": "AppPageForm",
+      "localPath": "src/components/AppPageForm",
+      "publicEntry": "src/components/AppPageForm/index.ts",
+      "sourceNote": "src/components/AppPageForm/SOURCE.md",
+      "source": {
+        "repository": "frontend/package/page-form",
+        "revision": "d18a96435fa48724763026b4c95d207a61935efa",
+        "packageVersion": "0.1.0",
+        "importedAt": "2026-08-26",
+        "includedPaths": ["packages/core/src", "packages/react/src"],
+        "excludedCapabilities": [
+          "Vue adapter",
+          "examples",
+          "publishing configuration",
+          "repository tooling"
+        ],
+        "license": {
+          "status": "not-provided",
+          "distributionPolicy": "internal-only"
+        }
+      },
+      "localAdaptations": [
+        "flattened core/react package layers into one application component",
+        "uses the application Locale and unsaved-changes providers",
+        "reuses the global FileUpload and UI primitives"
+      ],
+      "regressionTests": [
+        "tests/unit/components/PageFormCore.test.ts",
+        "tests/unit/components/PageForm.test.tsx"
+      ],
+      "requiredCommands": ["pnpm components:check", "pnpm verify"]
+    },
+    {
+      "name": "AppTable",
+      "localPath": "src/components/AppTable",
+      "publicEntry": "src/components/AppTable/index.ts",
+      "sourceNote": "src/components/AppTable/SOURCE.md",
+      "source": {
+        "repository": "frontend/package/table-component",
+        "revision": "496e8740933c7748ce22bc1ad05499ee1e9ba7ec",
+        "packageVersion": "0.5.13",
+        "importedAt": "2026-09-02",
+        "includedPaths": ["packages/core/src", "packages/react/src"],
+        "excludedCapabilities": [
+          "Vue adapter",
+          "examples",
+          "publishing configuration",
+          "copied shadcn primitives",
+          "repository tooling"
+        ],
+        "license": {
+          "status": "not-provided",
+          "distributionPolicy": "internal-only"
+        }
+      },
+      "localAdaptations": [
+        "keeps framework-independent behavior in engine",
+        "groups React code by table domain instead of package layers",
+        "reuses global UI primitives and the central Handsontable license resolver",
+        "retains reactive Locale messages, sensitive columns and unsaved-changes protection",
+        "uses application Tailwind Preflight instead of package-only base.css; omits unused controlled-settings builder",
+        "commits layout callback refs in layout effects and tracks height readiness in React state"
+      ],
+      "regressionTests": [
+        "tests/unit/components/AppTable.test.tsx",
+        "tests/unit/components/AppTableLocalization.test.ts",
+        "tests/unit/components/TableComponent.test.tsx",
+        "tests/unit/components/AppTableUpgrade.test.tsx",
+        "tests/unit/components/AppTableUpgradeCore.test.ts",
+        "tests/unit/components/AppTableLayoutTransition.test.ts",
+        "tests/unit/config/appTableContracts.test.mjs",
+        "tests/unit/config/viteConfig.test.mjs"
+      ],
+      "requiredCommands": ["pnpm components:check", "pnpm verify"]
+    }
+  ],
+  "thirdParty": [
+    {
+      "packageName": "handsontable",
+      "expectedVersion": "18.0.0",
+      "expectedLicense": "SEE LICENSE IN LICENSE.txt",
+      "licenseFile": "LICENSE.txt",
+      "usedBy": ["AppTable"],
+      "productionPolicy": "commercial-key-required",
+      "policyEvidence": [
+        {
+          "path": "build/advancedTable.ts",
+          "markers": ["APP_TABLE_LICENSE_REQUIRED", "APP_TABLE_EAGER_LOAD"]
+        },
+        {
+          "path": "tests/unit/config/viteConfig.test.mjs",
+          "markers": [
+            "production does not silently accept the Handsontable evaluation license"
+          ]
+        }
+      ]
+    },
+    {
+      "packageName": "exceljs",
+      "expectedVersion": "4.4.0",
+      "expectedLicense": "MIT",
+      "licenseFile": "LICENSE",
+      "usedBy": ["AppTable"],
+      "productionPolicy": "retain-license-notice",
+      "policyEvidence": []
+    }
+  ]
+}

package/template/tools/deployment/browser-smoke.mjs

@@ -0,0 +1,76 @@
+import { mkdir, writeFile } from 'node:fs/promises'
+import path from 'node:path'
+import { chromium } from 'playwright'
+
+const nNavigationTimeout = 15_000
+
+const fnFail = (strCode, strMessage) => {
+  throw new TypeError(`[${strCode}] ${strMessage}`)
+}
+
+const fnValidateTargetUrl = (strValue) => {
+  let objUrl
+  try {
+    objUrl = new URL(strValue)
+  } catch {
+    fnFail(
+      'DEPLOY_BROWSER_SMOKE_ARGUMENT_INVALID',
+      '请提供有效的候选应用 URL。'
+    )
+  }
+  if (!['http:', 'https:'].includes(objUrl.protocol)) {
+    fnFail(
+      'DEPLOY_BROWSER_SMOKE_ARGUMENT_INVALID',
+      '候选应用 URL 必须使用 HTTP 或 HTTPS。'
+    )
+  }
+  return objUrl.href
+}
+
+const fnWriteDom = async (strOutputFile, strDom) => {
+  if (!strOutputFile) return
+  await mkdir(path.dirname(path.resolve(strOutputFile)), { recursive: true })
+  await writeFile(strOutputFile, strDom, 'utf8')
+}
+
+const fnRun = async () => {
+  const strTargetUrl = fnValidateTargetUrl(process.argv[2] ?? '')
+  const strOutputFile = process.argv[3]
+  const objBrowser = await chromium.launch({ headless: true })
+
+  try {
+    const objPage = await objBrowser.newPage()
+    const objResponse = await objPage.goto(strTargetUrl, {
+      timeout: nNavigationTimeout,
+      waitUntil: 'domcontentloaded',
+    })
+
+    if (!objResponse?.ok()) {
+      fnFail(
+        'DEPLOY_BROWSER_SMOKE_NAVIGATION_FAILED',
+        `候选应用返回 HTTP ${objResponse?.status() ?? 'unknown'}。`
+      )
+    }
+
+    try {
+      await objPage.locator('form').first().waitFor({
+        state: 'visible',
+        timeout: nNavigationTimeout,
+      })
+    } catch {
+      const strDom = await objPage.content()
+      await fnWriteDom(strOutputFile, strDom)
+      fnFail(
+        'DEPLOY_BROWSER_SMOKE_APP_NOT_READY',
+        '候选应用没有渲染登录表单；请检查 Runtime Config、React 启动、路由和静态资源。'
+      )
+    }
+
+    await fnWriteDom(strOutputFile, await objPage.content())
+    process.stdout.write(`候选应用浏览器冒烟通过：${strTargetUrl}\n`)
+  } finally {
+    await objBrowser.close()
+  }
+}
+
+await fnRun()

package/template/tools/deployment/browser-smoke.sh

@@ -0,0 +1,141 @@
+#!/bin/sh
+
+set -eu
+
+strTargetUrl=${1:-}
+strOutputFile=${2:-}
+strBrowserPath=${BROWSER_EXECUTABLE_PATH:-}
+bRemoveOutput=false
+nBrowserPid=
+nWatchdogPid=
+strBrowserLog=
+strTimeoutMarker=
+
+fnFail() {
+  strCode=$1
+  strMessage=$2
+  printf '[%s] %s\n' "$strCode" "$strMessage" >&2
+  exit 1
+}
+
+if [ -z "$strTargetUrl" ]; then
+  fnFail \
+    'DEPLOY_BROWSER_SMOKE_ARGUMENT_INVALID' \
+    '请提供候选应用 URL，例如 http://127.0.0.1/sign-in。'
+fi
+
+case "$strTargetUrl" in
+  http://* | https://*) ;;
+  *)
+    fnFail \
+      'DEPLOY_BROWSER_SMOKE_ARGUMENT_INVALID' \
+      '候选应用 URL 必须使用 HTTP 或 HTTPS。'
+    ;;
+esac
+
+if [ -z "$strBrowserPath" ]; then
+  strBrowserPath=$(find /ms-playwright -type f \
+    \( -name headless_shell -o -path '*/chrome-linux/chrome' \) \
+    -perm -111 2>/dev/null | head -n 1 || true)
+fi
+
+if [ -z "$strBrowserPath" ] || [ ! -x "$strBrowserPath" ]; then
+  fnFail \
+    'DEPLOY_BROWSER_SMOKE_BROWSER_MISSING' \
+    '没有找到可执行的 Chromium；请设置 BROWSER_EXECUTABLE_PATH。'
+fi
+
+if [ -z "$strOutputFile" ]; then
+  strOutputFile=$(mktemp)
+  bRemoveOutput=true
+else
+  mkdir -p "$(dirname "$strOutputFile")"
+fi
+
+strBrowserProfile=$(mktemp -d)
+strBrowserLog=$(mktemp)
+strTimeoutMarker=$(mktemp)
+rm -f "$strTimeoutMarker"
+
+fnCleanup() {
+  if [ -n "$nWatchdogPid" ]; then
+    kill "$nWatchdogPid" 2>/dev/null || true
+  fi
+  if [ -n "$nBrowserPid" ]; then
+    kill "$nBrowserPid" 2>/dev/null || true
+  fi
+  rm -rf "$strBrowserProfile"
+  rm -f "$strBrowserLog" "$strTimeoutMarker"
+  if [ "$bRemoveOutput" = true ]; then
+    rm -f "$strOutputFile"
+  fi
+}
+
+fnHandleSignal() {
+  fnCleanup
+  exit 130
+}
+
+trap fnCleanup EXIT
+trap fnHandleSignal HUP INT TERM
+
+"$strBrowserPath" \
+  --headless \
+  --no-sandbox \
+  --disable-background-networking \
+  --disable-component-update \
+  --disable-default-apps \
+  --disable-dev-shm-usage \
+  --disable-gpu \
+  --disable-sync \
+  --metrics-recording-only \
+  --no-first-run \
+  --safebrowsing-disable-auto-update \
+  --user-data-dir="$strBrowserProfile" \
+  --timeout=10000 \
+  --dump-dom \
+  "$strTargetUrl" > "$strOutputFile" 2> "$strBrowserLog" &
+nBrowserPid=$!
+
+(
+  sleep 20
+  if kill -0 "$nBrowserPid" 2>/dev/null; then
+    : > "$strTimeoutMarker"
+    kill "$nBrowserPid" 2>/dev/null || true
+    sleep 2
+    kill -9 "$nBrowserPid" 2>/dev/null || true
+  fi
+) &
+nWatchdogPid=$!
+
+nBrowserStatus=0
+wait "$nBrowserPid" || nBrowserStatus=$?
+kill "$nWatchdogPid" 2>/dev/null || true
+wait "$nWatchdogPid" 2>/dev/null || true
+nBrowserPid=
+nWatchdogPid=
+
+if grep -Eq '<form([[:space:]>])' "$strOutputFile"; then
+  printf '候选应用浏览器冒烟通过：%s\n' "$strTargetUrl"
+  exit 0
+fi
+
+if [ -f "$strTimeoutMarker" ]; then
+  fnFail \
+    'DEPLOY_BROWSER_SMOKE_TIMEOUT' \
+    'Chromium 在 20 秒内没有完成候选应用检查。'
+fi
+
+if [ "$nBrowserStatus" -ne 0 ]; then
+  sed -n '1,80p' "$strBrowserLog" >&2
+  fnFail \
+    'DEPLOY_BROWSER_SMOKE_NAVIGATION_FAILED' \
+    'Chromium 无法完成候选应用导航。'
+fi
+
+printf '%s\n' \
+  '[DEPLOY_BROWSER_SMOKE_APP_NOT_READY] 候选应用没有渲染登录表单。' \
+  'runtime-config.json 可能不符合应用契约，或 React 启动、路由和静态资源加载失败。' >&2
+printf '%s\n' '候选页面 DOM（最多 120 行）：' >&2
+sed -n '1,120p' "$strOutputFile" >&2
+exit 1

package/template/tools/openapi/generate.mjs

@@ -0,0 +1,268 @@
+import { loadEnv } from 'vite'
+import axios from 'axios'
+import { mkdir, mkdtemp, readFile, rename, rm } from 'node:fs/promises'
+import https from 'node:https'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { generateApi } from 'swagger-typescript-api'
+
+const strCurrentDir = path.dirname(fileURLToPath(import.meta.url))
+const strProjectRoot = path.resolve(strCurrentDir, '../..')
+
+const fnReadArg = (strName) => {
+  const nIndex = process.argv.indexOf(`--${strName}`)
+  return nIndex >= 0 ? process.argv[nIndex + 1] : undefined
+}
+
+const strMode = fnReadArg('mode') || process.env.NODE_ENV || 'development'
+const objEnv = loadEnv(strMode, strProjectRoot, '')
+const strRequestedName = fnReadArg('name')
+const strExplicitUrl = fnReadArg('url')
+const objServiceNamePattern = /^[a-z][a-z0-9-]*$/
+const objEnvNamePattern = /^VITE_[A-Z0-9_]+$/
+const strServiceConfigPath = path.resolve(
+  strProjectRoot,
+  'src/api/config/services.json'
+)
+const strOutputRoot = path.resolve(strProjectRoot, 'src/api/generated')
+const nOpenApiRequestTimeoutMs = 30_000
+
+const fnAssertHttpUrl = (strUrl, strLabel) => {
+  if (!/^https?:\/\//i.test(strUrl)) {
+    throw new Error(`${strLabel} must be an absolute HTTP(S) URL: ${strUrl}`)
+  }
+  return strUrl
+}
+
+const fnJoinUrl = (strBaseUrl, strDocumentPath) => {
+  if (!strBaseUrl) return undefined
+  fnAssertHttpUrl(strBaseUrl, 'API base URL')
+  return `${strBaseUrl.replace(/\/$/, '')}/${strDocumentPath.replace(/^\//, '')}`
+}
+
+const fnToIdentifier = (strValue) => {
+  const arrParts = String(strValue || '')
+    .split(/[^A-Za-z0-9_$]+/)
+    .filter(Boolean)
+  const strIdentifier = arrParts
+    .map((strPart, nIndex) =>
+      nIndex === 0 ? strPart : strPart[0].toUpperCase() + strPart.slice(1)
+    )
+    .join('')
+
+  if (!strIdentifier) return 'request'
+  return /^[A-Za-z_$]/.test(strIdentifier)
+    ? strIdentifier
+    : `request${strIdentifier}`
+}
+
+const fnReadServiceDefinitions = async () => {
+  let arrDefinitions
+  try {
+    arrDefinitions = JSON.parse(await readFile(strServiceConfigPath, 'utf8'))
+  } catch {
+    throw new Error(
+      `Unable to read API service config: ${strServiceConfigPath}`
+    )
+  }
+  if (!Array.isArray(arrDefinitions) || arrDefinitions.length === 0) {
+    throw new Error('API service config must be a non-empty JSON array.')
+  }
+
+  const objServiceNames = new Set()
+  return arrDefinitions.map((objDefinition, nIndex) => {
+    if (
+      !objDefinition ||
+      typeof objDefinition !== 'object' ||
+      Array.isArray(objDefinition)
+    ) {
+      throw new Error(`Invalid API service definition at index ${nIndex}.`)
+    }
+
+    const {
+      name: strName,
+      baseUrlEnv: strBaseUrlEnv = 'VITE_API_BASE_URL',
+      openapiPath: strOpenApiPath,
+    } = objDefinition
+    if (!objServiceNamePattern.test(strName)) {
+      throw new Error(`Invalid API service name: ${strName}`)
+    }
+    if (objServiceNames.has(strName)) {
+      throw new Error(`Duplicate API service name: ${strName}`)
+    }
+    if (!objEnvNamePattern.test(strBaseUrlEnv)) {
+      throw new Error(`Invalid baseUrlEnv for API service "${strName}".`)
+    }
+    if (typeof strOpenApiPath !== 'string' || !strOpenApiPath.startsWith('/')) {
+      throw new Error(
+        `API service "${strName}" requires an absolute openapiPath.`
+      )
+    }
+
+    objServiceNames.add(strName)
+    return {
+      name: strName,
+      baseUrlEnv: strBaseUrlEnv,
+      openapiPath: strOpenApiPath,
+    }
+  })
+}
+
+const arrServiceDefinitions = await fnReadServiceDefinitions()
+const bApiInsecureTls =
+  strMode === 'development' &&
+  objEnv.VITE_DEV_API_INSECURE_TLS?.trim().toLowerCase() === 'true'
+if (strRequestedName && !objServiceNamePattern.test(strRequestedName)) {
+  throw new Error(`Invalid API service name: ${strRequestedName}`)
+}
+if (strExplicitUrl && !strRequestedName) {
+  throw new Error('--url must be used together with --name.')
+}
+
+const arrSelectedDefinitions = strRequestedName
+  ? arrServiceDefinitions.filter(
+      (objDefinition) => objDefinition.name === strRequestedName
+    )
+  : arrServiceDefinitions
+if (arrSelectedDefinitions.length === 0) {
+  throw new Error(`API service is not configured: ${strRequestedName}`)
+}
+
+const arrTargets = arrSelectedDefinitions.map((objDefinition) => {
+  const strBaseUrl = objEnv[objDefinition.baseUrlEnv]?.trim()
+  const strSchemaUrl = strExplicitUrl
+    ? fnAssertHttpUrl(strExplicitUrl, 'OpenAPI schema URL')
+    : fnJoinUrl(strBaseUrl, objDefinition.openapiPath)
+  if (!strSchemaUrl) {
+    throw new Error(
+      `${objDefinition.baseUrlEnv} is required for API service "${objDefinition.name}" in mode "${strMode}".`
+    )
+  }
+  return { ...objDefinition, schemaUrl: strSchemaUrl }
+})
+
+const fnReadOpenApiSpec = async (strSchemaUrl) => {
+  const objHttpsAgent =
+    bApiInsecureTls && strSchemaUrl.startsWith('https://')
+      ? new https.Agent({ rejectUnauthorized: false })
+      : undefined
+  try {
+    process.stdout.write(
+      `Downloading ${strSchemaUrl}${objHttpsAgent ? ' with development TLS verification disabled' : ''}.\n`
+    )
+    const objResponse = await axios.get(strSchemaUrl, {
+      httpsAgent: objHttpsAgent,
+      timeout: nOpenApiRequestTimeoutMs,
+    })
+    return objResponse.data
+  } finally {
+    objHttpsAgent?.destroy()
+  }
+}
+
+const objCommonOptions = {
+  templates: path.resolve(strCurrentDir, 'templates/default'),
+  httpClientType: 'axios',
+  defaultResponseAsSuccess: false,
+  generateRouteTypes: false,
+  generateResponses: false,
+  toJS: false,
+  extractRequestParams: false,
+  extractRequestBody: false,
+  unwrapResponseData: true,
+  prettier: {
+    printWidth: 120,
+    tabWidth: 2,
+    trailingComma: 'all',
+    parser: 'typescript',
+  },
+  hooks: {
+    onFormatRouteName: (objRouteInfo) => {
+      if (objRouteInfo.operationId) {
+        return fnToIdentifier(objRouteInfo.operationId)
+      }
+      if (!objRouteInfo.route) return 'request'
+      const strRouteName = `${objRouteInfo.route}/${objRouteInfo.method}`
+        .split('/')
+        .filter(Boolean)
+        .map((strPart, nIndex) => {
+          const strNormalized = strPart.replace(/\$|{|}|-/g, '')
+          return nIndex === 0
+            ? strNormalized
+            : strNormalized[0].toUpperCase() + strNormalized.slice(1)
+        })
+        .join('')
+      return fnToIdentifier(strRouteName)
+    },
+  },
+  defaultResponseType: 'void',
+  singleHttpClient: false,
+  cleanOutput: true,
+  enumNamesAsValues: false,
+  generateUnionEnums: false,
+}
+
+const fnReplaceDirectory = async (strPreparedPath, strDestinationPath) => {
+  const strBackupPath = `${strDestinationPath}.backup-${process.pid}`
+  let bHasBackup = false
+
+  try {
+    await rename(strDestinationPath, strBackupPath)
+    bHasBackup = true
+  } catch (objError) {
+    if (objError?.code !== 'ENOENT') throw objError
+  }
+
+  try {
+    await rename(strPreparedPath, strDestinationPath)
+  } catch (objError) {
+    if (bHasBackup) await rename(strBackupPath, strDestinationPath)
+    throw objError
+  }
+
+  if (bHasBackup) {
+    await rm(strBackupPath, { recursive: true, force: true })
+  }
+}
+
+const arrPreparedTargets = await Promise.all(
+  arrTargets.map(async (objTarget) => ({
+    ...objTarget,
+    spec: await fnReadOpenApiSpec(objTarget.schemaUrl),
+  }))
+)
+const strOutputParent = path.dirname(strOutputRoot)
+await mkdir(strOutputParent, { recursive: true })
+const strTemporaryRoot = await mkdtemp(
+  path.resolve(strOutputParent, '.generated-')
+)
+
+try {
+  for (const objTarget of arrPreparedTargets) {
+    const strOutput = path.resolve(strTemporaryRoot, objTarget.name)
+    await generateApi({
+      ...objCommonOptions,
+      fileName: 'Api.ts',
+      spec: objTarget.spec,
+      output: strOutput,
+      moduleNameFirstTag: false,
+    })
+  }
+
+  if (strRequestedName) {
+    await fnReplaceDirectory(
+      path.resolve(strTemporaryRoot, strRequestedName),
+      path.resolve(strOutputRoot, strRequestedName)
+    )
+  } else {
+    await fnReplaceDirectory(strTemporaryRoot, strOutputRoot)
+  }
+
+  for (const objTarget of arrPreparedTargets) {
+    process.stdout.write(
+      `Generated ${objTarget.name} API client in ${path.resolve(strOutputRoot, objTarget.name)}\n`
+    )
+  }
+} finally {
+  await rm(strTemporaryRoot, { recursive: true, force: true })
+}

package/template/tools/openapi/templates/README.md

@@ -0,0 +1,14 @@
+# swagger-typescript-api
+
+# templates
+
+Templates:
+
+- `api.eta` - Api class module (locations: [default](https://github.com/acacode/swagger-typescript-api/tree/next/templates/default/api.eta), [modular](https://github.com/acacode/swagger-typescript-api/tree/next/templates/modular/api.eta))
+- `data-contracts.eta` - all types (data contracts) from swagger schema (locations: [base](https://github.com/acacode/swagger-typescript-api/tree/next/templates/base/data-contracts.eta))
+- `http-client.eta` - HttpClient class module (locations: [base](https://github.com/acacode/swagger-typescript-api/tree/next/templates/base/http-client.eta))
+- `procedure-call.eta` - route in Api class (locations: [default](https://github.com/acacode/swagger-typescript-api/tree/next/templates/default/procedure-call.eta), [modular](https://github.com/acacode/swagger-typescript-api/tree/next/templates/modular/procedure-call.eta))
+- `route-docs.eta` - documentation for route in Api class (locations: [base](https://github.com/acacode/swagger-typescript-api/tree/next/templates/base/route-docs.eta))
+- `route-name.eta` - route name for route in Api class (locations: [base](https://github.com/acacode/swagger-typescript-api/tree/next/templates/base/route-name.eta))
+- `route-type.eta` - _(`--route-types` option)_ (locations: [base](https://github.com/acacode/swagger-typescript-api/tree/next/templates/base/route-type.eta))
+- `route-types.eta` - _(`--route-types` option)_ (locations: [base](https://github.com/acacode/swagger-typescript-api/tree/next/templates/base/route-types.eta))

package/template/tools/openapi/templates/base/README.md

@@ -0,0 +1,7 @@
+# swagger-typescript-api
+
+# templates/base
+
+This templates use both for multiple api files and single api file
+
+path prefix `@base`

package/template/tools/openapi/templates/base/data-contracts.eta

@@ -0,0 +1,44 @@
+<%
+  const { modelTypes, utils } = it;
+  const { formatDescription, require, _ } = utils;
+  
+
+  const dataContractTemplates = {
+    enum: (contract) => {
+      return `enum ${contract.name} {\r\n${contract.content} \r\n }`;
+    },
+    interface: (contract) => {
+      return `interface ${contract.name} {\r\n${contract.content}}`;
+    },
+    type: (contract) => {
+      return `type ${contract.name} = ${contract.content}`;
+    },
+  }
+
+  const createDescription = (contract) => {
+    if (!contract.typeData) return _.compact([contract.description]);
+
+    return _.compact([
+        contract.description && formatDescription(contract.description),
+        !_.isUndefined(contract.typeData.format) && `@format ${contract.typeData.format}`,
+        !_.isUndefined(contract.typeData.minimum) && `@min ${contract.typeData.minimum}`,
+        !_.isUndefined(contract.typeData.maximum) && `@max ${contract.typeData.maximum}`,
+        !_.isUndefined(contract.typeData.pattern) && `@pattern ${contract.typeData.pattern}`,
+        !_.isUndefined(contract.typeData.example) && `@example ${
+          _.isObject(contract.typeData.example) ? JSON.stringify(contract.typeData.example) : contract.typeData.example
+        }`,
+    ]);
+  }
+%>
+<% modelTypes.forEach((contract) => { %>
+<% const description = createDescription(contract); %>
+<% if (description.length) { %>
+/**
+<%~ description.map(part => `* ${part}`).join("\n") %>
+
+*/
+<% } %>
+export <%~ (dataContractTemplates[contract.typeIdentifier] || dataContractTemplates.type)(contract) %>
+
+
+<% }) %>

package/template/tools/openapi/templates/base/http-client.eta

@@ -0,0 +1,3 @@
+<% const { config } = it; %>
+<% /* https://github.com/acacode/swagger-typescript-api/tree/next/templates/base/http-clients/ */ %>
+<%~ includeFile(`@base/http-clients/${config.httpClientType}-http-client`, it) %>