@h-ai/cli 0.1.0-alpha.15 → 0.1.0-alpha.18

package/templates/apps/fullstack/apps/{{projectName}}-web/messages/zh-CN.json.hbs

@@ -0,0 +1,34 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "page_title": "{name} · Web",
+  "platform_name": "Web",
+  "hero_badge": "Web 工作台",
+  "hero_title": "{name} Web 控制台",
+  "hero_subtitle": "面向浏览器的产品首页，使用本端 messages 管理页面文案，并复用 shared 的 Shell、主题、语言与 API 客户端。",
+  "hero_primary_action": "查看服务状态",
+  "hero_secondary_action": "了解如何自定义",
+  "preview_title": "响应式 Web 体验",
+  "preview_body": "适合官网、控制台与运营后台入口",
+  "preview_metric_shared": "共享组件与 API 客户端",
+  "preview_metric_local": "Web 自有 messages",
+  "preview_metric_theme": "主题可配置",
+  "status_title": "服务联通状态",
+  "status_description": "页面会调用后端服务，确认 contract、service、shared 与 Web 前端已经连通。",
+  "status_online": "{name} 已连接",
+  "status_version": "服务版本",
+  "status_started": "启动时间：{time}",
+  "status_frontends": "服务声明的前端：{list}",
+  "status_frontends_count": "{count} 个前端目标",
+  "custom_shared_title": "共享层放通用能力",
+  "custom_shared_body": "把跨端一致的 Shell、主题、语言切换、API client 与通用组件放在 packages/{{projectName}}-shared。",
+  "custom_local_title": "Web 层放产品文案",
+  "custom_local_body": "Web 独有页面文案写在 apps/{{projectName}}-web/messages，再由本端 project.inlang 编译。",
+  "flow_title": "协同边界",
+  "flow_contract": "Contract 定义接口真相源",
+  "flow_service": "Service 实现业务接口",
+  "flow_shared": "Shared 提供跨端 UI/API 能力",
+  "flow_frontend": "Web 组合页面与本端文案"
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/package.json.hbs

@@ -0,0 +1,50 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+{
+  "name": "{{projectName}}-web",
+  "type": "module",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "paraglide:compile": "paraglide-js compile --project ./project.inlang --outdir ./src/lib/paraglide",
+    "paraglide:watch": "paraglide-js compile --project ./project.inlang --outdir ./src/lib/paraglide --watch",
+    "dev": "vite dev --host 127.0.0.1 --port {{fullstack.ports.web}}",
+    "build": "vite build",
+    "preview": "vite preview --host 127.0.0.1 --port {{fullstack.ports.web}} --strictPort",
+    "typecheck": "pnpm paraglide:compile && svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rimraf .svelte-kit build .turbo src/lib/paraglide"
+  },
+  "dependencies": {
+    "@h-ai/api-client": "{{fullstack.versions.apiClient}}",
+    "@h-ai/ui": "{{fullstack.versions.ui}}",
+    "{{fullstack.contractPackageName}}": "workspace:*",
+    "{{fullstack.sharedPackageName}}": "workspace:*"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "{{fullstack.versions.antfuEslintConfig}}",
+    "@iconify-json/tabler": "{{fullstack.versions.iconifyJsonTabler}}",
+    "@iconify/tailwind4": "{{fullstack.versions.iconifyTailwind}}",
+    "@inlang/paraglide-js": "{{fullstack.versions.inlangParaglide}}",
+    "@inlang/plugin-message-format": "{{fullstack.versions.inlangMessageFormat}}",
+    "@sveltejs/adapter-auto": "{{fullstack.versions.adapterAuto}}",
+    "@sveltejs/kit": "{{fullstack.versions.svelteKit}}",
+    "@sveltejs/vite-plugin-svelte": "{{fullstack.versions.sveltePlugin}}",
+    "@tailwindcss/vite": "{{fullstack.versions.tailwindcssVite}}",
+    "bits-ui": "{{fullstack.versions.bitsUi}}",
+    "daisyui": "{{fullstack.versions.daisyui}}",
+    "eslint": "{{fullstack.versions.eslint}}",
+    "eslint-plugin-format": "{{fullstack.versions.eslintPluginFormat}}",
+    "eslint-plugin-svelte": "{{fullstack.versions.eslintPluginSvelte}}",
+    "svelte": "{{fullstack.versions.svelte}}",
+    "svelte-check": "{{fullstack.versions.svelteCheck}}",
+    "svelte-eslint-parser": "{{fullstack.versions.svelteEslintParser}}",
+    "tailwindcss": "{{fullstack.versions.tailwindcss}}",
+    "typescript": "{{fullstack.versions.typescript}}",
+    "vite": "{{fullstack.versions.vite}}",
+    "vitest": "{{fullstack.versions.vitest}}"
+  }
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/project.inlang/settings.json.hbs

@@ -0,0 +1,17 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+{
+  "$schema": "https://inlang.com/schema/project-settings",
+  "baseLocale": "{{fullstack.i18n.baseLocale}}",
+  "locales": [
+    {{#each fullstack.i18n.locales}}"{{this}}"{{#unless @last}},{{/unless}}
+    {{/each}}
+  ],
+  "modules": [
+    "https://cdn.jsdelivr.net/npm/@inlang/plugin-message-format@latest/dist/index.js"
+  ],
+  "plugin.inlang.messageFormat": {
+    "pathPattern": "./messages/{locale}.json"
+  }
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/src/app.css.hbs

@@ -0,0 +1,18 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+@import 'tailwindcss';
+@import '@h-ai/ui/styles/global.css';
+@import '@h-ai/ui/styles/theme.css';
+@source "../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
+@source "../../../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
+@source "../../../packages/{{fullstack.sharedPackageName}}/src/**/*.{svelte,js,ts}";
+
+@plugin "daisyui" {
+  themes:
+    {{#each fullstack.theme.themes}}{{this}}{{#if_eq this ../fullstack.theme.defaultTheme}} --default{{/if_eq}}{{#unless @last}},
+    {{/unless}}{{/each}};
+}
+@plugin "@iconify/tailwind4" {
+  prefixes: tabler;
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/src/app.d.ts.hbs

@@ -0,0 +1,9 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+/// <reference types="@sveltejs/kit" />
+/// <reference types="vite/client" />
+
+import '@h-ai/ui/auto-import'
+
+declare module '*.css'
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/src/app.html.hbs

@@ -0,0 +1,14 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+<!doctype html>
+<html lang="%paraglide.lang%">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    %sveltekit.head%
+  </head>
+  <body data-sveltekit-preload-data="hover">
+    <div style="display: contents">%sveltekit.body%</div>
+  </body>
+</html>
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/src/routes/+layout.svelte.hbs

@@ -0,0 +1,18 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+<script lang="ts">
+  import { setLocale } from '$lib/paraglide/runtime.js'
+  import { AppShell } from '{{fullstack.sharedPackageName}}'
+  import '../app.css'
+
+  const { children } = $props()
+
+  function syncLocale(locale: string) {
+    setLocale(locale as Parameters<typeof setLocale>[0])
+  }
+</script>
+
+<AppShell platform="web" onLocaleChange={syncLocale}>
+  {@render children()}
+</AppShell>
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/src/routes/+page.svelte.hbs

@@ -0,0 +1,162 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+<script lang="ts">
+  import type { AppInfo } from '{{fullstack.sharedPackageName}}'
+  import * as appM from '$lib/paraglide/messages.js'
+  import { Alert, Button, Card, Skeleton } from '@h-ai/ui'
+  import { onMount } from 'svelte'
+  import { fetchAppInfo, messages as sharedM } from '{{fullstack.sharedPackageName}}'
+
+  let info = $state<AppInfo | null>(null)
+  let loading = $state(true)
+  let errorMessage = $state('')
+
+  async function refreshStatus() {
+    loading = true
+    errorMessage = ''
+    try {
+      info = await fetchAppInfo()
+    }
+    catch {
+      info = null
+      errorMessage = sharedM.home_error()
+    }
+    finally {
+      loading = false
+    }
+  }
+
+  onMount(() => {
+    void refreshStatus()
+  })
+</script>
+
+<svelte:head>
+  <title>{appM.page_title({ name: sharedM.app_name() })}</title>
+</svelte:head>
+
+<section class="space-y-8">
+  <div class="grid gap-6 lg:grid-cols-[1.2fr_0.8fr]">
+    <section class="relative overflow-hidden rounded-[2rem] border border-base-300/70 bg-gradient-to-br from-primary/15 via-base-100 to-secondary/15 p-6 shadow-2xl shadow-primary/10 lg:p-10">
+      <div class="absolute right-8 top-8 hidden size-28 rounded-full bg-primary/20 blur-3xl sm:block"></div>
+      <div class="relative z-10 max-w-2xl space-y-6">
+        <span class="badge badge-primary badge-lg gap-2">
+          <span class="icon-[tabler--rocket] size-4"></span>
+          {appM.hero_badge()}
+        </span>
+        <div class="space-y-4">
+          <h1 class="text-4xl font-black tracking-tight text-base-content sm:text-5xl">
+            {appM.hero_title({ name: sharedM.app_name() })}
+          </h1>
+          <p class="max-w-xl text-lg leading-8 text-base-content/70">
+            {appM.hero_subtitle()}
+          </p>
+        </div>
+        <div class="flex flex-wrap gap-3">
+          <a class="btn btn-primary shadow-lg shadow-primary/20" href="#status">
+            <span class="icon-[tabler--activity-heartbeat] size-5"></span>
+            {appM.hero_primary_action()}
+          </a>
+          <a class="btn btn-ghost" href="#customize">
+            <span class="icon-[tabler--adjustments] size-5"></span>
+            {appM.hero_secondary_action()}
+          </a>
+        </div>
+      </div>
+    </section>
+
+    <aside class="rounded-[2rem] border border-base-300/70 bg-base-100/80 p-5 shadow-xl backdrop-blur">
+      <div class="mockup-window border border-base-300 bg-base-200/70">
+        <div class="space-y-4 bg-base-100 p-5">
+          <div class="flex items-center justify-between">
+            <div>
+              <p class="text-sm font-semibold">{appM.preview_title()}</p>
+              <p class="text-xs text-base-content/55">{appM.preview_body()}</p>
+            </div>
+            <span class="badge badge-success badge-outline">{appM.platform_name()}</span>
+          </div>
+          <div class="grid gap-3 text-sm">
+            <div class="rounded-2xl bg-primary/10 p-4">
+              <span class="icon-[tabler--components] mb-2 size-6 text-primary"></span>
+              <p class="font-semibold">{appM.preview_metric_shared()}</p>
+            </div>
+            <div class="grid grid-cols-2 gap-3">
+              <div class="rounded-2xl bg-secondary/10 p-4">
+                <span class="icon-[tabler--language] mb-2 size-6 text-secondary"></span>
+                <p class="font-semibold">{appM.preview_metric_local()}</p>
+              </div>
+              <div class="rounded-2xl bg-accent/10 p-4">
+                <span class="icon-[tabler--palette] mb-2 size-6 text-accent"></span>
+                <p class="font-semibold">{appM.preview_metric_theme()}</p>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </aside>
+  </div>
+
+  <div class="grid gap-6 lg:grid-cols-[0.95fr_1.05fr]">
+    <div id="status">
+    <Card title={appM.status_title()} bordered shadow="md" class="bg-base-100/90 backdrop-blur">
+      <p class="mb-5 text-sm text-base-content/65">{appM.status_description()}</p>
+      {#if loading}
+        <Skeleton variant="title" class="mb-3" />
+        <Skeleton count={3} />
+        <p class="sr-only" data-testid="service-status">{sharedM.home_loading()}</p>
+      {:else if info}
+        <Alert variant="success" title={appM.status_online({ name: info.name })}>
+          <p data-testid="service-status">{info.name}</p>
+        </Alert>
+        <dl class="mt-5 grid gap-3 sm:grid-cols-2 text-sm">
+          <div class="rounded-box border border-base-300/70 bg-base-200/60 p-4">
+            <dt class="text-xs text-base-content/55">{appM.status_version()}</dt>
+            <dd class="mt-1 font-semibold">{info.version}</dd>
+          </div>
+          <div class="rounded-box border border-base-300/70 bg-base-200/60 p-4">
+            <dt class="text-xs text-base-content/55">{appM.status_started({ time: info.startedAt })}</dt>
+            <dd class="mt-1 font-semibold">{appM.status_frontends_count({ count: String(info.frontends.length) })}</dd>
+          </div>
+          <div class="rounded-box border border-base-300/70 bg-base-200/60 p-4 sm:col-span-2">
+            <dt class="text-xs text-base-content/55">{appM.status_frontends({ list: info.frontends.join(' / ') })}</dt>
+            <dd class="mt-1 font-semibold">{sharedM.home_subtitle()}</dd>
+          </div>
+        </dl>
+      {:else}
+        <Alert variant="error" title={sharedM.home_error()}>
+          <p data-testid="service-status">{errorMessage}</p>
+        </Alert>
+      {/if}
+
+      <div class="mt-5">
+        <Button type="button" variant="primary" loading={loading} onclick={refreshStatus}>
+          {sharedM.home_refresh()}
+        </Button>
+      </div>
+    </Card>
+    </div>
+
+    <section id="customize" class="grid gap-4 sm:grid-cols-2">
+      <div class="rounded-[1.5rem] border border-base-300/70 bg-base-100/90 p-5 shadow-md">
+        <span class="icon-[tabler--package] mb-4 size-7 text-primary"></span>
+        <h2 class="text-lg font-bold">{appM.custom_shared_title()}</h2>
+        <p class="mt-2 text-sm leading-6 text-base-content/65">{appM.custom_shared_body()}</p>
+      </div>
+      <div class="rounded-[1.5rem] border border-base-300/70 bg-base-100/90 p-5 shadow-md">
+        <span class="icon-[tabler--message-language] mb-4 size-7 text-secondary"></span>
+        <h2 class="text-lg font-bold">{appM.custom_local_title()}</h2>
+        <p class="mt-2 text-sm leading-6 text-base-content/65">{appM.custom_local_body()}</p>
+      </div>
+      <div class="rounded-[1.5rem] border border-base-300/70 bg-base-100/90 p-5 shadow-md sm:col-span-2">
+        <h2 class="text-lg font-bold">{appM.flow_title()}</h2>
+        <ol class="mt-4 grid gap-3 md:grid-cols-4">
+          <li class="rounded-box bg-base-200/70 p-4 text-sm">{appM.flow_contract()}</li>
+          <li class="rounded-box bg-base-200/70 p-4 text-sm">{appM.flow_service()}</li>
+          <li class="rounded-box bg-base-200/70 p-4 text-sm">{appM.flow_shared()}</li>
+          <li class="rounded-box bg-base-200/70 p-4 text-sm">{appM.flow_frontend()}</li>
+        </ol>
+      </div>
+    </section>
+  </div>
+</section>
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/svelte.config.js.hbs

@@ -0,0 +1,20 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+import { autoImportHaiUi } from '@h-ai/ui/auto-import'
+import adapter from '@sveltejs/adapter-auto'
+import { vitePreprocess } from '@sveltejs/vite-plugin-svelte'
+
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+  preprocess: [autoImportHaiUi(), vitePreprocess()],
+  compilerOptions: {
+    // 使用 Svelte 5 Runes，和 @h-ai/ui 组件库保持一致。
+    runes: true,
+  },
+  kit: {
+    adapter: adapter(),
+  },
+}
+
+export default config
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/tests/api.test.ts.hbs

@@ -0,0 +1,28 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+import { fetchAppInfo } from '{{fullstack.sharedPackageName}}'
+import { describe, expect, it } from 'vitest'
+
+describe('fetchAppInfo', () => {
+  it('parses shared contract response', async () => {
+    const fetchFn: typeof fetch = async () => new Response(
+      JSON.stringify({
+        success: true,
+        data: {
+          name: '{{fullstack.servPackageName}}',
+          version: '0.1.0',
+          startedAt: '2026-01-01T00:00:00.000Z',
+          frontends: ['web'],
+        },
+      }),
+      {
+        headers: { 'content-type': 'application/json' },
+      },
+    )
+
+    const info = await fetchAppInfo({ fetchFn, baseUrl: 'http://127.0.0.1:3000' })
+
+    expect(info.name).toBe('{{fullstack.servPackageName}}')
+  })
+})
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/tsconfig.json.hbs

@@ -0,0 +1,17 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+{
+  "extends": "./.svelte-kit/tsconfig.json",
+  "compilerOptions": {
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "allowJs": true,
+    "checkJs": false,
+    "strict": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*", "src/**/*.svelte", "tests/**/*"],
+  "exclude": ["node_modules", ".svelte-kit", "build"]
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/vite.config.ts.hbs

@@ -0,0 +1,29 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+import { paraglideVitePlugin } from '@inlang/paraglide-js'
+import { sveltekit } from '@sveltejs/kit/vite'
+import tailwindcss from '@tailwindcss/vite'
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  plugins: [
+    paraglideVitePlugin({
+      project: './project.inlang',
+      outdir: './src/lib/paraglide',
+      strategy: ['cookie', 'baseLocale'],
+    }),
+    sveltekit(),
+    tailwindcss(),
+  ],
+  optimizeDeps: {
+    exclude: ['bits-ui'],
+  },
+  ssr: {
+    noExternal: [/@h-ai\//, /{{fullstack.sharedPackageName}}/],
+  },
+  test: {
+    environment: 'node',
+    include: ['tests/**/*.test.ts'],
+  },
+})
+{{/if}}

package/templates/apps/fullstack/e2e/fullstack.spec.ts.hbs

@@ -0,0 +1,30 @@
+import { expect, test } from '@playwright/test'
+import { APP_API_ROUTES } from '{{fullstack.contractPackageName}}'
+
+const apiBaseUrl = 'http://127.0.0.1:3000'
+
+test('service health endpoint is ready', async ({ request }) => {
+  const response = await request.get(apiBaseUrl + APP_API_ROUTES.health)
+  expect(response.ok()).toBe(true)
+  await expect(response).toBeOK()
+})
+
+test('service echo endpoint returns HaiResult', async ({ request }) => {
+  const response = await request.post(apiBaseUrl + APP_API_ROUTES.echo, {
+    data: { message: 'hello e2e' },
+  })
+  expect(response.ok()).toBe(true)
+
+  const body = await response.json()
+  expect(body.success).toBe(true)
+  expect(body.data.message).toBe('hello e2e')
+  expect(body.data.requestId).toBeTruthy()
+})
+{{#if fullstack.e2eFrontend}}
+
+test('frontend loads service status from page', async ({ page }) => {
+  await page.goto('/')
+  await expect(page.getByRole('heading', { level: 1 })).toBeVisible()
+  await expect(page.getByTestId('service-status')).toContainText('{{fullstack.servPackageName}}')
+})
+{{/if}}

package/templates/apps/fullstack/eslint.config.js

@@ -0,0 +1,44 @@
+import antfu from '@antfu/eslint-config'
+
+export default antfu({
+  formatters: true,
+  ignores: [
+    '**/.svelte-kit/**',
+    '**/build/**',
+    '**/dist/**',
+    '**/src/lib/paraglide/**',
+    '**/project.inlang/**',
+    '**/*.d.ts',
+    '**/.agents/**',
+    '**/.github/**',
+    '**/AGENTS.md',
+    '**/CLAUDE.md',
+    '**/README.md',
+    '**/opencode.json',
+    '**/package.json',
+  ],
+  svelte: true,
+}, {
+  files: ['**/*.ts', '**/*.svelte'],
+  rules: {
+    'no-console': 'error',
+    'ts/no-explicit-any': 'error',
+  },
+}, {
+  files: ['**/*.svelte'],
+  rules: {
+    'svelte/html-quotes': 'off',
+    'svelte/indent': 'off',
+    'perfectionist/sort-imports': 'off',
+  },
+}, {
+  files: ['**/tsconfig.json', '**/tsconfig.*.json'],
+  rules: {
+    'jsonc/sort-keys': 'off',
+  },
+}, {
+  files: ['**/index.ts'],
+  rules: {
+    'perfectionist/sort-exports': 'off',
+  },
+})

package/templates/apps/fullstack/package.json.hbs

@@ -0,0 +1,42 @@
+{
+  "name": "{{projectName}}",
+  "type": "module",
+  "version": "0.1.0",
+  "private": true,
+  "packageManager": "pnpm@9.15.0",
+  "description": "Full-stack hai workspace with separated contract, service and frontends.",
+  "scripts": {
+    "i18n:compile": "pnpm --filter {{fullstack.sharedPackageName}} paraglide:compile{{#each fullstack.frontendApps}} && pnpm --filter {{packageName}} paraglide:compile{{/each}}",
+    "postinstall": "pnpm i18n:compile",
+    "dev": "pnpm --filter {{fullstack.contractPackageName}} build && pnpm i18n:compile && pnpm --parallel --filter {{fullstack.servPackageName}}{{#each fullstack.frontendApps}} --filter {{packageName}}{{/each}} dev",
+    "build": "pnpm --filter {{fullstack.contractPackageName}} build && pnpm i18n:compile && pnpm -r --if-present build",
+    "typecheck": "pnpm --filter {{fullstack.contractPackageName}} build && pnpm i18n:compile && pnpm -r --if-present typecheck",
+    "lint": "pnpm -r --if-present lint",
+    "test": "pnpm --filter {{fullstack.contractPackageName}} build && pnpm i18n:compile && pnpm -r --if-present test",
+    "test:e2e": "pnpm build && playwright test",
+    "clean": "pnpm -r --if-present clean && rimraf node_modules .turbo"
+  },
+  "dependencies": {
+    "{{fullstack.contractPackageName}}": "workspace:*",
+    "{{fullstack.sharedPackageName}}": "workspace:*"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "{{fullstack.versions.antfuEslintConfig}}",
+    "@playwright/test": "{{fullstack.versions.playwright}}",
+    "@sveltejs/adapter-auto": "{{fullstack.versions.adapterAuto}}",
+    "@sveltejs/kit": "{{fullstack.versions.svelteKit}}",
+    "@sveltejs/vite-plugin-svelte": "{{fullstack.versions.sveltePlugin}}",
+    "@types/node": "{{fullstack.versions.nodeTypes}}",
+    "eslint": "{{fullstack.versions.eslint}}",
+    "eslint-plugin-format": "{{fullstack.versions.eslintPluginFormat}}",
+    "eslint-plugin-svelte": "{{fullstack.versions.eslintPluginSvelte}}",
+    "rimraf": "{{fullstack.versions.rimraf}}",
+    "svelte": "{{fullstack.versions.svelte}}",
+    "svelte-check": "{{fullstack.versions.svelteCheck}}",
+    "svelte-eslint-parser": "{{fullstack.versions.svelteEslintParser}}",
+    "tsup": "{{fullstack.versions.tsup}}",
+    "typescript": "{{fullstack.versions.typescript}}",
+    "vite": "{{fullstack.versions.vite}}",
+    "vitest": "{{fullstack.versions.vitest}}"
+  }
+}

package/templates/apps/fullstack/packages/{{projectName}}-contract/README.md.hbs

@@ -0,0 +1,15 @@
+# {{fullstack.contractPackageName}}
+
+共享 API 契约包，包含前后端共用的路径常量、Zod Schema、`apiContract.route()` 路由定义与工程级 contract。
+
+## 骨架说明
+
+- `src/app-routes.ts`：HTTP 路径常量，供 service、frontend 与 E2E 复用。
+- `src/app-schemas.ts`：输入输出 Schema 与类型。
+- `src/app-contract.ts`：app 领域 contract 路由定义。
+- `src/{{projectName}}-contract.ts`：工程级 contract，供 `@h-ai/serv` 与 `@h-ai/api-client` 共用。
+
+## 开发
+
+- `pnpm --filter {{fullstack.contractPackageName}} typecheck`
+- `pnpm --filter {{fullstack.contractPackageName}} test`

package/templates/apps/fullstack/packages/{{projectName}}-contract/package.json.hbs

@@ -0,0 +1,27 @@
+{
+  "name": "{{fullstack.contractPackageName}}",
+  "type": "module",
+  "version": "0.1.0",
+  "private": true,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rimraf dist .turbo"
+  },
+  "dependencies": {
+    "@h-ai/api-contract": "{{fullstack.versions.apiContract}}",
+    "@h-ai/core": "{{fullstack.versions.core}}",
+    "zod": "{{fullstack.versions.zod}}"
+  }
+}

package/templates/apps/fullstack/packages/{{projectName}}-contract/src/app-contract.ts.hbs

@@ -0,0 +1,21 @@
+import { apiContract } from '@h-ai/api-contract'
+import { APP_CONTRACT_ROUTES } from './app-routes.js'
+import { AppEchoInputSchema, AppEchoOutputSchema, AppInfoOutputSchema } from './app-schemas.js'
+
+/** app 领域 API contract：路径、方法、输入输出 Schema 的单一来源。 */
+export const appContract = {
+  info: apiContract.route({
+    method: 'POST',
+    path: APP_CONTRACT_ROUTES.info,
+    operationId: 'app.info',
+    tags: ['app'],
+    summary: 'Get application runtime information',
+  }).output(AppInfoOutputSchema),
+  echo: apiContract.route({
+    method: 'POST',
+    path: APP_CONTRACT_ROUTES.echo,
+    operationId: 'app.echo',
+    tags: ['app'],
+    summary: 'Echo a message through the generated service route',
+  }).input(AppEchoInputSchema).output(AppEchoOutputSchema),
+}

package/templates/apps/fullstack/packages/{{projectName}}-contract/src/app-routes.ts.hbs

@@ -0,0 +1,27 @@
+/** HTTP 与业务 API 路径常量，前端、服务端与 E2E 共用。 */
+export const APP_HTTP_ROUTES = {
+  apiPrefix: '/api/v1',
+  health: '/health',
+  ready: '/ready',
+  openapi: '/openapi.json',
+  docs: '/docs',
+} as const
+
+/** app 领域 contract 内部路径，最终会挂载到 APP_HTTP_ROUTES.apiPrefix 下。 */
+export const APP_CONTRACT_ROUTES = {
+  info: '/app/info',
+  echo: '/app/echo',
+} as const
+
+/** 已拼接 apiPrefix 的实际 HTTP 路径，便于测试和非 typed client 场景使用。 */
+export const APP_API_ROUTES = {
+  health: APP_HTTP_ROUTES.health,
+  ready: APP_HTTP_ROUTES.ready,
+  openapi: APP_HTTP_ROUTES.openapi,
+  docs: APP_HTTP_ROUTES.docs,
+  info: `${APP_HTTP_ROUTES.apiPrefix}${APP_CONTRACT_ROUTES.info}`,
+  echo: `${APP_HTTP_ROUTES.apiPrefix}${APP_CONTRACT_ROUTES.echo}`,
+} as const
+
+/** 当前工程启用的前端目标。 */
+export const ENABLED_FRONTENDS = {{{fullstack.selectedFrontendsJson}}} as const