@funhub/platform 0.1.51 → 0.1.52

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@funhub/platform",
   "type": "module",
-  "version": "0.1.51",
+  "version": "0.1.52",
   "private": false,
   "sideEffects": [
     "**/*.css"
@@ -62,9 +62,12 @@
     },
     "./theme.css": "./theme.css"
   },
+  "bin": "./bin/index.mjs",
   "files": [
+    "bin",
     "config",
     "dist",
+    "templates",
     "theme.css"
   ],
   "scripts": {
@@ -89,7 +92,8 @@
     "i18n:build": "node scripts/i18n-flat-sync.mjs build",
     "i18n:watch": "node scripts/i18n-flat-sync.mjs watch",
     "i18n:check": "node scripts/i18n-flat-sync.mjs check",
-    "pretest": "pnpm i18n:build"
+    "pretest": "pnpm i18n:build",
+    "init:local": "node ./bin/index.mjs"
   },
   "peerDependencies": {
     "@tanstack/query-core": ">=5",
@@ -107,6 +111,7 @@
     "@ncdai/react-wheel-picker": "^1.1.0",
     "@next/bundle-analyzer": "^16.1.6",
     "browser-image-compression": "^2.0.2",
+    "cac": "^6.7.14",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "crypto": "^1.0.1",

package/templates/base/_meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "base",
+  "description": "最小可运行的 Funhub Next.js starter"
+}

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

@@ -0,0 +1,32 @@
+# {{PROJECT_NAME}}
+
+基于 `@funhub/platform` 初始化的 Next.js Starter。
+
+## 开始使用
+
+```bash
+pnpm install
+pnpm dev
+```
+
+## 可用命令
+
+```bash
+pnpm dev
+pnpm build
+pnpm start
+pnpm lint
+pnpm typecheck
+```
+
+## 目录说明
+
+- `app/`: Next App Router 路由
+- `i18n/`: next-intl 请求配置
+- `proxy.ts`: 国际化路由中间件
+
+## 依赖说明
+
+- `@funhub/platform`: SDK 主包
+- `@funhub/platform/config/tailwind`: Tailwind 预设与内容扫描配置
+- `@funhub/platform/theme.css`: 平台主题变量

package/templates/base/template/__dot__gitignore

@@ -0,0 +1,6 @@
+.next
+node_modules
+dist
+coverage
+*.log
+.DS_Store

package/templates/base/template/app/[locale]/layout.tsx.template

@@ -0,0 +1,36 @@
+import type { ReactNode } from 'react';
+import { FunhubProvider, LocaleSync } from '@funhub/platform/components/common';
+import { defaultLocale, getMessages, isValidLocale, locales } from '@funhub/platform/i18n';
+import { setRequestLocale } from 'next-intl/server';
+
+interface LocaleLayoutProps {
+  children: ReactNode
+  params: Promise<{ locale: string }>
+}
+
+/**
+ * 预生成支持的语言参数。
+ */
+export function generateStaticParams() {
+  return locales.map(item => ({ locale: item.code }));
+}
+
+/**
+ * 语言布局负责注入平台 Provider 与国际化上下文。
+ */
+export default async function LocaleLayout({ children, params }: LocaleLayoutProps) {
+  const { locale } = await params;
+  const validLocale = isValidLocale(locale) ? locale : defaultLocale;
+
+  setRequestLocale(validLocale);
+  const messages = getMessages(validLocale);
+
+  return (
+    <>
+      <LocaleSync locale={validLocale} />
+      <FunhubProvider intl={{ locale: validLocale, messages }}>
+        {children}
+      </FunhubProvider>
+    </>
+  );
+}

package/templates/base/template/app/[locale]/page.tsx.template

@@ -0,0 +1,24 @@
+import { Button } from '@funhub/platform/components/biz';
+import { DebugLocaleSwitcher } from '@funhub/platform/components/common';
+
+/**
+ * Starter 首页，展示平台组件已接入成功。
+ */
+export default function HomePage() {
+  return (
+    <main className='min-h-screen bg-bg1 px-6 py-10 text-text1'>
+      <section className='mx-auto flex max-w-xl flex-col gap-4 rounded-3xl bg-bg2 p-6 shadow-sm'>
+        <span className='text-sm text-text3'>@funhub/platform starter</span>
+        <h1 className='text-2xl font-semibold'>{'{{PROJECT_NAME}}'}</h1>
+        <p className='text-sm leading-6 text-text2'>
+          这个项目已经接入平台主题、Tailwind 预设、next-intl 和 FunhubProvider，
+          你可以直接开始组合页面组件、业务组件或物料渲染能力。
+        </p>
+        <div className='flex flex-wrap gap-3 pt-2'>
+          <Button text='平台按钮已就绪' variant='red' disabled={false} />
+          <DebugLocaleSwitcher />
+        </div>
+      </section>
+    </main>
+  );
+}

package/templates/base/template/app/globals.css

@@ -0,0 +1,26 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+html {
+  font-size: 16px;
+}
+
+body {
+  font-family: var(--font-sans), Arial, Helvetica, sans-serif;
+  -webkit-text-size-adjust: 100%;
+  -moz-text-size-adjust: 100%;
+  -ms-text-size-adjust: 100%;
+  text-size-adjust: 100%;
+  background: var(--color-bg1);
+  color: var(--color-text1);
+}
+
+* {
+  box-sizing: border-box;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}

package/templates/base/template/app/layout.tsx.template

@@ -0,0 +1,38 @@
+import type { Metadata, Viewport } from 'next';
+import { ThemeSync } from '@funhub/platform/components/common';
+import { defaultLocale } from '@funhub/platform/i18n';
+import '@funhub/platform/theme.css';
+import './globals.css';
+
+/**
+ * Starter 应用默认 viewport 配置。
+ */
+export const viewport: Viewport = {
+  width: 'device-width',
+  initialScale: 1,
+  viewportFit: 'cover',
+};
+
+/**
+ * Starter 应用的站点元信息。
+ */
+export const metadata: Metadata = {
+  title: '{{PROJECT_NAME}}',
+  description: 'A starter app powered by @funhub/platform',
+};
+
+/**
+ * 根布局负责挂载主题和全局样式。
+ */
+export default function RootLayout({ children }: Readonly<{ children: React.ReactNode }>) {
+  const theme = 'dark';
+
+  return (
+    <html lang={defaultLocale} className={theme} data-prefers-color-scheme={theme}>
+      <body suppressHydrationWarning>
+        <ThemeSync defaultTheme={theme} />
+        {children}
+      </body>
+    </html>
+  );
+}

package/templates/base/template/eslint.config.mjs.template

@@ -0,0 +1,68 @@
+import { antfu } from '@antfu/eslint-config';
+
+export function react(options = {}) {
+  return antfu({
+    react: true,
+    ignores: [
+      '**/*.md',
+      '.next/**',
+      'out/**',
+      'build/**',
+      'public',
+      'next-env.d.ts',
+      ...(options.ignores || []),
+    ],
+    rules: {
+      'react-hooks/exhaustive-deps': 'error',
+      'eslint-comments/no-unlimited-disable': 'off',
+      'no-redeclare': 'off',
+      'jsdoc/require-returns-description': 'off',
+      '@typescript-eslint/no-redeclare': 'off',
+      'style/quotes': ['warn', 'single'],
+      'style/jsx-quotes': ['warn', 'prefer-single'],
+      'node/prefer-global/process': 'off',
+      'style/semi': ['warn', 'always'],
+      'package-json/valid-package-def': 'off',
+      '@eslint-react/no-missing-key': 'warn',
+      'no-restricted-syntax': 'off',
+      'react-hooks-extra/no-direct-set-state-in-use-effect': 'off',
+      'import/no-anonymous-default-export': 'off',
+      'eqeqeq': 'warn',
+      'ts/no-use-before-define': ['warn', { functions: false, variables: false }],
+      'no-use-before-define': ['warn', { functions: false, variables: false }],
+      'no-console': 'warn',
+      'unicorn/prefer-math-trunc': 'off',
+      'unicorn/prefer-dom-node-remove': 'off',
+      '@typescript-eslint/no-unsafe-function-type': 'off',
+      'no-empty': 'off',
+      '@typescript-eslint/no-empty-object-type': 'warn',
+      'unicorn/prefer-query-selector': 0,
+      'regexp/no-super-linear-backtracking': 0,
+      'regexp/no-useless-assertions': 0,
+      'unicorn/no-new-array': 0,
+      '@typescript-eslint/method-signature-style': 0,
+      'unicorn/prefer-code-point': 'warn',
+      'unicorn/no-object-as-default-parameter': 'warn',
+      'unused-imports/no-unused-vars': 'warn',
+      '@eslint-react/no-unstable-default-props': 'warn',
+      'unicorn/prefer-regexp-test': 'warn',
+      'no-unsafe-optional-chaining': 'warn',
+      'unicorn/prefer-logical-operator-over-ternary': 'warn',
+      'arrow-body-style': 0,
+      'unicorn/no-array-callback-reference': 0,
+      'prefer-regex-literals': 0,
+      'regexp/optimal-quantifier-concatenation': 'warn',
+      'unicorn/prefer-string-slice': 0,
+      'array-callback-return': 0,
+      'regexp/no-unused-capturing-group': 1,
+      'unicorn/no-anonymous-default-export': 0,
+      'unicorn/no-magic-array-flat-depth': 1,
+      'react-refresh/only-export-components': 0,
+      'react/no-array-index-key': 0,
+      'package-json/valid-name': 0,
+      ...(options.rules || {}),
+    },
+  });
+}
+
+export default react();

package/templates/base/template/i18n/request.ts.template

@@ -0,0 +1,3 @@
+import { nextIntlRequestConfig } from '@funhub/platform/i18n';
+
+export default nextIntlRequestConfig;

package/templates/base/template/next-env.d.ts.template

@@ -0,0 +1,4 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// This file is auto-generated by Next.js.

package/templates/base/template/next.config.ts.template

@@ -0,0 +1,21 @@
+import type { NextConfig } from 'next';
+import createNextIntlPlugin from 'next-intl/plugin';
+
+const withNextIntl = createNextIntlPlugin('./i18n/request.ts');
+
+/**
+ * Starter 应用的 Next 配置。
+ */
+const nextConfig: NextConfig = {
+  transpilePackages: ['@funhub/platform'],
+  images: {
+    remotePatterns: [
+      {
+        protocol: 'https',
+        hostname: '*',
+      },
+    ],
+  },
+};
+
+export default withNextIntl(nextConfig);

package/templates/base/template/package.json.template

@@ -0,0 +1,37 @@
+{
+  "name": "{{PACKAGE_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint .",
+    "fix": "eslint . --fix",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@funhub/platform": "{{PLATFORM_VERSION}}",
+    "@tanstack/react-query": "^5.90.16",
+    "next": "16.1.6",
+    "next-intl": "^4.8.2",
+    "react": "19.2.0",
+    "react-dom": "19.2.0"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^7.4.3",
+    "@eslint-react/eslint-plugin": "^2.12.4",
+    "@types/node": "^20.19.17",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.2",
+    "autoprefixer": "^10.4.23",
+    "eslint": "^10.0.0",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.0",
+    "postcss": "^8.5.6",
+    "postcss-nesting": "^13.0.2",
+    "postcss-px-to-viewport-8-plugin": "^1.2.5",
+    "tailwindcss": "^3.4.19",
+    "typescript": "^5.9.2"
+  }
+}

package/templates/base/template/postcss.config.js.template

@@ -0,0 +1,18 @@
+module.exports = {
+  plugins: {
+    'postcss-nesting': {},
+    'tailwindcss': {},
+    'autoprefixer': {},
+    'postcss-px-to-viewport-8-plugin': {
+      unitToConvert: 'px',
+      viewportUnit: 'vw',
+      unitPrecision: 6,
+      fontViewportUnit: 'vw',
+      selectorBlackList: [],
+      minPixelValue: 1,
+      mediaQuery: false,
+      replace: true,
+      viewportWidth: 430,
+    },
+  },
+};

package/templates/base/template/proxy.ts.template

@@ -0,0 +1,18 @@
+import type { NextRequest } from 'next/server';
+import { routing } from '@funhub/platform/i18n';
+import createMiddleware from 'next-intl/middleware';
+
+const handleI18nRouting = createMiddleware(routing);
+
+/**
+ * 处理 Starter 应用的国际化路由。
+ * @param {NextRequest} request
+ */
+export default async function middleware(request: NextRequest) {
+  const response = handleI18nRouting(request);
+  return response;
+}
+
+export const config = {
+  matcher: '/((?!api|trpc|_next|_vercel|.*\\..*).*)',
+};

package/templates/base/template/tailwind.config.cjs.template

@@ -0,0 +1,13 @@
+/** @type {import('tailwindcss').Config} */
+const {
+  platformTailwindPreset,
+  withPlatformTailwindContent,
+} = require('@funhub/platform/config/tailwind');
+
+module.exports = {
+  content: withPlatformTailwindContent([
+    './app/**/*.{js,ts,jsx,tsx}',
+    './components/**/*.{js,ts,jsx,tsx}',
+  ]),
+  presets: [platformTailwindPreset],
+};

package/templates/base/template/tsconfig.json.template

@@ -0,0 +1,43 @@
+{
+  "compilerOptions": {
+    "incremental": true,
+    "target": "ES2017",
+    "jsx": "react-jsx",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "paths": {
+      "@/*": [
+        "./*"
+      ]
+    },
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}