@neuxnet/neux-cli 0.2.3

package/src/core/init.js

@@ -0,0 +1,866 @@
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { DiminaCliError } from './errors.js'
+import { pathExists, resolvePath, writeJson } from './fs.js'
+import { getCliVersion } from './package-info.js'
+import { saveCliKey } from '../providers/service-config.js'
+import { promptLines, shouldPrompt } from './prompts.js'
+
+const DEFAULT_APP_ID = 'touristappid'
+const DEFAULT_LIB_VERSION = '3.3.3'
+export const DEFAULT_SERVER_URL = 'https://demo-c.paas.superapp.neuvision.cn'
+const CLI_PACKAGE_NAME = '@neuxnet/neux-cli'
+const TEMPLATE_ASSET_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../assets/init')
+const DEFAULT_DOCS_BASE_URL = `${DEFAULT_SERVER_URL}/miniappdoc`
+
+export async function initProject(options = {}) {
+  const targetArg = options._?.[0] || options.project || '.'
+  const projectPath = resolvePath(targetArg)
+  await assertWritableProjectDir(projectPath, !!options.force)
+
+  const interactive = shouldPrompt(options)
+  const prompts = interactive ? await promptInitValues(options, projectPath) : {}
+  const projectName = normalizeProjectName(options.name || prompts.name, projectPath)
+  const appId = options.appId || prompts.appId || DEFAULT_APP_ID
+  const serverUrl = options.serverUrl || prompts.serverUrl || DEFAULT_SERVER_URL
+  const cliKey = options.key || prompts.cliKey
+  const cliVersion = await getCliVersion()
+  const files = createTemplateFiles({ appId, projectName, serverUrl, cliVersion })
+
+  for (const file of files) {
+    const filePath = path.join(projectPath, file.path)
+    if (file.kind === 'json') await writeJson(filePath, file.content)
+    else if (file.kind === 'merge-json') await mergeJsonFile(filePath, file.content)
+    else if (file.kind === 'asset') {
+      await fs.mkdir(path.dirname(filePath), { recursive: true })
+      const sourcePath = path.join(TEMPLATE_ASSET_DIR, file.source)
+      if (file.source === 'types/neux-api.d.ts') {
+        const docsBaseUrl = `${String(serverUrl || DEFAULT_SERVER_URL).replace(/\/+$/, '')}/miniappdoc`
+        const content = await fs.readFile(sourcePath, 'utf8')
+        await fs.writeFile(filePath, content.replaceAll(DEFAULT_DOCS_BASE_URL, docsBaseUrl), 'utf8')
+      }
+      else await fs.copyFile(sourcePath, filePath)
+    }
+    else {
+      await fs.mkdir(path.dirname(filePath), { recursive: true })
+      await fs.writeFile(filePath, file.content, 'utf8')
+    }
+  }
+
+  if (cliKey) await saveCliKey({ appId, key: cliKey, configPath: options.config })
+
+  return {
+    ok: true,
+    command: 'init',
+    projectPath,
+    outputPath: projectPath,
+    appId,
+    name: projectName,
+    serverUrl,
+    cliKeyConfigured: !!cliKey,
+    files: files.map(file => file.path),
+  }
+}
+
+async function promptInitValues(options, projectPath) {
+  const prompts = []
+  if (!options.name) prompts.push({ name: 'name', label: `Project name (${path.basename(projectPath) || 'neux-miniapp'}): ` })
+  if (!options.appId) prompts.push({ name: 'appId', label: `App ID (${DEFAULT_APP_ID}): ` })
+  if (!options.serverUrl) prompts.push({ name: 'serverUrl', label: `Server URL (${DEFAULT_SERVER_URL}): ` })
+  if (!options.key) prompts.push({ name: 'cliKey', label: 'CLI Key (optional): ', secret: true })
+  const values = prompts.length > 0 ? await promptLines(prompts) : {}
+  return {
+    name: String(values.name || '').trim() || path.basename(projectPath),
+    appId: String(values.appId || '').trim() || DEFAULT_APP_ID,
+    serverUrl: String(values.serverUrl || '').trim() || DEFAULT_SERVER_URL,
+    cliKey: String(values.cliKey || '').trim(),
+  }
+}
+
+function normalizeProjectName(name, projectPath) {
+  const value = String(name || '').trim()
+  if (value) return value
+  const basename = path.basename(projectPath)
+  return basename && basename !== '.' ? basename : 'neux-miniapp'
+}
+
+function normalizePackageName(name) {
+  const normalized = String(name || '')
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9._-]+/g, '-')
+    .replace(/^[._-]+|[._-]+$/g, '')
+    .replace(/-{2,}/g, '-')
+  return normalized || 'neux-miniapp'
+}
+
+async function assertWritableProjectDir(projectPath, force) {
+  if (!(await pathExists(projectPath))) return
+
+  const stat = await fs.stat(projectPath)
+  if (!stat.isDirectory()) {
+    throw new DiminaCliError('NEUX_CLI_INIT_TARGET_INVALID', `Init target is not a directory: ${projectPath}`, {
+      projectPath,
+    })
+  }
+
+  const entries = await fs.readdir(projectPath)
+  if (entries.length > 0 && !force) {
+    throw new DiminaCliError('NEUX_CLI_INIT_TARGET_NOT_EMPTY', `Init target is not empty: ${projectPath}`, {
+      projectPath,
+      suggestions: [
+        'Choose an empty directory.',
+        'Pass --force to write the starter files into the existing directory.',
+      ],
+    })
+  }
+}
+
+async function mergeJsonFile(filePath, generated) {
+  let existing = {}
+  try {
+    existing = JSON.parse(await fs.readFile(filePath, 'utf8'))
+  }
+  catch (error) {
+    if (error.code !== 'ENOENT') throw error
+  }
+
+  const merged = {
+    ...(generated && typeof generated === 'object' ? generated : {}),
+    ...(existing && typeof existing === 'object' ? existing : {}),
+  }
+  if (generated?.['files.associations'] || existing?.['files.associations']) {
+    merged['files.associations'] = {
+      ...(generated['files.associations'] || {}),
+      ...(existing['files.associations'] || {}),
+    }
+  }
+  if (filePath.endsWith('neux.code-snippets')) {
+    Object.assign(merged, generated || {}, existing || {})
+  }
+  await writeJson(filePath, merged)
+}
+
+function createTemplateFiles({ appId, projectName, serverUrl = DEFAULT_SERVER_URL, cliVersion }) {
+  return [
+    {
+      path: 'project.config.json',
+      kind: 'json',
+      content: {
+        description: 'Neux mini program project.',
+        setting: {
+          urlCheck: true,
+          es6: true,
+          postcss: true,
+          minified: true,
+          newFeature: true,
+          babelSetting: {
+            ignore: [],
+            disablePlugins: [],
+            outputPath: '',
+          },
+        },
+        compileType: 'miniprogram',
+        libVersion: DEFAULT_LIB_VERSION,
+        appid: appId,
+        projectname: projectName,
+        miniprogramRoot: '',
+        versionName: '1.0.0',
+        versionCode: 1,
+        neuxCli: {
+          serverUrl,
+        },
+        condition: {},
+        packOptions: {
+          ignore: [],
+          include: [],
+        },
+        editorSetting: {
+          tabIndent: 'insertSpaces',
+          tabSize: 2,
+        },
+      },
+    },
+    {
+      path: 'package.json',
+      kind: 'json',
+      content: {
+        name: normalizePackageName(projectName),
+        version: '1.0.0',
+        private: true,
+        scripts: {
+          dev: 'neux dev',
+          build: 'neux build',
+          debug: 'neux debug',
+          upload: 'neux upload --preview',
+          submit: 'neux submit',
+        },
+        devDependencies: {
+          [CLI_PACKAGE_NAME]: `^${cliVersion}`,
+        },
+      },
+    },
+    {
+      path: 'app.json',
+      kind: 'json',
+      content: {
+        pages: ['pages/index/index', 'pages/list/list'],
+        window: {
+          navigationBarTitleText: projectName,
+          navigationBarBackgroundColor: '#ffffff',
+          navigationBarTextStyle: 'black',
+          backgroundColor: '#f7f8fa',
+          backgroundTextStyle: 'light',
+        },
+        tabBar: {
+          color: '#64748b',
+          selectedColor: '#1aad19',
+          backgroundColor: '#ffffff',
+          borderStyle: 'black',
+          list: [
+            {
+              pagePath: 'pages/index/index',
+              iconPath: 'assets/tabbar/home.png',
+              selectedIconPath: 'assets/tabbar/home-active.png',
+              text: 'Home',
+            },
+            {
+              pagePath: 'pages/list/list',
+              iconPath: 'assets/tabbar/list.png',
+              selectedIconPath: 'assets/tabbar/list-active.png',
+              text: 'List',
+            },
+          ],
+        },
+      },
+    },
+    {
+      path: 'app.js',
+      content: 'App({})\n',
+    },
+    {
+      path: 'AGENTS.md',
+      content: createAgentsDocument(),
+    },
+    {
+      path: 'llms.txt',
+      content: createLlmsDocument(),
+    },
+    {
+      path: 'mcp.example.json',
+      kind: 'json',
+      content: createMcpExample(),
+    },
+    {
+      path: '.vscode/settings.json',
+      kind: 'merge-json',
+      content: {
+        'files.associations': {
+          '*.nxml': 'html',
+          '*.nxss': 'css',
+        },
+      },
+    },
+    {
+      path: '.vscode/neux.code-snippets',
+      kind: 'merge-json',
+      content: createNeuxCodeSnippets(),
+    },
+    {
+      path: 'jsconfig.json',
+      kind: 'json',
+      content: {
+        compilerOptions: {
+          allowJs: true,
+          checkJs: false,
+          noEmit: true,
+          target: 'ES2020',
+        },
+        include: ['**/*.js', '**/*.ts', 'types/**/*.d.ts'],
+      },
+    },
+    { path: 'types/neux-api.d.ts', kind: 'asset', source: 'types/neux-api.d.ts' },
+    { path: 'assets/tabbar/home.png', kind: 'asset', source: 'tabbar/home.png' },
+    { path: 'assets/tabbar/home-active.png', kind: 'asset', source: 'tabbar/home-active.png' },
+    { path: 'assets/tabbar/list.png', kind: 'asset', source: 'tabbar/list.png' },
+    { path: 'assets/tabbar/list-active.png', kind: 'asset', source: 'tabbar/list-active.png' },
+    {
+      path: 'app.nxss',
+      content: [
+        'page {',
+        '  min-height: 100vh;',
+        '  background: #f7f8fa;',
+        '  color: #1f2933;',
+        '  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;',
+        '}',
+        '',
+      ].join('\n'),
+    },
+    {
+      path: 'pages/index/index.json',
+      kind: 'json',
+      content: {
+        navigationBarTitleText: projectName,
+      },
+    },
+    {
+      path: 'pages/index/index.js',
+      content: [
+        'Page({',
+        '  data: {',
+        `    title: '${escapeJsString(projectName)}',`,
+        '    count: 0,',
+        '  },',
+        '  increase() {',
+        '    this.setData({',
+        '      count: this.data.count + 1,',
+        '    })',
+        '  },',
+        '})',
+        '',
+      ].join('\n'),
+    },
+    {
+      path: 'pages/index/index.nxml',
+      content: [
+        '<view class="page">',
+        '  <view class="card">',
+        '    <text class="eyebrow">Welcome</text>',
+        '    <text class="title">{{title}}</text>',
+        '    <text class="desc">A simple setData counter.</text>',
+        '    <view class="counter">',
+        '      <text class="count">{{count}}</text>',
+        '      <text class="count-label">clicks</text>',
+        '    </view>',
+        '    <button class="primary-button" bindtap="increase">Add one</button>',
+        '  </view>',
+        '</view>',
+        '',
+      ].join('\n'),
+    },
+    {
+      path: 'pages/index/index.nxss',
+      content: [
+        '.page {',
+        '  min-height: 100vh;',
+        '  box-sizing: border-box;',
+        '  padding: 48rpx 32rpx;',
+        '}',
+        '',
+        '.card {',
+        '  padding: 40rpx 32rpx;',
+        '  border-radius: 16rpx;',
+        '  background: #ffffff;',
+        '  box-shadow: 0 12rpx 36rpx rgba(15, 23, 42, 0.08);',
+        '}',
+        '',
+        '.title {',
+        '  display: block;',
+        '  font-size: 40rpx;',
+        '  font-weight: 600;',
+        '}',
+        '',
+        '.eyebrow {',
+        '  display: block;',
+        '  color: #1aad19;',
+        '  font-size: 24rpx;',
+        '  font-weight: 600;',
+        '  text-transform: uppercase;',
+        '}',
+        '',
+        '.desc {',
+        '  display: block;',
+        '  margin-top: 16rpx;',
+        '  color: #64748b;',
+        '  font-size: 28rpx;',
+        '}',
+        '',
+        '.counter {',
+        '  display: flex;',
+        '  align-items: baseline;',
+        '  margin-top: 48rpx;',
+        '}',
+        '',
+        '.count {',
+        '  color: #0f172a;',
+        '  font-size: 88rpx;',
+        '  font-weight: 700;',
+        '  line-height: 1;',
+        '}',
+        '',
+        '.count-label {',
+        '  margin-left: 16rpx;',
+        '  color: #64748b;',
+        '  font-size: 28rpx;',
+        '}',
+        '',
+        '.primary-button {',
+        '  margin-top: 40rpx;',
+        '  border-radius: 12rpx;',
+        '  background: #1aad19;',
+        '  color: #ffffff;',
+        '  font-size: 30rpx;',
+        '}',
+        '',
+      ].join('\n'),
+    },
+    {
+      path: 'pages/list/list.json',
+      kind: 'json',
+      content: {
+        navigationBarTitleText: 'List',
+      },
+    },
+    {
+      path: 'pages/list/list.js',
+      content: [
+        'Page({',
+        '  data: {',
+        '    items: [',
+        "      { id: 1, name: 'Learn nxml', detail: 'Build a page with template syntax.' },",
+        "      { id: 2, name: 'Use setData', detail: 'Update data from an event handler.' },",
+        "      { id: 3, name: 'Try hot update', detail: 'Change code and see the preview update.' },",
+        '    ],',
+        '  },',
+        '})',
+        '',
+      ].join('\n'),
+    },
+    {
+      path: 'pages/list/list.nxml',
+      content: [
+        '<view class="page">',
+        '  <view class="header">',
+        '    <text class="title">List example</text>',
+        '    <text class="desc">This page uses the nx:for directive.</text>',
+        '  </view>',
+        '  <view class="list">',
+        '    <view class="list-item" nx:for="{{items}}" nx:key="id">',
+        '      <view class="item-index">{{index + 1}}</view>',
+        '      <view class="item-content">',
+        '        <text class="item-name">{{item.name}}</text>',
+        '        <text class="item-detail">{{item.detail}}</text>',
+        '      </view>',
+        '    </view>',
+        '  </view>',
+        '</view>',
+        '',
+      ].join('\n'),
+    },
+    {
+      path: 'pages/list/list.nxss',
+      content: [
+        '.page {',
+        '  min-height: 100vh;',
+        '  box-sizing: border-box;',
+        '  padding: 48rpx 32rpx;',
+        '}',
+        '',
+        '.header {',
+        '  padding: 24rpx 8rpx 32rpx;',
+        '}',
+        '',
+        '.title {',
+        '  display: block;',
+        '  color: #0f172a;',
+        '  font-size: 44rpx;',
+        '  font-weight: 700;',
+        '}',
+        '',
+        '.desc {',
+        '  display: block;',
+        '  margin-top: 16rpx;',
+        '  color: #64748b;',
+        '  font-size: 28rpx;',
+        '}',
+        '',
+        '.list-item {',
+        '  display: flex;',
+        '  align-items: center;',
+        '  margin-bottom: 20rpx;',
+        '  padding: 28rpx 24rpx;',
+        '  border-radius: 16rpx;',
+        '  background: #ffffff;',
+        '}',
+        '',
+        '.item-index {',
+        '  display: flex;',
+        '  align-items: center;',
+        '  justify-content: center;',
+        '  width: 56rpx;',
+        '  height: 56rpx;',
+        '  border-radius: 50%;',
+        '  background: #1aad19;',
+        '  color: #ffffff;',
+        '  font-weight: 700;',
+        '}',
+        '',
+        '.item-content {',
+        '  flex: 1;',
+        '  margin-left: 20rpx;',
+        '}',
+        '',
+        '.item-name, .item-detail {',
+        '  display: block;',
+        '}',
+        '',
+        '.item-name {',
+        '  color: #0f172a;',
+        '  font-size: 30rpx;',
+        '  font-weight: 600;',
+        '}',
+        '',
+        '.item-detail {',
+        '  margin-top: 8rpx;',
+        '  color: #64748b;',
+        '  font-size: 24rpx;',
+        '}',
+        '',
+      ].join('\n'),
+    },
+  ]
+}
+
+function escapeJsString(value) {
+  return String(value).replaceAll('\\', '\\\\').replaceAll("'", "\\'")
+}
+
+function createAgentsDocument() {
+  const ai = createAiDocumentationLinks(DEFAULT_SERVER_URL)
+  return `# AI Development Standard for Neux Mini Apps
+
+This file defines a reusable development standard for AI coding agents. It is intentionally independent of any project, application, App ID, page, business domain, or deployment environment.
+
+## Role
+
+Act as a careful Neux mini app engineer. Before changing code, understand the existing project structure, configuration, compiler behavior, and runtime constraints. Make the smallest complete change that satisfies the request.
+
+## Official Documentation for AI Tools
+
+Use the official documentation as the source of truth for framework behavior, APIs, components, SDK integration, and CLI workflows:
+
+- AI guide: ${ai.guide}
+- LLM index: ${ai.llms}
+- Full LLM export: ${ai.llmsFull}
+- MCP endpoint: ${ai.mcp}
+- Agent Skill index: ${ai.skillsIndex}
+- Neux documentation Skill: ${ai.skill}
+
+Prefer the official documentation over assumptions or undocumented runtime behavior. Use the MCP endpoint only when the AI tool supports MCP. Do not commit credentials or modify global AI tool configuration automatically.
+
+## Working Process
+
+1. Inspect the repository, current branch, working tree, relevant documentation, and existing tests.
+2. Identify the correct layer for the change: project code, compiler, runtime, container, SDK, or host integration.
+3. Reproduce the problem or create a minimal test case before making a broad change.
+4. Follow existing patterns and public contracts. Avoid speculative APIs and unrelated refactors.
+5. Implement the change with clear names, stable behavior, and short comments only where the intent is not obvious.
+6. Verify the original workflow and nearby regression paths.
+7. Report what changed, what was verified, and any remaining limitations.
+
+## Source and Runtime Rules
+
+- Use the project's configured source format. For Neux projects, view templates use \`.nxml\` and styles use \`.nxss\`.
+- Keep application and page behavior in source JavaScript or TypeScript, not generated output.
+- Update rendered state through the framework's data update API, such as \`setData\`, instead of directly mutating displayed state.
+- Use the project's documented template directives and preserve stable list identity with a key when rendering collections.
+- Treat configuration files as contracts. Validate route, component, asset, and package references before changing them.
+- Preserve service/render, compiler/runtime, and host/SDK boundaries. Do not solve a framework problem with a page-specific workaround.
+- Do not rely on fixed delays, random identifiers, or environment-specific paths to hide lifecycle or timing problems.
+
+## Code Change Rules
+
+- Read surrounding code before editing and preserve unrelated user or collaborator changes.
+- Prefer structured parsers and existing helpers over ad hoc text replacement.
+- Keep generated directories such as \`dist\` disposable; never edit generated output as the source of truth.
+- Do not add dependencies when the existing toolchain is sufficient.
+- Do not introduce secrets, tokens, private URLs, or machine-specific paths into source files.
+- Keep public interfaces backward compatible unless the task explicitly requires a breaking change.
+- Update focused tests and documentation when a public behavior or workflow changes.
+
+## Commands
+
+\`\`\`bash
+npm run dev
+npm run build
+npm run debug
+\`\`\`
+
+Use \`npm run dev\` for local Web preview and hot update. If multiple development servers are needed, give each process a different port and output directory:
+
+\`\`\`bash
+neux dev --port 7721 --out dist/dev-7721
+\`\`\`
+
+## Verification
+
+After changing code:
+
+1. Run \`npm run dev\`.
+2. Check the affected workflow in the Web preview or target host.
+3. Modify the same source file more than once when verifying hot update behavior.
+4. Run the focused tests and \`npm run build\` before delivery.
+
+Read \`llms.txt\` for official AI documentation entry points. \`mcp.example.json\` contains the public Neux documentation MCP endpoint and can be copied into an MCP-compatible client. Never commit credentials or modify global AI tool configuration automatically.
+`
+}
+
+function createLlmsDocument() {
+  const ai = createAiDocumentationLinks(DEFAULT_SERVER_URL)
+  return `# Mini App AI Development Context
+
+> General development context for Neux mini apps. This file does not describe a specific application, App ID, business domain, or page implementation.
+
+## Official AI Documentation
+
+- AI guide: ${ai.guide}
+- LLM index: ${ai.llms}
+- Full LLM export: ${ai.llmsFull}
+- MCP endpoint: ${ai.mcp}
+- Agent Skill index: ${ai.skillsIndex}
+- Neux documentation Skill: ${ai.skill}
+
+These published resources are the source of truth for framework, API, component, SDK, and CLI questions.
+
+## Development Guidelines
+
+- Use \`nxml\` for view templates and \`nxss\` for stylesheets.
+- Use page or component JavaScript for behavior and state.
+- Use \`this.setData({ ... })\` when changing data rendered by the view.
+- Use \`nx:for\` with \`nx:key\` for list rendering when supported by the project compiler.
+- Keep configuration, source code, assets, and generated output separate.
+- Do not edit the generated \`dist\` directory by hand.
+- Inspect the existing project configuration before changing routes, components, or runtime settings.
+
+## Development
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+## Build
+
+\`\`\`bash
+npm run build
+\`\`\`
+
+Use the project files as a starting point and organize pages, components, and application logic according to the actual project requirements.
+`
+}
+
+function createAiDocumentationLinks(serverUrl) {
+  const baseUrl = String(serverUrl || DEFAULT_SERVER_URL).replace(/\/+$/, '')
+  const docsBaseUrl = `${baseUrl}/miniappdoc`
+  return {
+    guide: `${docsBaseUrl}/en/ai`,
+    llms: `${docsBaseUrl}/llms.txt`,
+    llmsFull: `${docsBaseUrl}/llms-full.txt`,
+    mcp: `${docsBaseUrl}/mcp`,
+    skillsIndex: `${docsBaseUrl}/.well-known/skills/index.json`,
+    skill: `${docsBaseUrl}/.well-known/skills/neux-docs/SKILL.md`,
+  }
+}
+
+function createNeuxCodeSnippets() {
+  return {
+    'Neux Page': {
+      prefix: 'nxpage',
+      scope: 'javascript,typescript',
+      include: ['**/*.js', '**/*.ts'],
+      body: [
+        'Page({',
+        '  data: {',
+        '    ${1:key}: ${2:value},',
+        '  },',
+        '  onLoad(options) {',
+        '    ${0}',
+        '  },',
+        '})',
+      ],
+      description: 'Create a Neux page definition',
+    },
+    'Neux Component': {
+      prefix: 'nxcomponent',
+      scope: 'javascript,typescript',
+      include: ['**/*.js', '**/*.ts'],
+      body: [
+        'Component({',
+        '  properties: {',
+        '    ${1:value}: {',
+        '      type: ${2:String},',
+        '      value: ${3:undefined},',
+        '    },',
+        '  },',
+        '  data: {},',
+        '  methods: {',
+        '    ${0}',
+        '  },',
+        '})',
+      ],
+      description: 'Create a Neux component definition',
+    },
+    'setData Update': {
+      prefix: 'nxset',
+      scope: 'javascript,typescript',
+      include: ['**/*.js', '**/*.ts'],
+      body: ['this.setData({', '  ${1:key}: ${2:value},', '})$0'],
+      description: 'Update rendered data with setData',
+    },
+    'Event Handler': {
+      prefix: 'nxevent',
+      scope: 'javascript,typescript',
+      include: ['**/*.js', '**/*.ts'],
+      body: ['${1:handleTap}(event) {', '  ${0}', '}'],
+      description: 'Create a page or component event handler',
+    },
+    'Network Request': {
+      prefix: 'nxrequest',
+      scope: 'javascript,typescript',
+      include: ['**/*.js', '**/*.ts'],
+      body: [
+        'wx.request({',
+        "  url: '${1:https://example.com/api}',",
+        '  method: ${2:\'GET\'},',
+        '  data: ${3:{}},',
+        '  success(result) {',
+        '    ${4}',
+        '  },',
+        '  fail(error) {',
+        '    ${0}',
+        '  },',
+        '})',
+      ],
+      description: 'Create a wx.request call',
+    },
+    'Toast': {
+      prefix: 'nxtoast',
+      scope: 'javascript,typescript',
+      include: ['**/*.js', '**/*.ts'],
+      body: ["nx.showToast({", "  title: '${1:Done}',", '  icon: ${2:\'success\'},', '})$0'],
+      description: 'Show a Neux toast',
+    },
+    'List Rendering': {
+      prefix: 'nxfor',
+      scope: 'html',
+      include: ['**/*.nxml'],
+      body: [
+        '<view nx:for="{{${1:items}}}" nx:key="${2:id}">',
+        '  <text>{{${3:item}.${4:name}}}</text>',
+        '</view>$0',
+      ],
+      description: 'Render a list with nx:for and nx:key',
+    },
+    'Conditional Rendering': {
+      prefix: 'nxif',
+      scope: 'html',
+      include: ['**/*.nxml'],
+      body: ['<view nx:if="{{${1:visible}}}">', '  ${0}', '</view>'],
+      description: 'Render a view conditionally',
+    },
+    'Tap Button': {
+      prefix: 'nxbutton',
+      scope: 'html',
+      include: ['**/*.nxml'],
+      body: ['<button bindtap="${1:handleTap}">${2:Button}</button>$0'],
+      description: 'Insert a button with a tap handler',
+    },
+    'Page View': {
+      prefix: 'nxview',
+      scope: 'html',
+      include: ['**/*.nxml'],
+      body: ['<view class="${1:page}">', '  ${0}', '</view>'],
+      description: 'Insert a page view container',
+    },
+    'NXML Image': {
+      prefix: 'nximage',
+      scope: 'html',
+      include: ['**/*.nxml'],
+      body: ['<image src="{{${1:imageUrl}}}" mode="${2:aspectFit}" />$0'],
+      description: 'Insert an image with a bound source',
+    },
+    'NXML Text': {
+      prefix: 'nxtext',
+      scope: 'html',
+      include: ['**/*.nxml'],
+      body: ['<text class="${1:text}">{{${2:value}}}</text>$0'],
+      description: 'Insert a text binding',
+    },
+    'NXML Input': {
+      prefix: 'nxinput',
+      scope: 'html',
+      include: ['**/*.nxml'],
+      body: ['<input value="{{${1:value}}}" placeholder="${2:Enter text}" bindinput="${3:onInput}" />$0'],
+      description: 'Insert a data-bound input',
+    },
+    'NXML Include': {
+      prefix: 'nxinclude',
+      scope: 'html',
+      include: ['**/*.nxml'],
+      body: ['<include src="${1:components/header/header.nxml}" />$0'],
+      description: 'Include another NXML template',
+    },
+    'NXML Template': {
+      prefix: 'nxtemplate',
+      scope: 'html',
+      include: ['**/*.nxml'],
+      body: ['<template name="${1:card}">', '  ${0}', '</template>'],
+      description: 'Define a reusable NXML template',
+    },
+    'NXML Template Use': {
+      prefix: 'nxtemplateuse',
+      scope: 'html',
+      include: ['**/*.nxml'],
+      body: ['<template is="${1:card}" data="{{${2:item}}}" />$0'],
+      description: 'Use a reusable NXML template',
+    },
+    'NXML Scroll View': {
+      prefix: 'nxscroll',
+      scope: 'html',
+      include: ['**/*.nxml'],
+      body: ['<scroll-view scroll-y class="${1:scroll-view}">', '  ${0}', '</scroll-view>'],
+      description: 'Insert a vertical scroll view',
+    },
+    'Style Rule': {
+      prefix: 'nxstyle',
+      scope: 'css',
+      include: ['**/*.nxss'],
+      body: ['.${1:class-name} {', '  ${2:display}: ${3:block};', '}$0'],
+      description: 'Insert an nxss style rule',
+    },
+    'Flex Layout': {
+      prefix: 'nxflex',
+      scope: 'css',
+      include: ['**/*.nxss'],
+      body: ['display: flex;', 'align-items: ${1:center};', 'justify-content: ${2:center};$0'],
+      description: 'Insert common flex layout properties',
+    },
+    'Grid Layout': {
+      prefix: 'nxgrid',
+      scope: 'css',
+      include: ['**/*.nxss'],
+      body: ['display: grid;', 'grid-template-columns: repeat(${1:2}, 1fr);', 'gap: ${2:16rpx};$0'],
+      description: 'Insert a common grid layout',
+    },
+    'Text Ellipsis': {
+      prefix: 'nxellipsis',
+      scope: 'css',
+      include: ['**/*.nxss'],
+      body: ['overflow: hidden;', 'text-overflow: ellipsis;', 'white-space: nowrap;$0'],
+      description: 'Insert single-line text ellipsis styles',
+    },
+  }
+}
+
+function createMcpExample() {
+  const ai = createAiDocumentationLinks(DEFAULT_SERVER_URL)
+  return {
+    '$schema': 'https://modelcontextprotocol.io/schema/config.json',
+    mcpServers: {
+      'neux-docs': {
+        url: ai.mcp,
+      },
+    },
+  }
+}